Generate AI video
from your own backend

1. 1

   Choose a video agent

   An agent is a saved model configuration - engine, resolution, aspect ratio, defaults. List the ones your workspace has and keep the id.

   curlresponse

   Copy

   export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
   
   # A video agent is a saved model configuration, not a model name.
   curl "https://autostud.ai/api/v1/agents?agent_type=video&limit=10" \
     -H "Authorization: Bearer $AUTOSTUD_API_KEY"

2. 2

   Send the prompt

   Text alone, or a still image to animate. The response comes back with a generation id and the credits it spent.

   curlimage to videoresponse

   Copy

   curl -X POST https://autostud.ai/api/v1/actions/videos_ai.generate \
     -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: lighthouse-shot-01" \
     -d '{
       "agent_id": "b21f7d90-3c44-4e1a-9f77-0c2ad5e6b118",
       "prompt": "A lighthouse at dusk, slow push-in, waves breaking under it",
       "duration": 8
     }'

3. 3

   Collect the clip

   Take the generation.completed webhook, or read the generation back when you prefer polling. The hosted URL is on the record.

   webhookpollingevent

   Copy

   # Register once. Every generation reports itself from then on.
   curl -X POST https://autostud.ai/api/v1/webhooks \
     -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://your-app.com/hooks/autostud",
       "events": ["generation.completed", "generation.failed"],
       "description": "AI video"
     }'
   # The signing secret comes back once, in this response. Store it.

Questions developers ask first