飞源 API · 使用教程

一个 Key、一个网址，同时用 Claude 全家桶 + GPT + AI 出图。OpenAI 兼容接口，国内访问稳定，支付宝充值。

飞源 API 是什么

飞源 API 是一个 AI 模型中转站：把 Claude、GPT、AI 出图这些能力，整理成统一的一套接口，方便你在任何"能自定义接口地址"的软件或代码里直接调用。

你可以这么理解：你自己的工具发起请求 → 飞源负责鉴权、算额度、调度、转发 → 再把模型返回的结果原样发回给你。飞源本身不是聊天软件，而是一层"接口服务"。

好处很直接：不用国外信用卡、不用改代码、开箱即用。一个 sk-xxxxxx 的 Key 走天下，Claude Code、Cherry Studio、Cursor、ChatBox、Dify… 换个地址就能用。

常见可接入场景

只要你的工具支持填"自定义 Base URL + API Key"，基本都能接飞源。常见的有：

• AI 编程工具：Claude Code、Codex CLI、Cursor 等。
• OpenAI 兼容客户端：Cherry Studio、ChatBox、NextChat、LobeChat、Open WebUI 等。
• 自己写的程序：Python、Node.js、Java、Go、PHP… 任意后端项目。
• 工作流 / 自动化：只要能发 HTTP 请求并带上 API Key，就能按接口调用（如 Dify、n8n）。

关于对话数据

飞源不保存你的对话原文、提示词和模型回复。请求内容只用于"当次转发"：发到飞源 → 转发给上游模型 → 结果原路返回。

为了扣费和售后排查，系统只会记录必要的用量信息，例如：调用时间、用的哪个 Key、请求了哪个模型、消耗多少 token、耗时、金额、以及 IP / User-Agent 等基础访问记录。这些都不含你的完整聊天内容。

基本运行流程

一句话：飞源只做"接口网关 + 额度管理"，不提供人工查看聊天记录的功能。

前置工作（开始前 5 步）

这是所有接入教程的第一步。无论你后面用 Claude Code、Codex、Cherry Studio 还是编辑器插件，都要先完成：注册、充值、建 Key，并搞懂接入时要填哪几样。

第 1 步：注册并登录账号

1. 打开注册页 feiyuanapi.com/register，按提示创建账号（新账号余额为 0）。
2. 注册后，登录进入用户后台 feiyuanapi.com。

注册、验证码、邮箱验证遇到问题，直接进 QQ 群找客服（见页面底部）。

第 2 步：充值

调用会消耗额度，正式用之前先确认账户里有余额。飞源的充值分两种情况：

1. 第一次购买 → 走闲鱼下单：在闲鱼店铺拍下对应额度，客服拉你进 QQ 群、给你开通账号和额度。
   闲鱼店铺地址请进 QQ 群向客服获取。
2. 之后续充 → 站内支付宝自助：登录 feiyuanapi.com → 右上角钱包 / 充值页 → 扫支付宝码付款，自助到账，不用再找人。

第 3 步：创建 API Key

API Key 就是你接入各种软件时填的"密钥"。后面教程里凡是让你填 API Key 的，填的都是这里生成的这串。

1. 登录后，打开左侧令牌页。
2. 点新建令牌，起个好认的名字（如 Claude Code、Cherry Studio）。
3. 生成后得到一串 sk-xxxxxx，复制保存好。

第 4 步：搞懂接入时要填的"三样"

几乎所有工具接飞源，核心就填三样：接口地址、API Key、模型名称。

第 5 步：先做一次小额测试

第一次接入别一上来就跑大任务，先用一句短问题试通：

1. 在工具里填好接口地址、API Key、模型名。
2. 发一句简单的：你好，请用一句话回复我。
3. 能正常回复 = 接通了。报错先查：Key 是否复制完整、账户有没有余额、模型名是否填对。
4. 还搞不定，把报错截图发 QQ 群，客服帮你定位。

有哪些模型可用

常用的直接复制下面的模型名即可。完整清单与实时价格以平台「定价 / 模型」页为准。

Claude 系列（写代码、推理首选）

GPT 系列（对话）

AI 出图

接入教程总览

接入分两大类，按你的用途挑一类看即可：

一、官方工具接入

官方工具（Claude Code、Codex、Claude Desktop、Gemini CLI…）统一推荐用 CC Switch 管理。这样你不用自己去找配置文件、手改 JSON / 环境变量，后续换 Key、换模型、换供应商都是点一下的事。

CC Switch 是一个专门管理这些 AI 工具配置的桌面软件，把多种工具的配置集中到一个界面里。官方地址：

• 官网：ccswitch.io
• GitHub / 下载：github.com/farion1231/cc-switch

安装 CC Switch

按你的系统选安装包：

• Windows：进 Releases 下载页，下 .msi 安装包，双击安装。
• macOS：推荐 .dmg 安装包；会用 Homebrew 的也可以：

brew install --cask cc-switch

• Linux：进 Releases 下载页，按系统选 .deb / .rpm / .AppImage。

装好后打开 CC Switch。第一次启动如果提示导入已有配置，可按提示操作；没用过这些工具的直接跳过，下面手动加飞源供应商。

在 CC Switch 里添加"飞源"供应商

先准备好两样：飞源接口地址 + 你的 API Key。这步只做一次，之后 Claude Code、Codex 等都能复用。

操作：打开 CC Switch → 添加供应商（优先选"通用 / 自定义 / Custom Provider"这类）→ 按上表填好 → 保存 → 点启用 / 切换到"飞源"。

Codex 接入

Codex 主要用 GPT / Codex 系列模型做代码。

1. 确认电脑已装好并打开 CC Switch。
2. 在 CC Switch 找到 Codex 入口，选择 / 添加"飞源"供应商。
3. 接口地址填 https://feiyuanapi.com/v1，API Key 填你的 Key，模型选 GPT 系列（如 gpt-5.5）。
4. 点启用 / 切换，关掉旧终端、重开一个新终端。
5. 启动 Codex，发一句：请用一句话介绍你能做什么。能回就成功。

Claude Code 接入

Claude Code 主要用 Claude 系列做代码分析、项目修改、长上下文开发。

1. 打开 CC Switch，找到 Claude Code 入口。
2. 选择 / 添加"飞源"供应商，接口地址填 https://feiyuanapi.com（不加 /v1）。
3. API Key 填你的 Key，模型选 Claude 系列（如 claude-opus-4-8）。
4. 点启用 / 切换。切换后没生效就重启一下 Claude Code 或终端。
5. 打开 Claude Code，发一句：请回复"Claude Code 接入测试成功"。

Claude Desktop 接入

Claude Desktop 偏桌面聊天和 MCP 场景。如果你主要是写代码，优先用 Claude Code；确实需要 Desktop 再按下面来。

1. 打开 CC Switch，找到 Claude Desktop 入口。
2. 选择 / 添加"飞源"供应商，接口地址填 https://feiyuanapi.com，API Key 填你的 Key，模型选 Claude 系列。
3. 启用后，完全退出 Claude Desktop 再重新打开，新建对话发一句测试即可。

若当前版本 CC Switch 没有 Claude Desktop 入口，先用 Claude Code。

附：不用 CC Switch 的手动配置

喜欢自己动手、或者不想装 CC Switch，可以直接改环境变量。以 Claude Code 为例，把下面三行写进 ~/.zshrc 或 ~/.bashrc，然后重开终端：

export ANTHROPIC_BASE_URL="https://feiyuanapi.com"
export ANTHROPIC_API_KEY="sk-你的飞源key"
export ANTHROPIC_MODEL="claude-opus-4-8"

之后直接敲 claude 启动。安装 Claude Code：

npm install -g @anthropic-ai/claude-code

Windows 从零装 Claude Code（WSL）

纯 Windows、国内网络也能跑通 Claude Code，下面是从零到能用的完整流程。只想聊天、怕麻烦的，直接用 Cherry Studio 更省事，不必走这条。

① 装 WSL + Ubuntu（Linux 环境）

1. 开始菜单搜 PowerShell → 右键「以管理员身份运行」。
2. 输入 wsl --install，回车，装完重启电脑。
3. 重启后设 Linux 用户名 + 密码。输密码时屏幕不显示字符是正常的，打完直接回车。

② 装 Node.js（走国内镜像）

打开 Ubuntu，确认提示符是 名字@电脑:~$（不是 C:\…>），把下面一整条粘进去回车：

cd ~ && curl -fL -O https://npmmirror.com/mirrors/node/v20.18.0/node-v20.18.0-linux-x64.tar.xz && mkdir -p ~/.local/node && tar -xJf node-v20.18.0-linux-x64.tar.xz -C ~/.local/node --strip-components=1 && echo 'export PATH="$HOME/.local/node/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc && node -v

末尾打印出 v20.18.0 即成功。别用网上的 nvm 一键脚本——那些从 GitHub 下载，国内经常卡死。

③ 装 Claude Code

npm config set registry https://registry.npmmirror.com && npm install -g @anthropic-ai/claude-code

敲 claude --version 能出版本号就装好了。

④ 接飞源（关键一步）

把下面四行写进去（sk-你的飞源Key 换成你自己的，模型名换成你 Key 开放的）：

echo 'export ANTHROPIC_BASE_URL="https://feiyuanapi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的飞源Key"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-opus-4-8"' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1' >> ~/.bashrc
source ~/.bashrc

⑤ 启动，发一句测试

进到你要写代码的文件夹，手动敲（别粘贴）claude → 选主题一路默认 → 发句「你好」，能正常回复就全线打通。

报错对照表 · 一眼定位（照着做还卡住，先来这查）

官方工具接入常见问题

大多数接入失败不是模型坏了，而是配置没生效、Key 填错、余额不足、模型名不对。

1. 切换供应商后没生效？
确认 CC Switch 当前启用的是"飞源" → 关掉终端 → 重开 → 重启 Codex / Claude Code → 再发测试。多数 CLI 切换后都要重启终端。

2. 提示 API Key 无效？
回令牌页重新复制 Key，检查有没有多复制空格、换行、中文冒号，再回 CC Switch 重新粘贴保存。

3. 提示余额不足？
登录 feiyuanapi.com 确认余额；刚充完还提示不足就刷新后台或稍等再试。续充走站内支付宝，首充走闲鱼。

4. 提示模型不存在 / 不可用？
检查模型名是否拼对，并确认是飞源开放的模型（Claude / GPT / 出图）。不确定就从模型表直接复制。

5. 不知道该选 Claude 还是 GPT？
写代码 / 跑 Codex → 优先 GPT / Codex 系列；用 Claude Code → 优先 Claude 系列；出图 → 用 gpt-image 系列。

二、第三方工具接入

第三方工具指 Cherry Studio、ChatBox、Cursor、VS Code 插件、Open WebUI、NextChat、LobeChat 等支持自定义 API 地址的软件。共同点：你自己填 Base URL + API Key + 模型名，界面不同但本质一样。

第三方工具统一填写规则

这类工具优先选 OpenAI 兼容接口 接入，通用填法：

Cherry Studio 接入

常见桌面聊天客户端，按 OpenAI 兼容方式接。官网 cherry-ai.com。

1. 打开 Cherry Studio → 设置 → 模型服务商 → 添加服务商。
2. 类型选 OpenAI / OpenAI Compatible，名称填"飞源"。
3. API 密钥填你的 Key；API 地址填 https://feiyuanapi.com/v1。
4. 在模型管理里手动添加要用的模型（如 claude-opus-4-8、gpt-5.5）。
5. 保存后选该模型新建对话，发 你好，请用一句话回复我 测试。有"测试连接"按钮可先点一下。

ChatBox 接入

官网 chatboxai.app。

1. 打开 ChatBox → 设置 → 模型提供方，选 OpenAI 兼容 / 自定义 OpenAI。
2. API Key 填你的 Key；API Host / Base URL 填 https://feiyuanapi.com/v1。
3. 填要用的模型名，保存后新建会话测试。

提示模型不存在多半是模型名填错；提示鉴权失败多半是 Key 没复制完整。

Cursor 接入

Cursor 支持自定义 OpenAI 接口，适合在里面用飞源的 GPT / OpenAI 兼容模型做代码问答。

1. Cursor → Settings → Models。
2. 添加 OpenAI API Key（填你的飞源 Key）。
3. 打开 Override OpenAI Base URL，填 https://feiyuanapi.com/v1。
4. 添加 / 选择飞源支持的模型名（如 claude-sonnet-4-6），关闭"Use Cursor's API"。
5. 在聊天窗口发一句测试。

VS Code 插件接入

VS Code 里的 AI 插件很多（Continue、Cline、Roo Code、CodeGPT…），配置入口各不同，但都按 OpenAI 兼容 思路填：

Continue 若要手写配置，可参考：

name: 飞源
version: 0.0.1
schema: v1
models:
  - name: 飞源 Claude
    provider: openai
    model: claude-opus-4-8
    apiBase: https://feiyuanapi.com/v1
    apiKey: 你的APIKey

Cline / Roo Code：能看到 OpenAI Compatible 就优先选它 → Base URL 填 https://feiyuanapi.com/v1 → 填 Key 和模型名 → 短问题测试。若插件里没有 Base URL 输入框，说明当前模式不适合接中转，换成 OpenAI Compatible / Custom Provider 模式再试。

OpenClaw / Hermes / OpenCode 接入

OpenClaw、Hermes、OpenCode 这类 Agent 工具，建议优先用 CC Switch 统一管理，别单独手改配置文件——这些工具各有自己的配置格式，手改容易写错路径、字段名、引号、逗号，后续换 Key / 换模型也难维护。

1. 打开 CC Switch，找到 OpenClaw / Hermes / OpenCode 对应入口。
2. 添加 / 选择"飞源"供应商，API Key 填你的 Key。
3. 接口地址按 CC Switch 页面提示填，一般是 https://feiyuanapi.com 或 https://feiyuanapi.com/v1。
4. 模型填飞源支持的（如 claude-opus-4-8），启用后重启对应工具测试。

不确定填哪个地址，先按 CC Switch 页面提示填；请求失败再把报错截图发 QQ 群。

Open WebUI / NextChat / LobeChat 接入

这类网页 / 自部署聊天面板，只要支持 OpenAI 兼容就能接。通用填法：

• API Key：你的飞源 Key
• Base URL：https://feiyuanapi.com/v1
• Model：飞源开放的模型名（可把常用的 Claude、GPT 分别加进去）

加完先用短问题测试，再正式跑长对话。

自写程序接入（开发者）

你是开发者的话，直接把飞源当 OpenAI 兼容接口用即可，官方 SDK 通常只改两处：API Key 和 Base URL。

一行验证（curl）

curl https://feiyuanapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [{"role":"user","content":"你好，介绍下你自己"}]
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的key",
    base_url="https://feiyuanapi.com/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-4-8",
    messages=[{"role": "user", "content": "用 Python 写个快排"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的key",
  baseURL: "https://feiyuanapi.com/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-opus-4-8",
  messages: [{ role: "user", content: "你好，请用一句话回复我。" }],
});
console.log(resp.choices[0].message.content);

AI 出图（Python）

from openai import OpenAI

client = OpenAI(api_key="sk-你的key", base_url="https://feiyuanapi.com/v1")

resp = client.images.generate(
    model="gpt-image-2",
    prompt="一只在咖啡馆喝拿铁的橘猫，写实风格",
    size="1024x1024",
    quality="medium",
    n=1,
)
print(resp.data[0].url)

Claude 原生 SDK（需要 Prompt Cache 省钱时用）—— 注意 base_url 不加 /v1：

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-你的key",
    base_url="https://feiyuanapi.com",   # 注意：不加 /v1
)

resp = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1000,
    system=[{
        "type": "text",
        "text": "你是一个专业代码助手……（长系统提示）",
        "cache_control": {"type": "ephemeral"},   # 开启缓存，重复部分省钱
    }],
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.content[0].text)

第三方工具常见问题

1. Base URL 到底填哪个？
第三方 OpenAI 兼容客户端优先填 https://feiyuanapi.com/v1；软件明确说不要带 /v1 时再改成 https://feiyuanapi.com。

2. 为什么显示模型不存在？
模型名拼错、填了没开放的模型、或软件自动改写了模型名。回后台看可用模型，复制准确名字再加。

3. 为什么提示 401 / Unauthorized？
Key 没复制完整、前后多了空格、填成了别的平台的 Key、或 Key 被删被禁。回令牌页重新复制粘贴。

4. 普通聊天能用，Agent / 工具调用不能用？
多半是客户端请求格式问题（Agent 模式可能走 Responses API / 函数调用等）。优先改用 Claude Code / Codex + CC Switch 方案，并把完整报错截图发群。

5. 找客服排查要带什么？
一次性给全：软件名称和版本、你填的 Base URL、模型名、完整报错截图、是否确认有余额。别把完整 Key 发群里，要排查只发前 6 位 + 后 4 位。

联系客服