Sign in

v47

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-01360485.4 KB
Video Projects

AI Talking Photo

Create a talking photo from an image and audio or text input.

post/v1/ai-talking-photo

Request body

namestring

Give your image a custom name for easy identification.

start_secondsnumber float required

The start time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 180s, prompted 45s.

end_secondsnumber float required

The end time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 180s, prompted 45s.

max_resolutioninteger

Constrains the larger dimension (height or width) of the output video. Allows you to set a lower resolution than your plan's maximum if desired. The value is capped by your plan's max resolution.

Example request

{
  "name": "My Talking Photo image",
  "end_seconds": 15,
  "assets": {
    "image_file_path": "api-assets/id/1234.png",
    "audio_file_path": "api-assets/id/1234.mp3"
  },
  "style": {
    "generation_mode": "realistic"
  },
  "max_resolution": 1024
}

Response

Success

idstring required

Unique ID of the video. Use it with the Get video Project API to fetch status and downloads.

credits_chargedinteger required

The amount of credits deducted from your account to generate the video. If the status is not 'complete', this value is an estimate and may be adjusted upon completion based on the actual FPS of the output video.

If video generation fails, credits will be refunded, and this field will be updated to include the refund.

Example response

{
  "id": "cuid-example",
  "credits_charged": 450
}