开发文档
天府软件园模型超市 — 企业级 AI 模型统一接入平台 · 完整技术文档
快速开始
完全兼容 OpenAI SDK,修改 base_url 即可接入。
Python
from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://tokenhub.tianfusoftwarepark.com/v1"
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[
{"role": "user", "content": "你好!"}
]
)
print(response.choices[0].message.content)Node.js
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-api-key',
baseURL: 'https://tokenhub.tianfusoftwarepark.com/v1',
});
const res = await client.chat.completions.create({
model: 'deepseek-chat',
messages: [{ role: 'user', content: '你好!' }],
});
console.log(res.choices[0].message.content);API 端点
所有 API 通过 Nginx (SLB) 统一入口 :15000 暴露:
| 方法 | 路径 | 目标服务 | 说明 |
|---|---|---|---|
| GET | /v1/models | Overlay | 模型列表(Claude/Codex 映射后) |
| POST | /v1/chat/completions | Overlay / New-API | OpenAI Chat Completions |
| POST | /v1/messages | Overlay | Claude Messages API → Chat 翻译 |
| POST | /v1/responses | Overlay | Codex Responses API → Chat 翻译 |
| POST | /api/user/register | New-API | 用户注册 |
| GET | /api/user/self | New-API | 当前用户信息 |
| GET | /api/status | New-API | 系统健康状态 |
| GET | /api/models | Portal | 模型列表(BFF) |
| POST | /api/user/login | Portal | 用户登录 |
认证方式
错误码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| 200 | 请求成功 | — |
| 400 | 请求参数错误 | 检查请求体格式和必填字段 |
| 401 | API 密钥无效或已过期 | 在控制台重新生成密钥 |
| 402 | 账户余额不足 | 前往充值中心充值 |
| 429 | 请求频率超限 | 降低请求频率,稍后重试 |
| 500 | 服务器内部错误 | 联系技术支持或查看服务状态 |
完整技术文档
架构设计、数据库 Schema、API 参考、部署运维等完整文档位于项目 docs/ 目录。