Submit Video Task - MixRoute API

Introduction

The submit video task endpoint is used to create video generation tasks. MixRoute supports multiple video generation models with a unified API endpoint.

Video generation is an asynchronous task. After submission, you need to poll the task status.

Authentication

Bearer Token, e.g., Bearer sk-xxxxxxxxxx

Workflow

Submit Task: POST /v1/video/generations
Poll Status: GET /v1/video/generations/{task_id}
Get Result: Download video or get URL after completion

Supported Models

Model ID	Provider	Description
`sora-2`	OpenAI	Sora 2 video generation model
`veo-3.0-fast-generate-001`	Google	Veo 3.0 fast version
`veo-3.1-fast-generate-preview`	Google	Veo 3.1 fast version
`veo-3.0-generate-preview`	Google	Veo 3.0 standard version
`veo-3.1-generate-preview`	Google	Veo 3.1 standard version
`dreamina-seedance-2-0-260128`	ByteDance	Dreamina Seedance 2.0 video generation
`dreamina-seedance-2-0-fast-260128`	ByteDance	Dreamina Seedance 2.0 Fast
`seedance-1-5-pro-251215`	ByteDance	Seedance 1.5 Pro video generation
`seedance-1-0-pro-250528`	ByteDance	Seedance 1.0 Pro video generation
`seedance-1-0-pro-fast-251015`	ByteDance	Seedance 1.0 Pro Fast video generation

Model-Specific Parameters

Sora 2 Parameters

model

string

required

Model name: sora-2

prompt

string

required

Video description prompt

duration

integer

Video duration (seconds): 5, 10, 15, 20, default 5

resolution

string

Resolution: 480p, 720p, 1080p, default 720p

aspect_ratio

string

Aspect ratio: 16:9, 9:16, 1:1, default 16:9

image_url

string

Reference image URL (image-to-video mode)

remix_url

string

Original video URL (Remix mode)

Veo Parameters

model

string

required

Model name: veo-3.1-fast-generate-preview, etc.

prompt

string

required

Video description prompt

durationSeconds

integer

Video duration: 4, 6, 8

aspectRatio

string

Aspect ratio: 16:9, 9:16

resolution

string

Resolution: 720p, 1080p

image

string

First frame reference image (Base64 or URL)

lastFrameImage

string

Last frame reference image (only supported by veo-3.1 series)

generateAudio

boolean

Whether to generate synchronized audio, default false

Dreamina Seedance Parameters

model

string

required

Model name: seedance-1.0, seedance-1.0-pro, seedance-1.5-pro

prompt

string

required

Video description prompt

duration

integer

Video duration (seconds): 4, 6, 8

aspect_ratio

string

Aspect ratio: 16:9, 9:16, 1:1

resolution

string

Resolution: 720p, 1080p

first_frame

string

First frame image (Base64 or URL)

last_frame

string

Last frame image (Base64 or URL)

reference_image

string

Reference image (for style or character reference)

negative_prompt

string

Negative prompt, describing unwanted elements

Usage Examples

Sora 2
Veo
Dreamina Seedance

Text-to-Video
Image-to-Video
Remix Mode

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "sora-2",
    "prompt": "A golden retriever running on the beach, sunny day, slow motion shot",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "sora-2",
    "prompt": "Make the person in the image smile and wave",
    "duration": 5,
    "image_url": "https://api.mixroute.ai/image.jpg"
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "sora-2",
    "prompt": "Convert the video style to anime, keep the same motion and composition",
    "duration": 10,
    "remix_url": "https://api.mixroute.ai/original-video.mp4"
  }'

Text-to-Video
First Frame Mode
First & Last Frame Mode

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "Morning sunlight shining on a cyberpunk city skyline, camera slowly pushing forward",
    "durationSeconds": 6,
    "aspectRatio": "16:9",
    "resolution": "1080p",
    "generateAudio": false
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "veo-3.1-generate-preview",
    "prompt": "Camera slowly pulls back to reveal the entire city panorama",
    "durationSeconds": 8,
    "aspectRatio": "16:9",
    "image": "https://api.mixroute.ai/first-frame.jpg"
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "veo-3.1-generate-preview",
    "prompt": "A flower blooming from bud to full bloom",
    "durationSeconds": 6,
    "image": "https://api.mixroute.ai/flower-bud.jpg",
    "lastFrameImage": "https://api.mixroute.ai/flower-bloom.jpg"
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "seedance-1.0",
    "prompt": "A girl dancing under cherry blossom trees, petals falling, beautiful aesthetic",
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "1080p",
    "negative_prompt": "blurry, distorted, low quality"
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "seedance-1.0",
    "prompt": "The person slowly turns their head and smiles",
    "duration": 4,
    "first_frame": "https://api.mixroute.ai/portrait.jpg"
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "seedance-1.0",
    "prompt": "A car accelerates from standstill and drives into the distance",
    "duration": 6,
    "first_frame": "https://api.mixroute.ai/car-start.jpg",
    "last_frame": "https://api.mixroute.ai/car-end.jpg"
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "seedance-1.0",
    "prompt": "A girl walking on the street, maintaining the character appearance from the reference image",
    "duration": 6,
    "reference_image": "https://api.mixroute.ai/character-ref.jpg",
    "aspect_ratio": "16:9"
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "seedance-1.0-pro",
    "prompt": "Cinematic quality, a samurai slowly drawing his sword in the rain",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "1080p"
  }'

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "seedance-1.5-pro",
    "prompt": "Ultra HD quality, an astronaut performing maintenance outside a space station, Earth slowly rotating in the background",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "negative_prompt": "blurry, noise, low quality"
  }'

Response Example

{
  "task_id": "video_xxx",
  "status": "pending"
}

Python Example

import requests
import time

def generate_video(prompt, model="veo-3.1-fast-generate-preview"):
    """Submit a video generation task and wait for completion"""
    api_key = "sk-xxxxxxxxxx"
    base_url = "https://api.mixroute.ai/v1"
    
    # Submit task
    response = requests.post(
        f"{base_url}/video/generations",
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        },
        json={
            "model": model,
            "prompt": prompt,
            "durationSeconds": 6,
            "aspectRatio": "16:9"
        }
    )
    
    task_id = response.json()["task_id"]
    print(f"Task submitted: {task_id}")
    
    # Poll status
    while True:
        status_response = requests.get(
            f"{base_url}/video/generations/{task_id}",
            headers={"Authorization": f"Bearer {api_key}"}
        )
        result = status_response.json()
        status = result.get("status")
        
        print(f"Current status: {status}")
        
        if status == "succeeded":
            return result.get("url")
        elif status == "failed":
            raise Exception(f"Generation failed: {result.get('error')}")
        
        time.sleep(5)

# Usage example
video_url = generate_video("A sailboat sailing on calm water at sunset")
print(f"Video URL: {video_url}")

Model Comparison

Feature	Sora 2	Veo	Dreamina Seedance
Max Duration	20s	8s	8s
Max Resolution	1080p	1080p	1080p
First Frame Constraint	✅	✅	✅
Last Frame Constraint	❌	✅ (3.1)	✅
Audio Generation	❌	✅	❌
Chinese Understanding	Good	Good	Excellent

Video generation consumes significant resources. Please control your request frequency. Different models have different pricing, see the pricing page for details.

Notes

Video generation is an asynchronous task, polling for status is required
Parameter names may vary slightly between models, please refer to each model’s examples
Prompts should describe scene content, camera movements, style, etc. in detail
Generated videos have an expiration period, download and save them promptly
Please follow content policies and avoid generating prohibited content

curl --request POST \
  --url https://api.mixroute.ai/v1/video/generations \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "A cute kitten playing in the garden",
    "durationSeconds": 6,
    "aspectRatio": "16:9"
  }'

{
  "task_id": "video_xxx",
  "status": "submitted",
  "format": "mp4"
}

​Introduction

​Authentication

​Workflow

​Supported Models

​Model-Specific Parameters

​Sora 2 Parameters

​Veo Parameters

​Dreamina Seedance Parameters

​Usage Examples

​Response Example

​Python Example

​Model Comparison

​Notes

Introduction

Authentication

Workflow

Supported Models

Model-Specific Parameters

Sora 2 Parameters

Veo Parameters

Dreamina Seedance Parameters

Usage Examples

Response Example

Python Example

Model Comparison

Notes