跳转到主要内容
POST
生成图片

授权

Authorization
string
header
必填

在 OmniRelay 控制台创建的 API Key。所有者确认身份后可在控制台再次查看。

请求头

X-Gateway-Tags
string

本次调用的标签,以逗号分隔的 key=value,例如 client=acme,env=prod。与 API Key 的默认标签合并;同名 key 以请求体 tags 字段为准。X-OmniRelay-Tags 是同一个请求头的旧名,继续接受。

X-Gateway-Metadata
enum<string>

传 enabled 时,响应会附带 gateway_metadata,说明网关为本次调用做出的决定。其他值或不传此头,响应保持不变。X-OmniRelay-Metadata 是同一个请求头的旧名,继续接受。

可用选项:
enabled

请求体

application/json

其他字段(background、output_format、output_compression、moderation、user)原样传给模型,由模型决定是否接受。

model
string
必填

图片模型 ID,例如 gpt-image-2。

示例:

"gpt-image-2"

prompt
string
必填

图片的文字描述,最多 32000 个字符。

Maximum string length: 32000
n
integer
默认值:1

图片张数,1 至模型上限(4)。预留 n 张的费用,只对实际返回的图片扣费。

必填范围: 1 <= x <= 4
size
string
默认值:auto

宽x高 或 auto。决定价格档位:最长边不超过 1024 px 为 1K,不超过 2048 px 为 2K,不超过 4096 px 为 4K;auto 或未传为 2K。

示例:

"1024x1024"

quality
string

传给模型,例如 low、medium、high 或 auto。不影响价格。

response_format
enum<string>

仅支持 b64_json。

可用选项:
b64_json
tags
object

可选的 OmniRelay 标签对象,调用前会被移除。

响应

图片及已结算的用量与费用。

created
integer
必填
model
string
必填
data
object[]
必填

生成的图片。

cost_microusd
integer
必填

折扣后的扣费金额(micro-USD)。

background
string
output_format
string
quality
string
size
string
usage
object

模型报告的 token 数,仅供参考;图片按张计费,不按 token 计费。

omnirelay_metadata
object

仅在请求带有 X-Gateway-Metadata: enabled 时出现。同时以 gateway_metadata 和旧名 omnirelay_metadata 返回,内容相同。流式响应中随第一个数据块返回。

gateway_metadata
object

仅在请求带有 X-Gateway-Metadata: enabled 时出现。同时以 gateway_metadata 和旧名 omnirelay_metadata 返回,内容相同。流式响应中随第一个数据块返回。