Skip to main content
POST
cURL

授权

TT-API-KEY
string
header
必填

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

请求体

application/json
prompt
string
必填

用于描述视频内容的自由格式提示词。

mode
string
默认值:t2v
必填

允许的值:"t2v"

aspect_ratio
enum<string>
默认值:auto

输出视频的宽高比。auto 表示根据提示词以及输入的参考内容自动选择。

可用选项:
auto,
21:9,
2:1,
16:9,
4:3,
1:1,
3:4,
9:16
duration
默认值:auto

视频时长,单位为秒。支持 5 到 20 秒之间的任意整数,也可以设置为 auto 以根据内容自动确定时长。

必填范围: 5 <= x <= 20
resolution
enum<string>
默认值:hd

视频分辨率级别:hd,或 fhd(由视频超分辨率处理器完成更高分辨率的输出)。具体尺寸会根据宽高比有所不同。

可用选项:
hd,
fhd
version
enum<string>

接口版本。latest 表示使用当前版本。

可用选项:
latest
示例:

"latest"

generate_audio
boolean
默认值:true

是否在生成视频的同时生成与视频同步的音频。

safety_tolerance
integer
默认值:2

输入和输出内容安全审核的容忍度等级。取值范围为 0 到 4,其中 0 最严格。无论请求的容忍度设置为何,色情内容最高允许等级为 3,仇恨内容最高允许等级为 2。系统可能会根据上下文安全信号进一步收紧所请求的等级。

必填范围: 0 <= x <= 4
draft
boolean
默认值:false

草稿模式:快速生成预览,并在结果中返回一个 draft_cache 下载 URL。下载该缓存包后,可以在之后的请求中将其传回,以生成相同内容的完整质量版本。

webhook_url
string

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

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

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