灵犀算力 · 接入文档

一个接口地址、一个密钥，调用多家主流大模型。本页覆盖接入、客户端配置、模型选择、计费与报错排查；内容与站内控制台的「常见问答」保持一致。

1. 快速开始（3 步）

1. 注册并登录：注册账号 → 登录控制台（注册需完成邮箱验证，收不到请查看垃圾邮件箱）。
2. 创建密钥：控制台 →「密钥」→ 新建，得到 sk- 开头的 API Key（只在创建时完整显示，请立即保存）。
3. 在客户端填三项：API Key、Base URL https://aitoken888.com/v1、模型名（从「价格」页复制，不要手打）。

2. 常见客户端配置

3. SDK / curl 示例

Python（OpenAI SDK）

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="deepseek-v4-flash",          # 模型名从「价格」页复制
    messages=[{"role": "user", "content": "你好，帮我写一段自我介绍"}],
    stream=True,
)
for chunk in resp:
    print(chunk.choices[0].delta.content or "", end="")

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LINGXI_API_KEY,
  baseURL: "https://aitoken888.com/v1",
});

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

curl

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

4. 编程工具配置（Codex / Claude Code / DSH / WorkBuddy / ZCode）

下面五个编程工具都能改指向本平台，用你的密钥直接跑，不需要各自的官方订阅。通用原则只有一条：OpenAI 兼容协议填 …/v1，Anthropic 协议填域名（客户端自己拼 /v1/messages）。

4.1 Codex CLI

编辑 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml）：

model = "gpt-5.6-sol"                 # 模型名从站内「价格」页复制
model_provider = "lingxi"

[model_providers.lingxi]
name = "灵犀算力"
base_url = "https://aitoken888.com/v1"
env_key = "LINGXI_API_KEY"            # 密钥从这个环境变量读
wire_api = "chat"                     # 本平台两种协议都支持：chat 或 responses

然后设置密钥并启动：

# macOS / Linux
export LINGXI_API_KEY="sk-你的密钥"
codex

# Windows PowerShell
$env:LINGXI_API_KEY="sk-你的密钥"
codex

4.2 Claude Code

Claude Code 走 Anthropic 协议（本平台已开放 /v1/messages），用环境变量指向本平台即可：

# macOS / Linux
export ANTHROPIC_BASE_URL="https://aitoken888.com"      # 注意：不要带 /v1
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://aitoken888.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

claude

也可以写进配置文件 ~/.claude/settings.json，避免每次开终端都要设置：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aitoken888.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}

4.3 DSH（DeepSeek Harness）

界面里配（推荐）：打开 设置 → 模型 → 添加模型提供商，把卡片切到 「自定义模型 API」，然后填：

也可以直接改配置文件 $DSH_HOME/profiles/web/cordis.patch.yml：

- id: llm-pi-ai
  config:
    providers:
      lingxi:
        apiKeyEnv: LINGXI_API_KEY
        api: openai-completions
        baseURL: https://aitoken888.com/v1
        models:
          - id: gpt-5.6-sol

4.4 WorkBuddy

对话界面底部点模型选择器 → 列表底部 「配置自定义模型」（或左下角头像 → 设置 → 模型）→ 添加模型 → 供应商选 「自定义」，然后填：

4.5 ZCode

首次启动选 Use API Key；已进入应用则点输入框里的模型名 → Manage Models → Settings → Model Settings，然后：

1. 左侧 Provider 列表底部点 Add Provider；
2. Provider 名称随意（例如 灵犀算力）；
3. 类型选 OpenAI-compatible，Base URL 填 https://aitoken888.com/v1；
4. API Key 填 sk-你的密钥；
5. 点 Add Model 手动填站内模型名（列表没自动返回时同样手填，注意大小写）；
6. 保存后打开该 Provider 的 Enable 开关，并确认要用的模型也已启用。

4.6 CC Switch（多 key / 多订阅，一键切换）

CC Switch 是 Claude Code / Claude Desktop / Codex / Gemini CLI / Grok Build / OpenCode / OpenClaw / Hermes / Pi / MiniMax Code 十种 AI 编程工具的统一配置管理器：把「地址 + 密钥 + 模型」存成一份供应商，一键切换。它的强项正是同一个工具下并存多份配置 —— 多个 key、多个上游、多个订阅账号，托盘点一下就能换，不用再手改 JSON / TOML。

方式一：站内一键导入（最省事）

1. 控制台 →「密钥」，在要用的密钥那一行点 CC Switch（弹窗标题「填入 CC Switch」）；
2. 选应用类型：Claude（可分别指定主模型与 Haiku / Sonnet / Opus 三级模型）、Codex 或 Gemini；
3. 选好模型，点 「打开 CC Switch」——系统唤起 CC Switch 并自动写入这份供应商（地址按协议自动填好：Claude / Gemini 用域名，Codex 用 …/v1）。

方式二：在 CC Switch 里手动添加：进入对应工具页面 → 添加供应商 → 选「自定义」，按下表填：

「多 key / 多订阅」怎么用起来

• 同一工具并存多份供应商：例如「灵犀算力 · 项目 A 的 key」「灵犀算力 · 项目 B 的 key」「官方订阅」各存一份，在列表或系统托盘一键切换；切换只替换端点 / 密钥 / 模型，你的插件、hooks、MCP、自定义设置与注释都原样保留。
• 多订阅账号（Accounts，Beta）：可登录多个 ChatGPT / GitHub Copilot / xAI(Grok) 账号，直接把它们当供应商用（除 Codex 的 OpenAI Official 外，需要在 Routing（本地路由） 模式下使用）。
• 项目（Projects）：把某个项目的「供应商 + MCP + Skills + 提示词」整体存成一个项目，整套一键切换（默认隐藏，在「设置 → 通用」里打开「显示项目切换器」）。
• 聚合模式（Aggregation）：让多家供应商的模型出现在同一份模型列表里，按你选的模型自动路由，不必手动切供应商。
• 自动故障转移：给某个工具配一条重试队列（例如：本站为主、官方订阅兜底），请求失败自动切换到下一个供应商。
• 用量看板：按供应商 / 模型统计请求数、token、缓存命中率与花费；官方订阅还会显示剩余额度与重置倒计时。

5. 模型与选择建议

• 日常问答 / 客服 / 摘要 / 文案：优先 mini、flash 类模型，速度快、成本低。
• 复杂推理 / 代码 / 长文档：升级到旗舰或高阶模型。
• DeepSeek 系列：按官方时段分时计价 —— 高峰为工作日 9:00–12:00、14:00–18:00，其余时段为错峰（约高峰价的一半）；模型详情页的「分档价格表」显示的金额就是实付价，系统按时段自动匹配。
• 完整模型清单、上下文长度与实时价格：见站内「价格」页；可用性以该页与控制台模型列表为准。

6. 计费与额度

• 按量计费：token 是模型读写内容的计量单位，输入（你的问题、系统提示词、历史对话、知识库片段）与输出都会计入。
• 页面金额：站内价格与账单以 ¥ 展示，即你的实付口径。
• 查账：控制台 →「钱包」看余额；「使用日志」看每次调用的模型、token 与扣费；概览页有近 24 小时消耗、历史消耗、请求数与 Token 消耗。
• 省钱要点：给输出设置最大长度、长对话做摘要、知识库只检索最相关的 3–8 个片段、批量与离线任务放到错峰时段。

7. 常见报错排查

8. 密钥安全

• Key 只保存在你的服务端或本地配置里，不要写进前端代码、公开仓库、截图或群聊。
• 怀疑泄露：控制台 →「密钥」删除旧 Key 并新建，然后核对「使用日志」有无异常调用与扣费。
• 给不同项目/环境使用不同的 Key，便于单独停用与统计。

9. 常见问答

控制台「概览 → 常见问答」有完整 13 条（含计费口径、DeepSeek 分时、余额与报错处理）。几条最常问的：

• Base URL 到底填哪个？常规填 https://aitoken888.com/v1；自动补路径的客户端填 https://aitoken888.com；主域名不通换 https://gptcc.cn。
• 余额掉得快？多为高倍率模型 + 长上下文 + 长输出；按上文「省钱要点」调整即可。
• 你们是 OpenAI 官方吗？不是。灵犀算力是兼容式 API 聚合/中转服务，模型能力来自不同上游通道，可用性以站内模型列表与公告为准。

10. 联系客服

遇到扣费异常、模型报错或需要更高并发限额：在首页点击 「客服」 扫码添加客服微信，把账号、时间点、模型名、报错原文一起发过来，处理最快。

© 灵犀算力