Images API 图片生成

功能概览

本页用于说明 Images API 图片生成 的核心能力、调用入口和接入要点，帮助开发者快速判断适用场景并完成集成。

适用场景

• 产品原型验证：快速接入模型能力，验证内容生成、理解或编辑流程。
• 生产业务接入：用于批量任务、自动化工作流和多模型组合调用。
• 能力迁移适配：适合从原有模型或 SDK 平滑切换到亿速云AI统一接口。

接入建议

• 优先确认模型名称、请求路径和响应字段，再接入具体业务流程。
• 对异步任务、媒体生成和长耗时请求，建议在业务侧加入重试与状态轮询。
• 上线前建议准备日志追踪、错误兜底和内容安全校验，便于稳定运行。

接口总览

POST /v1/images/generations
POST /v1/images/edits
POST /v1/images/variations

POST /v1/images/generations

用于文生图。需要上传参考图、图片编辑或图生图时，使用 /v1/images/edits。

部分明显涉及黄色、赌博、违法交易等高风险提示词，可能会直接返回 content_policy_violation。

文生图

curl "/v1/images/generations" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-image-2",
    "prompt": "一只橘猫坐在窗边晒太阳，柔和光线，写实风格",
    "size": "1024x1024",
    "n": 1,
    "quality": "high",
    "style": "vivid",
    "response_format": "url"
  }'

流式最终结果

stream: true 当前只返回最终结果和 [DONE]，不返回官方 partial image 中间事件。

curl -N "/v1/images/generations" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-image-2",
    "prompt": "一只橘猫坐在窗边晒太阳，柔和光线，写实风格",
    "size": "1024x1024",
    "n": 1,
    "stream": true,
    "response_format": "url"
  }'

响应格式

response_format: "url"：

{
  "created": 1710000000,
  "data": [
    {
      "url": "/7ed82c6454482a26808c3170a36/req_xxx_0_random.png"
    }
  ],
  "usage": {
    "total_tokens": 2240,
    "input_tokens": 1024,
    "output_tokens": 1216,
    "input_tokens_details": {
      "text_tokens": 1024,
      "image_tokens": 0
    }
  }
}

response_format: "b64_json"：

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

参数支持状态

支持尺寸

常见官方规格：

auto
256x256
512x512
1024x1024
1536x1024
1024x1536
1792x1024
1024x1792

如果传自定义 WIDTHxHEIGHT，网关会把目标尺寸、可计算出的比例、横竖方向写入提示词。如果传其它自定义字符串，网关会按原值写入提示词。

POST /v1/images/edits

用于图片编辑、图生图或参考图生成。OpenAI 官方风格请求建议使用 multipart/form-data 上传图片。

部分明显涉及黄色、赌博、违法交易等高风险提示词，可能会直接返回 content_policy_violation。

JSON 图片 URL 和 JSON data URL 属于本项目网关扩展能力，已单独整理到 Images API 网关扩展请求格式。如果请求经过 LiteLLM 或其它 OpenAI 兼容中转层，建议优先使用本文的 multipart 请求方式。

当前多图上限为 6 张。单张 multipart 上传图片最大 50MB。

multipart 上传单图

curl "/v1/images/edits" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -F "model=gpt-5.4-image-2" \
  -F "image[]=@source.png" \
  -F "prompt=参考这张图片，生成一张相同主体但换成雪山背景的图片" \
  -F "size=1024x1024" \
  -F "n=1" \
  -F "quality=high" \
  -F "response_format=url"

multipart 上传多图

curl "/v1/images/edits" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -F "model=gpt-5.4-image-2" \
  -F "image[]=@subject.png" \
  -F "image[]=@style.png" \
  -F "prompt=保留第一张图的主体，参考第二张图的色彩和质感生成新图" \
  -F "size=1024x1024" \
  -F "response_format=url"

参数支持状态

图片输入限制

支持的图片引用：

https://example.com/image.png
http://example.com/image.jpg

multipart 上传支持的后缀和 MIME：

.jpg  image/jpeg
.jpeg image/jpeg
.png  image/png
.webp image/webp

常见错误

POST /v1/images/variations

用于基于单张原图生成若干张高相似度的新图片。适合保留原图整体风格、构图、色彩关系和主题方向，同时让细节出现自然变化。

multipart 上传原图

curl "/v1/images/variations" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -F "model=gpt-5.4-image-2" \
  -F "image=@source.png" \
  -F "size=1024x1024" \
  -F "n=3" \
  -F "response_format=url"

响应格式

response_format: "url"：

{
  "created": 1710000000,
  "data": [
    {
      "url": "/7ed82c6454482a26808c3170a36/req_xxx_0_random.png"
    },
    {
      "url": "/7ed82c6454482a26808c3170a36/req_xxx_1_random.png"
    }
  ]
}

response_format: "b64_json"：

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

参数支持状态

图片输入要求

image 需要满足：

PNG 文件
单张图片
方图
小于 4MB

支持尺寸

256x256
512x512
1024x1024

常见错误