创建图片

根据文本提示使用 GPT 图像模型生成图像。

接口地址

POST /v1/images/generations

认证

方式	说明
Bearer Token	在请求头中携带 Authorization: Bearer <API_key> 用于验证账户信息。

请求头

参数名	类型	必填	说明
Content-Type	string	是	请求体的媒介类型，请设置为 application/json
Authorization	string	是	Bearer API_key，用于验证账户信息

请求体

参数名	类型	必填	默认值	说明
model	string	是	-	用于图像生成的 GPT 图像模型，需显式指定，枚举值见下文「支持模型Id」
prompt	string	是	-	所需图像的文本描述，最大长度 32000 字符
background	string	否	auto	生成图像的背景：transparent（透明）、opaque（不透明）或 auto（自动），详见下文参数说明
moderation	string	否	auto	内容审核级别：low（较低限制）或 auto（自动），仅 GPT 图像模型支持
n	integer	否	1	生成的图像数量，取值范围 1–10
output_compression	integer	否	100	压缩级别（0–100%），仅 GPT 图像模型在 webp 或 jpeg 格式下支持
output_format	string	否	png	图像返回格式：png、jpeg 或 webp，仅 GPT 图像模型支持
partial_images	integer	否	0	流式返回的中间过程图像数量，取值 0–3；设为 0 时在一次流事件中返回单张完整图像
quality	string	否	auto	生成图像的质量，枚举值见下文参数说明
response_format	string	否	-	已退役图像模型的遗留参数，GPT 图像模型不支持（始终返回 base64 编码图像）
safety_identifier	string	否	-	最终用户的稳定标识符，用于安全监控，最长 128 字符，详见下文参数说明
size	string	否	auto	生成图像的尺寸，详见下文参数说明
stream	boolean	否	false	是否以流式模式生成图像，仅 GPT 图像模型支持
style	string	否	-	已退役图像模型的遗留参数，GPT 图像模型不支持，请在提示词中描述所需风格
user	string	否	-	已废弃，请改用 safety_identifier；当 safety_identifier 省略、为 null 或为空时使用

支持模型Id：

• gp-im-1.5
• gp-im-2
• gp-im-2-2026-04-21
• gp-im-2.5-su
• gp-im-2.5-su-2026-09-08
• gp-im-2.5-fl
• gp-im-2.5-fl-2026-09-08
• gp-im-1-mini
• gp-im-1（已于 2026 年 10 月 23 日下线，请改用 gp-im-2.5-su 或 gp-im-2.5-fl）
• dall-e-2
• dall-e-3

参数说明

background 说明

仅 GPT 图像模型支持此参数。设为 auto 时，模型将自动确定最佳背景。

gp-im-2.5-su 和 gp-im-2.5-fl（含 2026-09-08 快照）支持 opaque 和 transparent 背景；对于 gp-im-2 和 gp-im-2-2026-04-21，透明背景支持处于预览阶段。使用 transparent 时，output_format 需设为 png 或 webp。

quality 枚举值

• auto：自动为给定模型选择最佳质量（默认值）
• low / medium / high：适用于 GPT 图像模型
• xhigh / max：仅 gp-im-2.5-su 和 gp-im-2.5-fl（含 2026-09-08 快照）支持
• standard / hd：已退役图像模型的遗留枚举值

size 说明

对于 gp-im-2、gp-im-2-2026-04-21、gp-im-2.5-su、gp-im-2.5-su-2026-09-08、gp-im-2.5-fl 和 gp-im-2.5-fl-2026-09-08，支持 WIDTHxHEIGHT 格式的任意分辨率，例如 1536x864。宽和高都必须能被 16 整除，且宽高比需在 1:3 到 3:1 之间；分辨率超过 2560x1440 为实验性支持，最大分辨率为 3840x2160；请求的尺寸还须满足模型当前的像素和边长限制。

标准尺寸：1024x1024、1536x1024、1024x1536；auto 适用于允许自动尺寸的模型。遗留枚举值：256x256、512x512、1792x1024、1024x1792。

safety_identifier 说明

组织内最终用户的稳定标识符，用于安全监控和滥用检测。请对用户名或邮箱地址进行哈希处理，避免发送可识别信息。非空值优先于已废弃的 user 参数；如果省略、为 null 或为空，API 将在 user 可用时使用它。

请求示例

生成图像

curl --request POST \
  --url https://neolink.com/api/v1/images/generations \
  --header 'Authorization: Bearer <API Key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gp-im-2",
    "prompt": "一只可爱的海獭宝宝",
    "n": 1,
    "size": "1024x1024"
  }'

流式生成

curl --request POST \
  --url https://neolink.com/api/v1/images/generations \
  --header 'Authorization: Bearer <API Key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gp-im-2",
    "prompt": "一只可爱的海獭宝宝",
    "n": 1,
    "size": "1024x1024",
    "stream": true
  }'

完整参数

curl --request POST \
  --url https://neolink.com/api/v1/images/generations \
  --header 'Authorization: Bearer <API Key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gp-im-2.5-fl",
    "prompt": "一只可爱的海獭宝宝",
    "background": "transparent",
    "moderation": "low",
    "n": 1,
    "output_compression": 100,
    "output_format": "png",
    "partial_images": 1,
    "quality": "medium",
    "safety_identifier": "user-1234",
    "size": "1024x1024"
  }'

响应体

参数名	类型	说明
created	integer	图像创建时的 Unix 时间戳（秒）
background	string	实际使用的背景参数：transparent 或 opaque
data	array	生成的图像列表
data.b64_json	string	图像的 base64 编码 JSON，GPT 图像模型默认返回
data.revised_prompt	string	用于生成图像的修订后提示词（适用于支持提示词修订的模型），GPT 图像模型不返回
data.url	string	图像 URL（遗留参数 response_format 设为 url 时返回），GPT 图像模型不支持
output_format	string	输出格式：png、webp 或 jpeg
quality	string	图像质量：low、medium、high、xhigh 或 max
safety_identifier	string	实际生效的安全标识符：请求中非空的 safety_identifier，或其省略、为 null 或为空时的 user 值
size	string	图像尺寸，WIDTHxHEIGHT 格式字符串，例如 1536x864
usage	object	令牌用量信息，仅 gp-im-1 支持
usage.input_tokens	integer	输入提示中的令牌数（图像和文本）
usage.input_tokens_details.image_tokens	integer	输入提示中的图像令牌数
usage.input_tokens_details.text_tokens	integer	输入提示中的文本令牌数
usage.output_tokens	integer	模型生成的输出令牌数
usage.total_tokens	integer	图像生成所使用的总令牌数（图像和文本）
usage.output_tokens_details.image_tokens	integer	模型生成的图像输出令牌数
usage.output_tokens_details.text_tokens	integer	模型生成的文本输出令牌数

响应示例

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

流式响应

设置 stream: true 时，响应以 SSE 事件流返回，事件格式如下：

• image_generation.partial_image：中间过程图像，partial_image_index 为图像序号；若完整图像生成较快，最终图像可能在达到 partial_images 指定数量前发送
• image_generation.completed：最终完整图像及令牌用量

event: image_generation.partial_image
data: {"type":"image_generation.partial_image","b64_json":"...","partial_image_index":0}

event: image_generation.completed
data: {"type":"image_generation.completed","b64_json":"...","usage":{"total_tokens":100,"input_tokens":50,"output_tokens":50,"input_tokens_details":{"text_tokens":10,"image_tokens":40}}}