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 或錯誤訊息傳給我們,我們來查。