搜索到
1
篇与
TokenHub
的结果
-
兼容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/v1API Key 鉴权凭证 在 Header 中填写 Authorization: Bearer YOUR_API_KEYModel 模型标识 如 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 等工具中使用，可以直接在插件设置中选择“自定义模型”：Provider: 选择 OpenAI 兼容 / CustomBase URL: https://tokenhub.tencentmaas.com/v1API Key: 填入你的 KeyModel Name: 手动输入如 glm-5💡 避坑小贴士地域选择：如果你在中国大陆，请务必使用境内域名 (tencentmaas.com)，否则可能会遇到连接超时。额度检查：调用前请确认账号内有余额或免费额度，且已开启对应模型的“后付费”或“服务实例”。参数格式：调用图像或 3D 接口时，注意参数名通常需要使用小写驼峰格式（如 result_format 而不是 ResultFormat）。
