图片生成 API
使用 GPT Image 2 / 2.5 生成图片：遵循 OpenAI Images 规范的端点、参数、调用示例与计费说明。
GetToken 图片生成 API 遵循 OpenAI Images 规范实现，支持 gpt-image-2、gpt-image-2.5-flare 和 gpt-image-2.5-sunburst，支持文生图与图片编辑。完整产品说明与价格页见站点「图片 API」页面：
https://gettoken.dev/image-api在 Codex 里生图（推荐）
在 Codex 中生成图片，请使用 GetToken 专属生图技能 gettoken-imagegen（控制台一键安装，见「接入与配置 · Codex 生图技能」）。Codex 内置 ImageGen 需要直连 OpenAI 官方服务，API Key 方式下不可用，因此需要该技能接管。
接口
- 服务地址：
https://api.gettoken.dev/image/v1（中国优化线路https://api.clawto.link/image/v1） - 端点：
POST /images/generations（文生图）POST /images/edits（图片编辑，multipart/form-data）
- 鉴权：
Authorization: Bearer <生图 API Key>（生图 Key 与其他 Key 分开管理） - 响应格式：与 OpenAI 规范一致，图片以
data[].b64_json返回，并附usagetoken 统计；response_format固定为b64_json
参数
文生图 /images/generations
| 参数 | 类型 | 说明 |
|---|---|---|
prompt | string | 必填，生成内容的文字描述 |
model | string | gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst |
n | integer | 生成张数，默认 1 |
size | string | auto / 1024x1024 / 1536x1024 / 1024x1536 / 2048x2048 / 4096x4096 |
quality | string | auto / low / medium / high / xhigh / max |
background | string | auto / opaque / transparent；transparent 只能搭配 PNG 或 WebP |
output_format | string | png / jpeg / webp |
output_compression | integer | 0-100，仅对 jpeg / webp 生效，值越低压缩越强 |
moderation | string | auto（默认）/ low，控制内容审核严格程度 |
stream | boolean | 是否流式返回（服务端事件） |
partial_images | integer | 0-3，流式模式下返回的局部预览图数量 |
图片编辑 /images/edits
| 参数 | 类型 | 说明 |
|---|---|---|
image | file | 必填，待编辑图片（可传多张），multipart/form-data 上传 |
prompt | string | 必填，编辑指令的文字描述 |
mask | file | 可选，透明区域为可编辑区域的遮罩图 |
model | string | 同上三选一 |
n / size / quality / background / output_format / output_compression | - | 含义同文生图 |
input_fidelity | string | low（默认）/ high；high 尽量保留原图细节（人脸、Logo 等） |
stream / partial_images | - | 含义同文生图 |
调用示例
文生图
curl https://api.clawto.link/image/v1/images/generations \
-H "Authorization: Bearer $IMAGE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-flare",
"prompt": "A clean product photo on a white desk",
"n": 1,
"size": "2048x2048",
"quality": "high",
"background": "auto",
"output_format": "png"
}'图片编辑
curl https://api.clawto.link/image/v1/images/edits \
-H "Authorization: Bearer $IMAGE_API_KEY" \
-F "model=gpt-image-2.5-flare" \
-F "prompt=把背景换成纯白影棚背景" \
-F "[email protected]" \
-F "input_fidelity=high" \
-F "size=2048x2048" \
-F "quality=high"价格（每张）
| 规格 | 计费边界（最长边） | 常规生图（USD） | 稳定生图（USD） |
|---|---|---|---|
| 1K | <= 1024px | 0.134 | 1.5 |
| 2K | 1025-2048px | 0.201 | 3 |
| 4K | > 2048px | 0.268 | 4 |
稳定生图优先按上游返回的实际输出尺寸分档；上游未返回可识别尺寸时，才按请求的
size判断。auto、空值或无法识别的size按 2K 兜底。直接 API 会透传自定义WxH，但最终是否生成仍取决于上游是否支持该尺寸。