Docs on Chanson Hub - AI 模型聚合枢纽

快速开始

Mon, 01 Jan 0001 00:00:00 +0000

Chanson Hub 文档#

平台概述#

Chanson Hub 是新一代 AI 模型聚合网关，聚合 50+ 全球顶尖大语言模型，提供统一 API 接入。平台特性：

统一 API — 一个端点调用所有模型，完全兼容 OpenAI 格式
智能路由 — 自动故障切换与负载均衡
实时监控 — 用量追踪与成本分析
企业安全 — 全链路 TLS 加密，API Key 认证，IP 白名单

快速开始#

1. 注册账号#

访问 API 控制台创建账号。

2. 获取 API Key#

进入「令牌管理」页面，创建新的 API 令牌。

3. 发起第一个请求#

curl https://api.hub.chansontechgroup.com/v1/chat/completions \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer YOUR_API_KEY" \
 -d '{
 "model": "deepseek-chat",
 "messages": [{"role": "user", "content": "你好"}]
 }'

4. 集成到你的应用#

将 OpenAI Base URL 替换为 https://api.hub.chansontechgroup.com 即可：

错误码

Mon, 01 Jan 0001 00:00:00 +0000

API 错误码#

HTTP 状态码#

状态码	含义	处理方式
200	请求成功	无需处理
400	请求参数错误	检查请求体格式
401	未授权	检查 API Key 是否正确并包含在 Authorization 请求头中
402	额度不足	前往钱包页面充值
403	禁止访问	API Key 可能已过期或被限制
429	频率限制	降低请求频率或升级套餐
500	服务器内部错误	使用指数退避重试；如持续出现请联系支持
502	网关错误	上游供应商异常；路由引擎自动重试
503	服务不可用	短暂中断；自动切换至备用供应商

常见错误#

API Key 无效#

{
 "error": {
 "message": "Invalid API key",
 "type": "invalid_request_error"
 }
}

解决方法：前往令牌管理确认 API Key 正确且处于启用状态。

余额不足#

{
 "error": {
 "message": "Insufficient balance",
 "type": "billing_error"
 }
}

解决方法：在 API 控制台钱包页面进行充值。

API 配置

Mon, 01 Jan 0001 00:00:00 +0000

API 接口配置#

接口地址#

https://api.hub.chansontechgroup.com

支持端点#

端点	说明
`/v1/chat/completions`	对话补全（OpenAI 兼容）
`/v1/embeddings`	文本嵌入
`/v1/images/generations`	图像生成
`/v1/audio/speech`	文本转语音
`/v1/audio/transcriptions`	语音转文本
`/v1/models`	模型列表查询

集成示例#

Python (OpenAI SDK)#

from openai import OpenAI

client = OpenAI(
 base_url="https://api.hub.chansontechgroup.com/v1",
 api_key="sk-your-api-key"
)

Node.js#

import OpenAI from 'openai';

const openai = new OpenAI({
 baseURL: 'https://api.hub.chansontechgroup.com/v1',
 apiKey: 'sk-your-api-key',
});

cURL#

curl https://api.hub.chansontechgroup.com/v1/chat/completions \
 -H "Authorization: Bearer sk-your-api-key" \
 -H "Content-Type: application/json" \
 -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"你好"}]}'

模型命名#

格式为 供应商-模型名。示例：

deepseek-chat — DeepSeek V3
deepseek-reasoner — DeepSeek R1
claude-4-opus — Claude 4 Opus
gpt-5 — OpenAI GPT-5
gemini-2.5-pro — Google Gemini 2.5 Pro

完整模型请查看模型广场。

钱包与计费

Mon, 01 Jan 0001 00:00:00 +0000

钱包与计费指南#

概述#

Chanson Hub 采用按量计费模式，根据实际消耗 Token 结算，用多少付多少。

使用流程#

充值 — 在钱包页面为账户充值
消费 — 每次 API 请求按 Token 消耗扣费
监控 — 控制台实时查看用量和余额

定价说明#

不同模型定价不同，以倍率方式展示。具体价格请查看模型广场。

Token 计算#

输入 Token — 请求中发送的内容
输出 Token — 模型返回的内容

按请求粒度精确实时扣费。

余额提醒#

随时在钱包查看余额
余额过低时自动发送邮件提醒
可设置自动充值避免服务中断

计费支持#

如有计费问题或发票需求，请联系 chansontechgroup@gmail.com。