AI Avatar v2 (Lipsync v2)

Fresh

Purpose

Generate multi-scene AI avatar videos with different avatars, voices, and backgrounds per scene using the Creatify Lipsync v2 API.

Prerequisites

• Authenticated API access (Authentication SOP)
• Avatar IDs and Voice IDs for each scene
• Sufficient credits (5/30s to create, 4/30s to render)

Procedure

Step 1: Plan Your Scenes

Each scene can have a different avatar, voice, background, and script. Plan the scene array before making the API call.

Scene	Avatar	Voice	Script	Background
1	Sarah	Friendly Female	"Welcome to our product..."	Office
2	James	Professional Male	"Let me show you the features..."	Studio
3	Sarah	Friendly Female	"Get started today..."	Outdoor

Step 2: Create Multi-Scene Task

curl --request POST \
  --url https://api.creatify.ai/api/lipsync_v2/ \
  --header "Content-Type: application/json" \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY" \
  --data '{
    "scenes": [
      {
        "text": "Welcome to our product demo.",
        "creator": "avatar-uuid-001",
        "voice_id": "voice-uuid-001",
        "background": "office"
      },
      {
        "text": "Let me show you the features that make us different.",
        "creator": "avatar-uuid-002",
        "voice_id": "voice-uuid-002",
        "background": "studio"
      },
      {
        "text": "Get started today with a free trial.",
        "creator": "avatar-uuid-001",
        "voice_id": "voice-uuid-001",
        "background": "outdoor"
      }
    ],
    "aspect_ratio": "9:16"
  }'

Response:

{
  "id": "lipsync-v2-task-uuid",
  "status": "pending",
  "scenes": [...]
}

Step 3: Poll for Preview Completion

curl --request GET \
  --url https://api.creatify.ai/api/lipsync_v2/lipsync-v2-task-uuid/ \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY"

Poll every 5-10 seconds until status is done.

Step 4: Review Preview

When status is done, the response includes a preview URL. Review the video for:

• Correct avatar in each scene
• Lip sync quality
• Scene transitions
• Audio clarity

Step 5: Render Final Video

curl --request POST \
  --url https://api.creatify.ai/api/lipsync_v2/lipsync-v2-task-uuid/render/ \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY"

Step 6: Poll Render and Download

Poll the same task ID until render completes, then download from output URL.

Credit Cost

Operation	Credits
Create multi-scene task	5 per 30s
Render final video	4 per 30s
Total	9 per 30s

WARNING

Multi-scene videos are calculated on total video duration, not per-scene. A 3-scene video totaling 45 seconds costs (45/30) * 5 = 7.5 credits to create.

v1 vs v2 Comparison

Feature	v1 (Lipsync)	v2 (Lipsync v2)
Scenes	Single scene	Multiple scenes
Avatars per video	1	Different per scene
Voices per video	1	Different per scene
Backgrounds	1	Different per scene
Preview + Render	No	Yes
Credits (create)	5/30s	5/30s
Credits (render)	N/A	4/30s

Verification Checklist

• [ ] All scene avatar IDs are valid
• [ ] All scene voice IDs are valid
• [ ] Task creation returns pending status
• [ ] Preview shows correct scenes in order
• [ ] Each scene uses the correct avatar and voice
• [ ] Scene transitions are smooth
• [ ] Rendered video is higher quality than preview
• [ ] Output URL returns valid MP4

Common Errors

Error	Cause	Fix
Invalid scene avatar	Avatar ID not found	Verify avatar exists via GET /api/personas/
Empty scenes array	No scenes provided	Include at least one scene object
Scene text too long	Individual scene exceeds character limit	Shorten text or split into more scenes

---

See Also

• AI Avatar v1 SOP -- Simple single-scene avatar
• Aurora SOP -- Studio-grade from a single image
• Avatar Pipeline Workflow -- v1 vs v2 vs Aurora decision tree