OpenAI 兼容协议。改 base_url，填 sk- 密钥，即可调用统一算力入口。
联系商务经理开通（后台人工发放，不开放自助注册）。你将获得形如 sk-xxxx-xxxx 的密钥，明文仅在创建时展示一次。
把请求地址根路径替换为以下函数 URL：
https://1446990742-jllr0g9ooj.ap-guangzhou.tencentscf.com每次请求携带 Bearer 令牌：
Authorization: Bearer sk-你的密钥调用 POST /v1/chat/completions，请求 / 响应结构与 OpenAI 完全一致，无需改动既有代码。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /v1/models | 查看当前 Key 有权调用的模型列表 |
| POST | /v1/chat/completions | OpenAI 兼容对话接口（代理至 TokenHub MaaS） |
curl -X POST https://1446990742-jllr0g9ooj.ap-guangzhou.tencentscf.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的密钥" \
-d '{
"model": "hy3-preview",
"messages": [
{"role": "system", "content": "你是 AI 业务助手。"},
{"role": "user", "content": "介绍一下通用智能体企业版"}
],
"temperature": 0.3,
"max_tokens": 600
}'from openai import OpenAI
client = OpenAI(
base_url="https://1446990742-jllr0g9ooj.ap-guangzhou.tencentscf.com/v1",
api_key="sk-你的密钥",
)
resp = client.chat.completions.create(
model="hy3-preview",
messages=[
{"role": "system", "content": "你是 AI 业务助手。"},
{"role": "user", "content": "介绍一下通用智能体企业版"},
],
)
print(resp.choices[0].message.content)
print("剩余额度:", resp.usage.total_tokens)stream=true 会退化为非流式 SSE 返回（v1 兼容方案），建议非流式调用。model、messages、temperature、max_tokens 等 OpenAI 标准字段。choices 与 usage；额度从 usage.total_tokens 扣减。X-Yongxu-Balance 返回当前 Key 的剩余 Token 额度。默认在线模型（具体以 GET /v1/models 返回为准）：
| HTTP | OpenAI error.type | 含义 | 处理建议 |
|---|---|---|---|
| 401 | invalid_api_key | API Key 缺失 / 格式错误 / 已吊销 | 检查 Authorization 头；联系商务经理确认 Key 状态 |
| 402 | insufficient_quota | API 额度已耗尽 | 商务经理在后台充值 |
| 403 | model_not_allowed | 该 Key 无权调用此模型 | 在后台「API 密钥」编辑允许模型白名单 |
| 429 | rate_limit_exceeded | 请求频率超限 | 降低调用频率或申请提高限速 |
| 400 | invalid_request_error | 请求参数错误 | 检查 messages 等字段 |
| 502 | upstream_error | 上游模型调用失败 | 稍后重试或联系运维 |
目前仅支持后台人工发放。联系商务经理，或发送邮件至下方地址即可申请。