Skip to main content
POST
cURL
根据文本提示创建图像。该接口与 OpenAI 官方 Images API 的 POST /v1/images/generations 请求和响应结构保持一致,文档翻译自 官方文档,如已对接官方文档可直接使用,入参出参结构与支持保持一致。”。 支持模型包括 gpt-image-2gpt-image-1.5gpt-image-1dall-e-2dall-e-3
由于 OpenAI 图像生成是同步响应,生成时间较长,建议使用 https://api.ttapi.org 网关

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

请求体

application/json
prompt
string
必填

图像的文本描述。gpt-image-1.5gpt-image-1 最多支持 32000 个字符;dall-e-2 最多支持 1000 个字符;dall-e-3 最多支持 4000 个字符。

model
enum<string>
必填

用于图像生成的模型。

可用选项:
gpt-image-2,
gpt-image-1.5,
gpt-image-1,
dall-e-2,
dall-e-3
background
enum<string>
默认值:auto

设置生成图像背景的透明度。仅适用于 GPT Image 模型。可选值为 transparentopaqueauto(默认)。当设置为 transparent 时,output_format 必须支持透明度,请使用 pngwebp

可用选项:
transparent,
opaque,
auto
moderation
enum<string>
默认值:auto

控制 GPT Image 模型生成图像的内容审核级别。可选 low(限制更少的过滤)或 auto(默认)。

可用选项:
low,
auto
n
integer

要生成的图像数量,默认值为 1。可选范围 1-10dall-e-3 固定为 1。

output_compression
integer
默认值:100

生成图像的压缩级别(0-100)。仅适用于 output_formatwebpjpeg 的 GPT Image 模型,默认值为 100。

output_format
enum<string>
默认值:png

生成图像的返回格式。仅适用于 GPT Image 模型。可选 png(默认)、jpegwebp

可用选项:
png,
jpeg,
webp
partial_images
integer
默认值:0

流式响应中要返回的部分图片数量,范围 0-3,默认值为 0。仅当 streamtrue 时可用。

quality
string
默认值:auto

图像质量。auto(默认)会为给定模型自动选择最佳质量。

GPT Image 模型支持 highmediumlow

dall-e-3 支持 hdstandard

dall-e-2 仅支持 standard

response_format
enum<string>

返回数据格式。仅 dall-e-2dall-e-3 支持 urlb64_json;URL 有效期为 60 分钟。GPT Image 模型始终返回 b64_json

可用选项:
url,
b64_json
size
string
默认值:auto

图像尺寸。

GPT Image 模型支持 1024x10241536x10241024x1536auto(默认);

gpt-image-2 支持 WIDTHxHEIGHT 任意分辨率字符串,宽高需可被 16 整除,宽高比需在 1:3 到 3:1 之间。

dall-e-2 支持 256x256512x5121024x1024

dall-e-3 支持 1024x10241792x10241024x1792

stream
boolean
默认值:false

是否以流式方式返回生成进度。启用后可通过 partial_images 获取部分图片事件。

style
enum<string>

生成图像的风格。仅适用于 dall-e-3

可用选项:
vivid(生动),
natural(自然)
user
string

代表最终用户的唯一标识,可帮助 OpenAI 监测和检测滥用。

响应

请求成功,返回图像生成结果(支持url/base64两种格式)

created
integer
必填

生成时间戳(秒)

示例:

1745818538

data
(URL格式 · object | Base64格式 · object)[]
必填

图像生成结果列表

usage
object
最后修改于 2026年6月16日