文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>大模型服务平台 TokenHub>调用指南>视频生成

视频生成

最近更新时间：2026-04-03 17:20:21

我的收藏

本页目录：

概述

腾讯混元生视频（Tencent HY Video），是一款提供视频生成和视频处理能力的 API 技术服务。该服务基于腾讯视频生成大模型等一系列领先的音视频 AI 技术，支持高质量地生成或处理视频内容。既能帮助专业视频创作者降低制作成本、发现视频创意，又能提升视频社交娱乐的趣味性。可广泛应用于短视频平台、影视制作、广告营销、社交媒体、游戏等领域。

产品功能

文/图生视频

支持文本和图片输入生成动态连贯性高的高清视频，可实现场景切换，简化制作流程、降低成本，应用于高要求的广告、影视片段与产品展示视频场景。

视频特效

通过上传图片和选择特效模板，生成一段特效视频，将静态图像转化为充满活力、动感、有趣的视频画面。

人像驱动

单张参考照片即可驱动生成动态人像视频，精准还原表情、姿态，支持写实、二次元等多风格切换。

立即使用

TokenHub 采用标准 OpenAI Chat Completions API 协议，您可以直接使用 OpenAI SDK 或任何兼容客户端接入。您可以调用 API 对生视频模型进行操作，具体使用方式详见对应接口文档。

接口概览

模型
接口名称
接口文档
接口功能
HY-Video-1.5
混元生视频接口，基于混元大模型，根据输入的文本或图片智能生成视频。
YT-Video-2.0
图生视频通用能力接口。
YT-Video-FX
通过上传图片和选择特效模板，生成一段特效视频。
特效模板详情请参见 视频特效模板列表。
YT-Video-HumanActor
支持提交音频和图文来生成对应视频，满足动态交互、内容生产等场景需求。

OpenAI 兼容接口调用示例

HY-Video-1.5

提交混元生视频任务
混元生视频 API 兼容了 OpenAI 的接口规范，这意味着您可以在 OpenAI 协议中使用 cURL 来调用混元生视频大模型。您仅需要将 base_url 和 YOUR_API_KEY 替换成混元的相关配置，即可将您的应用切换到混元生视频。
base_url：https://tokenhub.tencentmaas.com/v1/api/video/submit。
请求示例代码如下，其中：请求的具体参数与 提交混元生视频任务 一致，但参数统一以小写驼峰形式呈现，例如 LogoAdd 需要写为 logo_add。
cURL
curl --location 'https://tokenhub.tencentmaas.com/v1/api/video/submit' \\
--header 'Authorization: Bearer YOUR_API_KEY' \\
--header 'Content-Type: application/json' \\
--data '{
    "model": "hy-video-1.5",
    "prompt": "小河流水"
}'
响应示例代码如下：
cURL

{ 
    "id": "143*************128",
    "request_id": "d5******-****-****-****-********c506",
    "object": "video",
    "created_at": 1775196710,
    "status": "queued"
}

查询混元生视频任务
将 base_url 和 YOUR_API_KEY 替换成混元的相关配置，即可获得混元生视频的生成结果。其中：id 为提交混元生视频任务时响应代码中的 id。
base_url：https://tokenhub.tencentmaas.com/v1/api/video/query
请求示例代码如下，其中：请求的具体参数与 查询混元生视频任务 一致，但参数统一以小写驼峰形式呈现，例如 LogoAdd 需要写为 logo_add。
请求示例代码：
cURL

curl --location 'https://tokenhub.tencentmaas.com/v1/api/video/query' \\
--header 'Authorization: Bearer YOUR_API_KEY' \\
--header 'Content-Type: application/json' \\
--data '{
    "model": "hy-video-1.5",
    "id": "1429*****0"
}'
返回响应示例代码：
cURL

{
    "request_id": "bb*******93",
    "object": "video",
    "created_at": 1774807628,
    "completed_at": 1774807628,
    "status": "completed",
    "progress": 100,
    "data": {
        "url": "https://vc*******e6a6"
    }
}


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/submit。
请求示例代码如下，其中，请求的具体参数与原接口一致（YT-Video-2.0为 图生视频接口，YT-Video-FX 为 视频特效接口，YT-Video-HumanActor 为 人像驱动接口），但参数统一以小写驼峰形式呈现，例如 LogoAdd 需要写为 logo_add。
以下以 YT-Video-2.0模型为例（注：image 可以为任意可访问的图片地址）：
cURL
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"}
}'
响应示例代码如下：
cURL

{
    "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/query
请求示例代码如下，其中：请求的具体参数与原接口一致（YT-Video-2.0为 查询图生视频通用能力任务，YT-Video-FX 为 查询视频特效任务，YT-Video-HumanActor 为 查询人像驱动任务），但参数统一以小写驼峰形式呈现，例如 LogoAdd 需要写为 logo_add。
以下以 YT-Video-2.0模型为例：
cURL

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"
}'
返回响应示例代码：
cURL

{
    "request_id": "bb*******93",
    "object": "video",
    "created_at": 1774807628,
    "completed_at": 1774807628,
    "status": "completed",
    "progress": 100,
    "data": {
        "url": "https://vc*******e6a6"
    }
}


中国站