影片生成

影片生成是非同步的:提交任務 → 拿到任務 id → 輪詢直到完成 → 獲取結果。提交的任務會出現在 控制台 → 任務日誌,參見 任務日誌。

建立影片

POST https://router.accels.tech/v1/videos

請求體為 application/json。所有欄位均為可選,但 model 與 prompt 是核心輸入。

欄位	型別	說明
model	string	模型 / 風格 id,如 kling-v1、sora-2
prompt	string	影片的文字描述
image	string	圖片輸入 —— URL 或 Base64(圖生影片）
duration	number	影片時長（秒）
width	integer	影片寬度
height	integer	影片高度
fps	integer	幀率
seed	integer	隨機種子
n	integer	生成影片數量
response_format	string	如 url
user	string	終端使用者標識
metadata	object	廠商特定擴充套件引數（如 negative_prompt、style、quality_level）

提交響應返回一個任務 id:

{ "task_id": "abcd1234efgh", "status": "queued" }

舊版別名 POST /v1/video/generations 接受相同的請求體。

輪詢任務狀態

GET https://router.accels.tech/v1/videos/{task_id}

{
  "task_id": "abcd1234efgh",
  "status": "succeeded",
  "url": "https://.../out.mp4",
  "format": "mp4",
  "metadata": { "duration": 5.0, "fps": 30, "width": 512, "height": 512, "seed": 20231234 },
  "error": null
}

status 為 queued / running / succeeded / failed;失敗時 error 為 { code, message }。舊版別名:GET /v1/video/generations/{task_id}。

獲取結果

GET https://router.accels.tech/v1/videos/{task_id}/content

示例

# 1. 提交
curl https://router.accels.tech/v1/videos \
  -H "Authorization: Bearer $ACCELSROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "sora-2", "prompt": "A red kite over a green valley at sunrise", "duration": 8 }'

# 2. 輪詢,然後 3. 下載
curl https://router.accels.tech/v1/videos/{task_id} \
  -H "Authorization: Bearer $ACCELSROUTER_API_KEY"
curl https://router.accels.tech/v1/videos/{task_id}/content \
  -H "Authorization: Bearer $ACCELSROUTER_API_KEY" -o out.mp4

廠商原生格式

部分影片模型通過廠商自有協議接入,而非上面的統一請求體:

• Kling —— /kling/v1/videos/...
• Jimeng（即夢） —— /jimeng/

說明

• 可用影片模型及其時長/解析度上限見 模型市場。
• 所有格式都返回任務 id;統一在 任務日誌 跟蹤。