国产大模型统一接入文档

把 OpenAI SDK 的 baseURL 改为 AlphaCat 地址即可。第一版重点支持 DeepSeek、Qwen、Kimi、豆包；海外模型作为可选 BYOK / OpenRouter 扩展。

推荐默认模型：modeldesk/auto。它会根据任务类型自动选择 code / vision / cheap / long / general 路由，并返回 modeldesk_routing 解释信息。

curl

curl https://alphacat.space/v1/chat/completions \
  -H "Authorization: Bearer sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "modeldesk/auto",
    "messages": [{"role":"user","content":"你好"}]
  }'

Chatbox / Cherry Studio 配置

  1. Provider 选择 OpenAI Compatible 或自定义 OpenAI。
  2. Base URL 填：https://alphacat.space/v1
  3. API Key 填：控制台创建的完整 sk_...，不要填 Key 前缀。
  4. 模型名填：modeldesk/auto
  5. 如果要强制代码任务，模型名填：modeldesk/code；如果要图片任务，填：modeldesk/vision。

Dify / FastGPT 配置

  1. 模型供应商选择 OpenAI-API-compatible。
  2. API endpoint 填：https://alphacat.space/v1
  3. 模型名称填：modeldesk/auto
  4. 如果平台要求 completion endpoint，不要填完整路径，只填 Base URL；接口路径会自动拼成 /chat/completions。

错误提示说明

错误含义处理方式
API Key 无效Key 错了、被禁用，或只复制了前缀。重新创建完整 Key。
余额不足账户没有可用余额。提交充值申请，管理员确认到账。
没有可用上游模型未配置 Provider Key 或 fallback。管理员测试上游并启用模型。
不支持图片输入路由到了文本模型。使用 modeldesk/vision 或确认 Qwen VL 已开通。

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk_xxx",
  baseURL: "https://alphacat.space/v1"
});

const response = await client.chat.completions.create({
  model: "modeldesk/auto",
  messages: [{ role: "user", content: "用中文解释什么是 API 网关" }]
});

常用工具配置

Cherry Studio / Chatbox

Provider 选择 OpenAI Compatible，Base URL 填 https://alphacat.space/v1，API Key 填你的 sk_...。

Dify / FastGPT

模型供应商选择 OpenAI-API-compatible，模型名填 modeldesk/auto 或下方可用模型。

Cursor / 编程工具

如果工具支持自定义 OpenAI Base URL，即可填入 AlphaCat 地址；不支持的工具暂时不能直接接入。

自动路由模型

modeldesk/auto

默认推荐。根据图片、代码、长文本、批量低成本、复杂推理等信号自动选择模型。

modeldesk/code

偏向代码、debug、SQL、前后端开发等任务，优先 DeepSeek / coder 类模型。

modeldesk/vision

偏向图片、截图、OCR、图像理解任务，优先支持视觉的 Qwen / Doubao 类模型。

modeldesk/cheap

偏向批量分类、提取、改写、翻译等低成本任务，优先低价模型。

当前可用模型

模型显示名路由 / 上游输入 $/1M输出 $/1M上下文状态