准备工作
在开始调用之前,请确保你已获取以下凭证:Base URL
API 地址,形如:
https://api.onetoken.oneAPI Key
在 OneToken 后台生成的令牌,形如:
sk-xxxxxxxxxxxx1. 文生图接口 (Text to Image)
该接口用于根据你输入的文本提示词(Prompt)从零开始生成一张全新的图片。请求信息
/v1/images/generations/
必填
标准 OpenAI 兼容的图像生成路径。
请求格式
application/json请求参数
string
必填
固定填入
gpt-image-2。string
必填
描述你想要生成的图片内容,支持中英文。
integer
默认值:"1"
生成图片的数量。
string
默认值:"1024x1024"
图片分辨率,例如
1024x1024 或 512x512。宽高都要传 16 的倍数string
默认值:"auto"
将生成的图像的质量。
low medium high auto代码示例
2. 图像编辑接口 (Image Edits)
该接口用于对现有的图片进行修改。你需要提供一张原图,以及一张掩码图(Mask)(掩码图中透明的区域代表需要被修改/替换的地方)。请求信息
/v1/images/edits/
必填
标准 OpenAI 兼容的图像编辑路径。
请求格式
multipart/form-data请求参数
string
必填
固定填入
gpt-image-2。string
必填
描述你想要生成的图片内容,支持中英文。
integer
默认值:"1"
生成图片的数量。
string
默认值:"1024x1024"
图片分辨率,例如
1024x1024 或 512x512。宽高都要传 16 的倍数string
默认值:"b64_json"
生成的图像返回的格式。必须是url或b64_json。
file
默认值:""
要编辑的图像。理论支持最多 16 张
代码示例
3. 返回数据结构
接口调用成功后,会返回一个包含图片 URL 的 JSON 对象。成功响应示例
4. 常用尺寸
- 正方形与近正方形比例
- 传统经典画幅比例
- 宽屏与超宽屏比例

