GPT Image 2 模型接入

概览

OneLinkAI 提供图像 API 兼容接口，用于在 OneLinkAI 网关下调用图像生成与图像编辑能力。整体目标是尽可能保持与上游图像接口协议一致，方便已经接入相关图像接口的业务快速迁移或并行接入。

当前本文档主要覆盖以下两个接口：

生成图像：根据文字描述生成图像

编辑图像：基于一张或多张源图像和文字描述生成编辑结果

接入规则

鉴权方式

调用 OneLinkAI 的图像 API 接口时，统一使用 Bearer Token 鉴权：

路径规则

当前图像 API 主要使用以下两个路径：

POST /v1/images/generations

POST /v1/images/edits

示例：

图像生成路径：POST /v1/images/generations

图像编辑路径：POST /v1/images/edits

通用调用方式

图像生成接口使用 application/json 请求体，适合文生图场景。

图像编辑接口使用 multipart/form-data 请求体，适合单图或多图编辑、扩展图像等场景。

图片结果通常通过 data[].b64_json 返回；部分场景下也可能返回 data[].url。

能力清单

以下内容用于快速说明当前图像 API 的支持范围。

能力名称	是否支持	说明
生成图像	✔️	根据文字描述生成图像
编辑图像	✔️	基于一张或多张源图像生成编辑结果

接口详情

以下请求示例统一以 https://api.onelinkai.cloud 作为示例网关地址，实际调用时请替换为你的真实接入地址和有效的 ApiKey。

生成图像

根据文字描述生成图像

请求路径：POST /v1/images/generations

请求格式：application/json

核心请求字段：prompt、model、background、moderation、n、quality、size、output_format、output_compression、user

当前模型字段固定为 gpt-image-2

核心响应字段：created、data[].b64_json、usage.input_tokens、usage.output_tokens、usage.total_tokens

请求参数

参数	类型	必填	说明
prompt	string	是	图像描述，最长 32000 字符
model	string	是	模型名称，固定为 `gpt-image-2`
background	string	否	背景透明度。可选 `transparent` / `opaque` / `auto`，默认 `auto`。当取值为 `transparent` 时，输出格式需为 `png` 或 `webp`
moderation	string	否	内容审核级别。可选 `low` / `auto`，默认 `auto`
n	number	否	生成数量，取值范围 1–10
quality	string	否	图像质量。可选 `high` / `medium` / `low` / `auto`，默认 `auto`
size	string	否	输出尺寸。支持 `1024x1024`、`1536x1024`、`1024x1536`、`auto`，以及任意 `WIDTHxHEIGHT`。宽高需为 16 的倍数，比例范围 1:3–3:1，最大 3840x2160
output_format	string	否	输出格式。可选 `png` / `jpeg` / `webp`，默认 `png`
output_compression	number	否	压缩率，取值范围 0–100，仅 `webp` / `jpeg` 格式支持，默认 100
user	string	否	终端用户唯一标识，用于滥用检测

响应体

{
  "created": 1713833628,
  "data": [
    {
      "b64_json": "..."
    }
  ],
  "usage": {
    "input_tokens": 50,
    "input_tokens_details": {
      "text_tokens": 10,
      "image_tokens": 40
    },
    "output_tokens": 50,
    "total_tokens": 100
  }
}

响应字段

字段	类型	说明
created	number	图像创建时间，Unix 时间戳
background	string	实际使用的背景设置，通常为 `transparent` 或 `opaque`
output_format	string	实际输出格式，通常为 `png` / `webp` / `jpeg`
quality	string	实际使用的质量档位，通常为 `low` / `medium` / `high`
size	string	实际输出尺寸
data[].b64_json	string	Base64 编码的图像数据
usage.input_tokens	number	输入 token 数，包含文本与图像输入
usage.output_tokens	number	输出 token 数
usage.total_tokens	number	总 token 数

请求示例

编辑图像

基于一张或多张源图像和文字描述，生成编辑或扩展后的图像

请求路径：POST /v1/images/edits

请求格式：multipart/form-data

支持单图和多图编辑，多图场景请使用 image[] 字段名上传

核心请求字段：image / image[]、prompt、model、background、input_fidelity、mask、moderation、n、output_compression、output_format、quality、size、user

核心响应字段：created、data[].b64_json、data[].revised_prompt、data[].url、usage

请求参数

参数	类型	必填	说明
image / image[]	file	是	输入的源图像文件，最多支持 16 张。多图上传时请使用 `image[]` 字段名传递
prompt	string	是	期望的图像编辑描述
model	string	否	模型名称，支持 `gpt-image-2`、`gpt-image-1.5`、`gpt-image-1`、`gpt-image-1-mini` 或 `chatgpt-image-latest` 等
background	string	否	背景行为设置。可选 `transparent` / `opaque` / `auto`
input_fidelity	string	否	对原图的保真度控制。可选 `high` / `low`
mask	file	否	蒙版图像文件，用于指定需要编辑的区域
moderation	string	否	内容审核级别。可选 `low` / `auto`
n	integer	否	生成的图像数量
output_compression	integer	否	压缩率，取值范围 0–100，仅 `jpeg` / `webp` 格式支持
output_format	string	否	输出格式。可选 `png` / `jpeg` / `webp`
quality	string	否	图像质量。可选 `low` / `medium` / `high` / `auto`
size	string	否	输出尺寸。可选 `auto` / `1024x1024` / `1536x1024` / `1024x1536`
user	string	否	终端用户唯一标识，用于滥用检测

响应体

{
  "created": 1713833628,
  "background": "transparent",
  "data": [
    {
      "b64_json": "...",
      "revised_prompt": "...",
      "url": "https://..."
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 50,
    "input_tokens_details": {
      "image_tokens": 40,
      "text_tokens": 10
    },
    "output_tokens": 50,
    "output_tokens_details": {
      "image_tokens": 40,
      "text_tokens": 10
    },
    "total_tokens": 100
  }
}

响应字段

字段	类型	说明
created	number	图像创建时间，Unix 时间戳
background	string	实际使用的背景设置，通常为 `transparent` 或 `opaque`
data[].b64_json	string	Base64 编码的图像数据
data[].revised_prompt	string	生成图像时实际使用的修改版提示词
data[].url	string	生成图像的 URL，如适用
output_format	string	实际输出格式，通常为 `png` / `webp` / `jpeg`
quality	string	实际使用的质量档位，通常为 `low` / `medium` / `high`
size	string	实际输出尺寸
usage.input_tokens	number	输入 token 总数，包含图像与文本
usage.input_tokens_details	object	输入 token 详情，通常包含 `image_tokens` 与 `text_tokens`
usage.output_tokens	number	输出 token 总数
usage.output_tokens_details	object	输出 token 详情，通常包含 `image_tokens` 与 `text_tokens`
usage.total_tokens	number	总 token 消耗数

请求示例

使用建议

图像生成接口适合快速完成文生图场景，建议优先明确 prompt、size 与 quality。

图像编辑接口建议在多图场景中保持素材风格一致，以提升最终结果稳定性。

如果需要透明背景，建议显式设置 background=transparent，并将输出格式指定为 png 或 webp。

如果需要更贴近原图内容，可以在编辑图像场景下优先尝试 input_fidelity=high。

具体模型可用性、尺寸约束、审核策略与返回细节，请以当前接口实际返回结果为准。

概览#

接入规则#

鉴权方式#

路径规则#

通用调用方式#

能力清单#

接口详情#

生成图像#

请求参数#

响应体#

响应字段#

请求示例#

编辑图像#

请求参数#

响应体#

响应字段#

请求示例#

使用建议#

概览

接入规则

鉴权方式

路径规则

通用调用方式

能力清单

接口详情

生成图像

请求参数

响应体

响应字段

请求示例

编辑图像

请求参数

响应体

响应字段

请求示例

使用建议