Video production, reduced to an API call.

Three requests. One finished video. Ads, slideshows, and images run the exact same shape — estimate, create, poll.

1. 1

   Price it first — free. The response quotes the exact cost and names the models that will run.

   Request

   curl -X POST https://api.turboclip.ai/v1/video/estimate \
     -H "Content-Type: application/json" \
     -H "x-api-key: tc_sk_..." \
     -d '{
       "prompt": "The 12-3-30 treadmill workout, explained in 30 seconds",
       "settings": { "aspectRatio": "9:16", "videoDurationSeconds": 30 }
     }'

   Copy

   Response · 200

   {
     "success": true,
     "data": {
       "sufficient": true,
       "estimate": { "total": 206 },
       "models": [
         { "role": "text", "name": "Opus 4.8" },
         { "role": "image", "name": "Nano Banana (3 Pro)" }
       ]
     }
   }

2. 2

   Send it — same body on POST /v1/video. Credits reserve up front, and the quote IS the charge.

   Request

   curl -X POST https://api.turboclip.ai/v1/video \
     -H "Content-Type: application/json" \
     -H "x-api-key: tc_sk_..." \
     -d '{ ...same body... }'

   Copy

   Response · 200

   {
     "success": true,
     "data": {
       "projectId": "3f2a1b4c-…",
       "jobId": "9b1c7e2d-…",
       "creditsReserved": 206,
       "creditsRemaining": 294
     }
   }

3. 3

   Poll, then collect the finished MP4 — narrated, captioned, ready to post.

   Request

   curl https://api.turboclip.ai/v1/jobs/{jobId} \
     -H "x-api-key: tc_sk_..."
   
   curl https://api.turboclip.ai/v1/video/{projectId}/result \
     -H "x-api-key: tc_sk_..."

   Copy

   Response · 200

   {
     "success": true,
     "data": {
       "status": "completed",
       "videoUrl": "https://…/final.mp4"
     }
   }