图片生成

POST /v1/images/generations 使用 OpenAI-compatible 图片生成格式。模型、尺寸、参考图与返回格式能力取决于当前账户可见的模型和后端渠道。

最小请求

curl --fail-with-body https://relay.withrpm.org/v1/images/generations \
  -H "Authorization: Bearer $SPEEDYRPM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<IMAGE_MODEL_ID>",
    "prompt": "一只戴宇航员头盔的橘猫，干净背景"
  }'

请先调用 /v1/models 获取模型 ID，并确认它支持图片生成。

输出

成功响应的 data 数组可能包含图片 URL 或 Base64 数据，具体取决于模型与渠道。客户端应同时考虑两种返回形态，并在下载远程 URL 时设置超时、大小上限和允许的内容类型。

{
  "created": 1786186500,
  "data": [
    { "url": "https://example.invalid/generated-image.png" }
  ]
}

可选能力

部分模型支持 size、n 或参考图输入，但字段与限制并不完全一致。建议先完成最小请求，再根据目标模型逐项增加参数；不要把某个模型的可选字段直接用于所有图片模型。

安全处理

• 不要在公开日志中记录包含隐私信息的提示词或参考图。
• 下载返回 URL 时防范超大文件、错误内容类型和长时间无响应。
• Base64 图片会显著增大 JSON 响应和内存占用，应设置响应体大小限制。