Skip to content

Preview Avatar Video (v2)

FreshPOST
POST https://api.creatify.ai/api/lipsyncs/{id}/preview/

Generate a preview of a v2 multi-scene avatar video. Use previews to verify scene composition before committing to a full render.

Credit Cost

1 credit per 30 seconds of video

Path Parameters

NameTypeRequiredDescription
idstringYesThe lipsync task ID

Headers

HeaderTypeRequiredDescription
X-API-IDstringYesYour Creatify API ID
X-API-KEYstringYesYour Creatify API key

Example Request

bash
curl -X POST 'https://api.creatify.ai/api/lipsyncs/v2-abc123/preview/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key'

Response

json
{
  "id": "v2-abc123",
  "status": "processing",
  "preview": null,
  "created_at": "2024-01-15T10:30:00Z"
}

When processing completes:

json
{
  "id": "v2-abc123",
  "status": "done",
  "preview": "https://cdn.creatify.ai/previews/v2-abc123.mp4",
  "created_at": "2024-01-15T10:30:00Z"
}

Status Codes

CodeDescription
200Preview generation started
401Unauthorized -- invalid API credentials
402Insufficient credits
404Lipsync task not found
500Internal server error

TIP

Preview all multi-scene compositions before rendering. This lets you verify scene transitions and avatar placement at a fraction of the render cost.