🦉 霜鸮科技 API · 使用文档

首页 · 控制台 · 在线测试
1拿 key登录控制台 →「新建秘钥」→ 按你要用的平台选分组
2配客户端按下方对应工具的配置，把 sk-xxx 换成你的 key
3验证打开在线测试，贴 key 发一条消息确认通
分组 = 平台，别选错：Claude 选 default ｜ Codex/GPT 选 default-openai ｜ Grok 选 default-grok。一把 key 只能绑一个分组，三个工具都用就建三把。
Claude Code
Codex CLI
Grok CLI
OpenCode

使用地址key 分组选 default

🔗 https://api.snowyowl.cn

macOS / Linux

终端执行（建议写入 ~/.zshrc 或 ~/.bashrc 永久生效）
export ANTHROPIC_BASE_URL="https://api.snowyowl.cn"
export ANTHROPIC_AUTH_TOKEN="sk-换成你的key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
或写入 ~/.claude/settings.json（改完重启 Claude Code）
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.snowyowl.cn",
    "ANTHROPIC_AUTH_TOKEN": "sk-换成你的key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Windows

PowerShell
$env:ANTHROPIC_BASE_URL="https://api.snowyowl.cn"
$env:ANTHROPIC_AUTH_TOKEN="sk-换成你的key"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
CMD
set ANTHROPIC_BASE_URL=https://api.snowyowl.cn
set ANTHROPIC_AUTH_TOKEN=sk-换成你的key
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

可用模型

模型 ID说明
claude-sonnet-4-6主力推荐，快且稳
claude-opus-4-7旗舰，复杂任务用
claude-sonnet-5 / claude-fable-5更新一代
⚠️ 旧版带日期的模型 ID（如 claude-sonnet-4-5-20250929）上游未开放，会报 503，请用表内 ID。

验证命令

curl -X POST https://api.snowyowl.cn/v1/messages \
  -H "x-api-key: sk-换成你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":16,"messages":[{"role":"user","content":"say ok"}]}'

使用地址key 分组选 default-openai

🔗 https://api.snowyowl.cn/v1

macOS / Linux

~/.codex/config.toml（已有配置则只合并 model_providers.snowyowl 段）
model_provider = "snowyowl"
model = "gpt-5.5"
disable_response_storage = true

[model_providers.snowyowl]
name = "SnowyOwl"
base_url = "https://api.snowyowl.cn/v1"
wire_api = "responses"
requires_openai_auth = true
~/.codex/auth.json
{
  "OPENAI_API_KEY": "sk-换成你的key"
}

Windows

%userprofile%\.codex\config.toml（内容同上）与 %userprofile%\.codex\auth.json（内容同上）

可用模型

模型 ID说明
gpt-5.5主力，2026-09-05 经网关实测通过
gpt-5.6-sol已开通，2026-09-05 经网关实测通过
gpt-5.6-luna / gpt-5.3-codex-spark上游清单在列，可按需试
⚠️ 2026-09-05 变更：上游已下线 gpt-5.4（调用报 503 Service temporarily unavailable），原来配置 model = "gpt-5.4" 的请改成 gpt-5.5 并重启 Codex CLI；gpt-5.6-terra 当日实测超时未通，暂勿用。写入完成后重启 Codex CLI 生效。

使用地址key 分组选 default-grok

🔗 https://api.snowyowl.cn/v1

macOS / Linux

~/.grok/config.toml（如已有配置请先备份再合并）
[models]
default = "grok"

[model."grok"]
model = "grok-4.5"
base_url = "https://api.snowyowl.cn/v1"
name = "Grok 4.5"
api_key = "sk-换成你的key"
api_backend = "responses"

Windows

%userprofile%\.grok\config.toml（内容同上）

可用模型

模型 ID说明
grok-4.5当前上游已开通
保存后运行 grok inspect 确认配置生效。此处用的是平台 API 地址，不是 xAI 官方 OAuth 地址。

使用地址key 分组选 default-openai

🔗 https://api.snowyowl.cn/v1

全平台通用

opencode.json（放项目根目录或 OpenCode 全局配置目录，保存后重启）
{
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.snowyowl.cn/v1",
        "apiKey": "sk-换成你的key"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5",
          "limit": { "context": 1050000, "output": 128000 },
          "options": { "store": false },
          "variants": { "low": {}, "medium": {}, "high": {}, "xhigh": {} }
        }
      }
    }
  },
  "$schema": "https://opencode.ai/config.json"
}
OpenCode 会直接读取 provider.openai.options 里的 baseURL 与 apiKey。

常见问题

现象原因 / 解决
403 INSUFFICIENT_BALANCE余额用完了，找管理员充值/续期
403 SUBSCRIPTION_EXPIRED订阅到期，找管理员续期
503 channel pricing restriction模型 ID 不对，换本文档「可用模型」表里的 ID
401 invalid api keykey 复制错 / 被禁用，回控制台核对或重建
连不上 / 超时先在在线测试页验证 key 本身通不通，再查本地网络
🦉 霜鸮科技 · 内部 API 网关 ｜ key 仅限本人使用，请勿外泄