这篇会为你介绍如何在大模型服务平台 TokenHub 完成你的首次 API 调用。
一、准备工作
在使用腾讯云大模型服务平台 TokenHub 之前，你需要 注册腾讯云 并完成 实名认证。
二、步骤一：登录大模型服务平台 TokenHub 控制台
登录 腾讯云大模型服务平台 TokenHub 控制台，按照界面提示开通大模型服务平台 TokenHub 后，你可以在模型广场浏览选择模型，详细模型信息可参见 模型列表。
三、步骤二：领取免费体验包
平台为新用户提供一定额度的免费体验额度，让你零成本试用模型。各模型免费体验额度信息可参见 新人免费体验包，具体免费额度及有效期请以控制台显示为准。
四、领取方式
1. 进入 模型广场 页面，单击右上角的新用户福利免费体验。
2. 在弹窗中勾选模型后，单击立即领取，即可获得多个模型的免费使用额度。
五、步骤三：创建 API Key
在调用模型 API 之前，你需要先创建 API Key 作为鉴权凭证。
1. 进入 API Key 管理 页面。
2. 在页面上方选择地域后，单击创建 API Key。
3. 在创建 API Key 对话框填写 Key 名称，并设置额度限制及可访问范围：
·额度限制：开启后，该 API Key 的 token 用量达到配额上限将停止服务，用量统计不区分模型与推理服务接入点（免费包不计算入内）。
·全选：可访问当前账号下所有模型和推理服务。
·限定范围：指定当前账号下可访问的模型和/或推理服务，实现访问范围控制。
4. 单击确定，完成创建。
创建完成后，请你务必复制并妥善保管 API Key，在后续调用 API 流程中将会使用该信息。更多 API Key 管理信息，请参见 API Key 管理。
六、通过 API 调用模型
大模型服务平台 TokenHub 兼容 OpenAI API 协议，你可以使用熟悉的 SDK 和工具直接接入。API 调用详情请参见 调用指南。
注意：说明：
CURLPythonNodeJSJavaGo# 请将 YOUR_API_KEY 替换为你在前面步骤创建的 API KEY# 请在 model 字段中更换你需要体验的模型名称curl -X POST 'https://tokenhub.tencentmaas.com/v1/chat/completions' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "deepseek-v3", "messages": [{"role": "user", "content": "你好"}], "stream": true }'from openai import OpenAIclient = OpenAI(# 请将 YOUR_API_KEY 替换为你在前面步骤创建的 API KEY api_key="YOUR_API_KEY", base_url="https://tokenhub.tencentmaas.com/v1")response = client.chat.completions.create(# 请在 model 字段中更换你需要体验的模型名称 model="deepseek-v3", 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.tencentmaas.com/v1',});async function main() { const response = await client.chat.completions.create({// 请在 model 字段中更换你需要体验的模型名称 model: 'deepseek-v3', 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", "messages": [{"role": "user", "content": "你好"}] } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://tokenhub.tencentmaas.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 mainimport ( "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", "messages": []map[string]string{ {"role": "user", "content": "你好"}, }, } jsonBody, _ := json.Marshal(body) req, _ := http.NewRequest("POST", "https://tokenhub.tencentmaas.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))}
七、通过命令行工具调用
你也可以使用 TokenHub 命令行工具（thcli），在终端一条命令完成模型调用，无需编写代码：
npm i -g tencent-tokenhub-clithcli auth loginthcli +chat –model <模型 Id> "你好"
注意：说明：
注意：除对话调用外，thcli 还支持查模型、管 API Key、看用量、排障等操作，详情请参见 TokenHub CLI 使用指南。
八、通过 AI 工具调用模型
详情参考：
·在 Claude Code 中调用
·在 Cursor 中调用
·在 OpenClaw 中调用
·在 Hermes Agent 中调用
·在 WorkBuddy 中调用
·在 CodeBuddy Code 中调用
·在 OpenCode 中调用
·在 Cline 中调用
·在 Kilo Code 中调用
·在 Roo Code 中调用
九、下一步
·你可以前往体验中心，在线体验模型能力，详情请参见 体验中心。
·你可以前往开通管理，快速批量开启模型按量付费，详情请参见开通管理。
·你可以前往在线推理，管理正在使用的模型服务，详情请参见 在线推理。
·如果你需要查看模型用量，请参见 用量统计。