Videodialogifi › API › Auto Movie Maker

Auto Movie Maker API

The Auto Movie Maker API lets you generate complete AI movies programmatically. Submit a concept, the pipeline writes the script, casts characters, renders scenes, mixes audio, and returns a finished movie.

Base URL

https://api.videodialogifi.com/v1

Authentication

All requests require a bearer API key. Get a key from your account dashboard.

Authorization: Bearer vdg_live_...

Create a movie

POST /movies

{
  "concept": "A 30-second superhero ad for a kids' bike brand. Hero is a 7-year-old girl with curly hair.",
  "duration_seconds": 30,
  "aspect_ratio": "16:9",
  "style": "cinematic",
  "reference_images": ["https://cdn.example.com/hero.jpg"],
  "voice": {"provider": "elevenlabs", "voice_id": "rachel"},
  "music": {"mood": "uplifting"},
  "webhook_url": "https://yourapp.com/webhooks/vdg"
}

Response:

{
  "id": "mov_01HX...",
  "status": "queued",
  "created_at": "2026-04-24T09:00:00Z"
}

Get movie status

GET /movies/{id}

{
  "id": "mov_01HX...",
  "status": "rendering",
  "progress": 0.62,
  "scenes_completed": 5,
  "scenes_total": 8
}

Terminal states: completed, failed, cancelled.

Download the finished movie

When status == "completed":

{
  "id": "mov_01HX...",
  "status": "completed",
  "output_url": "https://cdn.videodialogifi.com/movies/mov_01HX.mp4",
  "thumbnail_url": "https://cdn.videodialogifi.com/movies/mov_01HX.jpg",
  "duration_seconds": 30,
  "coins_used": 240
}

Webhooks

If you pass webhook_url, Videodialogifi POSTs the final job object when the movie finishes (or fails). Webhooks are signed with HMAC-SHA256 in the X-Videodialogifi-Signature header.

Rate limits

Error codes

Related

• Seedance 2 reference guide — reference videos, first/last frame rules.
• Pricing & coin FAQ.
• Platform overview.