开发文档

天府软件园模型超市 — 企业级 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/modelsOverlay模型列表(Claude/Codex 映射后)
POST/v1/chat/completionsOverlay / New-APIOpenAI Chat Completions
POST/v1/messagesOverlayClaude Messages API → Chat 翻译
POST/v1/responsesOverlayCodex Responses API → Chat 翻译
POST/api/user/registerNew-API用户注册
GET/api/user/selfNew-API当前用户信息
GET/api/statusNew-API系统健康状态
GET/api/modelsPortal模型列表(BFF)
POST/api/user/loginPortal用户登录

认证方式

API 请求在 Header 中携带密钥:

Authorization: Bearer sk-your-api-key

控制台 → API 密钥 中创建和管理密钥。

错误码

状态码含义处理建议
200请求成功
400请求参数错误检查请求体格式和必填字段
401API 密钥无效或已过期在控制台重新生成密钥
402账户余额不足前往充值中心充值
429请求频率超限降低请求频率,稍后重试
500服务器内部错误联系技术支持或查看服务状态

完整技术文档

架构设计、数据库 Schema、API 参考、部署运维等完整文档位于项目 docs/ 目录。

联系我们获取技术支持