ToAPIs

快速结论

  • 支持 prompt 文生图，适合营销、电商和创意视觉生产。
  • 支持 reference_images（最多 5 张）进行图生图与风格约束。
  • 支持 mask_url 做局部编辑，便于精修和定向修改。

关键参数

  • model | string | 必填 | gpt-4o-image | - | 模型标识，必须使用 ToAPIs 提供值。
  • prompt | string | 必填 | - | - | 图片描述文本。
  • size | string | 可选 | 1:1 | 1:1 | 2:3 | 3:2 | 输出宽高比。
  • n | integer | 可选 | 1 | 1-4 | 单次请求生成张数。
  • reference_images | file[] | 可选 | - | max 5 | 参考图片数组，用于图生图与风格控制。
  • mask_url | string | 可选 | - | - | 遮罩图 URL，用于局部编辑。

常见错误

  • 400 invalid_request_error: 触发=字段缺失、类型错误或参数取值不在允许范围。; 修复=校验 model/prompt/size/n/reference_images/mask_url 参数。; 重试=修正请求体后重试。
  • 401 authentication_error: 触发=API Key 缺失或无效。; 修复=确认 Authorization 头和密钥权限。; 重试=修复鉴权后重试。
  • 429 rate_limit_exceeded: 触发=请求频率、并发或当前额度命中上游限流策略。; 修复=先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。; 重试=建议 1s/2s/4s + 抖动；连续触发时再收紧提交节奏。
返回模型广场

模型解析页

GPT-4o Image

模型 ID: gpt-4o-image

厂商: OpenAI能力类型: Chat价格: Input $0.00/1M, Output $0.00/1M更新于: 2026-05-02

GPT-4o Image 是 ToAPIs 提供的 GPT-4o 图像生成模型，支持文生图与参考图驱动编辑。参数与行为以 ToAPIs 文档为准。

在 Playground 中打开文档

模型概览

快速结论

  • 支持 prompt 文生图，适合营销、电商和创意视觉生产。
  • 支持 reference_images（最多 5 张）进行图生图与风格约束。
  • 支持 mask_url 做局部编辑，便于精修和定向修改。

GPT-4o Image模型特点

核心能力

能力一览与工程实践价值

高质量文生图

通过统一接口快速生成可交付图像素材。

参考图一致性

通过 reference_images 提升风格和构图稳定性。

局部编辑能力

通过 mask_url 对指定区域进行细粒度改图。

如何使用 GPT-4o Image API

  1. 设置 Authorization: Bearer <YOUR_API_KEY>。
  2. 调用 GPT-4o 图像生成接口并传入 model、prompt、size 等参数。
  3. 按需传入 reference_images 与 mask_url 进行约束或局部编辑。
  4. 轮询图片任务状态并下载结果图片 URL。
GPT-4o Image 示例图 1

适用场景

  • 需要快速生成商品图、广告图、活动视觉等素材。
  • 需要在已有图片基础上做风格统一或局部重绘。

API 运行特性

  • 统一走图片生成接口，结果通常以异步任务形式返回并通过任务状态查询。
  • reference_images 最多 5 张，单张文件大小与格式需满足文档约束。
  • mask_url 可选，用于局部编辑和替换。
GPT-4o Image 示例图 2

关键参数

参数类型必填默认值取值范围说明
modelstring是gpt-4o-image-模型标识，必须使用 ToAPIs 提供值。
promptstring是--图片描述文本。
sizestring否1:11:1 | 2:3 | 3:2输出宽高比。
ninteger否11-4单次请求生成张数。
reference_imagesfile[]否-max 5参考图片数组，用于图生图与风格控制。
mask_urlstring否--遮罩图 URL，用于局部编辑。

常见错误

400 invalid_request_error

触发条件: 字段缺失、类型错误或参数取值不在允许范围。

修复建议: 校验 model/prompt/size/n/reference_images/mask_url 参数。

重试策略: 修正请求体后重试。

401 authentication_error

触发条件: API Key 缺失或无效。

修复建议: 确认 Authorization 头和密钥权限。

重试策略: 修复鉴权后重试。

429 rate_limit_exceeded

触发条件: 请求频率、并发或当前额度命中上游限流策略。

修复建议: 先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。

重试策略: 建议 1s/2s/4s + 抖动；连续触发时再收紧提交节奏。

GPT-4o Image 示例图 3

FAQ

GPT-4o Image 适合什么场景？

适合高频创意出图、品牌视觉扩展、以及在已有素材上进行局部编辑。

为什么图生图效果不稳定？

请检查 reference_images 质量与数量，并在 prompt 中明确保留元素和风格约束。

图像视频模型报错：invalid apitype: -1

这类错误通常说明接口走错了。图像和视频模型一般不走 chat 接口，而是按对应文档发起 HTTP 任务请求，并通过任务状态接口轮询结果。排查时建议先看用户的实际请求代码、请求地址和请求体。

用户进行生成图片/视频的任务时出现任务失败，但是扣款

先让用户提供任务日志或截图，重点看是否出现了输入或输出 token 统计。如果有这类 token 记录，大概率是用户把图片/视频模型走成了 chat 接口；这不是正确用法。图片和视频模型通常是异步任务接口，需要通过 HTTP 请求先提交任务，再拿到任务 ID 轮询状态，详细以对应文档为准。

模式说明

文生图 模式（GPT-4o Image）

基于 prompt 直接生成图片。

模式参数

modelpromptsizen

最佳应用场景

  • 商品主图
  • 广告素材
  • 概念视觉

图生图/局部编辑 模式（GPT-4o Image）

通过参考图与遮罩进行风格约束或局部修改。

模式参数

reference_imagesmask_urlpromptsize

最佳应用场景

  • 品牌视觉统一
  • 局部重绘
  • 多版本改图

相关 API

準備好開始了嗎？

免費註冊，立即體驗企業级 AI API 網關的強大功能

免費開始查看定價