接入 TokenHub,几行代码调用全球AI大模型
TokenHub API 兼容 OpenAI 接口格式,只需三步即可开始调用:
登录控制台,进入「API密钥」页面,点击「创建密钥」即可生成。密钥格式为 sk-th-xxxxxxxx。
# 使用 curl 调用 GPT-4o
curl https://api.tokenhub.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-th-xxxx" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "你好,介绍一下你自己"}
]
}'
TokenHub API 使用 Bearer Token 进行鉴权。在每次请求的 Header 中添加 Authorization 字段即可。
Authorization: Bearer sk-th-xxxxxxxxxxxxxxxx
创建一个聊天补全请求,模型将根据对话上下文生成回复。
请求地址: POST https://api.tokenhub.com/v1/chat/completions
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型ID,如 gpt-4o、claude-3.5-sonnet |
| messages | array | 是 | 对话消息数组 |
| temperature | float | 否 | 温度参数,0-2,默认0.7 |
| max_tokens | int | 否 | 最大生成Token数,默认1024 |
| stream | bool | 否 | 是否流式输出,默认false |
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"model": "gpt-4o",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!我是AI助手..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 45,
"total_tokens": 57
}
}
获取平台支持的所有模型列表。
请求地址: GET https://api.tokenhub.com/v1/models
不同模型支持的参数可能有所不同,以下是通用参数说明:
| 参数 | 范围 | 说明 |
|---|---|---|
| temperature | 0 - 2 | 值越高输出越随机,值越低越确定 |
| top_p | 0 - 1 | 核采样,与temperature二选一 |
| max_tokens | 1 - 128000 | 限制生成Token数量 |
| stream | true/false | 流式输出,适合实时场景 |
| stop | string/array | 停止词,遇到则停止生成 |
| 状态码 | 说明 | 处理方式 |
|---|---|---|
| 200 | 成功 | — |
| 400 | 请求参数错误 | 检查请求体格式 |
| 401 | 鉴权失败 | 检查API Key是否正确 |
| 402 | 余额不足 | 请充值后重试 |
| 429 | 请求频率超限 | 降低调用频率或升级套餐 |
| 500 | 服务器错误 | 稍后重试或联系客服 |
TokenHub 提供多语言 SDK,安装后即可使用:
pip install tokenhub