Dreamina
curl --request POST \
--url https://api.mixroute.ai/v1/video/generationsimport requests
url = "https://api.mixroute.ai/v1/video/generations"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.mixroute.ai/v1/video/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mixroute.ai/v1/video/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.mixroute.ai/v1/video/generations"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mixroute.ai/v1/video/generations")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mixroute.ai/v1/video/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyVideo Series
Dreamina
Dreamina video generation parameters, supported values, input constraints, and request examples.
Dreamina
curl --request POST \
--url https://api.mixroute.ai/v1/video/generationsimport requests
url = "https://api.mixroute.ai/v1/video/generations"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.mixroute.ai/v1/video/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mixroute.ai/v1/video/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.mixroute.ai/v1/video/generations"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mixroute.ai/v1/video/generations")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mixroute.ai/v1/video/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyThis page documents the
Model availability is account-specific. Use the complete ID shown in the Model Marketplace.
The nested content fields and media size/format constraints are defined in Seedance.
dreamina-seedance-* video routes. Dreamina is the route/product prefix; Seedance is the video model family. Use the complete model ID rather than exchanging prefixes.
POST https://api.mixroute.ai/v1/video/generations
Keep
model, prompt, and asset at the root. Put every provider field inside the single metadata object, including content, duration, ratio, resolution, and generate_audio.Model IDs
| Version | MixRoute model ID |
|---|---|
| Seedance 2.5 | dreamina-seedance-2-5-260628 |
| Seedance 2.0 | dreamina-seedance-2-0-260128 |
| Seedance 2.0 Fast | dreamina-seedance-2-0-fast-260128 |
| Seedance 2.0 Mini | dreamina-seedance-2-0-mini-260615 |
Top-Level Fields
| Field | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Complete MixRoute model ID from the model table. |
prompt | string | Yes | MixRoute video prompt. If metadata.content includes a text item, keep both texts consistent. |
asset | boolean | Conditional | MixRoute media-processing switch, not a provider field. Keep it at the root; the text-only examples use false. |
metadata | object | Yes | Container for the provider fields described below. |
Generation Parameters
| Field | Type | Required | Description |
|---|---|---|---|
metadata.content | object[] | Yes | Video inputs: text, images, video, and supported audio references. Pure text generation requires a text item; text is optional in provider media-input combinations. |
metadata.draft | boolean | No | Default false. Draft mode is supported by Dreamina Seedance 2.5, using 480p. Dreamina 2.5 finalization uses 1080p; parameter reuse differs by version. Do not apply these rules to 2.0. |
metadata.output_format | string | No | Seedance 2.5 only. Default mp4; values: mp4, mov. MP4 is intended for general playback; MOV preserves higher color precision for post-production and requires compatible playback software. |
metadata.omni_reference_task_type | string | No | Seedance 2.5 only. Default auto; values: auto, reference, edit, extend. Explicit modes enable early task-type validation. A mismatch between the declared mode and the inferred intent can still fail asynchronously. |
metadata.resolution | string | No | Output resolution tier. Supported values and defaults depend on the model version; see the version table. Values are case-sensitive. |
metadata.ratio | string | No | Default adaptive. Values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive. Scenario constraints are listed below. |
metadata.duration | integer | No | 2.5: integer seconds 4-30 or -1 (default, automatic); editing requires -1. 2.0: 4-15 or -1. |
metadata.generate_audio | boolean | No | Default true: generate synchronized mono audio, including speech, sound effects, or music. false produces a silent video. |
metadata.watermark | boolean | No | Default false. true adds an AI-generated watermark in the lower-right corner; false omits it. |
metadata.return_last_frame | boolean | No | Default false. true returns a watermark-free PNG of the final frame, with the same pixel dimensions as the generated video, in the task result. |
metadata.callback_url | string | No | Task-status callback URL. The provider sends POST notifications with its task-query response structure. Statuses include queued, running, succeeded, failed, and expired. |
metadata.execution_expires_after | integer | No | Range 3600-259200 seconds; default 172800 (48 hours), measured from task creation. A task that exceeds this threshold is terminated with status expired. |
metadata.priority | integer | No | 2.5 and 2.0 only. Range 0-9; default 0. Higher values move ahead of lower-priority queued tasks on the same endpoint. Equal priorities remain FIFO; running tasks are not interrupted. Not supported with flex. |
metadata.safety_identifier | string | No | Stable, unique identifier for the end user, limited to 64 English characters. Use a hashed identifier instead of raw personal information. |
metadata.tools | object[] | No | 2.5 and 2.0 only. Each tool requires type; the supported value is web_search. The model decides whether to search. The query result exposes the search count in usage.tool_usage.web_search. |
Version Limits
| Version | Resolution | Default Resolution | Duration | Reference Limits (Images / Videos / Audio) |
|---|---|---|---|---|
| Seedance 2.5 | 480p / 720p / 1080p | 720p | 4-30 s / -1 | 30 / 10 / 10 |
| Seedance 2.0 | 480p / 720p / 1080p / 4k | 720p | 4-15 s / -1 | 9 / 3 / 3 |
| Seedance 2.0 Fast / Mini | 480p / 720p | 720p | 4-15 s / -1 | 9 / 3 / 3 |
Seedance 2.5
For editing and extension, usemetadata.ratio=adaptive; editing also requires metadata.duration=-1 and a 4-30 second source video. Audio-only reference input is supported in 2.5, unlike 2.0.
1080p uses 10-bit H.265/HEVC. Use a compatible decoder when the returned video cannot play. A Draft request uses metadata.draft=true and metadata.resolution=480p; finalization uses a successful provider draft_task.id and 1080p. Draft IDs expire after seven days.
Scenario Constraints
- First-frame, first/last-frame, and multimodal reference workflows are mutually exclusive. Do not mix frame roles with
reference_*roles. - Seedance 2.0 audio references require at least one image or video reference.
Examples
SetMIXROUTE_API_KEY before calling the API. Replace media placeholders with accessible inputs. Accepted requests create billable generation tasks; do not automatically resubmit after a submission timeout.
curl --request POST "https://api.mixroute.ai/v1/video/generations" \
--header "Authorization: Bearer $MIXROUTE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "dreamina-seedance-2-5-260628",
"prompt": "A red cube slowly rotates on a white background. Static camera.",
"asset": false,
"metadata": {
"content": [
{
"type": "text",
"text": "A red cube slowly rotates on a white background. Static camera."
}
],
"duration": 4,
"ratio": "9:16",
"resolution": "480p",
"generate_audio": false
}
}'
Python
import json
import os
import requests
payload = json.loads(r'''
{
"model": "dreamina-seedance-2-5-260628",
"prompt": "A red cube slowly rotates on a white background. Static camera.",
"asset": false,
"metadata": {
"content": [
{
"type": "text",
"text": "A red cube slowly rotates on a white background. Static camera."
}
],
"duration": 4,
"ratio": "9:16",
"resolution": "480p",
"generate_audio": false
}
}
''')
response = requests.post(
"https://api.mixroute.ai/v1/video/generations",
headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
json=payload,
timeout=120,
)
response.raise_for_status()
result = response.json()
print(result)