Skip to main content
POST
生成视频
根据文本提示生成视频。这是一个异步端点——它会立即返回一个任务 ID(HTTP 202),视频将在后台生成。
视频生成是异步的。请使用 获取任务状态 轮询任务状态,或在 SDK 中使用 theo.waitForJob()。
AI 披露水印。 由 Theo 返回的每个视频右下角都带有一个小型半透明的 Theo 徽标。这是一个溯源标识,用于标明该片段为 AI 生成,并且始终会被应用(无论品牌偏好设置如何)。每个片段预计会因重新编码而增加 2-15 秒的延迟。

身份验证

需要 Bearer 令牌。参见 身份验证。

请求体

string
必填
要生成的视频的文本描述。
string
目标视频时长(例如 "5s"、"10s"、"15s")。
string
视觉风格(例如 "cinematic"、"animation"、"timelapse")。

请求示例

响应(HTTP 202)

string
唯一的视频请求 ID(以 vid_ 为前缀)。
string
用于轮询状态的任务 ID。
string
创建时始终为 "queued"。
string
ISO 8601 时间戳。
string
用于轮询任务状态的相对 URL(例如 /api/v1/jobs/{job_id})。

响应示例

轮询结果

使用 获取任务状态 端点检查进度。当 status 为 "completed" 时,result 字段将包含视频 URL。

错误