SEVN DocsIntegration guides返回首页
SEVN Docs

5 分钟完成首次接入。

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

Quick Start

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

不需要理解后台概念。你只需要准备 API Key、Base URL 和一个可用模型名。当前开放采用人工开通,拿到账号后再创建 Key。

接入前准备

准备 API Key 和 Base URL。

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

Base URL
https://ai.aisevn.com/v1
curl 快速验证
curl -N https://ai.aisevn.com/v1/responses \
  -H "Authorization: Bearer sk-sevn_xxx" \
  -H "Accept: text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.2",
    "input": [
      {
        "type": "message",
        "role": "user",
        "content": [{ "type": "input_text", "text": "用一句话回复:SEVN 已接入" }]
      }
    ],
    "store": false,
    "stream": true
  }'
选择工具
选择系统
Responses 已支持

Codex Desktop / CLI

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

创建 API Key
接入前确认

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

权限建议

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

1

安装工具

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

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

配置 SEVN

写入 Codex config.toml + auth.json,或在当前终端会话里执行。

配置
# 第 1 步:写入 ~/.codex/config.toml
model_provider = "sevn"
model = "gpt-5.2"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.sevn]
name = "SEVN"
base_url = "https://ai.aisevn.com/v1"
wire_api = "responses"
requires_openai_auth = true

# 第 2 步:写入 ~/.codex/auth.json
{
  "OPENAI_API_KEY": "sk-sevn_xxx"
}

# 第 3 步:建议同时写入终端环境变量,方便 Codex CLI 和其他工具读取
echo 'export SEVN_API_KEY=sk-sevn_xxx' >> ~/.zshrc && source ~/.zshrc

# 第 4 步:完全退出 Codex Desktop 后重新打开
3

启动验证

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

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

Codex Desktop 推荐使用 auth.json。requires_openai_auth = true 会让 Codex 从 auth.json 的 OPENAI_API_KEY 字段读取密钥,这个字段里填写 SEVN Key 即可。建议同时设置 SEVN_API_KEY 环境变量,方便 Codex CLI、脚本和其他工具读取;但不要在 config.toml 里额外写 env_key,否则 Codex 可能只检查环境变量并报 Missing environment variable。修改后必须完全退出 Codex Desktop 再重新打开。

兼容状态

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

Codex / Responses

Base URL 使用 https://ai.aisevn.com/v1,首次验证推荐模型 gpt-5.2,并开启 stream。

OpenClaw / Chat Completions

按 OpenAI-compatible endpoints 配置 base_url、api_key、default_model;首次验证推荐 Claude Haiku。

Claude Code / Messages

Base URL 使用 https://ai.aisevn.com,Claude Code 会请求 /v1/messages。

排错

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

401 / 无权限

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

Endpoint 错误

确认 Base URL 使用当前文档里的 SEVN 正式域名,不要再使用服务器 IP。

工具没有走 SEVN

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

Reference外部资料