AI 接口对接文档中心

1. 概述

使用 GPT-Image 模型，根据文本提示词生成图片。

baseUrl：https://token.soar.qjclouds.cn/laserEr/00000000/v1
completionsPath：/image/generations/{apiType}
apiType：TextToImage
标准地址：POST {baseUrl}{completionsPath}
鉴权：Authorization: Bearer <api_key>
请求体：标准 GPT-Image JSON

地址拼接：{baseUrl}{completionsPath}，其中 apiType=TextToImage，即 https://token.soar.qjclouds.cn/laserEr/00000000/v1/image/generations/TextToImage。

2. 鉴权

请求 Header 中需携带平台生成的 API Key：

HTTP

Authorization: Bearer <api_key>
Content-Type: application/json
Accept: application/json

3. 请求与响应示例

Header 参数

字段	类型	必填	说明
`Content-Type`	string	是	示例：application/json
`Authorization`	string	是	示例：Bearer {YOUR_API_KEY}

Body 参数

字段	类型	必填	说明
`model`	string	是	模型名称
`prompt`	string	是	图片生成提示词
`quality`	string	否	输出质量。支持 low、medium、high、auto；默认 auto。可选值：auto、high、medium、low 默认值：auto 允许为空。
`n`	integer	否	生成图片数量。必须为正整数；不传时由上游使用默认值 1。默认值：1 范围：最小 1，最大 10 格式：int32 允许为空。
`size`	string	否	生成图片的尺寸。对于`gpt-image-2`，以下约束支持任意解析： - 这两个边必须是 16 像素的倍数。 - 最长边最多 3840 像素（支持 4K）。 - 纵横比高达 3：1。 - 655,360 到 8,294,400 之间的总像素计数。对于 `GPT-image-1` 系列模型，请将生成图像的大小指定为 `1024x1024`、`1024x1536` 或 `1536x1024` 中的一个。方形图像生成速度更快。允许为空。
`output_format`	string	否	指定生成的图像的格式。支持的格式是 PNG 和 JPEG。默认值为 PNG。不支持 WEBP 图像。可选值：png、jpeg 默认值：png 允许为空。
`background`	string	否	图片背景类型 auto（自动）/opaque（不透明）/transparent（透明）。如果设置为transparent（透明），输出的图片格式需要支持透明度，因此应设置为png。可选值：auto、transparent、opaque 默认值：auto 允许为空。
`moderation`	string	否	控制由GPT图像模型生成的图像的内容审核级别。可选值：low、auto 默认值：auto 允许为空。
`output_compression`	integer	否	指定生成的映像的压缩级别。在两者之间输入一个整数0~100，其中0没有压缩，并且100是最大压缩。默认值为 100。仅对jpeg格式图片有效范围：最小 0，最大 100 格式：int32 允许为空。
`user`	string	否	最终用户标识，用于追踪和滥用检测允许为空。

响应状态

HTTP 状态码	说明
`200`	图片生成结果
`400`	请求失败

成功响应参数

字段	类型	必填	说明
`created`	integer	否	Unix 时间戳（秒）
`data`	array<object>	否
`data[].b64_json`	string	否	图片的 base64 数据
`usage`	object	否	本次图片请求的用量。
`usage.total_tokens`	integer	否	总 Token 数，通常等于 input_tokens 与 output_tokens 之和。
`usage.input_tokens`	integer	否	输入 Token 总量。
`usage.output_tokens`	integer	否	输出 Token 总量。
`usage.input_tokens_details`	object	否	输入 Token 的分类明细，已包含在 input_tokens 中。
`usage.input_tokens_details.text_tokens`	integer	否	文本输入 Token 数。
`usage.input_tokens_details.image_tokens`	integer	否	图片输入 Token 数。
`usage.output_tokens_details`	object	否	输出 Token 的分类明细，已包含在 output_tokens 中。
`usage.output_tokens_details.text_tokens`	integer	否	文本输出 Token 数。
`usage.output_tokens_details.image_tokens`	integer	否	图片输出 Token 数。
`background`	string	否	背景类型
`quality`	string	否	图像质量
`size`	string	否	图像尺寸
`output_format`	string	否	输出图像格式

请求示例

JSON

{
  "model": "gpt-image-1-mini",
  "prompt": "一只在月球漫步的橘猫，身披中国国旗，电影感。",
  "size": "1024x1024",
  "quality": "low",
  "output_format": "png"
}

响应示例

JSON

{
  "created": 1788750103,
  "data": [{ "b64_json": "base64 data" }],
  "usage": {
    "total_tokens": 299,
    "input_tokens": 27,
    "output_tokens": 272,
    "input_tokens_details": { "text_tokens": 27, "image_tokens": 0 },
    "output_tokens_details": { "text_tokens": 0, "image_tokens": 272 }
  },
  "background": "opaque",
  "quality": "low",
  "size": "1024x1024",
  "output_format": "png"
}

4. 调用提示

请求中的 model 必须为当前租户已开通的 GPT-Image 模型编码。