跳轉到主要內容
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 張,每張不超過 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}