API reference

What the API is

The MyDreamVid API lets your own software generate videos and images with the Seedance and Seedream models, without anyone clicking through the studio. Your program sends a prompt (and optional reference files), we run the same safety checks and the same pricing as the web studio, and your program collects the finished file. Credits are drawn from the same account balance.

Who it is for

• Teams that generate at volume: product catalogs, ad variants, social clips, localized versions of one video.
• Developers adding video or image generation to their own app, tool, bot or internal pipeline.
• Agencies and studios that want their own front end while we handle models, queues and billing.

If you make a few videos a week by hand, you do not need the API. The studio does everything the API does, with the same prices.

Authentication

Every request carries a bearer key. Keys are created in the studio and are shown once.

• Header: Authorization: Bearer mdv_live_…
• Permission write can create and cancel tasks and upload files; read can only list and fetch.
• Keys are available after a Creator ($25) or Studio ($50) top-up. Credits never expire.
• The API is meant to be called from your server. Do not ship keys in browser or mobile code.

Know the price first

Every task costs credits (1 credit = $0.01). Ask for a quote before you create: it is free, needs no Idempotency-Key, and returns exactly what the task will reserve. The same number comes back as credits_reserved when you create the task, and credits_charged on the finished task is what you actually paid (any unused reservation is returned).

GET /v1/credits shows your available and reserved balance at any time. Tasks created through the API also appear in the studio under My Creations and in the Credits history.

Endpoints

• GET /v1/models — Models with durations, resolutions, ratios, per-second credit prices and reference limits.
• POST /v1/videos/quote — Exact credit cost for a task. Free, no reservation.
• POST /v1/videos — Create a task. Body: kind (t2v | i2v | r2v), model, prompt, duration_s, resolution, ratio, optional generate_audio, references. Requires Idempotency-Key.
• GET /v1/videos/{id} — Task status; a succeeded task carries video_url.
• GET /v1/videos — Your tasks, newest first, cursor paginated (limit, cursor).
• POST /v1/videos/{id}/cancel — Cancel a waiting or queued task.
• POST /v1/files/presign — Upload slot for a reference image, video or audio file.
• POST /v1/files/{media_id}/confirm — Finish an upload: the file is probed and safety-checked, then usable as a reference.
• GET /v1/credits — Available and reserved credits.

Limits

• 60 requests per minute per key.
• 2 tasks in progress (waiting, queued or running) per account through the API.
• Per-model lanes are shared by everyone; when a lane is full your task waits in order and is sent automatically.
• Up to 5 active keys per account.
• Files: images up to 10 MB, video up to 50 MB, audio up to 20 MB. Reference videos must be at least 2 seconds; video and audio can be at most 5 minutes long.