图片生成（GPT Image 2）

BumoAPI 支持兼容 OpenAI 的图片生成和编辑接口，可以使用任何 OpenAI SDK 或 HTTP 客户端来生成和编辑图片。

支持的模型

模型	说明
gpt-image-2	最新 GPT 图片模型，支持多种尺寸和质量选项

价格

所有价格已包含 6% 服务费（官方价格 + 6%）。

尺寸	Low（低）	Medium（中）	High（高）
1024×1024	$0.00636	$0.05618	$0.22366
1024×1536	$0.00530	$0.04346	$0.17490
1536×1024	$0.00530	$0.04346	$0.17490

生成图片

POST /v1/images/generations

请求参数

参数	类型	必填	说明
model	string	是	使用的模型，如 gpt-image-2
prompt	string	是	图片描述文本（最多 32000 字符）
n	integer	否	生成图片数量（1-10，默认 1）
size	string	否	图片尺寸，如 1024x1024、1024x1536、1536x1024（默认 1024x1024）
quality	string	否	图片质量：low、medium、high 或 auto（默认 auto）
background	string	否	背景透明度：transparent、opaque 或 auto（默认 auto）
output_format	string	否	输出格式：png、jpeg 或 webp（默认 png）
output_compression	integer	否	webp 或 jpeg 格式的压缩级别（0-100）
moderation	string	否	内容审核级别：low 或 auto（默认 auto）
stream	boolean	否	启用流式模式（默认 false）
user	string	否	终端用户标识

示例

curl -X POST "https://api.bumo.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只可爱的海獭宝宝",
    "n": 1,
    "size": "1024x1024",
    "quality": "medium"
  }'

响应

{
  "created": 1713833628,
  "data": [
    {
      "b64_json": "..."
    }
  ]
}

GPT 图片模型始终返回 base64 编码的图片数据（不支持 response_format 参数）。

编辑图片

POST /v1/images/edits

使用文本提示编辑或扩展一张或多张源图片。

请求参数

参数	类型	必填	说明
model	string	是	使用的模型，如 gpt-image-2
prompt	string	是	编辑描述文本
images	array	否	输入图片引用（GPT 图片模型最多 16 张）
n	integer	否	生成图片数量
size	string	否	输出图片尺寸
quality	string	否	输出质量：low、medium、high 或 auto
background	string	否	背景：transparent、opaque 或 auto
output_format	string	否	输出格式：png、jpeg 或 webp
moderation	string	否	内容审核级别：low 或 auto
user	string	否	终端用户标识

示例

curl -X POST "https://api.bumo.ai/v1/images/edits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[][email protected]" \
  -F 'prompt=给这张图片添加水彩效果'

流式输出

GPT 图片模型支持流式响应。在请求中设置 "stream": true 即可通过 Server-Sent Events (SSE) 接收部分图片更新。

流式输出示例

curl -X POST "https://api.bumo.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只可爱的海獭宝宝",
    "stream": true
  }' \
  --no-buffer

流式事件

事件	说明
image_generation.partial_image	部分图片数据（base64），包含 partial_image_index
image_generation.completed	最终完成的图片及用量信息

注意事项

• 计费：按生成图片数量计费，价格取决于尺寸和质量等级。
• 认证：使用 Authorization: Bearer YOUR_API_KEY 请求头。
• 速率限制：图片生成受速率限制，如需更高限制请联系支持。
• 透明背景：使用 background: "transparent" 时，输出格式必须为 png 或 webp。