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.

​
API Overview

The TurboAds Public API lets you create and poll media generation jobs from your own backend, automation tools, and internal workflows.

​
Base URL

https://api.turboads.ai
All v1 endpoints are rooted under /v1.

​
Authentication

Create an API key in Settings > Developers, then send it as a bearer token. 
Authorization: Bearer ta_live_...

​
Core workflow

  1. List workspace projects and choose an existing project_id.
  2. Create an image, video, replace actor, or talking actor generation.
  3. Poll the generation by ID until it reaches completed or failed.
  4. Fetch the final asset URL from the matching /url endpoint when the resource supports one.

​
Endpoint shape

POST /v1/images/generate
GET  /v1/images/{id}
GET  /v1/images/{id}/url

POST /v1/videos/generate
GET  /v1/videos/{id}
GET  /v1/videos/{id}/url

POST /v1/talking-actors/generate
GET  /v1/talking-actors/{id}
GET  /v1/talking-actors/{id}/url
The API uses polling only in v1. Webhooks are not part of the first public API release.