概述
腾讯优图生视频，是一款提供视频生成和视频处理能力的 API 技术服务。该服务基于腾讯视频生成大模型等一系列领先的音视频 AI 技术，支持高质量地生成或处理视频内容。既能帮助专业视频创作者降低制作成本、发现视频创意，又能提升视频社交娱乐的趣味性。可广泛应用于短视频平台、影视制作、广告营销、社交媒体、游戏等领域。
产品功能
文/图生视频
支持文本和图片输入生成动态连贯性高的高清视频，可实现场景切换，简化制作流程、降低成本，应用于高要求的广告、影视片段与产品展示视频场景。
视频特效
通过上传图片和选择特效模板，生成一段特效视频，将静态图像转化为充满活力、动感、有趣的视频画面。
人像驱动
单张参考照片即可驱动生成动态人像视频，精准还原表情、姿态，支持写实、二次元等多风格切换。
立即使用
大模型服务平台 TokenHub 采用标准 OpenAI Chat Completions API 协议，您可以直接使用 OpenAI SDK 或任何兼容客户端接入。您可以调用 API 对生视频模型进行操作，具体使用方式详见对应接口文档。
接口概览
模型 | 接口名称 | 接口文档 | 接口功能 |
YT-Video-2.0 | SubmitImageToVideoGeneralJob | 图生视频通用能力接口。 | |
| DescribeImageToVideoGeneralJob | | |
YT-Video-FX | SubmitTemplateToVideoJob | ||
| DescribeTemplateToVideoJob | | |
YT-Video-HumanActor | SubmitHumanActorJob | 支持提交音频和图文来生成对应视频，满足动态交互、内容生产等场景需求。 | |
| DescribeHumanActorJob | | |
OpenAI 兼容接口调用示例
YT-Video-2.0/YT-Video-FX/YT-Video-HumanActor
提交优图生视频任务
优图生视频系列模型 API 兼容了 OpenAI 的接口规范，这意味着您可以在 OpenAI 协议中使用 cURL 来调用优图生视频模型。您仅需要将 base_url 和 YOUR_API_KEY 替换成相关配置，即可将您的应用切换到优图生视频。
base_url：
https://tokenhub.tencentmaas.com/v1/api/video/submitAPI Key：可去 API Key 管理 页创建、获取。
请求示例代码如下，其中，请求的具体参数与原接口一致（YT-Video-2.0为 图生视频接口，YT-Video-FX 为 视频特效接口，YT-Video-HumanActor 为 人像驱动接口），但参数统一以小写下划线形式呈现，例如
LogoAdd 需要写为 logo_add。以下以 YT-Video-2.0模型为例（注：image 可以为任意可访问的图片地址）：
curl --location 'https://tokenhub.tencentmaas.com/v1/api/video/submit' \\--header 'Authorization: Bearer YOUR_API_KEY' \\--header 'Content-Type: application/json' \\--data '{"model": "yt-video-2.0","image": {"url":"https://obj1-******.jpeg"}}'
响应示例代码如下：
{"id": "*************143680","request_id": "d0e*****a05","object": "video","created_at": 1774808129,"status": "queued"}
查询优图生视频任务
将 base_url 和 YOUR_API_KEY 替换成相关配置，即可获得优图生视频的生成结果。其中：id 为提交 YT-Video-2.0任务时响应代码中的 id。
base_url：
https://tokenhub.tencentmaas.com/v1/api/video/queryAPI Key：可去 API Key 管理 页创建、获取。
请求示例代码如下，其中：请求的具体参数与原接口一致（YT-Video-2.0为 查询图生视频通用能力任务，YT-Video-FX 为 查询视频特效任务，YT-Video-HumanActor 为 查询人像驱动任务），但参数统一以小写下划线形式呈现，例如
LogoAdd 需要写为 logo_add。以下以 YT-Video-2.0模型为例：
curl --location 'https://tokenhub.tencentmaas.com/v1/api/video/query' \\--header 'Authorization: Bearer YOUR_API_KEY' \\--header 'Content-Type: application/json' \\--data '{"model": "yt-video-2.0","id": "1429*****0"}'
返回响应示例代码：
{"request_id": "bb*******93","object": "video","created_at": 1774807628,"completed_at": 1774807628,"status": "completed","progress": 100,"data": {"url": "https://vc*******e6a6"}}
