兼容OpenAI协议，TokenHub接入全攻略

TokenHub 的 API 接口设计非常友好，它兼容 OpenAI API 协议。这意味着如果你之前使用过 OpenAI 的服务，或者手头有基于 OpenAI SDK 开发的代码，几乎不需要修改代码，只需要替换 Base URL 和 API Key 即可直接使用。

以下是调用 TokenHub API 接口的完整实操步骤：

第一步：准备工作（获取凭证）

在写代码之前，你需要先在腾讯云控制台获取调用的“钥匙”。

登录控制台：登录腾讯云 TokenHub 控制台。
创建 API Key：
- 进入左侧菜单的「API 密钥管理」。
- 点击「创建 API Key」，设置名称和访问范围（通常选全选）。
- 重要：创建成功后，务必复制并保存好 SecretId 和 SecretKey（或者直接生成的 Bearer Token），这相当于你的密码，泄露会有安全风险。
确认模型名称：在「模型广场」或「模型列表」中查看你想调用的模型对应的 model 参数值（例如 deepseek-v3.2、glm-5、kimi-k2.6 等）。
第二步：核心参数配置

调用 API 时，你需要关注以下三个核心要素：
配置项说明示例/备注
Base URL 接口地址境内：https://tokenhub.tencentmaas.com/v1境外：https://tokenhub-intl.tencentmaas.com/v1
API Key 鉴权凭证在 Header 中填写 Authorization: Bearer YOUR_API_KEY
Model 模型标识如 deepseek-v3.2、hy-image-v3.0 等，需严格对应

第三步：代码调用示例

这里提供两种最常用的调用方式：cURL（命令行）和 Python（SDK）。

1. 使用 cURL 调用（文本生成）

以调用 DeepSeek-V3.2 模型为例：

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.2",
    "messages": [
      {"role": "user", "content": "你好，请介绍一下TokenHub"}
    ],
    "stream": true
  }'

2. 使用 Python SDK 调用

由于兼容 OpenAI 协议，你可以直接安装 openai 库来使用：

from openai import OpenAI

初始化客户端，指向 TokenHub 的地址

client = OpenAI(
    api_key="YOUR_API_KEY",  # 替换为你的 TokenHub API Key
    base_url="https://tokenhub.tencentmaas.com/v1"
)

发起对话

response = client.chat.completions.create(
    model="glm-5",  # 替换为你想用的模型，如 kimi-k2.6
    messages=[
        {"role": "user", "content": "帮我写一个Python快速排序代码"}
    ]
)

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

第四步：进阶功能（图像与 3D 生成）

除了文本对话，TokenHub 还支持图像和 3D 生成，但接口路径略有不同：

图像生成 (混元生图)：
- 极速版：POST /v1/api/image/lite
- 专业版 (3.0)：POST /v1/api/image/submit（提交任务） -> 需要轮询查询任务状态。
3D 生成 (混元生3D)：
- 极速版：POST /v1/api/3d/submit
- 专业版：同样采用“提交任务 -> 查询结果”的异步模式。
  第五步：IDE 工具集成（推荐开发者使用）

如果你是在 VS Code、Cursor 或 Claude Code 等工具中使用，可以直接在插件设置中选择“自定义模型”：