Skip to main content
POST
cURL

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

请求体

application/json
prompt
string
必填

用于描述图像的自由格式提示词。不传 images 时按提示词生成新图像;传入参考图时,写明要修改的内容,并按顺序称为图 1、图 2。也可以在提示词末尾附加边界框,用 0 到 1000 的 [top, left, bottom, right] 指定元素位置。

images

可选参考图。不传时为文生图;传入后按提示词编辑、换风格或合成。每张为 http(s) URL 或 base64,共 1 到 10 张。第一张是被编辑的图像,并决定默认输出尺寸。

aspect_ratio
enum<string>
默认值:auto

输出图像宽高比。auto 时,有参考图则使用第一张的精确比例;没有参考图时先根据提示词选择比例,否则使用 16:9。同时传入 width 和 height 时忽略该字段。

可用选项:
auto,
21:9,
2:1,
16:9,
3:2,
7:5,
4:3,
5:4,
1:1,
4:5,
3:4,
5:7,
2:3,
9:16,
1:2,
9:21
resolution
enum<string>

图像分辨率档位:768sq、1k、1.5k、2k、4k。文生图省略时为 1k;有参考图且省略时使用第一张自身尺寸,若同时设置了 aspect_ratio 则取最接近的档位。同时传入 width 和 height 时忽略该字段。

可用选项:
768sq,
1k,
1.5k,
2k,
4k
width
integer

输出宽度,单位为像素,范围 64 到 6256。必须与 height 一起传入,并覆盖 aspect_ratio 和 resolution。宽乘高不超过 16822272 像素。

必填范围: 64 <= x <= 6256
height
integer

输出高度,单位为像素,范围 64 到 6256。必须与 width 一起传入。宽乘高不超过 16822272 像素。

必填范围: 64 <= x <= 6256
seed
integer

随机种子,用于复现结果。省略时随机。取值范围 0 到 4294967295。

必填范围: 0 <= x <= 4294967295
safety_tolerance
integer
默认值:2

内容安全审核容忍度,取值 0 到 7,0 最严格,默认 2。允许的最高等级以及各类内容上限由路由和组织决定。

必填范围: 0 <= x <= 7
output_format
enum<string>
默认值:jpeg

输出图像格式。

可用选项:
jpeg,
png
steps
integer
默认值:16

去噪采样步数,默认 16。取值范围 1 到 16。

必填范围: 1 <= x <= 16
webhook_url
string

异步回调地址。初始响应会返回 jobId;可以通过该回调地址或 Flux 查询接口 获取最终图像结果。

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

data
object
必填
示例:
最后修改于 2026年10月16日