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