Preview Avatar Video (v1)

FreshPOST

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

Generate a preview version of an avatar video. Previews are lower quality but cost fewer credits, allowing you to verify the content before committing to a full render.

Credit Cost

1 credit per 30 seconds of video

Path Parameters

Name	Type	Required	Description
id	string	Yes	The lipsync task ID

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key

Example Request

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

Response

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

When processing completes:

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

Status Codes

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

TIP

Poll GET /api/lipsyncs/{id}/ to check when the preview is ready. The preview field will contain the URL when status is done.