提交视频任务 - MixRoute API

简介

提交视频任务接口用于创建视频生成任务。MixRoute 支持多种视频生成模型，提供统一的调用入口。

视频生成是异步任务，提交后需要轮询查询任务状态。

认证

Bearer Token，如 Bearer sk-xxxxxxxxxx

调用流程

提交任务：POST /v1/video/generations
轮询状态：GET /v1/video/generations/{task_id}
获取结果：成功后下载视频或获取URL

支持的模型

模型 ID	厂商	说明
`sora-2`	OpenAI	Sora 2 视频生成模型
`veo-3.0-fast-generate-001`	Google	Veo 3.0 快速版
`veo-3.1-fast-generate-preview`	Google	Veo 3.1 快速版
`veo-3.0-generate-preview`	Google	Veo 3.0 标准版
`veo-3.1-generate-preview`	Google	Veo 3.1 标准版
`dreamina-seedance-2-0-260128`	字节跳动	Dreamina Seedance 2.0 视频生成
`dreamina-seedance-2-0-fast-260128`	字节跳动	Dreamina Seedance 2.0 快速版
`seedance-1-5-pro-251215`	字节跳动	Seedance 1.5 Pro 视频生成
`seedance-1-0-pro-250528`	字节跳动	Seedance 1.0 Pro 视频生成
`seedance-1-0-pro-fast-251015`	字节跳动	Seedance 1.0 Pro Fast 视频生成

模型专用参数详解

Sora 2 参数

model

string

required

模型名称：sora-2

prompt

string

required

视频描述提示词

duration

integer

视频时长（秒）：5、10、15、20，默认 5

resolution

string

分辨率：480p、720p、1080p，默认 720p

aspect_ratio

string

宽高比：16:9、9:16、1:1，默认 16:9

image_url

string

参考图片URL（图生视频模式）

remix_url

string

原始视频URL（Remix 模式）

Veo 参数

model

string

required

模型名称：veo-3.1-fast-generate-preview 等

prompt

string

required

视频描述提示词

durationSeconds

integer

视频时长：4、6、8

aspectRatio

string

宽高比：16:9、9:16

resolution

string

分辨率：720p、1080p

image

string

首帧参考图（Base64 或 URL）

lastFrameImage

string

尾帧参考图（仅 veo-3.1 系列支持）

generateAudio

boolean

是否生成同步音频，默认 false

Dreamina Seedance 参数

model

string

required

模型名称：seedance-1.0、seedance-1.0-pro、seedance-1.5-pro

prompt

string

required

视频描述提示词

duration

integer

视频时长（秒）：4、6、8

aspect_ratio

string

宽高比：16:9、9:16、1:1

resolution

string

分辨率：720p、1080p

first_frame

string

首帧图片（Base64 或 URL）

last_frame

string

尾帧图片（Base64 或 URL）

reference_image

string

参考图片（用于风格或角色参考）

negative_prompt

string

负面提示词，描述不想要的元素

使用示例

Sora 2
Veo
Dreamina Seedance

文生视频
图生视频
Remix 模式

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": "一只金毛犬在海滩上奔跑，阳光明媚，慢动作镜头",
    "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": "让图片中的人物微笑并挥手",
    "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": "将视频风格改为动漫风格，保持相同的运动和构图",
    "duration": 10,
    "remix_url": "https://api.mixroute.ai/original-video.mp4"
  }'

文生视频
首帧模式
首尾帧模式

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": "清晨阳光洒在赛博城市的高楼群，镜头慢慢推进",
    "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": "镜头缓缓拉远，展示整个城市全景",
    "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": "一朵花从含苞待放到盛开的过程",
    "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": "一个女孩在樱花树下转圈跳舞，花瓣飘落，唯美风格",
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "1080p",
    "negative_prompt": "模糊, 变形, 低质量"
  }'

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": "人物缓缓转头微笑",
    "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": "汽车从静止加速驶向远方",
    "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": "一个女孩在街头行走，保持参考图中的人物形象",
    "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": "电影级画质，一位武士在雨中缓缓拔刀",
    "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": "超高清画质，宇航员在太空站外进行维修作业，地球在背景中缓缓旋转",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "negative_prompt": "模糊, 噪点, 低质量"
  }'

响应示例

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

Python 示例

import requests
import time

def generate_video(prompt, model="veo-3.1-fast-generate-preview"):
    """提交视频生成任务并等待完成"""
    api_key = "sk-xxxxxxxxxx"
    base_url = "https://api.mixroute.ai/v1"
    
    # 提交任务
    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_id}")
    
    # 轮询状态
    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"当前状态: {status}")
        
        if status == "succeeded":
            return result.get("url")
        elif status == "failed":
            raise Exception(f"生成失败: {result.get('error')}")
        
        time.sleep(5)

# 使用示例
video_url = generate_video("日落时分，一艘帆船在平静的海面上航行")
print(f"视频URL: {video_url}")

模型对比

特性	Sora 2	Veo	阿里万相	Dreamina Seedance
最大时长	20秒	8秒	10秒	8秒
最高分辨率	1080p	1080p	720p	1080p
首帧约束	✅	✅	✅	✅
尾帧约束	❌	✅ (3.1)	❌	✅
音频生成	❌	✅	❌	❌
中文理解	良好	良好	优秀	优秀

视频生成消耗较多资源，请合理控制调用频率。不同模型的计费标准不同，详见价格页面。

注意事项

视频生成是异步任务，需要轮询查询状态
不同模型的参数名称可能略有差异，请参照各模型示例
提示词建议详细描述画面内容、运镜方式、风格等
生成的视频有一定有效期，建议及时下载保存
请遵守内容政策，避免生成违规内容

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": "一只可爱的小猫在花园里玩耍",
    "durationSeconds": 6,
    "aspectRatio": "16:9"
  }'

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

​简介

​认证

​调用流程

​支持的模型

​模型专用参数详解

​Sora 2 参数

​Veo 参数

​Dreamina Seedance 参数

​使用示例

​响应示例

​Python 示例

​模型对比

​注意事项

简介

认证

调用流程

支持的模型

模型专用参数详解

Sora 2 参数

Veo 参数

Dreamina Seedance 参数

使用示例

响应示例

Python 示例

模型对比

注意事项