メインコンテンツへスキップ
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "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": "gemini-3.1-flash-image-preview",
    "prompt": "一只橘猫趴在窗台上晒太阳,水彩画风格",
    "size": "16:9"
  }'
{
  "code": "success",
  "data": "task-wave17200000001234567890abcdef"
}

利用可能なモデル

モデル ID説明
gemini-2.5-flash-image-previewGemini 2.5 Flash 画像プレビュー版
gemini-3-pro-image-previewGemini 3 Pro 画像プレビュー版
gemini-3.1-flash-image-previewGemini 3.1 Flash 画像プレビュー版、高解像度と検索強化に対応

共通パラメータ

model
string
必須
モデル ID、上記のモデルリストを参照
prompt
string
必須
画像の説明テキスト、最大1000文字
image_urls
array
参照画像 URL 配列、最大14枚、1枚あたり10MB以下
n
integer
デフォルト:"1"
生成数、固定値 1

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

size
string
デフォルト:"1:1"
画像サイズ比率対応:1:12:33:23:44:34:55:49:1616:921:9
resolution
string
デフォルト:"1K"
出力解像度:1K

レスポンス

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