飞源 API · 接入文档

Claude 全家桶 + GPT 系列 + AI 出图｜OpenAI 兼容接口｜支付宝充值｜国内直连免翻墙

一、飞源 API 是什么

飞源 API 是面向国内用户的 AI 模型中转服务：一个 Key、一个网址，同时调用 Claude、GPT 和 AI 出图。不用翻墙、不用国外信用卡，支付宝直接充值。

所有 OpenAI 兼容的工具（Claude Code、Cherry Studio、Cursor、ChatBox、Dify…）只要把"接口地址"换成飞源的，再填上 Key，就能用，不用改代码。

二、三步开始

第 1 步：注册 + 充值，拿到 Key

1. 注册：打开 feiyuanapi.com 注册账号（新账号余额为 0）。
2. 充值：进用户群 t.me/feiyuanapi_group 或私聊 @baote911，说明金额 → 扫支付宝码付款 → 把截图发回 → 收到充值码后，平台右上角头像 → 兑换 → 填入充值码。
3. 建 Key：平台左侧 令牌 页 → 新建令牌，得到一串 sk-xxxxxx，这就是你的 API Key。

第 2 步：记住这两个值（配置时到处要用）

第 3 步：填进你的工具（见第四章）

任何工具，找到"自定义 / OpenAI 兼容接口"的设置，把地址和 Key 填进去即可。

三、有哪些模型可用

常用的填下面这些模型名即可。完整清单与实时价格，以平台「定价 / 模型」页为准。

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

GPT 系列（对话）

AI 出图

四、常用工具配置

下面每个工具的逻辑都一样：地址填飞源、Key 填你的 sk、模型填上面表里的名字。

4.1 Claude Code（Anthropic 官方 CLI）⭐ 最推荐写代码

安装：

# 跨平台（Node.js）
npm install -g @anthropic-ai/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 用的地址 不加 /v1。

4.2 Cherry Studio（桌面客户端，新手友好）

设置 → 模型服务 → 新建（选 OpenAI 类型）：

• API 地址：https://feiyuanapi.com
• API 密钥：你的 sk-xxx
• 模型：手动添加 claude-opus-4-8、claude-sonnet-4-6、gpt-5.5 等

4.3 Cursor（AI 代码编辑器）

Settings → Models → 打开 Custom OpenAI API：

• Base URL：https://feiyuanapi.com/v1
• API Key：你的 sk-xxx
• Model：claude-sonnet-4-6 或 claude-opus-4-8
• 关闭 "Use Cursor's API"

4.4 ChatBox

设置 → 模型提供方 → OpenAI API：

• API Host：https://feiyuanapi.com
• API Key：你的 sk-xxx

4.5 Dify（工作流 / 知识库平台）

模型供应商 → 选 "OpenAI-API-compatible" → 添加：

• API endpoint URL：https://feiyuanapi.com/v1
• API Key：你的 sk-xxx
• 模型名：claude-opus-4-8 等

4.6 其它（LobeChat / Open WebUI / NextChat …）

都是同一招：找到 OpenAI 接口设置，地址填 https://feiyuanapi.com/v1，Key 填 sk-xxx。

五、代码调用（开发者）

5.1 一行验证（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":"你好，介绍下你自己"}]
  }'

能返回回复就说明通了。换 model 即可切换其它模型。

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

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

5.4 Claude 原生 SDK（需要 Prompt Cache 省钱时用）

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)

💡 同一段长上下文重复使用时，开启 cache_control 后第 2 次起命中缓存，输入费大幅下降。Claude Code、Cursor 等工具已内置，无需手动设置。

六、常见问题

Q：报 401 / 认证失败？
A：① Key 填错或写法不对，正确是 Authorization: Bearer sk-xxx；② 地址用错——OpenAI 类工具用 https://feiyuanapi.com/v1，Claude Code / Anthropic SDK 用 https://feiyuanapi.com（不加 /v1）。

Q：报 404 / model not found？
A：模型名拼错了。请直接从第三章表格复制，例如 claude-opus-4-8、gpt-5.5。

Q：偶尔报 503 / "无可用账号"？
A：对应模型瞬时排队，稍等重试即可；持续出现请在用户群反馈，我们会扩容。

Q：余额不足怎么充值？
A：进用户群 t.me/feiyuanapi_group 或私聊 @baote911，告知金额 → 扫支付宝码付款 → 发截图 → 收到充值码后在平台「兑换」页填入。

Q：有免费试用吗？
A：新用户可联系客服申请试用额度（有效期 3 天）。