API 文档 / Trellis 视频生成（Wan TI2V）

API 文档 · Trellis 视频生成（Wan TI2V）

模型 ID：trellis-wan-ti2v

接口

POST /v1/videosapplication/json提交生成任务（mode=t2v/i2v）

GET /v1/jobs/{id}查询任务状态与结果

POST /v1/jobs/{id}/cancel取消任务（canceling → canceled；不计费）

调用方式

异步（仅支持）：POST 提交返回 {id, status}；轮询 GET /v1/jobs/{id}（间隔 3–5s）。

请求参数：

参数	类型	必填	默认	说明
`mode`	string	否	t2v	t2v \| i2v
`prompt`	string	是	—	提示词
`negative_prompt`	string	否	""	反向提示词
`height`	integer	否	480	分辨率高
`width`	integer	否	832	分辨率宽
`num_frames`	integer	否	49	帧数，须为 4n+1；决定耗时
`num_inference_steps`	integer	否	30	步数
`guidance_scale`	number	否	5.0	引导强度
`seed`	integer	否	0	随机种子
`fps`	integer	否	16	帧率；时长 = num_frames/fps，不影响耗时
`image`	string	i2v 必填	—	首帧图：可下载 http(s) URL 或 data-uri(base64)，非上传
`qc`	boolean	否	false	是否质检（qc=true 时结果内回显 qc 指标；不额外收费）

响应示例：

# 提交
{ "id": "<job>", "status": "queued" }

# 查询
{ "id": "<job>", "status": "completed",
  "url": "/v1/files/video/<job>.mp4",
  "usage": { "frames": 49, "seconds": 3.06, "fps": 16, "working_set": "draft" } }

所有模型共用同一 API Key 与同一端点：https://api.trellis.hk/v1