GPT Image 2 API 调用
生成接口使用 /v1/images/generations；编辑、流式和其他可选字段属于模型相关能力；本文示例中的字段是否生效，以对应模型详情和实际接口响应为准。
分辨率规则：不带 -4k 后缀的模型，若提示词中指定了分辨率，则以提示词为准；未指定时按请求参数（如 size）生成，但不支持生成 4K 图像。带 -4k 后缀的模型请求时必须显式传入具体的 size 参数，以该参数为准生成图像，并支持生成 4K 图像。
一、接口地址与鉴权
Mixtoken 使用 OpenAI Images API 兼容格式：
- 生成图片：
POST https://api.mixtoken.ai/v1/images/generations - 编辑图片：
POST https://api.mixtoken.ai/v1/images/edits
请求头：
Authorization: Bearer $MIXTOKEN_API_KEY
Content-Type: application/json
编辑接口也支持 multipart/form-data，用于上传图片文件。
二、生成图片
最小请求：
curl https://api.mixtoken.ai/v1/images/generations \
-H "Authorization: Bearer $MIXTOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一只在键盘上打字的橘猫，插画风格"
}'
指定尺寸和质量：
{
"model": "gpt-image-2",
"prompt": "一只在键盘上打字的橘猫，插画风格",
"size": "2048x2048",
"quality": "high"
}
常用参数：
| 参数 | 说明 |
|---|---|
model |
使用 gpt-image-2。 |
prompt |
生图描述。 |
size |
auto 或 宽x高，例如 1024x1024、2048x2048、3840x2160。 |
quality |
low、medium、high 或 auto。 |
n |
一次生成的图片数量，默认 1。 |
output_format |
png、jpeg 或 webp。 |
output_compression |
JPEG/WebP 压缩等级，0 到 100。 |
background |
transparent、opaque 或 auto。transparent 时返回带透明通道的图片，需搭配 output_format 为 png 或 webp。 |
moderation |
内容审核强度，low 或 auto。 |
stream |
设为 true 时以 SSE 流式返回：中间分片 object 为 image.generation.chunk，最后一个分片 object 为 image.generation.result，data[0].b64_json 是结果图，随后是 data: [DONE]。 |
partial_images |
0 到 3。当前中间分片不带图片，只有最后一个分片带结果。 |
user |
调用方自定义的最终用户标识，原样透传。 |
OpenAI 对 gpt-image-2 的尺寸约束是：最大边不超过 3840 像素；宽高均为 16 的倍数；长宽比不超过 3:1；总像素数在 655,360 到 8,294,400 之间。尺寸不是固定的 1k、2k、4k 字符串，而是像素尺寸。
三、编辑图片
curl https://api.mixtoken.ai/v1/images/edits \
-H "Authorization: Bearer $MIXTOKEN_API_KEY" \
-F "model=gpt-image-2" \
-F "prompt=把背景替换成雪山" \
-F "image=@input.png" \
-F "size=1024x1024"
常用参数：
| 参数 | 说明 |
|---|---|
model |
使用 gpt-image-2。 |
image |
原图文件。 |
mask |
遮罩图文件，透明区域为可编辑区域，尺寸与原图一致。 |
prompt |
修改指令。 |
n |
一次生成的图片数量，默认 1。 |
size |
auto 或 宽x高。 |
quality |
low、medium、high 或 auto。 |
background |
transparent、opaque 或 auto。透明通道支持情况以实际返回为准。 |
input_fidelity |
对原图细节的保真程度，high 或 low。 |
output_format |
png、jpeg 或 webp。 |
output_compression |
JPEG/WebP 压缩等级，0 到 100。 |
stream |
设为 true 时以 SSE 流式返回。流式事件结构可能随模型版本调整；请读取实际事件，并在 image_generation.completed 或最终完成事件中获取结果。 |
partial_images |
0 到 3。 |
user |
调用方自定义的最终用户标识，原样透传。 |
四、Mixtoken 计费与可用性
模型可用性、价格与计费方式以 Mixtoken 实时价格和控制台为准。请显式填写模型 ID 与所需尺寸；可选参数是否生效以对应模型详情和实际接口响应为准。