跳转到主要内容
POST
cURL

授权

Authorization
string
header
必填

在 Authorization 请求头中使用 Bearer APIPod_API_KEY。

请求体

application/json
model
string
必填

APIPod 公开模型 ID。

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

生成或编辑指令。输出 GIF 时需写明主体、运动方式与循环目标。

Maximum string length: 32000
image_urls
string[]

可公开访问的源图或参考图 URL。与 gif、svg 输出不能同时使用。

Maximum array length: 16
output_format
enum<string>
默认值:png

输出格式。gif 与 svg 是 GPT Image 2.6 新增能力,仅支持文生图;svg 一次只返回一个结果,两者都不支持 output_compression 与透明背景。

可用选项:
png,
jpeg,
webp,
gif,
svg
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,
1:1,
2:3,
3:2,
3:4,
4:3,
4:5,
5:4,
9:16,
16:9,
21:9
resolution
enum<string>
默认值:1K

生成图片的分辨率档位。

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

精确像素尺寸,格式为 宽x高,例如 1024x1536。宽高必须是 16 的倍数且不超过 3840;优先于 resolution 与 aspect_ratio,同时决定 GIF 的单帧尺寸。

frame_count
integer
默认值:9

GIF 总帧数,取值 2-64。仅当 output_format 为 gif 时生效,缺省为 9。

必填范围: 2 <= x <= 64
frame_duration_ms
integer
默认值:200

GIF 每帧时长(毫秒),取值 20-2000。仅当 output_format 为 gif 时生效,缺省为 200。

必填范围: 20 <= x <= 2000
output_compression
integer

jpeg 与 webp 的输出压缩率,取值 0-100。gif 与 svg 不支持该参数。

必填范围: 0 <= x <= 100

响应

200 - application/json

任务已受理

Standard response for task submission

code
integer
必填

HTTP 状态码。

data
Task Submit Data · object
必填

响应数据。

message
string
必填

响应消息。