生图接口使用指南（小白版）

生图主要使用两个接口：

• 文生图：POST /v1/images/generations
• 改图 / 图生图：POST /v1/images/edits

完整请求地址：

https://api.likeai520.cc/v1/images/generations
https://api.likeai520.cc/v1/images/edits

所有请求都需要携带 API Key：

Authorization: Bearer 你的APIKey

1. 文生图

文生图就是：你提供一段图片描述，接口返回生成的图片。

请求地址

POST https://api.likeai520.cc/v1/images/generations

最简单示例

curl https://api.likeai520.cc/v1/images/generations \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只白色小猫坐在窗边，阳光照进来，写实风格",
    "size": "1024x1024"
  }'

返回结果

接口默认返回 b64_json，也就是图片的 Base64 内容：

{
  "created": 1783007786,
  "data": [
    {
      "b64_json": "这里是一大段图片base64内容"
    }
  ]
}

前端或后端可以将 b64_json 解码并保存为图片。网页中直接显示时可以组合为：

data:image/png;base64,这里放b64_json内容

2. 常用参数

必填参数

参数	说明	示例
model	生图模型	gpt-image-2
prompt	图片描述	一张国潮风海报

可选参数

参数	说明	常用值
size	图片尺寸	1024x1024
quality	图片质量	low / medium / high
output_format	输出格式	png / jpeg / webp
response_format	返回格式	b64_json / url
background	背景	auto / opaque
n	生成张数	建议先传 1

新手可以从下面的参数开始：

{
  "model": "gpt-image-2",
  "prompt": "你的图片描述",
  "size": "1024x1024",
  "quality": "low",
  "response_format": "b64_json"
}

3. 改图 / 图生图

改图需要提供原图，并在 prompt 中说明修改要求。

请求地址

POST https://api.likeai520.cc/v1/images/edits

JSON 图片链接方式

如果图片已经有公网 URL：

curl https://api.likeai520.cc/v1/images/edits \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "把这张图改成国潮海报风格，保留主体",
    "images": [
      {
        "image_url": "https://example.com/input.png"
      }
    ],
    "size": "1024x1024",
    "quality": "low",
    "response_format": "b64_json"
  }'

上传本地图片方式

上传本地图片时使用 multipart/form-data：

curl https://api.likeai520.cc/v1/images/edits \
  -H "Authorization: Bearer 你的APIKey" \
  -F "model=gpt-image-2" \
  -F "prompt=把这张图改成国潮海报风格，保留主体" \
  -F "image=@input.png" \
  -F "size=1024x1024" \
  -F "quality=low" \
  -F "response_format=b64_json"

局部修改时可以再传入一张遮罩图：

curl https://api.likeai520.cc/v1/images/edits \
  -H "Authorization: Bearer 你的APIKey" \
  -F "model=gpt-image-2" \
  -F "prompt=只修改遮罩区域，把衣服改成红色" \
  -F "image=@input.png" \
  -F "mask=@mask.png" \
  -F "size=1024x1024" \
  -F "response_format=b64_json"

4. 价格说明

当前生图分组按图片尺寸计费：

尺寸档位	价格
1K	0.03
2K	0.06
4K	0.18

一般用户建议先使用 1024x1024，也就是 1K 档。

5. 注意事项

• 生图可能需要几十秒，客户端超时时间建议设置为 120 秒以上。
• 当前主要使用同步接口，不要调用 /api/images/generations/jobs 类异步接口。
• gpt-image-2 不建议用于普通聊天接口，生图请使用 /v1/images/generations。
• 如果提示分组不支持生图，请确认 API Key 是否属于生图分组。

6. 最小可用请求

curl https://api.likeai520.cc/v1/images/generations \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一个红色圆形图标，白色背景，极简风格",
    "size": "1024x1024"
  }'