Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.turboads.ai/llms.txt

Use this file to discover all available pages before exploring further.

Talking Actors

Talking actor generations create AI actor videos from a script, actor, and optional voice.

Generate a talking actor

POST /v1/talking-actors/generate
{
  "project_id": "PROJECT_ID",
  "actor_id": "ACTOR_ID",
  "script": "This is the best way to create high-performing ad creative.",
  "voice_id": "VOICE_ID"
}
If voice_id is omitted, TurboAds uses the actor’s default voice when available.

Voice options

You can pass voice_options to tune ElevenLabs speech output:
{
  "speed": 1,
  "stability": 0.5,
  "similarity": 0.75,
  "style": 0
}

Get generation status

GET /v1/talking-actors/{id}
Returns job metadata and status.

Get talking actor URL

GET /v1/talking-actors/{id}/url
Returns the final video URL once ready. If the video is still processing, the API returns 409 not_ready.