① 注册、登录与获取 API Key
所有客户端后续可共用同一套账号与 Key，先在这里完成一次，后面直接复用。
第 1 步 · 注册账号
- 打开 https://napi.funengyun.com/，点击右上角「注册」。
- 填写用户名 + 密码 + 确认密码，提交注册。
真实截图 · 平台注册页（用户名 / 密码 / 确认密码）
第 2 步 · 登录
- 在登录页输入用户名 / 密码登录即可。
真实截图 · 平台登录页（用户名 / 密码）
第 3 步 · 选择分组（按模型选套餐）
- 进入控制台「分组 / 套餐」，根据你打算使用的模型选择对应的折扣分组。
- 不同分组对应不同价格档位（如 35 折 / 9 折 / 百度 7 折 / 第四范式备用 8 折等），模型越贵越适合更高折扣分组。
第 4 步 · 创建 API Key
- 进入控制台 → 左侧「API 密钥」 → 点击右上角「创建 API 密钥」。
- 填写名称（如 WorkBuddy），在「分组」下拉框中选择上一步选好的折扣分组，按需设置额度 / 过期时间。
- 点击保存，Key 只展示一次，格式为
sk-xxxxxxxx，立即复制保存到本地。
真实截图 · 控制台「创建 API 密钥」弹窗（名称 + 分组下拉 + 额度 / 过期设置）
真实截图 · API 密钥列表（创建后在这里看到 Key，点击复制即可）
对接需要的 3 个关键信息
- Base URL
- https://napi.funengyun.com/v1 （OpenAI 兼容）
- API Key
- sk-xxxxxxxx （你刚创建的令牌）
- 协议
- OpenAI 兼容：文本 /chat/completions，图片 /images/generations，视频 /videos/generations
提示：本平台基于 New API 搭建，同时支持 OpenAI 与 Anthropic Messages API 两种协议。任何支持自定义 Base URL 的客户端都能直接接入，无需改代码。
② WorkBuddy 对接
WorkBuddy 支持自定义 OpenAI 兼容模型供应商，填入 Base URL + Key 即可。
配置步骤
添加自定义模型
- 打开 WorkBuddy → 点左下角个人头像 →设置 → 模型 → 添加自定义模型 → 提供商选自定义
- API Base URL 填
https://napi.funengyun.com/v1/chat/completions。 - API Key 填你的
sk-xxxxxxxx。 - 默认模型填一个文本模型，例如
fn-kimi-k3。 - 保存后可在模型下拉里，看到刚加入的模型。
添加自定义模型
③ Codex（OpenAI Codex CLI）对接
Codex 是 OpenAI 官方 CLI，通过 ~/.codex/config.toml 配置 Base URL，再配合环境变量传入 API Key 即可接入。
config.toml 持久化配置
编辑 ~/.codex/config.toml（若文件不存在则新建），写入以下内容：
# ~/.codex/config.toml —— 将 Codex 的内置 OpenAI 提供商指向富能云网关 openai_base_url = "https://napi.funengyun.com/v1"
API Key 写入 shell 配置持久化，或放入项目 .env 文件（Codex 自动加载）：
# 写入 ~/.bashrc 或 ~/.zshrc 持久化 export OPENAI_API_KEY="sk-xxxxxxxx" # 之后直接运行 codex --model deepseek-v4-pro "帮我重构这段 Python 代码"
Codex 以文本 / 代码模型为主，图片、视频模型建议通过平台 API（见第 ⑤ 页 curl 示例）或支持的客户端调用。
Codex 桌面版（图形化客户端）
Codex Desktop 与 CLI 共享 ~/.codex/ 配置目录。只要 CLI 步骤的 config.toml 配好，桌面版自动读取，无需重复配置。下面介绍桌面版特有的登录流程与首次使用步骤。
方式一 · 复用 CLI 配置（推荐）
- 先按上面 CLI 步骤配好
~/.codex/config.toml。 - 在
~/.codex/auth.json写入 API Key（桌面版强制要求此文件）：
// ~/.codex/auth.json
{
"OPENAI_API_KEY": "sk-xxxxxxxx"
}
- 打开 Codex Desktop 应用 → 选择工作目录 → 直接进入对话界面，无需走登录流程。
方式二 · 登录界面手动填写
- 下载并安装 Codex Desktop：访问
https://developers.openai.com/codex/app，按操作系统选择安装包（Windows / macOS / Linux）。 - 首次启动后会看到欢迎页，点击底部的「使用其他方式登录」（不要点「使用 ChatGPT 继续」，那是走 OpenAI 官方账号）。
- 在弹出的窗口粘贴你的
sk-xxxxxxxx，点击「继续」即可登录。
Codex Desktop 欢迎页 · 选择「使用其他方式登录」（底部红色框标注）
点击「使用其他方式登录」后 · 粘贴 OpenAI API 密钥（即富能云 sk-xxxxxxxx）
说明：UI 登录界面只让你填 API Key，Base URL 走的是
~/.codex/config.toml 里的 openai_base_url。所以方式二需要先准备好 config.toml，再点 UI 登录。两条路径都说的是同一件事：先配 config.toml，再走 auth.json 或 UI 登录。多渠道切换：如需在不同网关 / 官方账号间快速切换，可使用开源工具 CC Switch（
https://github.com/farion1231/cc-switch），图形化增删 Codex 渠道配置。④ Cursor / Claude / 其他 OpenAI 客户端
核心都是「改 Base URL + 填 Key」，区别只在配置入口。
Cursor
- Settings → Models → 找到 OpenAI Base URL Override。
- 填
https://napi.funengyun.com/v1，API Key 填sk-xxxxxxxx。 - 在模型列表选择fn-glm-5.3 / fn-deepseek-v4-flash 等。
真实截图 · Cursor Settings → Models（填入 OpenAI API Key 与 Override OpenAI Base URL）
Claude（Claude Code / 桌面端）
本平台基于 New API 搭建，同时支持 OpenAI 与 Anthropic Messages API 两种协议。Claude Code 走 Anthropic 协议直连即可。
- 在终端中设置环境变量
ANTHROPIC_BASE_URL与ANTHROPIC_AUTH_TOKEN（注意：Anthropic 协议的 Base URL 不带/v1，Claude Code 会自动拼接路径）。 - 也可写入
~/.claude/settings.json的env字段持久化，或使用 CC Switch 等第三方工具一键切换。
# Claude Code —— 环境变量方式（临时生效） export ANTHROPIC_BASE_URL="https://napi.funengyun.com" export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx" export ANTHROPIC_API_KEY="" # 必须显式设为空，否则 Claude Code 会尝试直连 Anthropic 官方 # 指定使用的模型（网关侧模型名，如 fn-deepseek-v4-flash 等） export ANTHROPIC_MODEL="fn-deepseek-v4-flash" claude
说明：与 OpenAI 协议不同，Anthropic 协议的 Base URL 填
https://napi.funengyun.com（不带 /v1，Claude Code 会自动拼接 /v1/messages）。认证变量用 ANTHROPIC_AUTH_TOKEN（自定义端点场景），同时必须显式将 ANTHROPIC_API_KEY 设为空字符串，否则 Claude Code 会尝试用 OAuth 直连 Anthropic 官方而忽略自定义端点。如需持久化，推荐写入 ~/.claude/settings.json：{"env": {"ANTHROPIC_BASE_URL": "https://napi.funengyun.com", "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx", "ANTHROPIC_API_KEY": ""}}通用 OpenAI 客户端（Cherry Studio / Lobe Chat / DeepChat / AionUI 等）
- 添加「自定义 OpenAI 兼容提供商」，Base URL =
https://napi.funengyun.com/v1，Key =sk-xxxxxxxx。 - 平台已内置一键接入：Cherry Studio、AionUI、流畅阅读、CC Switch、DeepChat、Lobe Chat、AMA问天、OpenCat 等，按引导授权即可。
真实截图 · Cherry Studio 官网（全能 AI 工作站，支持自定义 OpenAI 兼容提供商）
真实截图 · LobeHub / Lobe Chat 官网（支持自定义模型提供商）
⑤ 平台支持模型总览
以下为线上实际在售模型（来自 /api/pricing 实测）。客户端里填的「模型名」必须与这里完全一致。
文本模型
| 模型名（Model ID） | 厂商 | 适用场景 |
|---|---|---|
| fn-glm-5.3 / fn-glm-5.3-flash | 智谱 Zhipu | 通用对话、写作、Agent |
| fn-qwen3.8-max | 阿里巴巴 Qwen | 长上下文、通用任务 |
| fn-deepseek-v4-flash / fn-deepseek-v4-pro | DeepSeek | 编码、推理、高性价比 |
| fn-kimi-k3 | 月之暗面 | 高速对话、低延迟 |
图片模型
| 模型名（Model ID） | 厂商 | 计费（参考） |
|---|---|---|
| fn-doubao-seedream-5.0 | 字节豆包 | ¥0.22 / 张 |
| fn-doubao-seedream-4.5 | 字节豆包 | ¥0.25 / 张 |
| fn-doubao-seedream-4.0 | 字节豆包 | ¥0.20 / 张 |
视频模型
| 模型名（Model ID） | 厂商 | 说明 |
|---|---|---|
| Doubao-Seedance-2.0 | 字节豆包 | 高质量视频生成 |
| Doubao-Seedance-2.0-fast | 字节豆包 | 快速视频生成 |
| Doubao-Seedance-2.0-mini | 字节豆包 | 轻量 / 低成本 |
| Doubao-Seedance-2.5 | 字节豆包 | 高质量视频生成 |
调用示例（curl）
# 文本
curl https://napi.funengyun.com/v1/chat/completions \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"fn-glm-5.3","messages":[{"role":"user","content":"你好"}]}'
# 图片
curl https://napi.funengyun.com/v1/images/generations \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"fn-doubao-seedream-5.0","prompt":"一只在太空中的猫","n":1,"size":"1024x1024"}'
# 视频
curl https://napi.funengyun.com/v1/videos/generations \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"Doubao-Seedance-2.0","prompt":"海浪拍打礁石","duration":5}'
图片 / 视频端点为 New API 网关约定路径；若平台有差异，以控制台「API 文档 / 开发者」页为准。文本模型均支持
/v1/chat/completions。