接入说明.

STEP BY STEP

三步开始

1. 01

   注册账号

   打开 控制台 注册，自动获得赠送 token，不充值也能先试用。

2. 02

   创建 API 密钥

   控制台 → API 密钥 → 创建密钥。密钥以 sk-kiro- 开头，只在创建时完整显示一次，请立即保存。建议每个工具单独建一个，方便停用和查账。

3. 03

   填进你的工具

   按下方对照表填写 Base URL、密钥和模型名，然后用 连接自检 确认可用。

BASE URL / AUTH

地址与密钥对照表

两种协议的 Base URL 不同，最常见的错误就是这一处多写或少写了 /v1。

MODELS / CNY

模型与价格

两款模型由第三方通道提供。其他模型名都会返回 404 model_not_listed。实时价格以 价格页 为准，价格按请求开始时计算。

CLIENT / CLAUDE CODE

Claude Code

Claude Code 走 Anthropic 协议，Base URL 填根地址（不带 /v1）。推荐写进配置文件，长期生效。

1. 方式一：写入 ~/.claude/settings.json（推荐）

   打开（没有就新建）~/.claude/settings.json，Windows 是 %USERPROFILE%\.claude\settings.json。把下面的 env 合并进去，密钥换成你自己的：

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://kiro.undusk.com",
       "ANTHROPIC_AUTH_TOKEN": "sk-kiro-你的密钥",
       "ANTHROPIC_MODEL": "external/claude-opus-5-5",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "external/claude-fable-5-1",
       "ANTHROPIC_SMALL_FAST_MODEL": "external/claude-fable-5-1",
       "API_TIMEOUT_MS": "600000",
       "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
     }
   }

   ANTHROPIC_MODEL

   主模型，用 Opus 5.5。

   ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_SMALL_FAST_MODEL

   后台小任务（标题、摘要等）用的模型，设为 Fable 5.1；不设置会返回 404。

   API_TIMEOUT_MS

   长任务的超时时间（毫秒），600000 即 10 分钟。

   CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS

   关闭实验性请求字段，避免兼容问题。

2. 方式二：终端临时设置

   只想在当前终端试用，可以先 export 再运行 claude：

   macOS / LinuxWindows PowerShell

   export ANTHROPIC_BASE_URL="https://kiro.undusk.com"
   export ANTHROPIC_AUTH_TOKEN="sk-kiro-你的密钥"
   export ANTHROPIC_MODEL="external/claude-opus-5-5"
   export ANTHROPIC_DEFAULT_HAIKU_MODEL="external/claude-fable-5-1"
   export ANTHROPIC_SMALL_FAST_MODEL="external/claude-fable-5-1"
   export API_TIMEOUT_MS=600000
   export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
   claude

3. 切换模型

   在 Claude Code 里输入 /model 加完整模型 ID 即可切换：

   /model external/claude-fable-5-1

   切回 Opus 用 /model external/claude-opus-5-5。若子代理或菜单里出现 model_not_listed 404，检查是否所有模型变量都指向这两个模型，可在 env 里再加 "ANTHROPIC_DEFAULT_SONNET_MODEL": "external/claude-opus-5-5"。

4. 验证

   启动后发一句「你好」，能正常回复即接入成功。控制台的「最近调用」里能看到这笔请求和费用。

CLIENT / CC SWITCH

CC Switch

用 CC Switch 管理 Claude Code 的多个供应商时，按下面新增一个供应商即可，它会帮你写入上面的配置。

1. 新增供应商

   打开 CC Switch，切到 Claude 标签页，点「添加供应商」，选择 自定义。

2. 填写字段

   供应商名称Kiro 中转站

   请求地址https://kiro.undusk.com复制

   API Keysk-kiro-你的密钥

   主模型external/claude-opus-5-5复制

   快速模型external/claude-fable-5-1复制

   如果界面只给出 JSON 配置框，直接粘贴 Claude Code 一节的 env 内容。

3. 启用并重启

   保存后点「启用」，然后重新打开 Claude Code 终端会话。

CLIENT / CURSOR

Cursor

Cursor 用 OpenAI 兼容方式接入，Base URL 要带 /v1。

1. 打开模型设置

   Cursor → Settings → Models，展开 API Keys 区域。

2. 填写地址与密钥

   OpenAI API Keysk-kiro-你的密钥

   Override OpenAI Base URLhttps://kiro.undusk.com/v1复制

   打开 Override OpenAI Base URL 开关并填入地址，然后点 Verify。

3. 添加自定义模型

   在模型列表底部点 Add Model，依次添加 external/claude-opus-5-5 和 external/claude-fable-5-1，勾选启用。

4. 开始使用

   在聊天 / Agent 面板的模型下拉里选刚加的模型。自定义地址只对你添加的这些模型生效，Cursor 自带的功能（如 Tab 补全）不经过本站。

CLIENT / OPENAI COMPATIBLE

Cherry Studio、ChatBox 等聊天客户端

大多数聊天客户端都支持「OpenAI 兼容」服务商，配置方式基本一致。

SDK / PYTHON · NODE

OpenAI 与 Anthropic SDK

官方 SDK 只需改 base_url 和 api_key。建议把密钥放进环境变量 KIRO_API_KEY，不要写死在代码里。

OpenAI SDK

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://kiro.undusk.com/v1",
    api_key=os.environ["KIRO_API_KEY"],
)

resp = client.chat.completions.create(
    model="external/claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "external/claude-opus-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(resp.choices[0].message.content);

Anthropic SDK

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://kiro.undusk.com",  # 不带 /v1
    api_key=os.environ["KIRO_API_KEY"],
)

msg = client.messages.create(
    model="external/claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(msg.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://kiro.undusk.com", // 不带 /v1
  apiKey: process.env.KIRO_API_KEY,
});

const msg = await client.messages.create({
  model: "external/claude-opus-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(msg.content[0].text);

流式输出：OpenAI SDK 传 stream=True，Anthropic SDK 用 client.messages.stream(...)。工具调用按各自 SDK 的 tools 参数正常传入即可。

HTTP / CURL

curl 示例

先在终端设置 export KIRO_API_KEY="sk-kiro-你的密钥"，下面的命令可直接粘贴运行。

curl https://kiro.undusk.com/v1/chat/completions \
  -H "Authorization: Bearer $KIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "external/claude-opus-5-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "你好"}]
  }'

curl -N https://kiro.undusk.com/v1/chat/completions \
  -H "Authorization: Bearer $KIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "external/claude-opus-5-5",
    "max_tokens": 512,
    "stream": true,
    "messages": [{"role": "user", "content": "你好"}]
  }'

curl https://kiro.undusk.com/v1/messages \
  -H "x-api-key: $KIRO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "external/claude-fable-5-1",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "你好"}]
  }'

curl -N https://kiro.undusk.com/v1/messages \
  -H "x-api-key: $KIRO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "external/claude-fable-5-1",
    "max_tokens": 512,
    "stream": true,
    "messages": [{"role": "user", "content": "你好"}]
  }'

HEALTH CHECK

连接自检

这三个请求都免费，不消耗余额和赠送 token。配置不通时，先按顺序跑一遍。

curl https://kiro.undusk.com/v1 -H "Authorization: Bearer $KIRO_API_KEY"

curl https://kiro.undusk.com/v1/models -H "Authorization: Bearer $KIRO_API_KEY"

curl https://kiro.undusk.com/v1/account -H "Authorization: Bearer $KIRO_API_KEY"

LIMITS

请求限制

BILLING

计费与赠送 token

FAST MODE

Fast 模式

Fast 模式让 Opus 5.5 输出更快，回答质量不变，但单价更高。目前只有 external/claude-opus-5-5 支持。

TROUBLESHOOTING

错误码排查

OpenAI 路径返回 OpenAI 格式的错误，Anthropic 路径返回 Anthropic 格式，客户端都能正常识别并重试。

REFUND

退款规则

申请入口：控制台 → 余额与账单 → 充值订单 → 申请退款。到账时间以支付渠道为准。

FAQ

常见问题