图像生成

图像生成接口根据文字描述生成图片，兼容 OpenAI 的 POST /v1/images/generations 规范；同时提供图像编辑端点 POST /v1/images/edits。

图像生成

请求

POST https://confluia.com/v1/images/generations
Authorization: Bearer sk-你的密钥
Content-Type: application/json

{
  "model": "dall-e-3",
  "prompt": "一只戴着宇航员头盔的橘猫，赛博朋克风格",
  "n": 1,
  "size": "1024x1024"
}

响应

默认返回图片 URL：

{
  "created": 1690000000,
  "data": [
    {
      "url": "https://...生成的图片地址..."
    }
  ]
}

部分模型会额外返回 revised_prompt（上游改写后的提示词）等字段，以实际响应为准。

若请求中指定 response_format: "b64_json"，则返回 Base64 编码的图片数据：

{
  "created": 1690000000,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAAN..." }
  ]
}

主要参数

参数	类型	必填	说明
model	string	✓	图像模型 ID，见 GET /v1/models 或控制台模型列表
prompt	string	✓	图片描述
n	int	—	生成数量，受模型与平台双重限制（建议 1；超出限制返回 400）
size	string	—	尺寸，如 1024x1024；可用值以模型为准
quality	string	—	质量档位，如 standard / hd；可用值以模型为准
response_format	string	—	url（默认）或 b64_json

参数为透传语义：网关原样转发给上游，具体取值范围与默认值以所用模型的官方文档为准。

图像编辑

POST https://confluia.com/v1/images/edits
Authorization: Bearer sk-你的密钥
Content-Type: multipart/form-data

以 multipart 表单提交 image（图片文件）、prompt（编辑指令）等字段，支持的字段与效果以模型为准。

curl https://confluia.com/v1/images/edits \
  -H "Authorization: Bearer sk-你的密钥" \
  -F "model=gpt-image-1" \
  -F "image=@photo.png" \
  -F "prompt=把背景换成海边日落"

计费说明

• 图像按 生成张数 × 尺寸 / 质量档位 折算额度计费，不同模型单价不同。
• 具体价格以控制台「价格 / 模型列表」页面为准，通用规则见计费与额度。

常见问题

• 返回的 URL 打不开：图片 URL 通常由上游生成并附带时效，请尽快下载保存；如需直接落盘，可改用 response_format: "b64_json"。
• 提示违规被拒：上游会对提示词做安全审核，触发时返回 400 / 内容审核类错误，请调整描述后重试。
• 图像变体（variations）：POST /v1/images/variations 未开放，调用返回 501 api_not_implemented。