# NiceAI Wiki > NiceAI 使用文档(中文)。NiceAI 是兼容 OpenAI 与 Anthropic 协议的 AI 大模型 API 中转平台,一个 API 密钥可调用 Claude、GPT、Gemini 等模型。API 地址:OpenAI 兼容协议用 https://api.niceai.dev/v1,Anthropic 协议(含 Claude Code)用 https://api.niceai.dev(不加 /v1),Gemini 接口用 https://api.niceai.dev/v1beta。 完整正文见 https://wiki.niceai.dev/llms-full.txt。每个页面也有纯文本版本:在页面地址后加 .md(目录页为 index.md),例如 https://wiki.niceai.dev/guide/quick-start.md。 ## 开始使用 - [快速开始:三步调用 Claude、GPT、Gemini](https://wiki.niceai.dev/guide/quick-start): 三步开始使用 NiceAI:注册账号、充值并创建 API 密钥、把客户端 Base URL 换成 NiceAI,即可调用 Claude、GPT、Gemini。附 curl、Python、Node.js 示例。 - [分组与倍率说明(含充值与退款)](https://wiki.niceai.dev/guide/billing-groups): NiceAI 的密钥分组是什么、倍率怎么影响实际扣费、缓存命中为什么更便宜,以及充值方式和未消耗余额的退款规则。 - [API 密钥安全最佳实践:防泄露、分用途、泄露后怎么办](https://wiki.niceai.dev/guide/key-security): 使用 NiceAI API 密钥的安全建议:用环境变量而不是写死在代码里、不要提交到 Git、按项目分开创建密钥、前端不能直接放密钥,以及密钥泄露后的处理步骤。 - [从 OpenRouter 切换到 NiceAI:需要改哪几处](https://wiki.niceai.dev/guide/migrate-from-openrouter): 从 OpenRouter 切换到 NiceAI 只需改 Base URL、API 密钥和模型名三处;本文列出对照表,以及 OpenRouter 专有参数和请求头的处理方法。 - [从 OpenAI / Anthropic 官方 API 切换到 NiceAI](https://wiki.niceai.dev/guide/migrate-from-official-api): 已经在用 OpenAI 或 Anthropic 官方 API 的项目,切换到 NiceAI 只需改 Base URL 和 API 密钥,并核对模型名;本文给出 SDK、环境变量和客户端的改法。 ## 编程工具 - [支持的客户端一览:各工具接入 NiceAI 的接口地址](https://wiki.niceai.dev/guide/clients/): NiceAI 支持哪些客户端?Claude Code、Codex、Cursor、VS Code Copilot、Cline、Zed、Aider、OpenCode、Cherry Studio、NextChat、Open WebUI、沉浸式翻译、Dify、n8n 等工具的协议、Base URL 和密钥分组速查表。 - [使用 CC Switch 一键导入 NiceAI](https://wiki.niceai.dev/guide/cc-switch): 在 NiceAI 控制台把 API 密钥一键导入 CC Switch,快速为 Claude Code、Codex、Gemini CLI 切换到 NiceAI,并在 CC Switch 中查看余额。 - [Claude Code 接入自定义 API(环境变量 / settings.json)](https://wiki.niceai.dev/guide/claude-code): 通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 把 Claude Code 接到 NiceAI,支持 settings.json、macOS / Linux 和 Windows PowerShell 三种配置方式。 - [Windows 上使用 Claude Code:原生安装、WSL 与环境变量配置](https://wiki.niceai.dev/guide/claude-code-windows): 在 Windows 上安装 Claude Code 并接入 NiceAI:PowerShell / CMD 安装命令、原生 Windows 与 WSL 怎么选、Git Bash 的作用、环境变量在 PowerShell、CMD 和 WSL 中的设置方法与常见坑。 - [Codex CLI 接入自定义 API(config.toml)](https://wiki.niceai.dev/guide/codex): 在 ~/.codex/config.toml 中添加自定义模型供应商,把 OpenAI Codex CLI 接到 NiceAI,含 base_url、wire_api、env_key 配置说明和常见报错。 - [Gemini CLI 接入自定义 API(GOOGLE_GEMINI_BASE_URL)](https://wiki.niceai.dev/guide/clients/gemini-cli): 设置 GOOGLE_GEMINI_BASE_URL=https://api.niceai.dev 和 GEMINI_API_KEY,即可让 Gemini CLI 通过 NiceAI 调用 Gemini 模型,含 macOS、Linux、Windows 配置方法。 - [Cursor 接入自定义 API(Override OpenAI Base URL)](https://wiki.niceai.dev/guide/clients/cursor): 在 Cursor 设置中开启 Override OpenAI Base URL,填写 https://api.niceai.dev/v1 和 NiceAI 密钥,即可在 Cursor 的 Chat 和 Agent 中使用自定义 API。 - [VS Code Copilot Chat 接入自定义 API(Custom Endpoint / BYOK)](https://wiki.niceai.dev/guide/clients/vscode-copilot): 在 VS Code 的 Language Models 编辑器中添加 Custom Endpoint,选择 Chat Completions、Responses 或 Messages 类型并填写 NiceAI 地址与密钥,即可在 Copilot Chat 中使用自定义模型。 - [Cline 接入自定义 API(OpenAI Compatible)](https://wiki.niceai.dev/guide/clients/cline): 在 Cline 设置中选择 OpenAI Compatible,Base URL 填 https://api.niceai.dev/v1,填入 NiceAI 密钥和模型 ID,即可在 VS Code 中使用 Cline。 - [Roo Code 接入自定义 API(OpenAI Compatible)](https://wiki.niceai.dev/guide/clients/roo-code): Roo Code 选择 OpenAI Compatible 提供商,Base URL 填 https://api.niceai.dev/v1,填入 NiceAI 密钥和支持工具调用的模型,即可使用。 - [Kilo Code 接入自定义 API(Custom provider:OpenAI Compatible / Anthropic Messages)](https://wiki.niceai.dev/guide/clients/kilo-code): 在 Kilo Code 的 Providers 设置中添加 Custom provider,Provider API 选 OpenAI Compatible 并把 Base URL 设为 https://api.niceai.dev/v1,即可使用 NiceAI 的模型。 - [Continue 接入自定义 API(config.yaml apiBase)](https://wiki.niceai.dev/guide/clients/continue): 在 Continue 的 config.yaml 中添加 provider 为 openai 的模型,apiBase 填 https://api.niceai.dev/v1,即可在 VS Code / JetBrains 中通过 NiceAI 使用。 - [Zed 编辑器接入自定义 API(OpenAI 兼容 / Anthropic 兼容供应商)](https://wiki.niceai.dev/guide/clients/zed): 在 Zed 的 Agent 设置中添加 OpenAI 兼容供应商(api_url 填 https://api.niceai.dev/v1)或 Anthropic 兼容供应商(api_url 填 https://api.niceai.dev),即可让 Zed Agent 使用 NiceAI。 - [Aider 接入自定义 API(OPENAI_API_BASE + openai/ 前缀)](https://wiki.niceai.dev/guide/clients/aider): 设置 OPENAI_API_BASE=https://api.niceai.dev/v1 和 OPENAI_API_KEY,再用 aider --model openai/<模型名> 启动,即可让 Aider 通过 NiceAI 调用模型。 - [OpenCode 接入自定义 API(opencode.jsonc 自定义 OpenAI 兼容供应商)](https://wiki.niceai.dev/guide/clients/opencode): 在 OpenCode 的 opencode.jsonc 中添加一个 OpenAI 兼容供应商,baseURL 填 https://api.niceai.dev/v1,密钥从环境变量读取,即可在 OpenCode 中使用 NiceAI 的模型。 ## 对话客户端与工作流 - [在 Magpie 中使用 NiceAI](https://wiki.niceai.dev/guide/magpie): 通过 NiceAI 控制台一键把 API 密钥导入 Magpie 客户端,自动配置 Chat Completions、Responses、Anthropic、Gemini 等接口地址。 - [Cherry Studio 接入自定义 API(API 地址怎么填)](https://wiki.niceai.dev/guide/clients/cherry-studio): 在 Cherry Studio「设置 → 模型服务」添加 OpenAI 类型的服务商,API 地址填 https://api.niceai.dev(会自动补 /v1),填入 NiceAI 密钥并添加模型即可使用。 - [ChatBox 接入自定义 API(API 主机与 API 路径)](https://wiki.niceai.dev/guide/clients/chatbox): 在 ChatBox 中添加自定义模型提供方,API 模式选 OpenAI API 兼容,API 主机填 https://api.niceai.dev、API 路径留空,填入 NiceAI 密钥即可使用。 - [NextChat(ChatGPT-Next-Web)接入自定义 API(自定义接口 / BASE_URL)](https://wiki.niceai.dev/guide/clients/nextchat): 在 NextChat 设置中打开自定义接口,接口地址填 https://api.niceai.dev 并填入 NiceAI 密钥;自部署时可用 BASE_URL、OPENAI_API_KEY 和 CUSTOM_MODELS 环境变量配置。 - [LobeChat 接入自定义 API(API 代理地址 / OPENAI_PROXY_URL)](https://wiki.niceai.dev/guide/clients/lobechat): 在 LobeChat 的 AI 服务商设置中填写 NiceAI 密钥和 API 代理地址 https://api.niceai.dev/v1;自部署时也可以用 OPENAI_API_KEY 和 OPENAI_PROXY_URL 环境变量配置。 - [Open WebUI 接入自定义 API(OpenAI API 连接 / OPENAI_API_BASE_URL)](https://wiki.niceai.dev/guide/clients/open-webui): 在 Open WebUI 管理员设置的 Connections 中添加 OpenAI API 连接,URL 填 https://api.niceai.dev/v1,或用 Docker 环境变量 OPENAI_API_BASE_URL 配置,即可使用 NiceAI 的模型。 - [沉浸式翻译接入自定义 API(OpenAI 自定义 API 接口地址)](https://wiki.niceai.dev/guide/clients/immersive-translate): 在沉浸式翻译的 OpenAI 翻译服务中选择自定义 API Key,自定义 API 接口地址填 https://api.niceai.dev/v1/chat/completions,添加模型名并调低请求频率,即可用 NiceAI 翻译网页和 PDF。 - [Obsidian Copilot 插件接入自定义 API(BYOK 自定义 OpenAI 兼容供应商)](https://wiki.niceai.dev/guide/clients/obsidian-copilot): 在 Obsidian 的 Copilot 插件设置中进入 BYOK,添加自定义供应商,Base URL 填 https://api.niceai.dev/v1,手动添加模型 ID,即可在笔记中使用 NiceAI 的模型。 - [Dify 接入自定义 API(OpenAI-API-compatible 插件)](https://wiki.niceai.dev/guide/clients/dify): 在 Dify 的模型供应商中安装 OpenAI-API-compatible 插件,API Base URL 填 https://api.niceai.dev/v1,填入 NiceAI 密钥和模型名,即可在 Dify 应用和工作流中使用。 - [n8n 接入自定义 API(OpenAI 凭据 Base URL)](https://wiki.niceai.dev/guide/clients/n8n): 在 n8n 新建 OpenAI 凭据,Base URL 填 https://api.niceai.dev/v1,OpenAI、OpenAI Chat Model、AI Agent 等节点即可通过 NiceAI 调用模型。 ## API 文档 - [NiceAI API 接口总览:OpenAI、Anthropic、Gemini 三种协议的地址与鉴权](https://wiki.niceai.dev/guide/api/): NiceAI 同时提供 OpenAI 兼容、Anthropic Messages 和 Gemini 三种接口。本页列出每种协议的 Base URL、请求路径、鉴权请求头和对应的密钥分组。 - [Chat Completions 接口(/v1/chat/completions)参数与示例](https://wiki.niceai.dev/guide/api/chat-completions): 通过 NiceAI 调用 OpenAI 兼容的 Chat Completions 接口:请求地址、curl / Python / Node.js 示例、常用参数表、返回结构和 usage 字段说明。 - [Anthropic Messages 接口(/v1/messages)调用 Claude 示例](https://wiki.niceai.dev/guide/api/anthropic-messages): 通过 NiceAI 用 Claude 原生的 Anthropic Messages 接口:Base URL 为 https://api.niceai.dev(不加 /v1),附 curl / Python / TypeScript 示例、必填请求头和参数说明。 - [Gemini 接口(/v1beta generateContent)调用示例](https://wiki.niceai.dev/guide/api/gemini): 通过 NiceAI 调用 Gemini 原生 REST 接口:地址 https://api.niceai.dev/v1beta/models/{模型}:generateContent,附 curl 与 google-genai SDK 示例、流式写法和鉴权说明。 - [流式输出(stream / SSE):边生成边返回的写法与排查](https://wiki.niceai.dev/guide/api/streaming): 在 NiceAI 的 OpenAI 兼容接口和 Anthropic 接口中开启流式输出:stream 参数、SSE 数据格式、Python / Node.js 读取示例、流式下获取 usage,以及断流、卡住的排查方法。 - [工具调用(Function Calling / Tool Use)示例:OpenAI 与 Anthropic 两种写法](https://wiki.niceai.dev/guide/api/tools): 通过 NiceAI 让模型调用你定义的函数:OpenAI 兼容接口的 tools / tool_calls 写法、Anthropic 的 tool_use / tool_result 写法,附完整的两轮请求示例和常见错误。 - [图片输入(Vision):用 URL 或 Base64 让模型识图](https://wiki.niceai.dev/guide/api/vision): 通过 NiceAI 给支持视觉的模型发送图片:OpenAI 兼容接口的 image_url 写法、Anthropic 的 image 内容块、Gemini 的 inline_data,附 Base64 编码示例和常见报错。 - [限流、超时与重试:429 和 5xx 的正确处理方式](https://wiki.niceai.dev/guide/api/rate-limits): 调用 NiceAI 时如何处理 429 限流、5xx 错误和超时:哪些错误该重试、指数退避加随机抖动的写法、SDK 自带的重试与超时参数、批量任务的并发控制。 - [OpenAI SDK 接入自定义 API(Python / Node.js base_url)](https://wiki.niceai.dev/guide/clients/openai-sdk): 在 OpenAI 官方 Python 和 Node.js SDK 中把 base_url / baseURL 设为 https://api.niceai.dev/v1,即可通过 NiceAI 调用 Chat Completions 和 Responses 接口。 - [Anthropic SDK 接入自定义 API(Python / TypeScript base_url)](https://wiki.niceai.dev/guide/clients/anthropic-sdk): 在 Anthropic 官方 Python 和 TypeScript SDK 中把 base_url / baseURL 设为 https://api.niceai.dev(不加 /v1),即可通过 NiceAI 调用 Claude Messages API。 ## 常见问题 - [常见问题 FAQ](https://wiki.niceai.dev/guide/faq): NiceAI 常见问题解答:什么是 API 中转、是否兼容 OpenAI、支持哪些客户端、如何计费和倍率、付款与退款、401/404/429 怎么处理、数据安全等。 - [接口地址要不要加 /v1?请求返回 404 的排查](https://wiki.niceai.dev/guide/v1-404): Claude Code、Codex、Cursor 等客户端接入 API 时返回 404,多数是 Base URL 里 /v1 加错了。本文按客户端列出 NiceAI 接口地址该不该带 /v1。 - [常见错误码对照(400、401、403、404、429、500、502、503、529)](https://wiki.niceai.dev/guide/error-codes): 调用 NiceAI 时遇到 400、401、403、404、429、500、502、503、529 等 HTTP 状态码的含义、常见原因和处理方法,适用于 OpenAI 兼容和 Anthropic 协议。 - [术语表:Base URL、倍率、分组、缓存命中、token 等名词解释](https://wiki.niceai.dev/guide/glossary): 使用 AI API 中转时常见名词的简明解释:Base URL、API 密钥、分组、倍率、token、上下文窗口、缓存命中、Chat Completions、Responses API、Messages API、流式输出等。 ## 技术文章 - [提示词缓存(Prompt Caching)是怎么省钱的:Anthropic 与 OpenAI 缓存机制详解](https://wiki.niceai.dev/guide/tech/prompt-caching): 提示词缓存把重复的请求前缀缓存起来,命中时按更低单价计费。本文讲清 Anthropic cache_control 与 OpenAI 自动缓存的规则、命中条件,以及如何在编程工具和自己的代码中提高命中率。 - [为什么 Claude Code 一句话也要几千输入 token?](https://wiki.niceai.dev/guide/tech/claude-code-input-tokens): 在 Claude Code 里只问一句话,使用记录却显示几千甚至上万输入 token。原因是每次请求都带着系统提示、工具定义、项目记忆和对话历史。本文拆解这些 token 的来源,并给出降低成本的方法。 - [Chat Completions 与 Responses API 有什么区别?对 Codex 意味着什么](https://wiki.niceai.dev/guide/tech/responses-vs-chat-completions): OpenAI 有 Chat Completions 和 Responses 两套对话接口。本文对比两者的请求格式、状态管理、推理与工具调用,解释为什么 Codex CLI 要配置 wire_api = "responses",以及第三方客户端该选哪个。 - [同一个 API,为什么各个工具的 Base URL 写法都不一样?](https://wiki.niceai.dev/guide/tech/base-url-rules): 一篇讲清楚 AI 客户端怎么拼接请求地址:SDK 补路径、客户端补 /v1、要求填完整地址三类规则,附 Cursor、Cherry Studio、NextChat、沉浸式翻译、VS Code 等常见工具的写法对照和 404 排查方法。 - [大模型 API 调用失败怎么排查:一份按顺序走的检查清单](https://wiki.niceai.dev/guide/tech/troubleshooting-checklist): 调用 OpenAI、Claude、Gemini 等大模型 API 报错时的排查顺序:先看状态码,再查地址、密钥、模型名、参数、网络和限流,附每一步的验证命令和常见误区。 - [一次 API 调用到底用了多少 token?读懂 usage 字段](https://wiki.niceai.dev/guide/tech/token-usage-explained): 解释大模型 API 返回的 usage 字段:输入 token、输出 token、缓存读写 token、推理 token 分别是什么,为什么多轮对话和 Agent 工具越用越多,以及降低 token 消耗的几个办法。 - [如何选择靠谱的 AI API 中转:一份可以逐项核对的清单](https://wiki.niceai.dev/guide/tech/choose-api-relay): 选 AI API 中转时该看什么?从协议兼容、计费透明、模型一致性、稳定性、数据与隐私、退款和支持等方面,整理一份可以逐项核对的中立清单。 - [Claude Code 国内怎么用?官方、国产模型、中转、自建四种接法对比](https://wiki.niceai.dev/guide/tech/claude-code-china): 在国内使用 Claude Code 的四种方式:官方订阅或 API、国产模型的 Anthropic 兼容接口、第三方 API 中转、自建网关,各自的优缺点对比,以及通用的 ANTHROPIC_BASE_URL 配置步骤。 - [Claude Code 报 429、529 Overloaded 或一直 Retrying 怎么办](https://wiki.niceai.dev/guide/tech/claude-code-429-529): Claude Code 出现 429 Too Many Requests、529 overloaded_error、反复 Retrying 时的原因和处理顺序:区分限流和上游过载,减少并发、切换模型、什么时候该找服务商。 - [ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 有什么区别?Claude Code 该用哪个](https://wiki.niceai.dev/guide/tech/auth-token-vs-api-key): Claude Code 的 ANTHROPIC_AUTH_TOKEN 发送 Authorization Bearer 请求头,ANTHROPIC_API_KEY 发送 x-api-key 请求头。两者的区别、该选哪个、同时设置会怎样,以及如何用 /status 确认。 - [用 API 中转安全吗?会不会封号、会不会降智、跑路怎么办](https://wiki.niceai.dev/guide/tech/relay-safety-faq): 关于 AI API 中转最常被问的问题:会不会封自己的 Claude 账号、代码数据是否安全、会不会被换成便宜模型、为什么 token 消耗多、计费怎么核对、服务商跑路怎么减少损失。每个问题先给一句话答案。 ## 其他 - [文档更新日志](https://wiki.niceai.dev/guide/changelog): NiceAI 使用文档(wiki.niceai.dev)的更新记录,按日期列出新增和修改的页面。 - [NiceAI API Quick Start (English)](https://wiki.niceai.dev/en/): NiceAI is an AI model API relay compatible with the OpenAI, Anthropic and Gemini APIs. Base URLs, authentication and setup for Claude Code, Codex and OpenAI / Anthropic SDKs. ## Optional - [NiceAI 官网](https://niceai.dev): 注册与控制台 - [模型广场](https://niceai.dev/model-plaza): 当前可用模型列表