Skip to main content

准备工作

在开始调用之前,请确保你已获取以下凭证:

Base URL

API 地址,形如: https://api.onetoken.one

API Key

在 OneToken 后台生成的令牌,形如: sk-xxxxxxxxxxxx

1. 文生图接口 (Text to Image)

该接口用于根据你输入的文本提示词(Prompt)从零开始生成一张全新的图片。

请求信息

/v1/images/generations/
必填
标准 OpenAI 兼容的图像生成路径。

请求格式

application/json

请求参数

string
必填
固定填入 gpt-image-2
string
必填
描述你想要生成的图片内容,支持中英文。
integer
默认值:"1"
生成图片的数量。
string
默认值:"1024x1024"
图片分辨率,例如 1024x1024512x512。宽高都要传 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"
图片分辨率,例如 1024x1024512x512。宽高都要传 16 的倍数
string
默认值:"b64_json"
生成的图像返回的格式。必须是url或b64_json。
file
默认值:""
要编辑的图像。理论支持最多 16 张

代码示例


3. 返回数据结构

接口调用成功后,会返回一个包含图片 URL 的 JSON 对象。

成功响应示例

4. 常用尺寸

  1. 正方形与近正方形比例
1:1 1K: 1024 × 1024 2K: 2048 × 2048 4K: 4096 × 4096 5:4 1K: 1280 × 1024 2K: 2000 × 1600 或 2080 × 1664 4K: 4000 × 3200 或 4080 × 3264 4:5 1K: 1024 × 1280 2K: 1600 × 2000 或 1664 × 2080 4K: 3200 × 4000 或 3264 × 4080
  1. 传统经典画幅比例
4:3 1K: 1024 × 768 2K: 2048 × 1536 4K: 3840 × 2880 或 4096 × 3072 3:4 1K: 768 × 1024 2K: 1536 × 2048 4K: 2880 × 3840 或 3072 × 4096 3:2 1K: 1152 × 768 2K: 2160 × 1440 4K: 3840 × 2560 或 4080 × 2720 2:3 1K: 768 × 1152 2K: 1440 × 2160 4K: 2560 × 3840 或 2720 × 4080
  1. 宽屏与超宽屏比例
16:9 1K: 1024 × 576 2K: 2048 × 1152 4K: 3840 × 2160 (注:标准的 4K UHD 完美满足 16:9 且宽高均为 16 的倍数) 9:16 1K: 576 × 1024 2K: 1152 × 2048 4K: 2160 × 3840 21:9 (等同于最简整数比 7:3) 1K: 1008 × 432 或 1120 × 480 2K: 2016 × 864 或 2128 × 912 4K: 3808 × 1632 或 4032 × 1728 9:21 (等同于最简整数比 3:7) 1K: 432 × 1008 或 480 × 1120 2K: 864 × 2016 或 912 × 2128 4K: 1632 × 3808 或 1728 × 4032