Skip to main content
POST
cURL
视频生成是异步任务。提交成功后会返回 jobId,请通过 视频结果查询 API 获取结果。

授权

TT-API-KEY
string
header
必填

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

请求体

application/json
prompt
string
必填

视频提示词

示例:

"A cinematic shot of a futuristic city at sunset"

model
enum<string>
默认值:omni-flash
必填

视频模型

可用选项:
veo-3.1-fast,
veo-3.1-quality,
veo-3.1-lite,
omni-flash
aspect_ratio
enum<string>
必填

视频宽高比,必填。

可用选项:
16:9,
9:16
示例:

"16:9"

resolution
enum<string>

分辨率

可用选项:
720p,
1080p
示例:

"720p"

duration
enum<string>

视频时长(秒)。Veo 3.1 系列(veo-3.1-fastveo-3.1-qualityveo-3.1-lite)仅支持 8

可用选项:
4,
6,
8,
10
示例:

"8"

generation_type
enum<string>

视频生成类型。frame:帧转视频;reference:参考图生视频。不传时根据参考图数量自动判断:2 张为帧转视频,3 张为参考图生视频。

可用选项:
frame,
reference
示例:

"frame"

reference_images
string[]

参考图,最多 3 张。每项为 http(s):// URL,支持 JPEG / PNG。

Maximum array length: 3
示例:
reference_videos
string[]

参考 / 待编辑视频,最多 1 个(不支持多视频引用)。每项为 http(s):// URL。当前仅 omni-flash 模型可用。

Maximum array length: 1
示例:
hookUrl
string

任务完成或失败后的回调通知地址

示例:

"https://example.com/callback"

响应

提交成功

status
string
必填

任务状态

示例:

"SUCCESS"

message
string
必填

任务消息

示例:

"success"

data
object
必填
最后修改于 2026年6月5日