API 接入指南 控制台

bixia 中转站 · 接入指南

站点:https://bixia.space  API 入口:https://bixia.space/v1


一、基本信息

项目 值
网页控制台 https://bixia.space
OpenAI 兼容地址 https://bixia.space/v1
Claude(Anthropic)兼容地址 https://bixia.space
Gemini 兼容地址 https://bixia.space
密钥格式 sk- 开头,在「令牌」页面创建
可用模型 deepseek-v4.1-flash(当前仅此一个)

价格

项目 单价(\$/百万 tokens)
输入(缓存命中) 0.04
输入(缓存未命中) 2
输出 8

平台按高峰时段价统一计费;界面货币符号为 $,数值与人民币 1:1。 充值方式:后台「充值」页,支持兑换码与在线支付。

获取密钥

  1. 登录 https://bixia.space ,注册账号
  2. 左侧菜单 →「令牌」→「添加令牌」
  3. 名称随意,额度选「无限额度」或自定义,分组按需
  4. 保存后复制 sk-... 开头的字符串

二、通用参数(所有客户端通用)

BASE_URL = https://bixia.space/v1
API_KEY  = sk-你的密钥
MODEL    = 控制台里显示的模型名,例如 deepseek-v4.1-flash、deepseek-v4.1-flash、deepseek-v4.1-flash

凡是要求填「API 地址 / Base URL / 接口地址」的软件,都填 https://bixia.space/v1; 只有 Claude Code 这类会自己拼 /v1/messages 的工具,才填 https://bixia.space(不带 /v1)。


三、Cherry Studio

  1. 下载 https://cherry-ai.com ,安装后打开
  2. 左下角「设置」→「模型服务」→ 点右上角「+ 添加」
  3. 供应商类型选 OpenAI,名称填 bixia
  4. 填写:
字段 值
API 地址 https://bixia.space/v1
API 密钥 sk-你的密钥
  1. 点「检查」旁边的「获取模型列表」,勾选要用的模型
  2. 回「对话」页,顶部模型选择里选刚添加的模型即可

四、CC Switch(Claude Code / Codex / Gemini CLI 切换器)

CC Switch 是一个桌面小工具,用来一键切换 Claude Code、Codex、Gemini CLI 的供应商配置。

4.1 添加 bixia 供应商

  1. 打开 CC Switch
  2. 顶部选择要配置的应用:Claude Code 或 Codex
  3. 点「+ 添加供应商」/「新增」
  4. 按下表填写:

Claude Code:

字段 值
名称 bixia
API 地址 / Base URL https://bixia.space
API Key / Token sk-你的密钥
模型 后台配置的 Claude 模型,如 deepseek-v4.1-flash

Codex:

字段 值
名称 bixia
API 地址 / Base URL https://bixia.space/v1
API Key sk-你的密钥
模型 如 deepseek-v4.1-flash,以控制台实际模型名为准
  1. 保存后,在列表里点该供应商的「启用 / 切换」

4.2 启用后验证

# Claude Code
claude "你好,用一句话介绍你自己"

# Codex
codex "print hello"

能正常返回即配置成功。配置写入位置:Claude Code 为 ~/.claude/settings.json,Codex 为 ~/.codex/config.toml。

注意:CC Switch 里的模型名必须与后台「渠道」里实际可用的模型一致,否则会返回 model not found。


五、ChatBox

  1. 打开 ChatBox → 设置 → 模型提供方 → OpenAI API
  2. API 域名:https://bixia.space(ChatBox 会自动补 /v1)
  3. API 密钥:sk-你的密钥
  4. 模型:手动填写控制台里的模型名
  5. 保存

六、NextChat(ChatGPT-Next-Web)

  1. 打开设置 →「自定义接口」
  2. 接口地址:https://bixia.space
  3. API Key:sk-你的密钥
  4. 自定义模型:填写控制台模型名,多个用英文逗号分隔
  5. 点「检查」通过后保存

七、LobeChat

  1. 设置 →「语言模型」→ OpenAI
  2. 代理地址:https://bixia.space/v1
  3. API Key:sk-你的密钥
  4. 模型列表会自动拉取

八、VS Code 插件:Cline / Roo Code

  1. 安装插件后打开设置
  2. API Provider 选 OpenAI Compatible
  3. Base URL:https://bixia.space/v1
  4. API Key:sk-你的密钥
  5. Model ID:填控制台模型名
  6. 保存

九、Cursor

  1. Ctrl+Shift+J 打开设置 → Models
  2. 关闭内置模型,点「+ Add model」
  3. 名称填模型名,Base URL 填 https://bixia.space/v1,Key 填 sk-...
  4. 在 OpenAI API Key 处点 Override,填入同一个 Key

十、沉浸式翻译

  1. 设置 →「翻译服务」→ 添加「OpenAI」
  2. API 地址:https://bixia.space/v1
  3. API Key:sk-你的密钥
  4. 模型:选一个便宜的,如 deepseek-v4.1-flash
  5. 点「测试」通过后保存

十一、OpenCat / 其他 iOS、macOS 客户端

通用规则:找「自定义 API / OpenAI 兼容」,Base URL 填 https://bixia.space/v1,Key 填 sk-...。


十二、命令行 / SDK

curl

curl https://bixia.space/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python(openai 库)

from openai import OpenAI

client = OpenAI(
    base_url="https://bixia.space/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://bixia.space/v1",
  apiKey: "sk-你的密钥",
});

const r = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);

Claude Code(手动配置,不用 CC Switch)

export ANTHROPIC_BASE_URL="https://bixia.space"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

十三、常见问题

现象 原因 / 解决
401 Unauthorized 密钥错误或已被删除,重新在「令牌」页复制
model not found / 无可用渠道 后台未添加对应模型的渠道,或模型名写错
403 / 分组无权限 令牌的分组与渠道分组不匹配,改令牌分组
429 请求过多 触发限流,降低并发或联系管理员提额
流式输出中断 客户端超时太短,或上游渠道不稳定
Claude Code 报 404 Base URL 多写了 /v1,Claude 应填 https://bixia.space
图片/文件上传失败 该模型不支持多模态,换视觉模型

十四、支持的接口

接口 路径
对话补全 POST /v1/chat/completions
文本补全 POST /v1/completions
向量 POST /v1/embeddings
图像生成 POST /v1/images/generations
语音 POST /v1/audio/speech、/v1/audio/transcriptions
Claude 消息 POST /v1/messages
模型列表 GET /v1/models
余额查询 GET /api/user/self(需登录态)