tencent cloud

快速入门

Download
聚焦模式
字号
最后更新时间: 2026-04-22 10:56:25
本文将为您介绍如何在大模型服务平台 TokenHub 完成您的首次 API 调用。

准备工作

在使用腾讯云大模型服务平台 TokenHub 之前,您需要 注册腾讯云 并完成 实名认证

操作步骤

步骤一:登录大模型服务平台 TokenHub 控制台

登录 TokenHub 控制台,按照界面提示开通大模型服务平台 TokenHub 后,您可以在模型广场浏览选择模型,详细模型信息可参见 模型列表


步骤二:开启指定模型后付费

TokenHub 中模型支持按量付费,对于您期望使用的模型,请在在线推理服务列表中,找到对应的模型,启用后付费。


步骤三:创建 API Key

在调用模型 API 之前,您需要先创建 API Key 作为鉴权凭证。
1. 进入 API Key 管理 页面。
2. 在页面上方选择地域后,单击创建 API Key。
3. 创建 API Key 对话框填写 Key 名称,并设置可访问范围
全选:可访问当前账号下所有模型和推理服务。
限定范围:您可以在可访问范围区域左、右两侧勾选可访问的模型和推理服务,实现访问范围控制。
4. 单击确定,完成创建。
创建完成后,请您务必复制并妥善保管 API Key,在后续调用 API 流程中将会使用该信息。更多 API Key 管理信息,请参见 API Key 管理


步骤四:通过 API 调用模型

大模型服务平台 TokenHub 兼容 OpenAI API 协议,您可以使用熟悉的 SDK 和工具直接接入。API 调用详情请参见 调用指南
说明:
请您将示例代码中的 YOUR_API_KEY 替换为您真实的 API KEY。
示例代码为调用新加坡地域模型,修改 model 字段,更换您需要调用的模型,各模型对应 model 值可参见 模型列表 中的 model(调用参数)
CURL
Python
NodeJS
Java
Go
# 请将 YOUR_API_KEY 替换为您在前面步骤创建的 API KEY
# 请在 model 字段中更换您需要体验的模型名称
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions' \\
-H 'Authorization: Bearer YOUR_API_KEY' \\
-H 'Content-Type: application/json' \\
-d '{
"model": "deepseek-v3.2",
"messages": [{"role": "user", "content": "你好"}],
"stream": true
}'
from openai import OpenAI

client = OpenAI(
# 请将 YOUR_API_KEY 替换为您在前面步骤创建的 API KEY
api_key="YOUR_API_KEY",
base_url="https://tokenhub-intl.tencentcloudmaas.com/v1"
)

response = client.chat.completions.create(
# 请在 model 字段中更换您需要体验的模型名称
model="deepseek-v3.2",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "你好,请介绍一下你自己"}
]
)
print(response.choices[0].message.content)
import OpenAI from 'openai';


const client = new OpenAI({
// 请将 YOUR_API_KEY 替换为您在前面步骤创建的 API KEY
apiKey: 'YOUR_API_KEY',
baseURL: 'https://tokenhub-intl.tencentcloudmaas.com/v1',
});


async function main() {
const response = await client.chat.completions.create({
// 请在 model 字段中更换您需要体验的模型名称
model: 'deepseek-v3.2',
messages: [
{ role: 'system', content: 'You are a helpful assistant.' },
{ role: 'user', content: '你好,请介绍一下你自己' },
],
});
console.log(response.choices[0].message.content);
}


main();
import java.net.http.*;
import java.net.URI;


public class MaaSExample {
public static void main(String[] args) throws Exception {
// 请将 YOUR_API_KEY 替换为您在前面步骤创建的 API KEY
String apiKey = "YOUR_API_KEY";
// 请在 model 字段中更换您需要体验的模型名称
String body = """
{
"model": "deepseek-v3.2",
"messages": [{"role": "user", "content": "你好"}]
}
""";


HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions"))
.header("Authorization", "Bearer " + apiKey)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();


HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request,
HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main

import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)

func main() {
// 请将 YOUR_API_KEY 替换为您在前面步骤创建的 API KEY
apiKey := "YOUR_API_KEY"
body := map[string]interface{}{
// 请在 model 字段中更换您需要体验的模型名称
"model": "deepseek-v3.2",
"messages": []map[string]string{
{"role": "user", "content": "你好"},
},
}

jsonBody, _ := json.Marshal(body)
req, _ := http.NewRequest("POST",
"https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions",
bytes.NewBuffer(jsonBody))
req.Header.Set("Authorization", "Bearer "+apiKey)
req.Header.Set("Content-Type", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()

result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}

下一步

您可以前往体验中心,在线体验模型能力,详情请参见 体验中心
您可以前往在线推理,管理正在使用的模型服务,详情请参见 在线推理
如果您需要查看模型用量,请参见 用量统计


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈