跳到主要内容
shuntio

接入文档

两个 base_url,一个密钥。以下内容假设你已经从控制台拿到了密钥。

接口地址

协议Base URL
OpenAIhttps://api.shuntio.com/v1
Anthropichttps://api.shuntio.com

请求头携带密钥 Authorization: Bearer sk-…

Claude Code

Claude Code 在启动时读取这两个环境变量。写进 shell 配置文件即可长期生效。

export ANTHROPIC_BASE_URL="https://api.shuntio.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"

用 ANTHROPIC_AUTH_TOKEN,不要用 ANTHROPIC_API_KEY —— 后者会被当作 Anthropic 官方密钥校验并拒绝。

Codex CLI

在 ~/.codex/config.toml 里新增一个 provider,然后用对应的 profile 启动。

[model_providers.shuntio]
name = "shuntio"
base_url = "https://api.shuntio.com/v1"
env_key = "SHUNTIO_API_KEY"

[profiles.shuntio]
model_provider = "shuntio"
model = "your-model-id"
export SHUNTIO_API_KEY="sk-your-key"
codex --profile shuntio

provider 名和 profile 名要区分开,它们在配置里是两个不同的键。

OpenAI SDK

只需要改 base_url,请求与响应结构完全不变。

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.shuntio.com/v1",
    api_key="sk-your-key",
)

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.shuntio.com/v1',
  apiKey: process.env.SHUNTIO_API_KEY,
});

curl

curl https://api.shuntio.com/v1/chat/completions \
  -H "Authorization: Bearer $SHUNTIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [{ "role": "user", "content": "ping" }]
  }'

Cursor、Cherry Studio 及其他客户端

任何支持自定义 OpenAI 兼容端点的客户端,填的都是同样三个值。

Base URLhttps://api.shuntio.com/v1
API 密钥sk-…
模型填 /models.json 里的任意 id /models.json

验证

这条命令应返回当前密钥可用的模型列表。

curl -s https://api.shuntio.com/v1/models \
  -H "Authorization: Bearer $SHUNTIO_API_KEY"

如果出错了

先看状态码:

  • 401 — 密钥缺失、写错或已吊销。确认请求头是Authorization: Bearer sk-…
  • 其他情况:控制台的请求日志记录了该次调用上游的真实返回,比根据状态码猜测可靠。

← 返回首页