Media
Video generation
Text and image to video, and stock-footage edits.
All video endpoints share the same auth (sk_…). Each provider charges credits up-front and refunds on failure.
POST/api/v1/video— Veo / Meta AI / Meta Muse / Omni Flash / Omni 1.2 / Google Vids / Seedance
Single endpoint that fans out to multiple providers based on model. All durations are inclusive of audio; failures are refunded automatically.
Veo 3.1 family (Google, 60-120 s, 8 s fixed clip):
Omni Flash (model: "omniflash", 16:9 / 9:16). Duration-tiered, and a 360p draft size at half the credits:
360p exists to make iteration cheap: five drafts cost less than one 720p render. There is no size above 720p on this model.
Fields: prompt, model: "omniflash", aspect_ratio (16:9 / 9:16), resolution (360p / 720p, default 720p), duration (4 / 6 / 8 / 10), ref_images (optional, up to 7 base64 data URIs or http(s) URLs). Images are always used as references (visual context); mode_image is ignored on Omni Flash, so there is no start / end frame mode.
Omni 1.2 (model: "omni-1.2", 16:9 / 9:16) — the newer Omni Flash: same fields, same up to 7 references and the same 360p draft at half price, with any whole length from 3 to 15 seconds, priced at 1.5× Omni Flash:
Fields: prompt, model: "omni-1.2" (omni_flash_12 is accepted too), aspect_ratio, resolution (360p / 720p), duration (whole number 3-15, default 8), ref_images (optional, up to 7). Clips longer than 10 s can take longer to start.
Google Vids (model: "google-vids", 16:9 / 9:16) — 900 credits per second, 1080p at 1.5×:
Fields: prompt, model: "google-vids", aspect_ratio (16:9 / 9:16), resolution (720p / 1080p), duration (any whole number 3-15, default 5), ref_images (optional, up to 3 subject/style references), mode_image: "frame" with a single image to start the clip from it. No end frame and no voice: either is a 400.
Meta Muse (model: "meta-muse") — 1,200 credits per second, any whole length from 1 to 60 seconds, with sound. The longest single clip on the API.
There is no resolution (the model chooses it; the field is ignored and absent from the response). voice, end_frame, reference_video and a count other than 1 are a 400. All validation errors are returned before any credit is taken.
A short clip usually answers 200 with video_url. A longer one answers 202 with status: "processing" and a task_id after about 150 seconds: poll GET /api/v1/video?task_id=... until it returns completed (with video_url) or failed (credits refunded). The success body carries image_mode: "start_frame", "references" or null.
curl -X POST "https://www.dubvoice.ai/api/v1/video" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"prompt": "a paper boat drifting down a rainy street, slow push in, cinematic",
"model": "meta-muse",
"aspect_ratio": "9:16",
"duration": 30
}'Seedance 2.0 and 2.5 (model: "seedance-2.0", "seedance-2.0-fast", "seedance-2.5" or "seedance-2.5-variant") — priced per second by resolution, with or without sound at the same price. One model covers text to video, opening and closing frames, and reference images: send no images, images with mode_image: "frame", or images with mode_image: "reference".
A 5-second 720p clip is 204,500 credits on 2.0, 182,000 on 2.0 Fast, 326,500 on 2.5 and 340,000 on 2.5 Variant.
Seedance renders take a few minutes, so the response is always 202 with status: "processing" and a task_id. Poll GET /api/v1/video?task_id=... every 10 seconds until it returns completed (with video_url) or failed (credits refunded). All validation happens before any credit is taken.
curl -X POST "https://www.dubvoice.ai/api/v1/video" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"prompt": "a red fox runs through fresh snow at sunrise, tracking shot",
"model": "seedance-2.0",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true
}'Meta AI (model: "meta") — flat 2,000 credits per clip, the cheapest video model here.
duration is ignored: Meta returns its own clip length, which is why it prices flat. Meta does not use ref_images — pass start_frame / end_frame instead (ref_images[0] and [1] are accepted as a fallback so callers reusing the Omni Flash shape still work).
curl -X POST "https://www.dubvoice.ai/api/v1/video" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"prompt": "waves crashing on a rocky shore at dawn, cinematic",
"model": "meta",
"aspect_ratio": "9:16",
"resolution": "720p"
}'POST/api/video/grok— Grok Imagine
xAI Grok video. Renders synchronously (~60-120 s) and returns the final file_url; refunds credits automatically on failure.
Cost — flat-rate matrix (per clip, not per second):
15 seconds is the longest single clip on the platform — every Veo 3.1 tier is fixed at 8 s.
Response:
{
"id": "...", "status": "completed",
"file_url": "https://...mp4",
"credits_used": 3000, "duration": 6, "resolution": "480p", "aspect_ratio": "16:9",
"created_at": "..."
}POST/api/v1/stock-video— Stock-footage edit
Auto-edited video from a stock library, driven by a script + topic. Optionally re-times to a supplied narration audio. Async — returns a job_id; poll GET /api/v1/stock-video?job_id=… for the final video_url. Credits are refunded automatically on failure.
Cost: 500 credits per 1,000 characters (minimum 500 cr).
curl -X POST "https://www.dubvoice.ai/api/v1/stock-video" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"text": "The Pacific is the largest and deepest ocean on Earth...",
"topic": "ocean waves",
"audio_url": "https://example.com/narration.mp3"
}'Status poll response when ready:
{
"job_id": "abc123...",
"status": "DONE",
"video_url": "https://....supabase.co/storage/v1/object/public/tts-audio/videos/...mp4"
}The first completed poll may return a relative video_url (/api/text-to-stock-video/download?job_id=...) — prefix it with https://www.dubvoice.ai to download. Later polls return the storage URL shown above.
Status values: QUEUED → PROCESSING → DONE (or ERROR).