图片模型接入说明
用于文生图、图生图和参考图编辑。按下方端点、示例和参数说明接入即可。
非常重要：图片接口必须使用图片模型 Key，普通聊天 Key 不能调用。
01
接口概览
| 接口 | 方法 | 用途 |
|---|---|---|
| /images/generations | POST JSON | 文生图，根据提示词生成图片。 |
| /images/edits | POST JSON / multipart | 图生图、参考图编辑、遮罩编辑，支持 URL 或文件上传格式。 |
02
文生图 JSON 示例
服务端可直接按 JSON 方式调用，返回图片 URL。
curl https://yh.968968968.xyz/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A premium black diamond product render on a clean white background",
"size": "1024x1024",
"n": 1,
"response_format": "url"
}'03
图生图 JSON URL 示例
已有可用图片 URL 时，可直接传入 image 字段。
curl https://yh.968968968.xyz/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Make the product more glossy and premium",
"image": "https://img.968968968.xyz/i/reference.png",
"size": "1024x1024",
"n": 1,
"response_format": "url"
}'04
multipart 文件上传示例
本地图片编辑建议直接使用文件上传。
curl https://yh.968968968.xyz/v1/images/edits \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "model=gpt-image-2" \ -F "prompt=Turn this into a premium product poster" \ -F "size=1024x1024" \ -F "n=1" \ -F "response_format=url" \ -F "image=@reference.png;type=image/png"
05
图片请求参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 图片模型名称，例如 gpt-image-2。 |
| prompt | string | 是 | 文本提示词，描述你要生成或编辑的图片目标。 |
| image | string / file | 图生图必填 | 编辑接口使用。支持平台认可的临时 URL，或 multipart 上传本地文件。 |
| size | string | 否 | 图片尺寸，按 1K / 2K / 4K 分辨率档位计费。必须使用文档支持的尺寸。 |
| response_format | string | 否 | 推荐使用 url。不要读取 b64_json。 |
支持的图片尺寸：请按后台已开放档位选择使用。
06
常见报错排查
- image_key_required：表示用了普通 Key，需要换成图片模型 Key。
- invalid_size：表示尺寸不支持，请改成文档支持列表内的尺寸。
- invalid_image_url：图生图 URL 不支持，建议改用 multipart 文件上传。
- invalid_image_route：传了不可用的 route_id，删除 route_id 让系统自动选择即可。
- insufficient_balance：表示图片 Key 额度不足。