Create talking-head task

API Reference

Generate a talking-head video from a portrait image and audio file. The output video is rendered at up to 1024 pixels on the longest edge.

The input audio must be no longer than 180 seconds (3 minutes).

Poll Get talking-head task status until COMPLETED or FAILED.

Model:talking-head

Credit:175/video (0-8 seconds), 4/second (each additional second)

post/v1/videos/talking-head

Authorization — This endpoint requires an API key. Pass it in the api-key header on every request. Learn more

For a 8-second output video.

Images

Audio

Name	Type	Status	Description
`task_id`	string	Required

Task createdTaskCreatedResponse

Field	Type	Description
`task_id`	string	Unique task identifier. Poll the matching task-status endpoint for results.
`status`	string
`created_at`	integer	Unix timestamp of task creation

curl -X POST "https://api.snapedit.app/v1/videos/talking-head" \
  -H "api-key: YOUR_API_KEY" \
  -F "task_id=value"

Response

{
  "task_id": "task_abc123",
  "status": "CREATED",
  "created_at": 1745827200
}

Input

Output