跳转到主要内容
POST
cURL

授权

Authorization
string
header
必填

在 Authorization 请求头中使用 Bearer APIPod_API_KEY。

请求体

application/json
model
string
必填

APIPod 公开模型 ID。

Allowed value: "gpt-image-2.6-flare-hd"
prompt
string
必填

生成或编辑指令。

Maximum string length: 32000
image_urls
string[]

可公开访问的源图或参考图 URL。

Maximum array length: 16
mask_url
string

局部重绘遮罩图,支持公网 URL 或 base64 数据 URI。透明像素标记允许编辑的区域,其余区域保持不变;须伴随 image_urls 使用,且不能与 markup_url 同时使用。

markup_url
string

编辑标注图,支持公网 URL 或 base64 数据 URI(GPT Image 2.5/2.6 新增)。透明 PNG 叠加在第一张参考图上,不透明笔迹引导模型编辑对应区域;尺寸须与第一张参考图一致。须伴随 image_urls 使用,且不能与 mask_url 同时使用。

output_format
enum<string>
默认值:png

输出格式。GPT Image 2.6 HD 仅输出位图,不支持 gif 与 svg。

可用选项:
png,
jpeg,
webp
complexity
enum<string>
默认值:high

渲染前的规划复杂度。low 适合改背景这类聚焦型编辑,high 适合密集文字与复杂版式;缺省为 high,不额外收费。

可用选项:
low,
medium,
high
quality
enum<string>
默认值:auto

保真档位。background 为 transparent 时不得低于 medium。

可用选项:
auto,
low,
medium,
high,
xhigh,
max
background
enum<string>
默认值:auto

背景模式。transparent 返回带 alpha 通道的图片,并要求 quality 不低于 medium。

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

生成图片的宽高比。

可用选项:
auto,
61,
123,
182,
184,
243,
245,
304,
556,
969,
1269
resolution
enum<string>
默认值:1K

生成图片的分辨率档位。

可用选项:
1K,
2K,
4K
size
string

可选的精确像素通道,格式为 宽x高(例如 1024x1536)。宽高必须是 16 的倍数且不超过 3840;与 resolution、aspect_ratio 同时出现时以 size 为准。1K/2K/4K 档位配合 15 种宽高比已覆盖常见尺寸,因此只有像素级对齐或非标准比例时才需要 size。

output_compression
integer

jpeg 与 webp 的输出压缩率,取值 0-100。

必填范围: 0 <= x <= 100
moderation
enum<string>
默认值:low

内容审核严格度。APIPod 对 GPT Image 2.6 默认下发 low 以减少误拦;传 auto 可恢复 OpenAI 默认的严格过滤。

可用选项:
low,
auto

响应

200 - application/json

任务已受理

Standard response for task submission

code
integer
必填

HTTP 状态码。

data
Task Submit Data · object
必填

响应数据。

message
string
必填

响应消息。