API 參考

圖片:直接回傳

目前沒有可用模型

目前模型目錄裡沒有模型支援這個介面,本頁僅供參考。
POST/v1/images/generations

同步圖片生成,僅限支援這個介面的模型,請求格式與 OpenAI 一致。回應裡直接帶最終圖片 URL。

#請求參數

  • modelstring必填

    支援這個同步介面的圖片模型。只支援任務的模型會拒絕它,請改用 /v1/images/tasks。

  • promptstring必填

    要畫什麼。

  • ninteger選填

    生成張數(按張數疊加計費)。

  • sizestring選填

    長寬比,如 "16:9",大多數圖片模型都用這種寫法,可選值見模型卡。部分舊模型也接受像素寫法 WIDTHxHEIGHT。

  • resolutionstring選填

    輸出解析度檔位,如 "1K"、"2K"、"4K",模型卡裡有這個參數時才能用;也影響計費檔位。

  • qualitystring選填

    廠商品質等級(如 standard / hd)——同樣是計費檔位維度。

  • response_formatstring選填

    "url"(預設)或 "b64_json"(內嵌位元組)。

檔位定價

size、quality、時長共同決定計費檔位——模型卡列出每檔確切價格,失敗呼叫自動退款。

#相關錯誤碼

  • 422 unprocessable_entity上游拒絕了閘道轉發的參數值(如不支援的尺寸或時長)。
  • 401Bearer 權杖無效或缺失。這條路徑不帶 error.code,請依狀態碼判斷。
  • 402 insufficient_user_quota錢包餘額不足以覆蓋預扣估算。
  • 429金鑰級限流。回應主體為空,按 Retry-After 等待。若 429 帶有 insufficient_user_quota,那是每日消費上限,不是限流。
  • 503 model_not_found模型名稱不存在,或目前沒有健康的通道可以提供服務。

完整錯誤碼表 →

#請求範例

curl https://www.aisplice.store/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_SYNC_IMAGE_MODEL",
    "prompt": "A cyberpunk skyline at dusk, neon rain",
    "size": "1:1"
  }'

#回應

response.json
{
  "created": 1720000000,
  "data": [{"url": "https://…"}]
}

還是沒解決?

把請求 ID 或錯誤訊息傳給我們,我們來查。