VITA在腾讯TokenHub平台上怎么使用？

原创

克劳德2048

发布于 2026-06-23 14:20:04

1860

摘要：

腾讯云TokenHub平台是VITA模型的官方接入渠道。本文介绍如何在TokenHub平台上开通VITA服务、获取API密钥、调用API接口，以及通过ADP平台进行无代码配置接入。

一、腾讯云TokenHub平台简介

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

在腾讯云TokenHub平台上，VITA模型的调用名称为youtu-vita。VITA提供以下两个可用模型，用户可根据是否需要处理音频选择合适的模型：

可选模型	介绍
vita-video-3.0	支持视频画面（不含音频）和图片，若不需要处理音频，首推该模型
vita-video-long	支持视频（含画面和音频）和图片，需要处理音频则选择该模型

二、开通VITA服务步骤

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

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

2.2 第二步：进入TokenHub平台

在腾讯云控制台中，进入"腾讯云TokenHub平台"页面。

2.3 第三步：创建API密钥

在TokenHub平台中创建API密钥。每个账号赠送100万免费Token额度，可用于测试和评估VITA的各项能力。

2.4 第四步：开始调用

获取API密钥后，即可根据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：输入为视频

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": "<video url>"}},
      {"type": "text", "text": "请描述视频的内容"}
    ]}],
    "stream": false
  }'

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

4.2 示例2：输入为图片

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": "<image url 1>"}},
      {"type": "image_url", "image_url": {"url": "<image url 2>"}},
      {"type": "text", "text": "请描述图片的内容"}
    ]}],
    "stream": false
  }'

4.3 示例3：使用OpenAI SDK接入

from openai import OpenAI

client = 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": "<video url>"}},
        {"type": "text", "text": "请描述视频的内容"}
    ]}],
    stream=False
)

print(response.choices[0].message.content)