快速开始
TokenHub API 概述、服务地址与认证方式
Token Hub 提供统一的 AI 能力接口，包括：
- LLM 聊天补全（Chat Completions）— 完全兼容 OpenAI 格式，可直接使用 OpenAI 官方 SDK（Python / Node.js / Go 等）
- 集成服务（图片生成、视频生成、语音合成、语音识别、网络搜索等）
申请到 API Key 后，按照本文档即可快速接入。LLM 接口只需修改 base_url 和 api_key，集成服务通过 REST API 调用。
服务地址与凭据
Base URL
| 环境 | Base URL |
|---|---|
| 正式环境 | https://tokenhub.piegateway.me |
凭据字段说明
通过 TokenHub Bot 申请后，你将获得以下凭据：
| 字段 | 说明 |
|---|---|
apiKey | API 密钥（以 sk- 开头），日常调用唯一需要的凭据 |
appId | 应用唯一标识（HMAC 签名认证时使用） |
appSecret | 应用密钥（HMAC 签名认证时使用） |
推荐使用 apiKey。
appId和appSecret仅用于 HMAC 签名认证（自研应用服务端集成场景）。
认证方式
API Key（推荐）
在请求头中添加以下任一方式：
X-API-Key Header（推荐）：
X-API-Key: <your-api-key>Authorization Header：
Authorization: Bearer <your-api-key>HMAC-SHA256 签名认证
适用于自研应用的服务端集成，安全性更高。详见「HMAC-SHA256 签名认证」文档。