提交影片任務 - MixRoute API

簡介

提交影片任務端點用於建立影片生成任務。 MixRoute 支援多種影片生成模型，提供統一的 API 端點。

影片生成是非同步任務。提交後需要輪詢任務狀態。

認證方式

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	豆包 Seedance
最大時長	20 秒	8 秒	8 秒
最大解析度	1080p	1080p	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 範例

模型比較

注意事項