メインコンテンツへスキップ
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服在月球上行走，电影感光影",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "watermark": false,
    "extra": {
      "generate_audio": true
    }
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "seedance-2.0",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
非同期処理モード — リクエスト送信後にタスク ID が返されます。タスクステータス照会 インターフェースで生成結果を取得してください。動画リンクの有効期限は24時間です。速やかにダウンロードしてください。 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服在月球上行走，电影感光影",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "watermark": false,
    "extra": {
      "generate_audio": true
    }
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "seedance-2.0",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​
利用可能なモデル

モデル ID説明
seedance-2.0Seedance 2.0、ネイティブ音声・先頭末尾フレーム・マルチモーダル参照・最大 2K に対応
seedance-2.0-fastSeedance 2.0 高速版
seedance-1.5-proSeedance 1.5 プロフェッショナル版
seedance-1.0-pro-fastSeedance 1.0 高速版
seedance-1.0-pro-qualitySeedance 1.0 高画質版

​
統一パラメータ

​
model
string
必須
モデル ID
​
action
string
デフォルト:"generate"
操作タイプ
​
prompt
string
必須
動画の説明テキスト、中国語・英語に対応。2.0 ではプロンプト内で @image1、@video1、@audio1 を使用して参照素材を引用できます
​
aspect_ratio
string
デフォルト:"16:9"
アスペクト比：16:9、9:16、4:3、3:4、21:9、1:1
​
duration
integer
デフォルト:"5"
動画の長さ（秒）、選択可能な範囲はモデルにより異なります。各モデルの Tab を参照
​
resolution
string
出力解像度、選択可能な値はモデルにより異なります。各モデルの Tab を参照
​
image_urls
string[]
参照画像 URL 配列、数量制限はモデルバージョンにより異なります
​
first_frame
string
先頭フレーム画像 URL
​
last_frame
string
末尾フレーム画像 URL（first_frame と併用が必要）
​
seed
integer
デフォルト:"-1"
ランダムシード、範囲 [-1, 2^32-1]。-1 はランダム。同じシード + 同じリクエストで類似の結果が得られます
​
watermark
boolean
デフォルト:"false"
透かしを追加するかどうか
​
callback_url
string
Webhook コールバックアドレス
​
extra
object
上流にパススルーされる追加パラメータ、各モデルの Tab を参照

​
モデル固有のパラメータ

duration の範囲： 4-15秒resolution の選択可能な値： 480p、720p、1080p、2Ksize の追加対応： adaptive（自適応、入力素材のアスペクト比に合わせる）入力制限： 画像最大9枚（≤ 30MB）、動画最大3つ（≤ 50MB、合計長さ ≤ 15秒）、音声最大3つ（MP3/WAV、≤ 15MB、合計長さ ≤ 15秒）
​
extra.generate_audio
boolean
デフォルト:"false"
ネイティブ音声・映像同時生成、セリフのリップシンクに対応（8言語以上）
​
extra.return_last_frame
boolean
デフォルト:"false"
末尾フレーム画像 URL を返却、動画クリップの連続撮影に便利
​
extra.tools
array
モデルツール、ウェブ検索に対応
"extra": { "tools": [{"type": "web_search"}] }
​
extra.service_tier
string
サービスティア、レイテンシーとコストのバランスを制御
2.0 で先頭末尾フレームモード（first_frame + last_frame）を使用する場合、video_urls と audio_urls は同時に指定できません。

​
生成モード

モードパラメータ対応バージョン
テキストから動画prompt全て
画像から動画prompt + image_urls(1枚) または first_frame全て
先頭末尾フレームfirst_frame + last_frame1.0-quality / 1.5 / 2.0
マルチモーダル参照image_urls + video_urls + audio_urls2.0 のみ

​
レスポンス

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