SiliEvo gpt-image-2 生图模型接入指南

1. 接口概览

功能	接口路径	方法	说明
图片生成	`/v1/images/generations`	POST	文生图（同步返回）
图片编辑	`/v1/images/edits`	POST	图生图编辑（同步返回）

Base URL: https://api.numspirit.com/

2. 认证方式

所有请求需要在 HTTP Header 中携带认证信息：

Content-Type: application/json    # 图片生成接口
Content-Type: multipart/form-data  # 图片编辑接口
Authorization: Bearer sk-silievo-xxxxxxxxxxxxxxxxxxxx

注意: sk-silievo- 开头的 API Key 需要通过平台官网 https://numspirit.com 申请。

3. 图片生成接口（/v1/images/generations）

3.1 请求参数

请求体结构

重要限制: azure/gpt-image-2 的 JSON 生图接口不支持 images 数组传参考图（参考图会被忽略，image_tokens=0，仅按文字生成）。图生图/多图编辑请使用 /v1/images/edits multipart 接口。
模型路由: 生产环境请使用带渠道前缀的完整模型 ID azure/gpt-image-2（固定路由到微软 Azure 渠道）。开发环境渠道 code 为 ms（请求模型 ms/gpt-image-2）；生产环境渠道 code 为 azure，请使用 azure/gpt-image-2（本指南所有示例均按生产写法）。不带渠道前缀的纯模型 ID 仅在模型唯一注册时自动路由，多渠道并存时建议用前缀形式固定渠道。

参数说明

参数	类型	必填	说明
`prompt`	string	是	提示词，描述要生成的图片内容。支持中英文，建议详细描述以获得更好效果。
`model`	string	是	模型名称，固定值为 `azure/gpt-image-2`
`size`	string	是	图片尺寸，可选值见下表
`quality`	string	是	图片质量，可选值：`low`（低）、`medium`（中）、`high`（高）
`output_compression`	integer	否	输出压缩比例，默认 `100`（100%不压缩），范围 `1-100`
`output_format`	string	否	输出格式，默认 `png`，可选值：`png`、`jpeg`、`webp`
`n`	integer	否	生成数量，默认 `1`，范围 `1-10`

支持的图片尺寸

尺寸	说明
`1024x1024`	正方形
`1024x1536`	竖屏
`1536x1024`	横屏
`auto`	自动选择

3.2 返回值格式

成功响应

{
  "created": 1784686812,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAABOYAAATmCAIAAAAKnjl9AABKMGNhQlgAAEowanVtYgAAAB5qdW1kYzJwYQARABCAAACqADibcQNjMnBhAAAASgpqdW1iAAAAR2p1bWRjMm1hABEAEIAAAKoAOJtxA3VybjpjMnBhOmI0N2RmOTViLWIwMTktNDNhZi05MDliLTBlNzFhNGRmZjA2YwAAAAQjanVtYgAAAClqdW1kYzJhcwARABCAAACqADibcQNjMnBhLmFzc2VydGlvbnMAAAACGGp1bWIAAABBanVtZGNib3IAEQAQgAAAqgA4m3ETYzJwYS5hY3Rpb25zLnYyAAAAABhjMnNomaStbyqagIS827lY66f5iAAAA+DYrMYQiZ3OycxLNn1A5277z7TnBYiMnEIQYRAADGDINsbal/gvwbQ50wzBoyxnfu3Pll989Dhg5J+CChkVQOq+8DQjijSSQRIQQbYqEOVQhnAGP8f+bwHhSO1ei2AAAAAElFTkSuQmCC",
    }
  ],
  "usage": {
    "total_tokens": 196,
    "input_tokens": 24,
    "output_tokens": 172,
    "input_tokens_details": {
      "text_tokens": 24,
      "image_tokens": 0
    }
  }
}

响应字段说明

字段	类型	说明
`created`	integer	响应创建时间戳
`data`	array	生成的图片数据数组
`data[].b64_json`	string	图片的 Base64 编码数据
`usage`	object	Token 使用统计
`usage.input_tokens`	integer	输入 Token 总数
`usage.input_tokens_details.image_tokens`	integer	输入图片 Token 数（纯文生图为 0，带输入图约 1024）
`usage.input_tokens_details.text_tokens`	integer	输入文本 Token 数
`usage.output_tokens`	integer	输出 Token 总数
`usage.total_tokens`	integer	总 Token 数

4. 图片编辑接口（/v1/images/edits）

4.1 请求参数

请求体结构（multipart/form-data）

参数说明

参数	类型	必填	说明
`image`	file	是	原始图片文件，支持 PNG、JPEG、WEBP 格式
`mask`	file	否	遮罩图片文件（可选），用于指定编辑区域
`prompt`	string	是	编辑提示词，描述要对图片进行的修改
`model`	string	是	模型名称，固定值为 `azure/gpt-image-2`

注意: 如果不传 mask，则会对整张图片进行编辑。
mask 支持确认: azure/gpt-image-2 的 mask 会真实透传上游（multipart 请求含 mask 字段），可用于精确指定编辑区域。

4.2 返回值格式

成功响应

{
  "created": 1784686812,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAABOYAAATmCAIAAAAKnjl9AABKMGNhQlgAAEowanVtYgAAAB5qdW1kYzJwYQARABCAAACqADibcQNjMnBhAAAASgpqdW1iAAAAR2p1bWRjMm1hABEAEIAAAKoAOJtxA3VybjpjMnBhOmI0N2RmOTViLWIwMTktNDNhZi05MDliLTBlNzFhNGRmZjA2YwAAAAQjanVtYgAAAClqdW1kYzJhcwARABCAAACqADibcQNjMnBhLmFzc2VydGlvbnMAAAACGGp1bWIAAABBanVtZGNib3IAEQAQgAAAqgA4m3ETYzJwYS5hY3Rpb25zLnYyAAAAABhjMnNomaStbyqagIS827lY66f5iAAAA+DYrMYQiZ3OycxLNn1A5277z7TnBYiMnEIQYRAADGDINsbal/gvwbQ50wzBoyxnfu3Pll989Dhg5J+CChkVQOq+8DQjijSSQRIQQbYqEOVQhnAGP8f+bwHhSO1ei2AAAAAElFTkSuQmCC"
    }
  ],
  "usage": {
    "total_tokens": 1560,
    "input_tokens": 1045,
    "output_tokens": 515,
    "input_tokens_details": {
      "text_tokens": 21,
      "image_tokens": 1024
    }
  }
}

响应字段说明

字段	类型	说明
`created`	integer	响应创建时间戳
`data`	array	编辑后的图片数据数组
`data[].b64_json`	string	编辑后图片的 Base64 编码数据
`usage`	object	Token 使用统计（同图片生成接口）

5. 错误处理

HTTP 状态码	错误码	说明
400	`invalid_request`	请求参数错误，如缺少必填字段
401	`unauthorized`	API Key 无效或已过期
403	`forbidden`	无权限访问该模型
429	`rate_limit`	请求频率超限
500	`internal_error`	服务器内部错误

6. 常见问题

Q1: 图片生成和图片编辑有什么区别？

功能	输入	输出	适用场景
图片生成	文本提示词	全新图片	根据描述创建图片
图片编辑	原始图片 + 文本提示词	修改后的图片	对现有图片进行修改

Q2: 图片编辑的 mask 参数有什么作用？

mask 是可选参数。如果不传，编辑会应用于整张图片；如果传入，只有 mask 指定的区域会被编辑。

Q3: 支持哪些图片格式？

支持 PNG、JPEG、WEBP 格式。建议使用 PNG 格式以获得最佳质量。

gpt-image-2生图接入

SiliEvo gpt-image-2 生图模型接入指南#

1. 接口概览#

2. 认证方式#

3. 图片生成接口（/v1/images/generations）#

3.1 请求参数#

请求体结构#

参数说明#

支持的图片尺寸#

3.2 返回值格式#

成功响应#

响应字段说明#

4. 图片编辑接口（/v1/images/edits）#

4.1 请求参数#

请求体结构（multipart/form-data）#

参数说明#

4.2 返回值格式#

成功响应#

响应字段说明#

5. 错误处理#

6. 常见问题#

Q1: 图片生成和图片编辑有什么区别？#

Q2: 图片编辑的 mask 参数有什么作用？#

Q3: 支持哪些图片格式？#

SiliEvo gpt-image-2 生图模型接入指南

1. 接口概览

2. 认证方式

3. 图片生成接口（/v1/images/generations）

3.1 请求参数

请求体结构

参数说明

支持的图片尺寸

3.2 返回值格式

成功响应

响应字段说明

4. 图片编辑接口（/v1/images/edits）

4.1 请求参数

请求体结构（multipart/form-data）

参数说明

4.2 返回值格式

成功响应

响应字段说明

5. 错误处理

6. 常见问题

Q1: 图片生成和图片编辑有什么区别？

Q2: 图片编辑的 mask 参数有什么作用？

Q3: 支持哪些图片格式？