跳轉到主要內容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro",
    "action": "generate",
    "prompt": "A cat playing piano in a jazz club, cinematic lighting",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "sora-2-pro",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
非同步處理模式 — 提交請求後回傳任務 ID,透過 查詢任務狀態 介面取得生成結果。
Sora 2 系列模型將於 2026 年 9 月 24 日停止服務。
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro",
    "action": "generate",
    "prompt": "A cat playing piano in a jazz club, cinematic lighting",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "sora-2-pro",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

可用模型

模型 IDresolution 支援說明
sora-2-pro720p1080p高畫質,支援 1080p
sora-2720p速度更快

統一參數

model
string
必填
模型 ID
action
string
預設值:"generate"
操作類型:generateremixextend
prompt
string
必填
影片描述文字
callback_url
string
Webhook 回呼位址
extra
object
透傳給 Sora 的額外參數

各操作類型參數

文生影片或圖生影片。
aspect_ratio
string
預設值:"9:16"
寬高比:16:99:16
duration
integer
預設值:"4"
影片時長(秒):48121620
resolution
string
預設值:"720p"
輸出解析度。1080psora-2-pro 支援
image_urls
string[]
參考圖片 URL,用於首幀引導。圖片寬高比需與 aspect_ratio 一致
extra.characters
array
角色資產陣列,最多 2 個。角色名稱必須在 prompt 中被提及

回應

task_id
string
任務 ID
model
string
使用的模型 ID
action
string
操作類型
status
string
任務狀態:queued
created_at
integer
建立時間(Unix 毫秒時間戳)
progress
integer
進度,初始為 0