FufuAPI 全平台配置指南

专业的AI API服务平台，完美兼容OpenAI接口。支持GPT、Claude、Gemini、DeepSeek等主流大模型，一键配置，即刻使用。

🚀 快速开始访问官网 →

服务交付标准

标准化交付流程，确保每一位客户都能快速上手

📦

标准化交付包

包含API Key、Base URL、推荐模型列表、测试命令，一站式交付

⚡

3分钟极速配置

平均3分钟完成全平台配置，无需技术背景即可上手

🔒

安全可靠

企业级安全架构，Key隔离管理，支持额度控制

💬

7×24技术支持

专业客服团队，响应及时，问题解决率高

🌐

多平台支持

支持20+主流AI工具和开发平台，覆盖全场景

📈

高可用保障

多节点部署，智能路由选择，确保服务稳定

快速开始（3分钟）

只需3个参数即可开始使用

参数	值	说明
Base URL	`https://fucaixie.xyz/v1`	注意保留 `/v1` 后缀
API Key	`fk-xxxxxxxxxxxxxxxxxxxx`	替换为您的真实密钥
Model	`gpt-4o`	根据场景选择合适模型

首次测试命令

cURL

curl https://fucaixie.xyz/v1/chat/completions ^
  -H "Content-Type: application/json" ^
  -H "Authorization: Bearer fk-xxxxxxxxxxxxxxxxxxxx" ^
  -d "{\"model\": \"gpt-4o\", \"messages\": [{\"role\": \"user\", \"content\": \"你好，请回复ok\"}]}"

💡

提示

返回JSON数据（含 choices 字段）即代表配置成功。如果返回错误，请查看「问题排查」章节。

两种获取密钥方式

根据您的业务模式选择合适的获取方式

方式一：用户自助注册获取

适合场景

终端用户自行注册、管理API Key，适合SaaS平台或个人开发者

打开 https://fucaixie.xyz 注册并登录账号
进入控制台 →「API Keys / 密钥管理」
点击「创建新密钥」
复制密钥并妥善保存（密钥只会显示一次）

💡

建议

开发环境和生产环境使用不同的Key，便于管理和监控。

方式二：平台方直接发放

适合场景

您作为平台方向终端客户发放Key，适合API分销或企业客户交付

建议交付包包含以下内容：

用户专属 API Key
Base URL：https://fucaixie.xyz/v1
推荐模型列表（3~5个常用模型）
一条测试命令
常见错误快速排查说明

交付模板（可直接复制）

你的 FufuAPI 已开通。
请配置：
- Base URL: https://fucaixie.xyz/v1
- API Key: fk-xxxxxxxxxxxxxxxxxxxx
- 推荐模型: gpt-4o / claude-sonnet-4-5 / gemini-2.5-flash

测试命令：
curl https://fucaixie.xyz/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer 你的Key" -d "{\"model\":\"gpt-4o\",\"messages\":[{\"role\":\"user\",\"content\":\"hello\"}]}"

通用配置规则

所有工具通用的核心配置规则

Base URL 规则

⚠️

常见错误

很多用户只填 https://fucaixie.xyz 而忘记 /v1，导致404错误。正确格式必须包含 /v1 后缀。

正确格式	`https://fucaixie.xyz/v1`	✅ 可用
错误格式	`https://fucaixie.xyz`	❌ 404

鉴权方式

                        HTTP Header
                    
Authorization: Bearer 你的APIKey

获取模型列表

cURL

curl https://fucaixie.xyz/v1/models ^
  -H "Authorization: Bearer fk-xxxxxxxxxxxxxxxxxxxx"

API 连通性测试（必做）

交付前务必完成以下测试，确保服务可用

测试一：获取模型列表

cURL

curl https://fucaixie.xyz/v1/models ^
  -H "Authorization: Bearer fk-xxxxxxxxxxxxxxxxxxxx"

测试二：聊天接口（推荐）

cURL

curl https://fucaixie.xyz/v1/chat/completions ^
  -H "Content-Type: application/json" ^
  -H "Authorization: Bearer fk-xxxxxxxxxxxxxxxxxxxx" ^
  -d "{\"model\": \"gpt-4o\", \"messages\": [{\"role\": \"user\", \"content\": \"请回复测试成功\"}]}"

测试三：流式输出

cURL (Stream)

curl -N https://fucaixie.xyz/v1/chat/completions ^
  -H "Content-Type: application/json" ^
  -H "Authorization: Bearer fk-xxxxxxxxxxxxxxxxxxxx" ^
  -d "{\"model\": \"gpt-4o\", \"stream\": true, \"messages\": [{\"role\": \"user\", \"content\": \"写一首四行诗\"}]}"

模型选择建议

根据不同场景选择最适合的模型

场景	推荐模型	说明
日常问答	gpt-4o gpt-3.5-turbo	稳定、通用、性价比高
编程开发	gpt-5.3-codex gpt-5.1-codex	代码能力突出
长文本处理	claude-sonnet-4-5 claude-opus-4-5	长上下文优势
低成本快速	gemini-2.5-flash glm-4.6-flash	成本友好、响应快速
推理任务	deepseek-r1 qwen3-thinking	数学、逻辑推理能力强

🚀

新手建议

初次使用建议从 gpt-4o 开始，稳定可靠，易于上手。

12+ 工具详细配置

主流AI工具和开发平台的配置指南

⚡ Cursor

AI增强代码编辑器

打开 Settings → Models/API
选择「OpenAI Compatible」
填写 Endpoint: https://fucaixie.xyz/v1
填写 API Key 和 Model: gpt-4o

🤖 Cline (Roo)

VSCode AI编程助手

安装 Cline 插件
Provider 选择「OpenAI Compatible」
填写 Base URL/Key/Model
保存设置即可使用

💬 Chatbox

跨平台AI客户端

设置 → AI API 设置
选择「OpenAI 兼容」
API URL: https://fucaixie.xyz/v1
API Key: 你的密钥 / Model: gpt-4o

📝 Continue (VSCode)

                                settings.json
                            
{
  "models": [{
    "provider": "openai",
    "model": "gpt-4o",
    "apiKey": "你的Key",
    "apiBaseUrl": "https://fucaixie.xyz/v1"
  }]
}

🌊 Windsurf

打开 Settings → AI Providers
添加自定义 Provider
URL: https://fucaixie.xyz/v1
填写 API Key 和默认模型

🦙 Claude Code CLI

                                Bash
                            
export ANTHROPIC_API_KEY="你的Key"
export ANTHROPIC_BASE_URL="https://fucaixie.xyz"

⚡ OpenAI Codex CLI

                                ~/.config/codex/config.toml
                            
[provider]
type = "openai"
api_key = "你的Key"
base_url = "https://fucaixie.xyz/v1"
model = "gpt-5.1-codex"

🔮 Gemini CLI

                                config.json
                            
{
  "apiKey": "你的Key",
  "baseUrl": "https://fucaixie.xyz/v1",
  "model": "gemini-2.5-flash"
}

📦 Open WebUI

                                环境变量
                            
OPENAI_API_KEY=你的Key
OPENAI_BASE_URL=https://fucaixie.xyz/v1

💻 LobeChat

                                环境变量
                            
OPENAI_API_KEY=你的Key
OPENAI_PROXY_URL=https://fucaixie.xyz/v1

🌙 NextChat

                                环境变量
                            
OPENAI_API_KEY=你的Key
BASE_URL=https://fucaixie.xyz

🌍 Immersive Translate

插件设置 → 自定义API
选择「OpenAI兼容」
URL: https://fucaixie.xyz/v1
模型: gpt-4o-mini 或 glm-4.6

常见错误排查

快速定位和解决常见问题

401 Unauthorized 未授权

可能原因：

API Key填写错误
Key已过期或被禁用
Key权限不足
Key复制时多了空格

解决方案

重新复制Key，确保无多余空格
确认使用的是最新Key，非旧Key
使用 /v1/models 单独测试Key有效性
联系客服确认Key状态

404 Not Found 资源不存在

可能原因：

Base URL缺少 /v1 后缀
模型名称拼写错误
模型名称大小写不匹配
当前Key未开通该模型

解决方案

检查Base URL是否包含 /v1
确认模型名称完全正确
先调用 /v1/models 获取可用模型列表
确认Key已开通该模型权限

429 Too Many Requests 请求过多

可能原因：

请求频率超过限制
并发请求过多
账户额度不足

解决方案

降低请求频率，添加重试间隔
减少并发连接数
检查账户剩余额度
错峰使用或升级套餐

5xx Server Error 服务器错误

可能原因：

服务端临时维护
网络波动
特定模型负载过高

解决方案

等待30-60秒后重试
切换其他模型尝试
记录错误时间和详情
提交工单联系技术支持

安全规范与企业建议

保护您的API Key安全是企业级使用的关键

安全规范

🚫

禁止暴露Key

永远不要把API Key直接写在前端代码、HTML或公开文档中

📁

使用.env文件

使用环境变量文件存储敏感信息，添加至.gitignore

🔄

定期轮换Key

建议每3-6个月更换一次API Key，降低泄露风险

👥

分离环境

开发、测试、生产环境使用不同的Key，独立管理

.env 模板

.env

OPENAI_API_KEY=你的Key
OPENAI_BASE_URL=https://fucaixie.xyz/v1

.gitignore

.env
.env.*
*.local

企业建议

每个团队或项目独立分配Key
对每个Key设置额度上限，防止超额使用
日志中只保留Key的后4位进行追溯
人员变动时及时回收和更新Key
建立Key使用监控和告警机制

技术支持

多种渠道为您提供服务支持

💬

微信客服

添加微信好友，获取即时支持

客服V：Xfc12091

📝

在线工单

提交详细问题描述，24小时内响应

工单系统入口

📧

邮件支持

发送邮件至官方邮箱

support@fucaixie.xyz

工单模板（可直接复制）

工单模板

【FufuAPI 技术支持工单】

问题类型：配置问题 / 技术问题 / 计费问题
使用工具：Cursor / Cline / Continue / Chatbox / 其他
操作系统：Windows / macOS / Linux
Base URL（脱敏）：
模型名：
错误代码：401 / 404 / 429 / 500
错误原文：
复现步骤：
已尝试排查：
联系方式：
（可附截图）

FAQ 常见问题

解答您最关心的问题

Q1: 我不会编程，能不能使用FufuAPI？ ▼

当然可以！FufuAPI设计时就考虑到了非技术用户。您可以直接使用Chatbox、NextChat等图形化客户端，只需填写URL和Key即可使用，完全不需要编程基础。我们提供详细的图文教程，3分钟即可上手。

Q2: 为什么一直提示401错误？ ▼

401错误通常由以下原因导致：
1. API Key填写错误（最常见）- 请检查是否有空格或多余字符
2. 使用了过期的Key - 请确认使用的是最新创建的Key
3. Key已被禁用 - 请联系客服确认Key状态

排查方法：使用 curl https://fucaixie.xyz/v1/models -H "Authorization: Bearer 你的Key" 单独测试Key是否有效。

Q3: 为什么模型显示404错误？ ▼

模型404错误的常见原因：
1. Base URL缺少 /v1 后缀（最多）
2. 模型名称拼写错误或大小写不匹配
3. 当前API Key未开通该模型的权限

解决方法：先调用 /v1/models 获取可用的模型列表，确认模型名称完全正确。

Q4: 多人能共用一个API Key吗？ ▼

技术上可以共用，但我们强烈建议一人一Key。原因如下：
1. 便于使用统计和费用分摊
2. 出现问题时可以快速定位到具体用户
3. 人员变动时无需更换所有人的配置
4. 便于独立设置额度和权限

企业用户建议为每个团队或项目分配独立Key。

Q5: 如何最稳妥地验证配置是否正确？ ▼

建议按以下顺序进行验证：

第一步： 测试模型列表接口
curl https://fucaixie.xyz/v1/models -H "Authorization: Bearer 你的Key"

第二步： 测试聊天接口

curl https://fucaixie.xyz/v1/chat/completions -H "Authorization: Bearer 你的Key" -d "{"model":"gpt-4o","messages":[{"role":"user","content":"hi"}]}"

两步都返回正常JSON即代表配置成功。

Q6: 支持流式输出吗？ ▼

是的，FufuAPI完全支持Server-Sent Events (SSE)流式输出。在请求中设置 "stream": true 即可启用流式模式。流式输出适合长文本生成场景，可以实时显示生成进度，提升用户体验。

Q7: 有使用额度限制吗？ ▼

额度限制取决于您购买套餐的类型：
1. 免费套餐：有基础额度限制
2. 付费套餐：根据套餐级别有不同的额度和请求频率限制
3. 企业套餐：可定制化额度，支持高并发

具体限额可在控制台查看，或联系客服咨询。

服务条款与退换政策

📜 虚拟服务退款政策

温馨提示：FufuAPI所提供的API服务属于数字/虚拟商品，一旦开通或交付使用，即时消耗服务器资源。

退款说明：虚拟服务一经开通/交付，不支持任何理由退款。购买前请充分了解服务内容和计费方式。如遇服务不可用等特殊情况，请通过工单提交详细说明，我们将以工单核验的方式进行处理。

不可抗力：因服务器故障、网络中断等不可抗力导致的服务中断，我们将根据实际情况进行补偿，但不接受以此为由的退款申请。

🔐 数据安全与隐私

数据处理：我们仅将您的API请求转发至上游模型服务商，不会保存您的对话内容。所有API请求均通过加密通道传输。

合规使用：请确保您的使用方式符合当地法律法规，不得利用本服务从事违法活动。

服务变更：我们保留调整服务内容和价格的权利，调整前将通过官网公告通知。

FufuAPI 全平台配置指南

服务交付标准

标准化交付包

3分钟极速配置

安全可靠

7×24技术支持

多平台支持

高可用保障

快速开始（3分钟）

首次测试命令

两种获取密钥方式

方式一：用户自助注册获取

方式二：平台方直接发放

通用配置规则

Base URL 规则

鉴权方式

获取模型列表

推荐默认参数

API 连通性测试（必做）

测试一：获取模型列表

测试二：聊天接口（推荐）

测试三：流式输出

模型选择建议

12+ 工具详细配置

常见错误排查

解决方案

解决方案

解决方案

解决方案

安全规范与企业建议

安全规范

禁止暴露Key

使用.env文件

定期轮换Key

分离环境

.env 模板

.gitignore

企业建议

技术支持

微信客服

在线工单

邮件支持

工单模板（可直接复制）

FAQ 常见问题

服务条款与退换政策