跳轉到主要內容
POST
/
v1
/
tasks
curl --request POST \
  --url https://qingbo.dev/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-image",
    "prompt": "星空下的古老城堡，数字艺术风格",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://example.com/reference.png"
    ]
  }'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}
非同步處理模式： 提交請求後回傳任務 ID，請透過 查詢任務狀態 介面取得生成結果。生成的圖片連結有效期為 24 小時，請及時儲存。
curl --request POST \
  --url https://qingbo.dev/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-image",
    "prompt": "星空下的古老城堡，数字艺术风格",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://example.com/reference.png"
    ]
  }'

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

​
認證方式

​
Authorization
string
必填
所有介面均需要使用 Bearer Token 進行認證取得 API Key：存取 API Key 管理頁面 取得您的 API Key使用時在請求標頭中新增：
Authorization: Bearer YOUR_API_KEY

​
請求參數

​
model
string
預設值:"gpt-4o-image"
必填
圖像生成模型名稱範例："gpt-4o-image"
​
prompt
string
必填
圖像生成的文字描述最大 1000 個字元
​
size
string
圖像生成尺寸支援的比例：
  • 1:1 - 正方形
  • 2:3 - 直版
  • 3:2 - 橫版
​
n
integer
生成圖像的數量支援 1、2、4，費用將按數量預扣預設值：1注意： 必須輸入純數字（如 1），不要使用引號包裹
​
image_urls
array<url>
參考圖像 URL 列表，用於圖生圖或圖片編輯限制： 最多 5 張圖片
​
mask_url
string
遮罩圖像 URL
  • 必須為 PNG 格式
  • 尺寸必須與參考圖像一致
  • 最大 4MB

​
回應參數

​
code
string
回應狀態碼
  • success - 請求成功，任務已提交
​
data
string
任務 ID，格式為 task-wave{timestamp}{userId}{random}用於透過 查詢任務狀態 介面取得生成結果

​
注意事項

  1. 非同步處理： 任務提交後非同步處理，請透過 查詢任務狀態 取得生成結果
  2. 連結有效期： 生成的圖片連結有效期為 24 小時，請及時下載儲存
  3. 圖片 URL 要求： 輸入的參考圖片必須為公開可存取的 URL 或 Base64 格式
  4. 費用說明： 當 n 大於 1 時，費用將按數量預扣