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.

​
Quickstart

​
1. Create an API key

Open TurboAds, go to Settings > Developers, and create a workspace API key. Copy the key immediately. TurboAds only shows the full secret once.

​
2. Set environment variables

export TURBOADS_API_KEY="ta_live_..."
export TURBOADS_API_BASE_URL="https://api.turboads.ai"

​
3. Find a project

curl "$TURBOADS_API_BASE_URL/v1/projects" \
  -H "Authorization: Bearer $TURBOADS_API_KEY"

​
4. Generate an image

curl "$TURBOADS_API_BASE_URL/v1/images/generate" \
  -H "Authorization: Bearer $TURBOADS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "PROJECT_ID",
    "prompt": "A bright product photo of a skincare bottle on a bathroom counter",
    "model": "nano-banana-2",
    "aspect_ratio": "1:1",
    "count": 1
  }'
The response includes generated image IDs.

​
5. Poll the generation

curl "$TURBOADS_API_BASE_URL/v1/images/IMAGE_ID" \
  -H "Authorization: Bearer $TURBOADS_API_KEY"

​
6. Fetch the final URL

curl "$TURBOADS_API_BASE_URL/v1/images/IMAGE_ID/url" \
  -H "Authorization: Bearer $TURBOADS_API_KEY"
If the generation is still processing, the API returns 409 not_ready.