SEVN DocsIntegration guides返回首页
SEVN Docs

5 分钟完成首次接入。

创建 API Key,复制 Base URL,按你的工具选择配置方式。 测试成功后,可以在使用日志里查看请求状态和消费记录。

Quick Start

按这三步走,先把第一条请求跑通。

不需要理解后台概念。你只需要准备 API Key、Base URL 和一个可用模型名。

接入前准备

准备 API Key 和 Base URL。

先创建自己的 API Key,再把下面的 Base URL 填到工具配置里。示例 Key 只是占位,请替换成你自己的密钥。

Base URL
http://43.133.253.110:3012/v1
curl 快速验证
curl http://43.133.253.110:3012/v1/chat/completions \
  -H "Authorization: Bearer sevn_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt",
    "messages": [
      { "role": "user", "content": "用一句话回复:SEVN 已接入" }
    ]
  }'
选择工具
选择系统
Responses 已支持

Codex CLI

适合代码修改、自动执行命令、长任务开发。

创建 API Key
接入前确认

把示例里的 sevn_sk_live_xxx 替换成你自己的 API Key。完整密钥只展示一次,请妥善保存。

权限建议

建议 Key scope 勾选 responses;如果还要聊天兼容,再额外勾选 chat。

1

安装工具

只显示你当前选择系统的安装命令。

安装命令
npm install -g @openai/codex
# 或者:brew install --cask codex
2

配置 SEVN

写入 ~/.codex/config.toml,或在当前终端会话里执行。

配置
model = "gpt"
model_provider = "sevn"

[model_providers.sevn]
name = "SEVN"
base_url = "http://43.133.253.110:3012/v1"
env_key = "SEVN_API_KEY"
3

启动验证

看到 Codex 返回模型响应,即说明配置生效。 如果没有返回,去调用日志确认请求是否进入 SEVN。

启动命令
codex "用一句话回复:SEVN 已接入"
说明

如果你电脑上已有 OPENAI_API_KEY 或 OPENAI_BASE_URL,建议单独使用 SEVN_API_KEY,避免串到原始 OpenAI 配置。

兼容状态

当前优先保证常用工具链路。

Responses

Codex CLI 推荐路径,已可转发。

Chat Completions

OpenClaw 和常见 OpenAI-compatible 客户端可用。

Claude Messages

Claude Code 基础接入可验证,复杂工具调用继续补齐。

排错

如果没有返回,先看这三项。

401 / 无权限

先检查 Key 是否正确、scope 是否包含当前工具需要的能力。

Endpoint 错误

确认 Base URL 使用当前文档里的 SEVN 地址,不要混用原始 OpenAI 或 Anthropic 地址。

工具没有走 SEVN

检查本机是否还保留 OPENAI_BASE_URL、ANTHROPIC_BASE_URL 等旧环境变量。

Reference外部资料