跳转到主要内容
POST
cURL

授权

Authorization
string
header
必填

在 Authorization 请求头中使用 Bearer APIPod_API_KEY。

请求体

application/json
model
string
必填

APIPod 公开模型 ID。

Allowed value: "qwen-image-3.0-pro"
prompt
string
必填

要生成的内容;传入 image_urls 时则为编辑指令。提示词最长约 4.5k token。 最大字符串长度:32000。

aspect_ratio
enum<string>

输出宽高比,与 resolution 搭配使用;接受 1:8 到 8:1 的任意比例。

可用选项:
auto,
1:1,
1:2,
2:1,
1:3,
3:1,
1:4,
4:1,
1:8,
8:1,
2:3,
3:2,
3:4,
4:3,
4:5,
5:4,
9:16,
16:9,
9:21,
21:9
enable_thinking
boolean

渲染前先推理以提升出图质量,但会增加耗时。仅在 prompt_extend 开启时生效;上游默认开启。

image_urls
string[]

可选。不传即为文生图;传入 1 到 3 张图片后,同一模型切换为指令式编辑。

n
enum<integer>
默认值:1

单次请求生成的图片数量;每张返回的图片分别计费。 最小值:1。 最大值:6。

可用选项:
1,
2,
3,
4,
5,
6
prompt_extend
boolean
默认值:true

渲染前先扩写简短提示词(增加 3 到 5 秒);提示词已精确详尽时建议关闭。

prompt_extend_mode
enum<string>

prompt_extend 开启时的提示词改写方式。direct(默认)文生图与编辑均可用;agent 改写更精细,仅支持文生图。

可用选项:
direct,
agent
resolution
enum<string>
默认值:2K

推荐的输出档位;与 aspect_ratio 搭配时由 API 换算出精确像素。未传 size 的请求按 2K 档计费。

可用选项:
1K,
2K
seed
integer

随机种子;复用同一种子可获得更稳定的结果。 最小值:0。 最大值:2147483647。

size
string

精确像素覆盖,格式为「宽高」;总像素须在 512512 到 2048*2048 之间、比例 1:8 到 8:1。优先级高于 resolution 与 aspect_ratio;不传则由模型自选。

watermark
boolean
默认值:false

在右下角添加 AI 生成的水印。

响应

200 - application/json

任务已受理

Standard response for task submission

code
integer
必填

HTTP 状态码。

data
Task Submit Data · object
必填

响应数据。

message
string
必填

响应消息。