快速开始

Altus 提供与官方完全一致的 Anthropic 与 OpenAI 协议。把客户端的地址换成下面的 base URL，用 Altus 的 API key 认证即可。

协议Base URL用于
Anthropichttps://altusapi.comClaude Code、Anthropic SDK（SDK 会自动拼接 /v1/messages）
OpenAIhttps://altusapi.com/v1Codex、OpenAI SDK、各类兼容 OpenAI 的工具

认证

在 控制台 创建 API key（以 sk-altus- 开头）。以下两种请求头都可以：

x-api-key: sk-altus-…
Authorization: Bearer sk-altus-…

key 只在创建时显示一次。泄露后请在控制台立即删除并新建。

模型列表

请求里的 model 填下表中的 id。Claude 模型只能走 Anthropic 接口，GPT 模型只能走 OpenAI 接口。价格见 模型与价格。

Claude Code

编辑 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）：

settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://altusapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-altus-…",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

或者直接运行 altus setup claude，它会自动写入上面的配置并保留你已有的其他设置。想用 Fable 时，在 Claude Code 里输入 /model claude-fable-5-1。

Codex

编辑 ~/.codex/config.toml：

config.toml
model_provider = "altus"
model = "gpt-6-astra"
model_reasoning_effort = "high"

[model_providers.altus]
name = "Altus"
base_url = "https://altusapi.com/v1"
wire_api = "responses"
env_key = "ALTUS_API_KEY"

然后在环境变量里设置 ALTUS_API_KEY=sk-altus-…。也可以运行 altus setup codex，它会把 key 写进 Codex 的配置，不需要设置环境变量。

SDK 与 curl

Anthropic Python SDK

python
from anthropic import Anthropic

client = Anthropic(base_url="https://altusapi.com", api_key="sk-altus-…")
msg = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=2048,
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(msg.content[0].text)

OpenAI Python SDK

python
from openai import OpenAI

client = OpenAI(base_url="https://altusapi.com/v1", api_key="sk-altus-…")
resp = client.responses.create(model="gpt-6-astra", input="用一句话介绍你自己")
print(resp.output_text)

curl（流式）

shell
curl https://altusapi.com/v1/messages \
  -H "x-api-key: $ALTUS_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-fable-5-1","max_tokens":1024,"stream":true,
       "messages":[{"role":"user","content":"你好"}]}'

altus 命令行

单文件、零依赖（只需要 Python 3.8+）。安装：

curl -fsSL https://altusapi.com/install.sh | sh
irm https://altusapi.com/install.ps1 | iex
命令作用
altus login手机号 + 密码登录，凭证保存在 ~/.altus/config.json（仅本人可读）
altus balance余额与近 7 天消费
altus usage [--days 7]按模型汇总用量
altus keys list | create NAME [--quota USD] | revoke ID管理 API key
altus setup claude [--model ID]写入 Claude Code 配置（自动创建 key）
altus setup codex [--model ID]写入 Codex 配置（自动创建 key，原配置会备份）
altus models可用模型与价格
altus test [MODEL]发一条极短的请求，检查连通性

接口

方法路径说明
POST/v1/messagesAnthropic Messages，支持 stream
POST/v1/messages/count_tokens计算 token 数，不收费
POST/v1/responsesOpenAI Responses，支持 stream
POST/v1/responses/compactCodex 上下文压缩
POST/v1/chat/completionsOpenAI Chat Completions，支持 stream
GET/v1/models模型列表

计费规则

错误码

HTTP类型含义
401authentication_errorkey 无效、已停用或已删除
402insufficient_balance余额不足，请充值
403key_quota_exceeded该 key 达到你设置的额度上限
404not_found_error模型 id 不存在
429rate_limit_error / overloaded_error并发超限或服务繁忙，稍后重试
5xxapi_error上游暂时不可用，可重试

并发与限制