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 或报错信息发给我们,我们来查。