使用指南

全面支持 Claude Code、Cursor、Codex、Trae、OpenCode 等 AI coding 工具接入

1. 创建 API Key

在「API Key 管理」页面创建 Key，生成后立即复制保存（仅显示一次）

2. 配置客户端

将客户端 base_url 指向 https://keypool.space，填入你的 Key

3. 选择模型并使用

根据所用工具选择对应协议的模型，开始编码

AI Coding 工具接入

8 款工具

Claude Code

Anthropic Messages/v1/messages

推荐模型：claude-fable-5

环境变量 / 配置项

ANTHROPIC_BASE_URL

https://keypool.space

中转服务地址

ANTHROPIC_AUTH_TOKEN

sk-nexus-your-api-key

你的 Nexus API Key

ANTHROPIC_MODEL

claude-fable-5

默认模型（可选）

配置步骤

1在「API Key 管理」页面创建 Key 并复制
2配置上述环境变量（或用 cc switch 工具一键切换）
3运行 claude 命令即可，模型列表会自动发现 claude 系列

⚠ claude-fable-5 任意客户端均可调用，推荐使用 Claude Code 获得最佳工具链体验。

通用 SDK 示例（OpenAI 格式）

非流式请求示例

curl https://keypool.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-nexus-your-api-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "stream": false
  }'

流式响应（SSE）

流式请求示例

curl https://keypool.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-nexus-your-api-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "写一首诗"}],
    "stream": true
  }'

接口列表

方法	路径	说明	适用工具
POST	`/v1/chat/completions`	对话补全（OpenAI 兼容，核心接口）	Cursor / Trae / OpenCode / Aider
POST	`/v1/responses`	Responses API（Codex CLI 原生协议）	Codex CLI
POST	`/v1/messages`	Anthropic Messages（Claude Code 原生协议，支持图片/视频输入）	Claude Code / Cline / Roo Code
POST	`/v1/messages/count_tokens`	Anthropic Token 计数	Claude Code
GET	`/v1/models`	获取可用模型列表（按客户端自动过滤）	全部工具
POST	`/v1/images/generations`	图像生成（gpt-image-2 等）	通用

视频理解（MiniMax-M3）

多模态

MiniMax-M3 是原生多模态模型，支持文本、图片、视频输入，经 /v1/messages（Anthropic Messages 协议）调用。视频以标准 Anthropic content block 传入，支持 HTTP(S) URL 和 base64 两种格式。仅 MiniMax-M3 支持视频，M2.x 系列不支持。

curl 调用示例（视频 URL）

curl -X POST https://keypool.space/v1/messages \
  -H "x-api-key: sk-nexus-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M3",
    "max_tokens": 300,
    "messages": [{
      "role": "user",
      "content": [
        { "type": "text", "text": "用一句话描述这个视频的内容。" },
        { "type": "video", "source": { "type": "url", "url": "https://example.com/video.mp4" } }
      ]
    }]
  }'

Python（Anthropic SDK）

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-nexus-your-api-key",
    base_url="https://keypool.space",
)

message = client.messages.create(
    model="MiniMax-M3",
    max_tokens=300,
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "视频里发生了什么？"},
            {"type": "video", "source": {"type": "url", "url": "https://example.com/video.mp4"}},
        ],
    }],
)
print(message.content[0].text)

视频 URL 格式

source.type = "url"，url 须为 http(s):// 开头的可公网访问视频地址（mp4 等）

Base64 格式

source.type = "data"，url = "data:video/mp4;base64,..." 适合本地视频上传场景

常见问题

不同 AI coding 工具用哪个端点？

Claude Code / Cline / Roo Code 走 Anthropic Messages（/v1/messages）；Codex CLI 走 Responses API（/v1/responses）；Cursor / Trae / OpenCode / Aider 走 OpenAI Chat Completions（/v1/chat/completions）。本站三种协议均已完整兼容。

支持哪些模型？

OpenAI（GPT-5.5/5.4/4o/o1/o3-mini）、Anthropic（Claude Fable 5/Opus/Sonnet/Haiku）、智谱（GLM-5/4）、Google（Gemini 3/2.5）、DeepSeek（V4/V3）、通义千问等 37+ 模型。Claude Code 仅展示 claude 系列，Codex 仅展示 gpt/o 系列，其余工具展示全部。

claude-fable-5 在不同工具下表现如何？

claude-fable-5 已对所有客户端开放调用。Claude Code / Cline / Roo Code 走 Anthropic Messages 协议，可完整使用其专属工具链（bash_tool、文件操作等）；Cursor / Trae / OpenCode / Codex 等走 OpenAI 格式也可调用该模型，但工具调用能力受客户端自身协议限制。

如何修改现有的 OpenAI SDK 代码接入？

只需将 api_key 替换为你的 Nexus Key，并将 base_url 改为 https://keypool.space/v1 即可，其余代码完全兼容，无需修改。

支持流式响应（SSE）吗？

支持。所有端点（chat/completions、messages、responses）均支持 stream: true，格式与各自协议完全一致。

MiniMax-M3 支持视频理解吗？如何调用？

支持。MiniMax-M3 是原生多模态模型，支持文本/图片/视频输入，经 /v1/messages（Anthropic Messages 协议）调用。视频以标准 Anthropic content block 传入：{"type":"video","source":{"type":"url","url":"https://视频地址.mp4"}}，也支持 base64 格式（source.type=data, url=data:video/mp4;base64,...）。仅 MiniMax-M3 支持视频，M2.x 系列不支持图片/视频。

支持函数调用（Function Calling / Tool Use）吗？

支持。三种协议的工具调用格式会自动转换：OpenAI tools、Anthropic tool_use、Responses tools 均可，中转层会按上游协议适配。

API Key 丢失了怎么办？

API Key 生成后仅显示一次，无法找回。请在「API Key 管理」页面吊销旧 Key 并创建新 Key，更新你的客户端配置即可。