跳转到主要内容
POST
创建图像
根据文本提示生成一张或多张图像。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

请求体

application/json
model
string
必填
prompt
string
必填
models
string[]

在 model 之后按顺序尝试的可选回退模型。model 为必填项,且始终是主模型。当某次尝试以 429、500、502、503 或 504 失败时,会尝试下一项;其他错误按原样返回。最多接受 25 个模型 ID 或预设;重复项以及与 model 相同的项会被忽略。每次尝试都会作为独立请求进行验证、记录和计费,响应中的 model 字段和路由追踪会显示实际处理请求的模型。流式请求仅在发送第一个字节之前回退,视频和音乐任务仅在提交时回退。Batch、realtime 和 council 请求会拒绝 models。动态路由上设置的回退优先,且 phaseo/auto 不能与 models 一起使用。

Required array length: 1 - 25 elements
Minimum string length: 1
示例:
size
string
resolution
string
n
integer
必填范围: 1 <= x <= 10
quality
string
stream
boolean
partial_images
integer
必填范围: 0 <= x <= 3
output_format
enum<string>

输出格式。gif 和 svg 需要 GPT Image 2.6 模型,且不支持 stream 或 partial_images。svg 还需要 svg.model 和 n=1。

可用选项:
png,
jpeg,
webp,
gif,
svg
output_compression
integer
必填范围: 0 <= x <= 100
background
enum<string>
可用选项:
transparent,
opaque,
auto
moderation
enum<string>
可用选项:
auto,
low
complexity
enum<string>
可用选项:
low,
medium,
high
frame_count
integer
必填范围: 2 <= x <= 64
frame_duration_ms
integer
必填范围: 20 <= x <= 2000
svg
object

当 output_format 为 svg 时必填。svg.model 是根据参考图像编写 SVG 的 OpenAI 文本模型。其 token 按该模型的文本价格计费,推理 token 计为输出,并在图像费用之外另行收取。

response_format
string
style
string
user
string
provider
object

用于网关选择的提供商路由偏好设置。

响应

图像响应

created
integer
data
object[]
svg_usage
object
最后修改于 2026年11月16日