メインコンテンツへスキップ
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服站在月球上",
    "size": "16:9",
    "resolution": "2K",
    "watermark": false
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "seedream-5.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": "seedream-5.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服站在月球上",
    "size": "16:9",
    "resolution": "2K",
    "watermark": false
  }'

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

​
利用可能なモデル

モデル ID説明
seedream-5.0Seedream 5.0、グループ画像、ウェブ検索、ストリーミング出力に対応
seedream-4.5Seedream 4.5、グループ画像、4K 解像度に対応
seedream-4.0Seedream 4.0、グループ画像、1K~4K 解像度に対応

​
統一パラメータ

​
model
string
必須
モデルグループ名：seedream-5.0、seedream-4.5、seedream-4.0
​
action
string
デフォルト:"generate"
操作タイプ
​
prompt
string
必須
テキストプロンプト、中国語・英語に対応、300文字以内を推奨
​
image_urls
string[]
参照画像 URL 配列、最大14枚、1枚あたり10MB以下
​
size
string
デフォルト:"1:1"
アスペクト比：1:1、2:3、3:2、3:4、4:3、9:16、16:9、21:9
​
resolution
string
デフォルト:"2K"
解像度、選択可能な値はモデルにより異なります。各モデルの Tab を参照
​
n
integer
デフォルト:"1"
生成数、1より大きい場合はグループ画像モードが有効になります
​
watermark
boolean
デフォルト:"true"
透かしを追加するかどうか
​
callback_url
string
タスク完了時の Webhook コールバックアドレス
​
extra
object
上流にパススルーされる追加パラメータ、各モデルの Tab を参照

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

resolution の選択可能な値： 2K、3Ksize の追加対応： 4:5、5:4
​
extra.output_format
string
デフォルト:"jpeg"
出力画像フォーマット：png、jpeg
​
extra.response_format
string
デフォルト:"url"
返却フォーマット：url（ダウンロードリンク）または b64_json（Base64）
​
extra.stream
boolean
デフォルト:"false"
ストリーミング出力、各画像の結果を即時返却
​
extra.optimize_prompt_options
object
プロンプト最適化設定
​
extra.tools
array
モデルツール、ウェブ検索で最新情報の精度を向上
"extra": { "tools": [{"type": "web_search"}] }

​
生成モード

モードパラメータ説明
テキストから画像promptテキストのみで生成
単一画像から画像prompt + image_urls(1枚)参照画像 + テキスト
複数画像から画像prompt + image_urls(2-14枚)複数の参照画像を融合
グループ画像n > 1一連の関連画像を生成
グループ画像モードでは、入力参照画像数 + 生成画像数 ≤ 15 です。

​
レスポンス

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