airouter.k330.com 接入指南

本文面向已获得 API Key 的用户。如果你还没有 Key,请联系管理员获取。

# airouter 接入指南 ## 基本信息 ### API 端点 ### 可用模型 ### 协议:OpenAI 兼容 ## 接入方式 ### Claude Code(环境变量) ### Cursor ### Cline / Roo Code ### Cherry Studio ### Continue.dev ### 直接 curl 调用 ## 常见问题 ### 流式输出断连 ### 模型列表为空 ### 超时配置

基本信息

项目
API 端点 https://airouter.k330.com
协议 OpenAI 兼容(/v1/chat/completions 等)
认证 Bearer Token,填你的 sk- Key

可用模型

Claude 系列

模型名 别名 说明
claude-opus-4-8 claude-opus 最强旗舰,适合复杂任务
claude-sonnet-4-6 claude-sonnet 速度与能力均衡,日常首选
claude-haiku-4-5-20251001 claude-haiku 最快,适合自动补全
claude-opus-4-7 Opus 上一版
claude-opus-4-6 Opus 更早版
claude-sonnet-4-5-20250929 Sonnet 上一版

Gemini 系列

模型名 别名 说明
gemini-2.5-flash Gemini 最新 Flash
gemini-3.5-flash gemini-flash 速度快,免费额度友好
gemini-3-flash
gemini-3.1-flash-lite 最轻量
gemini-2.5-flash-lite

DeepSeek 系列

模型名 说明
deepseek-v4-pro DeepSeek 旗舰
deepseek-v4-flash DeepSeek 快速版

别名可以直接使用,例如填 claude-sonnet 等价于 claude-sonnet-4-6


快速验证

拿到 Key 后先跑这条命令确认链路通了:

curl https://airouter.k330.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet",
    "messages": [{"role": "user", "content": "你好,用一句话介绍你自己"}],
    "max_tokens": 50
  }'

返回包含 choices[0].message.content 的 JSON 即表示接入成功。

查看所有可用模型:

curl https://airouter.k330.com/v1/models \
  -H "Authorization: Bearer sk-你的Key"

Claude Code

Claude Code 是 Anthropic 官方 CLI,通过环境变量指定自定义端点。

方式一:环境变量(临时,测试用)

export ANTHROPIC_BASE_URL=https://airouter.k330.com
export ANTHROPIC_AUTH_TOKEN=sk-你的Key
claude

方式二:写入 Shell 配置(永久生效)

# ~/.bashrc 或 ~/.zshrc
echo 'export ANTHROPIC_BASE_URL=https://airouter.k330.com' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的Key' >> ~/.bashrc
source ~/.bashrc

方式三:项目级 settings.json

在项目根目录或 ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://airouter.k330.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

适合团队共享,可以纳入版本控制(注意 Key 不要提交到公开仓库)。

flowchart LR A["Claude Code CLI"] -->|ANTHROPIC_BASE_URL| B["airouter.k330.com"] B --> C["Claude Opus 4.8\nSonnet / Haiku"]

Cursor

  1. 打开 SettingsCtrl+, / Cmd+,)→ 搜索 Models
  2. 找到 Override OpenAI Base URLOpenAI API Key
    • Base URL:https://airouter.k330.com/v1
    • API Key:sk-你的Key
  3. 点击 Add Model,手动输入模型名(Cursor 不会自动拉取列表):
    • 推荐添加:claude-opusclaude-sonnetgemini-flash

Cursor 配置的是 OpenAI 兼容接口,直接用别名即可。

流式输出断连问题:如果你系统开了代理,长推理请求可能中途断流。解决方法:

# macOS / Linux
export NO_PROXY=airouter.k330.com

# Windows(系统环境变量)
NO_PROXY = airouter.k330.com

Cline / Roo Code(VS Code 插件)

两个插件配置方式完全一致。

  1. VS Code 侧边栏打开 Cline 或 Roo Code 面板
  2. 右上角设置图标 → Provider 配置
  3. Provider 类型选 OpenAI Compatible
  4. 填写:
    • Base URLhttps://airouter.k330.com/v1
    • API Keysk-你的Key
    • Model:手动输入,如 claude-opus-4-8

Cherry Studio

  1. 设置 → 模型服务 → 右上角 +
  2. 服务商类型选 OpenAI-Response(不是普通 OpenAI)
  3. 填写:
    • 接口地址:https://airouter.k330.com/v1
    • API Key:sk-你的Key
  4. 点「检查」 → 成功后点「获取模型列表」可自动拉取

Continue.dev

编辑 ~/.continue/config.json

{
  "models": [
    {
      "title": "Claude Opus(airouter)",
      "provider": "openai",
      "model": "claude-opus-4-8",
      "apiBase": "https://airouter.k330.com/v1",
      "apiKey": "sk-你的Key"
    },
    {
      "title": "Claude Sonnet(airouter)",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "apiBase": "https://airouter.k330.com/v1",
      "apiKey": "sk-你的Key"
    }
  ],
  "tabAutocompleteModel": {
    "title": "Haiku(airouter)",
    "provider": "openai",
    "model": "claude-haiku-4-5-20251001",
    "apiBase": "https://airouter.k330.com/v1",
    "apiKey": "sk-你的Key"
  }
}

tabAutocompleteModel 建议用 Haiku,响应最快,不影响补全体验。


其他工具(通用配置)

只要工具支持"自定义 OpenAI 接口",填以下两个参数即可:

参数
Base URL / API Base https://airouter.k330.com/v1
API Key sk-你的Key

常见工具对应字段名:

工具 Base URL 字段名 API Key 字段名
OpenCode OPENAI_BASE_URL 环境变量 OPENAI_API_KEY
NextChat 设置 → 自定义接口地址 API Key
LobeChat 设置 → OpenAI → Endpoint API Key
Chatbox 设置 → OpenAI API → API Host API Key
Msty Provider → Custom OpenAI API Key

常见问题

请求报错 Invalid token

Key 填写有误,或 Key 已过期。确认 Authorization header 格式为 Bearer sk-...(注意 Bearer 后有空格)。

模型名不对怎么办

用别名更稳妥:claude-opusclaude-sonnetclaude-haikugemini-flash。或者先调 /v1/models 接口查看实时列表。

流式输出卡顿或一次性返回

若使用系统代理,设置 NO_PROXY=airouter.k330.com 绕过代理。工具本身如果有"缓冲模式"开关,关掉它。

请求超时(长上下文/慢响应)

服务端超时已设为 600 秒,本地工具也需要对应调高:

  • Cline:Settings → Request Timeout(毫秒,如 600000
  • Cursor:没有单独超时配置,依赖全局网络超时
  • curl:加 --max-time 600 参数

我想看自己的用量

暂不提供用量查看功能,有需求联系管理员。


相关文章

本站相关系列文章,如果想了解服务背后的架构:


实操清单

  • 收到 sk- 开头的 API Key
  • 用 curl 发测试请求,确认返回正常 JSON
  • /v1/models 查看完整模型列表
  • 按需配置你使用的工具(Claude Code / Cursor / Cline / Cherry Studio / Continue.dev)
  • 发一次流式请求,确认逐字符输出正常(无卡顿无一次性返回)
  • 如有超时问题,检查工具的 Timeout 配置,调高到 600 秒