Skip to main content
POST
GPT-Image-2.5 图像生成
普通版通过 POST /v1/images/generations 创建图片任务, 返回任务 ID. 任务完成后通过查询接口获取图片 URL. 两个模型使用相同的请求格式: gpt-image-2.5 是系列名称. 调用时请填写表中的完整模型名.
本文介绍普通版. 需要同步返回 Base64 图片和按实际 token 计费时, 请使用独立的 GPT-Image-2.5 VIP 文档.
中国大陆用户可将示例中的 https://api.toapis.com 替换为 https://api.toapis.cn. API Key 可在 控制台 创建.

快速开始

将自己的 ToAPIs API Key 设置为环境变量 TOAPIS_API_KEY, 提交任务:
提交响应示例:
保存返回的 id, 将下方的 TASK_ID 替换为该值后查询:
任务可能经过 pending, queued, in_progress, 最终进入 completedfailed. completed 时从 result.data 读取图片 URL, failed 时读取 error. 建议每隔数秒查询一次. 完整字段见 图片任务状态接口. 提交成功表示任务已创建. 请等到 completed 后再下载图片; 等待期间继续查询同一个任务 ID.

请求参数

string
必填
使用 Bearer YOUR_TOAPIS_API_KEY 认证.
string
必填
gpt-image-2.5-flaregpt-image-2.5-sunburst.
string
必填
图片描述. 使用参考图时, 描述需要保留的主体和需要修改的内容.
string
默认值:"high"
支持 low, medium, high, xhigh, max 五档, 默认 high. 使用小写值.quality 控制生成质量, 可能影响耗时. 当前普通版按 resolution 定价, 五档 quality 不单独加价.
string
默认值:"1:1"
画面比例, 例如 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 21:9, 9:21.推荐使用比例并显式填写 resolution. 服务端根据二者计算输出像素尺寸. 普通版的比例写法与 VIP 版的像素尺寸写法不同.
string
默认值:"1K"
分辨率档位, 支持 1K, 2K, 4K, 也接受小写形式. 该字段决定普通版的计价档位.
integer
默认值:1
每次请求使用 1, 生成一张图片.
string[]
可选的参考图 URL 列表. 图片地址需要能被服务端访问. 本地图片请先通过 上传图片接口 获取 URL.也兼容 image_urls. 选择其中一个字段即可. 本接口示例使用 URL 参考图; 需要直接上传本地文件进行同步编辑时, 请参考 VIP 图片编辑.

比例和分辨率示例

4K 表示分辨率档位, 实际长宽取决于画面比例, 例如正方形 4K 输出为 2880x2880.

参考图生成

使用同一个生成接口, 增加 reference_images. 下例使用 Sunburst, 返回值仍然是异步任务:
https://example.com/otter.png 替换为自己的参考图 URL, 然后使用返回的任务 ID 查询结果.

价格

以下为 2026-09-09 核对的标准价格, 每次生成一张图片, 两个普通版模型价格相同: 这三个价格均适用于 low, medium, high, xhigh, max. 当前参考图输入没有额外的按张费用. 账户专属定价或折扣可能不同, 最新价格以 模型定价页 和账户实际配置为准.

与 VIP 版的区别

切换到 VIP 时, 请同时调整模型名, 参数和响应处理方式. 详见 GPT-Image-2.5 VIP.