メインコンテンツへスキップ
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "一只橘猫趴在窗台上晒太阳，水彩画风格",
    "size": "16:9"
  }'

{
  "code": "success",
  "data": "task-wave17200000001234567890abcdef"
}
非同期処理モード — リクエスト送信後にタスク ID が返されます。タスクステータス照会 インターフェースで生成結果を取得してください。 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "一只橘猫趴在窗台上晒太阳，水彩画风格",
    "size": "16:9"
  }'

{
  "code": "success",
  "data": "task-wave17200000001234567890abcdef"
}

​
利用可能なモデル

モデル ID説明
flux-kontext-proFLUX Kontext Pro、画像編集とスタイル転送が得意
flux-kontext-maxFLUX Kontext Max、強化版
flux-2-proFLUX 2.0 Pro、汎用画像生成
flux-2-devFLUX 2.0 Dev、開発版

​
共通パラメータ

​
model
string
必須
モデル ID、上記のモデルリストを参照
​
prompt
string
必須
画像の説明テキスト、最大1000文字
​
image_urls
array
参照画像 URL 配列

​
各モデルの差異パラメータ

flux-kontext-pro と flux-kontext-max に適用
​
size
string
デフォルト:"match_input_image"
画像サイズ対応：match_input_image、auto、1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9、9:21
​
response_format
string
デフォルト:"png"
出力フォーマット：png、jpg
​
safety_tolerance
integer
デフォルト:"2"
コンテンツセーフティレベル、範囲 0-6、値が高いほど緩和
​
prompt_upsampling
boolean
デフォルト:"false"
プロンプト最適化強化を有効にする
Kontext シリーズは画像編集に特化しており、image_urls は最大1枚の参照画像を指定できます。

​
レスポンス

タスク ID を返します。タスクステータス照会 で最終的な画像結果を取得してください。
​
code
string
ステータスコード、成功時は "success"
​
data
string
タスク ID、形式は task-wave{timestamp}{userId}{random}