VITA在腾讯TokenHub平台使用教程

来源：互联网 2026-06-24 06:28:00

腾讯云TokenHub平台提供VITA模型服务，支持vita-video-3.0（不含音频）和vita-video-long（含音频）。用户可创建API密钥获得100万免费Token，通过兼容OpenAI协议的接口或ADP平台无代码接入，调用时需指定模型名称和消息结构，支持视频、图片和文本输入。

摘要：

腾讯云TokenHub平台是VITA模型的官方接入渠道。以下内容将详细说明如何在TokenHub平台上开通VITA服务、获取API密钥、调用API接口，以及通过ADP平台进行无代码配置接入。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

一、腾讯云TokenHub平台简介

腾讯云TokenHub平台是腾讯云提供的模型服务平台。用户可在该平台开通VITA多模态理解模型服务、获取API密钥，并通过兼容OpenAI API协议的接口直接调用。

在TokenHub平台上，VITA模型的调用名称为youtu-vita。目前提供两个可用模型，选择取决于场景是否需要处理音频：

可选模型	介绍
vita-video-3.0	支持视频画面（不含音频）和图片。若无需处理音频，推荐使用此模型。
vita-video-long	支持视频（含画面和音频）和图片。需要处理音频时，必须选择此模型。

二、开通VITA服务步骤

2.1 第一步：登录腾讯云控制台

访问腾讯云官网，登录您的腾讯云控制台。

2.2 第二步：进入TokenHub平台

在控制台中，找到并进入“腾讯云TokenHub平台”页面。

2.3 第三步：创建API密钥

进入平台后，创建一个API密钥。每个账号将获赠100万免费Token额度，足以用于测试和评估VITA的各项能力。

2.4 第四步：开始调用

获取密钥后，可参照API接入文档进行接口调用。VITA API兼容OpenAI API协议，可直接使用OpenAI SDK接入。

三、API接入说明

3.1 接口基础信息

配置过程较为简单，核心参数如下：

接口协议：兼容OpenAI Completions API协议
BaseURL：https://tokenhub.tencentmaas.com/v1
接口路径：/chat/completions
请求方式：POST
调用方式：支持流式或非流式，根据需求选择
授权方式：Bearer Token

3.2 请求参数说明

参数名	必选	类型	描述
model	是	String	模型名称，可选值：`vita-video-3.0`、`vita-video-long`。在TokenHub平台上也可使用`youtu-vita`，两者等价。
messages	是	Array	需要理解的内容。
stream	否	Boolean	是否启用流式输出，取值范围`true / false`，默认`false`。
temperature	否	Float	输出随机性，取值范围`[0.0, 2.0]`。
top_p	否	Float	输出多样性（核采样），取值范围`[0.0, 1.0]`。
max_tokens	否	Integer	限制最大输出Token数。
stop	否	Array of String	指定输出停止序列，最多4个。

3.3 messages参数结构

messages是一个数组，每个元素包含role和content字段：

字段	必选	类型	描述
role	是	String	角色，固定为`user`（用户）。
content	是	Array	需要理解的内容。

而content本身也是一个数组，每个元素包含type字段和对应的内容字段：

字段	必选	类型	描述
type	是	String	输入类型，可选值：`text`（文本指令）、`image_url`（图片）、`video_url`（视频）。
text	是	String	自定义的理解指令。
image_url	否	Object	需要理解的图片信息。
video_url	否	Object	需要理解的视频信息。

四、调用示例

4.1 示例1：输入为视频

代码语言：bash

复制

curl -X POST 'https://tokenhub.tencentmaas.com/v1/chat/completions' -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "vita-video-long","messages": [{"role": "user", "content": [{"type": "video_url", "video_url": {"url": "

如果视频不含音频，建议使用vita-video-3.0模型。

4.2 示例2：输入为图片

代码语言：bash

复制

curl -X POST 'https://tokenhub.tencentmaas.com/v1/chat/completions' -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "vita-video-3.0","messages": [{"role": "user", "content": [{"type": "image_url", "image_url": {"url": ""}},{"type": "image_url", "image_url": {"url": ""}},{"type": "text", "text": "请描述图片的内容"}]}],"stream": false}'

4.3 示例3：使用OpenAI SDK接入

代码语言：python

复制

from openai import OpenAIclient = OpenAI(api_key="YOUR_API_KEY",base_url="https://tokenhub.tencentmaas.com/v1")response = client.chat.completions.create(model="vita-video-long",messages=[{"role": "user", "content": [{"type": "video_url", "video_url": {"url": "