メインコンテンツへスキップ
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-pro720p、1080p高画質、1080p 対応
sora-2720p速度重視

​
統一パラメータ

​
model
string
必須
モデル ID
​
action
string
デフォルト:"generate"
操作タイプ：generate、remix、extend
​
prompt
string
必須
動画の説明テキスト
​
callback_url
string
Webhook コールバックアドレス
​
extra
object
Sora にパススルーされる追加パラメータ

​
各操作タイプのパラメータ

テキストから動画または画像から動画。
​
aspect_ratio
string
デフォルト:"9:16"
アスペクト比：16:9、9:16
​
duration
integer
デフォルト:"4"
動画の長さ（秒）：4、8、12、16、20
​
resolution
string
デフォルト:"720p"
出力解像度。1080p は sora-2-pro のみ対応
​
image_urls
string[]
参照画像 URL、先頭フレームガイダンス用。画像のアスペクト比は aspect_ratio と一致する必要があります
​
extra.characters
array
キャラクターアセット配列、最大2つ。キャラクター名はプロンプト内で言及する必要があります

​
レスポンス

​
task_id
string
タスク ID
​
model
string
使用されたモデル ID
​
action
string
操作タイプ
​
status
string
タスクステータス：queued
​
created_at
integer
作成時間（Unix ミリ秒タイムスタンプ）
​
progress
integer
進捗、初期値は 0