跳轉到主要內容
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:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9
​
resolution
string
預設值:"1K"
輸出解析度：1K

​
回應

回傳任務 ID，使用 查詢任務狀態 取得最終圖像結果。
​
code
string
狀態碼，成功為 "success"
​
data
string
任務 ID，格式為 task-wave{timestamp}{userId}{random}