首页> 都市> KingFlow AI 完整接入教程

KingFlow AI 完整接入教程

著

本文标签：

KingFlow AI 接入教程创建密钥接口测试工具配置错误排查 KingFlow AI 完整接入教程从创建 API Key 到接入 Claude Code Codex Cursor 与自建应用本教程适合第一次使用 KingFlow AI 的个人开发者和团队成员。完成文中的步骤后，你将能够创建 API Key，选择正确的兼容协议，用命令行验证连接

来源：KingFlow AI 主角: 更新: 2026-10-21 10:14:03

在线阅读

【扫一扫】手机随心读

读书简介

KingFlow AI 完整接入教程

从创建 API Key 到接入 Claude Code Codex Cursor 与自建应用

本教程适合第一次使用 KingFlow AI 的个人开发者和团队成员。完成文中的步骤后，你将能够创建 API Key，选择正确的兼容协议，用命令行验证连接，并把 Claude Code、Codex、Cursor、Cline 或其他支持自定义 API 的工具接入平台。

资料核验日期 2026-10-21

开始前的准备

可以接收验证邮件的邮箱，用于注册和登录 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 配置中。

两种协议如何选择

使用对象	协议	ase *L
GPT、Codex、部分国产模型	OpenAI Compati*le	`https://api.njushen.com/v1`
Claude、Claude Code	Anthropic Compati*le	`https://api.njushen.com`

先用命令行验证接口

先完成一个最小请求，再配置桌面客户端。这样可以把接口问题与客户端配置问题分开排查。把示例中的密钥和模型 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 设置，按下表完成配置。

配置项	填写内容
协议或 Provider	按模型选择 OpenAI Compatile 或 Anthropic Compatile。
ase *L	OpenAI 填 https://api.njushen.com/v1；Anthropic 填 https://api.njushen.com。
API Key	填入控制台创建的 sk- 密钥，不要添加多余空格或引号。
Model	填写模型广场或控制台展示的完整模型 ID。
Streaming	如果客户端提供开关，建议开启。部分模型或线路要求 stream 为 true。

在 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)

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

常见错误和处理方法

现象	常见原因	处理方法
401 未授权	密钥拼写错误、已禁用、额度用尽，或客户端没有按所选协议发送认证头。	重新复制 sk- 密钥；检查密钥状态和额度；确认协议与认证方式匹配。
404 模型不存在	模型 ID 写错，或当前订阅分组不包含该模型。	从模型广场或控制台复制完整模型 ID，并检查账户分组权限。
503 无可用账号	平台对应通道的账号池暂时不可用。	等待后重试；切换同类备用模型；持续出现时联系平台**。
连接超时	本地网络、**、DNS 或防火墙阻止访问接口。	先在浏览器或终端检查域名可达性，再检查**和防火墙设置。
返回内容为空或中断	客户端不支持流式响应，或目标模型要求 stream 为 true。	开启 Streaming；用官方 curl 示例先验证接口，再回到客户端排查。
调用成功但扣费异常	选择了不同分组、模型价格口径理解有误，或订阅倍率未纳入估算。	停止批量调用，核对用量明细、模型单价和套餐规则，必要时联系支持。