文档

Generations格式

更新时间:2026-11-11

请求方法与路径

POST
/v1/images/generations

OpenAI Images 原生格式,根据文本提示词生成图片。

身份验证

详见调用指南 - 鉴权。

请求头参数

详见调用指南 - 公共请求头。

请求体

application/json
  1. body
model*string

模型 ID,如 gpt-image-1。

prompt*string

图片描述提示词。

n?integer

生成图片的数量。

范围1 <= value
默认值1
size?string

图片尺寸,如 1024x1024。

quality?string

图片质量,如 low、medium、high、auto。

response_format?string

返回格式,url 或 b64_json。部分模型固定返回 b64_json。

可选值"url""b64_json"
output_format?string

输出图片格式,如 png、jpeg、webp。

stream?boolean

是否流式响应。

响应体

成功创建响应

application/json
  1. response
created?integer

创建时间,Unix 时间戳(秒)。

data?array<>

生成的图片列表。

usage?

Token 用量统计。

请求示例
curl -X POST 'https://api.cysuo.com/v1/images/generations' \  -H 'Content-Type: application/json' \  -d '{  "model": "gpt-image-1",  "prompt": "一只在窗台上晒太阳的橘猫,水彩风格",  "n": 1,  "size": "1024x1024"}'
响应示例200
{  "created": 0,  "data": [    {      "url": "string",      "b64_json": "string",      "revised_prompt": "string"    }  ],  "usage": {    "input_tokens": 0,    "input_tokens_details": {      "text_tokens": 0,      "image_tokens": 0    },    "output_tokens": 0,    "total_tokens": 0  }}