一、接口地址与鉴权
CA云上创造 使用 OpenAI Images API 兼容格式：
- ·生成图片：
POST https://caapi.top/v1/images/generations - ·编辑图片：
POST https://caapi.top/v1/images/edits
请求头：
http
Authorization: Bearer sk-xxxxxx
Content-Type: application/json编辑接口也支持 multipart/form-data，用于上传图片文件。
调用名是
gpt-image-2.5。旧的 gpt-image-2.5-flare、gpt-image-2.5-sunburst 仍可用，价格相同，属于同一款模型的别名；新接入请直接用 gpt-image-2.5。二、生成图片
最小请求：
bash
curl https://caapi.top/v1/images/generations \
-H "Authorization: Bearer sk-xxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5",
"prompt": "一只在键盘上打字的橘猫，插画风格"
}'指定尺寸和质量：
json
{
"model": "gpt-image-2.5",
"prompt": "一只在键盘上打字的橘猫，插画风格",
"size": "2048x2048",
"quality": "high"
}常用参数：
| 参数 | 说明 |
|---|---|
model | 使用 gpt-image-2.5。必须明确指定。 |
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.5 的尺寸约束是：最大边不超过 3840 像素；宽高均为 16 的倍数；长宽比不超过 3:1；总像素数在 655,360 到 8,294,400 之间。尺寸不是固定的 1k、2k、4k 字符串，而是像素尺寸。
三、编辑图片
bash
curl https://caapi.top/v1/images/edits \
-H "Authorization: Bearer sk-xxxxxx" \
-F "model=gpt-image-2.5" \
-F "prompt=把背景替换成雪山" \
-F "[email protected]" \
-F "size=1024x1024"常用参数：
| 参数 | 说明 |
|---|---|
model | 使用 gpt-image-2.5。 |
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 流式返回，事件格式与生成图片相同。 |
partial_images | 0 到 3。 |
user | 调用方自定义的最终用户标识，原样透传。 |
四、尺寸与计费规则
生图按张计费（n 张就是 n 次），每张的单价由请求里的 `size` 决定，分三档：
| 请求的 size | 档位 |
|---|---|
宽或高含 4096 / 3840 / 2160（如 3840x2160、4096x4096） | 4K |
宽或高含 2048 / 2560 / 1440（如 2048x2048、2560x1440） | 2K |
其余，包括 1024x1024、auto 与不传 | 1K |
三档单价见 模型广场。请求被上游拒绝（参数不合法、内容审核不通过等）不扣费。