Joule Joule

接入文档

Joule 网关同时提供 OpenAI 兼容与 Anthropic 兼容两种协议，任何主流客户端与 Agent 都能接入。所有请求按上游返回的真实用量逐笔记账。

一、准备工作

二、OpenAI 兼容接入（Cherry Studio / Cline / LobeChat / 任意 SDK）

端点与鉴权

API 端点   https://joule.xmzf.space/v1
鉴权方式   Authorization: Bearer sk-joule-你的Key
模型列表   GET https://joule.xmzf.space/v1/models

curl 示例

curl https://joule.xmzf.space/v1/chat/completions \
  -H "Authorization: Bearer sk-joule-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"你好"}],"max_tokens":512}'

客户端配置

三、Claude Code 接入（Anthropic 兼容）

Joule 提供 Anthropic Messages 协议端点 /v1/messages，Claude Code 可直连。请求的模型名若以 claude 开头，会自动路由到我们的默认旗舰模型；也可以用 ANTHROPIC_MODEL 指定具体模型。

环境变量方式（推荐）

export ANTHROPIC_BASE_URL=https://joule.xmzf.space
export ANTHROPIC_API_KEY=sk-joule-你的Key
export ANTHROPIC_MODEL=deepseek-v4.1-flash
claude

settings.json 方式

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://joule.xmzf.space",
    "ANTHROPIC_API_KEY": "sk-joule-你的Key",
    "ANTHROPIC_MODEL": "deepseek-v4.1-flash"
  }
}

CC Switch 添加供应商

在 CC Switch「添加供应商 → 自定义」中粘贴：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://joule.xmzf.space",
    "ANTHROPIC_API_KEY": "sk-joule-你的Key"
  }
}

curl 示例（原生 Anthropic 格式）

curl https://joule.xmzf.space/v1/messages \
  -H "x-api-key: sk-joule-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash","max_tokens":512,"messages":[{"role":"user","content":"你好"}]}'

流式（stream: true）同样支持，返回标准 Anthropic SSE 事件流。当前为纯文本内容块；图片输入与工具调用（tools / tool_use）暂不支持——依赖工具调用的客户端功能（如 Claude Code 执行命令、编辑文件）可能不可用，我们会在后续版本补齐。

四、限额说明

档位月费月额度（官方价值）5h 滚动窗口周上限同时并发
Lite$1$8$1.5$43 个请求
Plus$5$50$10$255 个请求
Pro$13$150$30$7510 个请求

额度按官方 API 牌价折算，所有模型通用；各模型的月度上限见模型广场。窗口用尽会返回 429 与重置时间，重置倒计时在控制台实时可见。同时并发按账号计：同一账号的所有 Key、OpenAI 与 Anthropic 两种端点共享并发额度，超出同样返回 429，等任一在途请求完成即恢复。

限时免费模型 MiniMax M3 Free（模型名 minimax-m3-free，活动持续至 2026 年 11 月 1 日）：完全免费、不占用订阅额度与窗口；按每日 token 限额与独立并发执行——Lite 每日 1,000 万 tokens / 并发 1，Plus 每日 2,500 万 / 并发 2，Pro 每日 1 亿 / 并发 5，北京时间每日 0 点重置。

五、常见问题