图像生成接口

POST /v1/images/generations 接受画面描述，返回 Base64 图片数据。它不会为 API 调用创建网页会话或附件链接。

请求示例

curl https://ai.example.com/v1/images/generations \
  -H "Authorization: Bearer $OBSIDIAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-image-model",
    "prompt": "雨后街角的一家咖啡馆，水彩画。",
    "size": "1024x1024",
    "n": 1,
    "response_format": "b64_json"
  }'

模型必须已启用生图能力，且当前密钥有权访问。

参数

参数	当前行为
model	必填，指定可用的生图模型名称
prompt	必填，不能为空
n	默认 1；超过 4 时限制为 4
size	按上游支持填写，不保证所有尺寸可用
quality	传给上游，支持值由上游决定
style	传给上游，支持值由上游决定
image	可选，Base64 参考图数据
images	可选，Base64 参考图数据列表（最多 5 张）
response_format	当前网关固定向上游请求 b64_json

size 和 quality 未填写时，网关没有统一补上 1024x1024 或 standard。最终行为由适配器与上游决定。

参考图与编辑端点

接口支持传入参考图进行图像变体与编辑（最多 5 张）：

• 在 POST /v1/images/generations 中，可通过 image 或 images 字段传入 Base64 图片数据。
• 同时支持兼容 OpenAI 的 POST /v1/images/edits 端点，支持通过 multipart/form-data 上传图片文件或通过 JSON 发送。文件字段名 image、image[]、images 都认；官方 SDK 传多张图时用的是 image[]。
• multipart 请求整体不能超过「5 张 × 单张附件上限」再加少量表单字段的余量，超出返回 413。

curl https://ai.example.com/v1/images/edits   -H "Authorization: Bearer $OBSIDIAN_API_KEY"   -F model=your-image-model   -F prompt="把这两张图合成一张海报"   -F "image[]=@a.png"   -F "image[]=@b.png"

响应格式

{
  "created": 1788998400,
  "data": [{
    "b64_json": "BASE64_IMAGE_DATA",
    "revised_prompt": "上游提供时才出现的修订提示词"
  }]
}

客户端解码 b64_json 并保存图片。示例中的 Base64 文字只是占位符，不能作为真实图片使用。

网关不透传上游签名 URL。如果上游忽略格式要求，只返回链接，接口会报格式错误，而不是返回永久图片地址。

用量与限制

图像请求同样执行账号权限、并发与额度检查，并写入用量记录。点数按模型配置和生图结算规则计算。

参数不被上游接受时，先简化为单张生成，再核对该模型支持的尺寸和风格。