Fyoulink API 使用文档

01服务简介与优势

Fyoulink API 是一个独立运营的第三方 AI 模型 API 中转 / 加速服务，为开发者提供对 Claude 系列大模型的稳定、便捷访问。

• 双格式兼容：同时提供 Anthropic 原生格式（/v1/messages）与 OpenAI 兼容格式（/v1/chat/completions），几乎无需改动现有代码即可迁移。
• 开箱即用：兼容 Claude Code、Anthropic 官方 SDK、OpenAI SDK 与 cURL，只需替换基址（Base URL）与密钥。
• 价格透明：充值 1 人民币 = 1 美元额度，模型倍率 1:1，与官方价格一致，按 token 实际用量计费。
• 超长上下文：支持最高 1M（100 万）token 超长上下文（需携带相应 beta 头）。
• 中文友好：面向中文开发者，文档、示例与客服均使用简体中文。

02快速开始（5 分钟接入）

整体流程只需四步：注册账号 → 邮箱验证激活 → 创建 API Key → 充值 → 开始调用。

03API 基址与鉴权

API 基址（Base URL）

鉴权方式

所有请求都需携带你的 API Key（sk- 开头），支持两种传递方式，任选其一：

• Anthropic 风格：请求头 x-api-key: sk-你的密钥
• Bearer 风格：请求头 Authorization: Bearer sk-你的密钥

04在 Claude Code 中配置

接入 Claude Code 只需配置两个环境变量：ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN。

方式 A：环境变量（快速验证）

export ANTHROPIC_BASE_URL="https://www.fyoulink.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

claude

$env:ANTHROPIC_BASE_URL = "https://www.fyoulink.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"

claude

方式 B：settings.json（持久化，推荐）

在用户主目录的 .claude 目录下创建或编辑 settings.json（Windows 路径 %userprofile%\.claude；macOS / Linux 为 ~/.claude；若目录不存在，先运行一次 claude 自动生成）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.fyoulink.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}

05调用示例（可直接复制）

以下示例替换密钥后可直接运行。默认使用模型 claude-sonnet-5，可按第 6 节替换为其它型号。

Anthropic 官方 SDK（Python）

from anthropic import Anthropic

client = Anthropic(
    base_url="https://www.fyoulink.com",
    api_key="sk-你的密钥",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句话介绍 Fyoulink API。"}],
)
print(resp.content[0].text)

OpenAI 兼容 SDK（Python）

from openai import OpenAI

client = OpenAI(
    base_url="https://www.fyoulink.com/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "用一句话介绍 Fyoulink API。"}],
)
print(resp.choices[0].message.content)

cURL — Anthropic 原生格式

curl https://www.fyoulink.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1024,
       "messages":[{"role":"user","content":"你好，Fyoulink！"}]}'

cURL — OpenAI 兼容格式

curl https://www.fyoulink.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5",
       "messages":[{"role":"user","content":"你好，Fyoulink！"}]}'

06支持的模型清单

Fyoulink 支持 Claude 全系列模型。下表为常用型号，以后台控制台展示的实时清单为准（新模型上线后同步更新）。单价为美元 / 每百万 token。

07计费与充值

• 汇率：充值 1 人民币 = 1 美元额度。
• 模型倍率：1:1，与模型官方定价一致，无额外加价。
• 计费方式：按 token 实际用量计费，费用 = 输入 token + 输出 token，按所用模型单价结算。
• 余额规则：调用实时扣减额度；余额不足时暂停调用，充值到账后自动恢复。

08超长上下文（1M）

Fyoulink 支持最高 1M（100 万）token 超长上下文，适合超大代码库、长文档分析等场景。需在请求中携带对应的 beta 头（以官网公告的最新标识为准）。

curl https://www.fyoulink.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: context-1m-2025-08-07" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":2048, ...}'

09并发与限流

• 默认并发：每账号默认 5 路并发。
• 调整方式：可根据套餐提升，或联系客服 email@fyoulink.com 申请调整。
• 超出并发或触发限流时接口可能返回 429 Too Many Requests，建议客户端实现指数退避重试（首次等待 1s，逐次翻倍）。

10常见问题 FAQ

11联系与支持

• 技术支持邮箱：email@fyoulink.com（占位地址，可按实际替换）
• 官网：https://www.fyoulink.com
• 反馈问题时请附上：所用模型、请求示例（务必隐去完整密钥）、错误码与时间戳，便于快速定位。