图像 API 调用说明

1. 接口地址

场景	接口	说明
文生图	`POST https://newapi.jaycue.dpdns.org/v1/images/generations`	输入提示词生成新图片，请求体使用 JSON。
图生图 / 改图	`POST https://newapi.jaycue.dpdns.org/v1/images/edits`	上传参考图或待修改图片，请求体使用 `multipart/form-data`。
网页工具	`https://newapi.jaycue.dpdns.org/console/image`	不想写代码时，直接在控制台生成图片或改图。

注意：图片调用不再展示统一 Base URL；请按场景直接调用上面两个完整接口。

建议：只是手动生成图片，优先使用控制台图像生成页；需要接入程序时再使用下面的 API 示例。

2. 如何修改尺寸

调用文生图或图生图接口时，在请求体里修改 size 字段即可。

size	含义	推荐场景
`1024x1024`	正方形	头像、图标、普通配图。
`1024x1536`	竖图	海报、人物全身图、竖版图。
`1536x1024`	横图	横版封面、Banner、风景图。
`auto`	自动	让上游模型决定尺寸。

建议：如果遇到超时或等待很久，先用 1024x1024 和 n: 1 测试。

3. 文生图调用

1024x1024 正方形

curl https://newapi.jaycue.dpdns.org/v1/images/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"一只赛博朋克风格的猫","size":"1024x1024","n":1}'

横图 JSON

{
  "model": "gpt-image-2",
  "prompt": "湖边雪山风景，电影感",
  "size": "1536x1024",
  "n": 1
}

4. 上传图片改图 / 图生图

改图使用 /v1/images/edits，请求格式是 multipart/form-data，尺寸同样通过 size 字段控制。

New-API 改图

curl https://newapi.jaycue.dpdns.org/v1/images/edits \
  -H "Authorization: Bearer sk-你的令牌" \
  -F "model=gpt-image-2" \
  -F "prompt=把这张图改成动漫头像风格，保持主体不变" \
  -F "size=1024x1024" \
  -F "image=@input.png"

可选 mask：如果要局部重绘，可以额外加 -F "mask=@mask.png"。

5. 常见问题

Q：为什么不用 `/v1/chat/completions`？

图片能力已拆成两个独立接口：文生图用 /v1/images/generations，上传图改图 / 图生图用 /v1/images/edits。

Q：为什么大尺寸更容易慢？

1536x1024 或 1024x1536 输出更大，生成和传输都更慢。建议先用 1024x1024 测试。

Q：Key 填什么？

填写你在 New-API 控制台「令牌」页面创建的令牌，通常以 sk- 开头。

New-API 图像 API 调用说明