开始前的准备

• 可以接收验证邮件的邮箱，用于注册和登录 KingFlow AI。
• 已购买订阅套餐或已充值余额，并确认目标模型位于当前账户可用分组中。
• 准备接入的客户端或开发环境，例如 Claude Code、Codex、Cursor、Cline、Cherry Studio，或能够发送 **** 请求的终端。
• 用于测试的非敏感提示词。首次连接不要发送源代码、客户资料或其他机密数据。

步骤 1 注册账号并创建 API Key

访问 KingFlow AI 官网完成注册并登录。在控制台创建新的 API Key。平台文档说明密钥以 sk- 开头。创建后立即复制并保存，因为部分控制台可能只在创建时完整显示密钥。

不要把密钥写进公开代码仓库、聊天截图、共享文档或前端网页。团队使用时，建议为不同成员、项目或环境分别创建密钥，便于限制额度、识别用量和及时撤销。

步骤 2 确认套餐 分组和模型 ID

进入模型广场或控制台模型列表，确认准备调用的模型 ID。模型名称必须与平台当前显示完全一致，不能只使用厂商名或自行简写。

按量余额和订阅套餐的计费口径不同。订阅套餐通常受有效期、周额度、月额度和分组倍率影响；余额按量则根据实际 Token 使用扣费。开始接入前，先确认账户仍有可用额度。

步骤 3 选择兼容协议和 *ase **L

调用 GPT、Codex、部分国产模型，或使用**兼容 OpenAI 的客户端时，选择 OpenAI 兼容协议。*ase **L 为 https://api.**nju**shen.com/v1。

调用 Claude 系列或连接 Claude Code 时，选择 Anthropic 兼容协议。*ase **L 为 https://api.**nju**shen.com。不要把 OpenAI 地址中的 /v1 直接复制到 Claude Code 配置中。

两种协议如何选择

先用命令行验证接口

先完成一个最小请求，再配置桌面客户端。这样可以把接口问题与客户端配置问题分开排查。把示例中的密钥和模型 ID 替换为自己的值。

OpenAI 兼容接口测试

curl https://api.**nju**shen.com/v1/chat/completions \
  -H "Authorization: *earer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型ID>",
    "messages": [
      {"role": "user", "content": "请回复：连接成功"}
    ],
    "stream": true
  }'

Windows PowerShell 中如果 curl 被映射为其他命令，可把开头的 curl 改成 curl.exe。

Anthropic 兼容接口测试

curl https://api.**nju**shen.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型ID>",
    "**x_tokens": 256,
    "messages": [
      {"role": "user", "content": "请回复：连接成功"}
    ],
    "stream": true
  }'

收到模型返回内容后，再检查控制台是否出现对应的用量记录。

接入 Claude Code

Claude Code 使用 Anthropic 兼容地址。下面的设置只对当前终端会话生效。

**cOS 与 Linux

export ANTHROPIC_*ASE_**L="https://api.**nju**shen.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

Windows PowerShell

$env:ANTHROPIC_*ASE_**L="https://api.**nju**shen.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

启动后发送一个简短问题。连接成功后，再根据自己的系统与团队规范决定是否持久化环境变量。

接入 Codex 和 OpenAI 系工具

Codex 及其他 OpenAI 兼容客户端使用带 /v1 的 *ase **L。设置后从同一终端启动客户端。

**cOS 与 Linux

export OPENAI_*ASE_**L="https://api.**nju**shen.com/v1"
export OPENAI_API_KEY="sk-你的密钥"
codex

Windows PowerShell

$env:OPENAI_*ASE_**L="https://api.**nju**shen.com/v1"
$env:OPENAI_API_KEY="sk-你的密钥"
codex

如果客户端已经打开，应完全退出后重新启动。

接入 Cursor Cline 和 Cherry Studio

打开模型或 Provider 设置，按下表完成配置。

在 Python 应用中接入

如果项目已经使用 OpenAI Python SDK，可以指定 KingFlow AI 的兼容地址并从环境变量读取密钥。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    *ase_url="https://api.**nju**shen.com/v1",
)

response = client.chat.completions.create(
    model="<模型ID>",
    messages=[{"role": "user", "content": "请回复：连接成功"}],
)

print(response.choices[0].message.content)

生产代码还应增加超时、重试、日志脱敏和错误处理。

常见错误和处理方法

密钥和数据安全

• 把 API Key 放在环境变量或密钥管理工具中，不要直接写入源代码。
• 为开发、测试和生产环境分别创建密钥，并设置与用途相符的额度。
• 发现密钥泄露后立即禁用或删除旧密钥，创建新密钥并检查近期用量。
• 提示词与生成内容会经过 KingFlow AI 服务器并转发给上游提供商。发送敏感数据前，应核对隐私**和所在组织的合规要求。
• 生产应用应设置连接超时、有限次数重试、失败告警、成本监控和备用模型。

上线前检查清单

• 账户已有余额或有效订阅。
• 密钥状态正常，且没有暴露在代码或日志中。
• *ase **L 与模型所用协议一致。
• 模型 ID 来自当前模型广场或控制台。
• 小额请求能够返回结果，并能在用量明细中找到记录。
• 客户端已开启所需的流式响应选项。
• 关键业务已经配置超时、重试、告警和备用方案。

完成接入后的下一步

接口能够稳定返回结果后，再逐步提高请求量，并持续观察响应时间、错误率和实际扣费。需要切换模型时，先在模型广场确认模型 ID 和分组权限，再做小额验证。关键业务应保留备用模型或备用通道。