gpt-image-2 图片接口指南

本文只保留 FriModel 已验证可用的调用方式。先复制最小示例跑通，再按需增加参数。

1. 基础信息

API 地址：https://api.pinniq.org

鉴权：Authorization: Bearer YOUR_API_KEY

推荐模型：gpt-image-2

图片生成：POST /v1/images/generations

图片编辑：POST /v1/images/edits

不要把真实 API Key 写进代码仓库、截图或公开文档。

2. 图片生成

最小请求

常用参数

参数	类型	必填	说明
`model`	string	是	使用 `gpt-image-2`
`prompt`	string	是	描述需要生成的画面
`size`	string	否	目标尺寸，如 `1024x1024`
`quality`	string	否	`low`、`medium`、`high` 或 `auto`
`output_format`	string	否	`png`、`jpeg` 或 `webp`
`n`	integer	否	生成数量，建议先使用 1

响应读取

图片内容位于：

data[0].b64_json

响应还可能包含 size、quality、output_format 和 usage。

实际测试中，请求 1024x1024，接口返回的图片为 1254x1254。因此 size 应理解为生成目标，不要用它校验最终像素；请在解码后读取图片的真实宽高。

保存图片

3. 图片编辑

图片编辑使用 multipart/form-data 上传本地文件。不要按 JSON 图片 URL 的方式调用，除非平台后续明确宣布支持。

单图编辑

多图参考

重复传入 image 字段：

如需局部重绘，可额外上传 mask=@mask.png。原图和 mask 建议尺寸一致，mask 使用带透明通道的 PNG。

4. JavaScript 示例

安装 SDK：

5. 常见问题

返回的是 base64，不是图片 URL

读取 data[0].b64_json，Base64 解码后保存为图片文件。

请求尺寸和实际尺寸不一致

这是正常情况。size 是生成目标，最终尺寸以解码后的图片文件为准。

401 或鉴权失败

确认请求头格式为：

400 或参数错误

先只保留 model、prompt 和 size。跑通后再逐个增加质量、格式等可选参数。

图片编辑失败

确认请求为 multipart/form-data，文件字段名使用 image，并且上传的是可正常打开的图片文件。

gpt-image-2 接口指南

gpt-image-2 图片接口指南#

1. 基础信息#

2. 图片生成#

最小请求#

常用参数#

响应读取#

保存图片#

3. 图片编辑#

单图编辑#

多图参考#

4. JavaScript 示例#

5. 常见问题#

返回的是 base64，不是图片 URL#

请求尺寸和实际尺寸不一致#

401 或鉴权失败#

400 或参数错误#

图片编辑失败#