💡 直接答案
API Key 是调用 API 时用于识别账户和权限的密钥；Base URL 是客户端请求发送到的 API 地址；模型名决定调用哪个模型。OpenAI-compatible API 通常使用带 /v1 的 Base URL，例如 https://api1.link-ai.cc/v1。Claude Code 的 Anthropic Messages 原生模式可能不带 /v1，需要按客户端模式区分。三者必须匹配：有 Key 不等于有模型权限，有余额不等于所有模型都可用。
如果你在 Continue.dev 里配置 OpenAI-compatible API，可参考：/continue-openai-compatible-api/（包含 Base URL 是否带 /v1、模型名、401/403/404、model not found、no available channel、tool_call 与 usage/raw quota 的排查）。
API Key、Base URL、模型名分别是什么？
配置任何 AI 编码工具之前，需要先理解三个基本概念：
| 概念 | 作用 | 示例 |
|---|---|---|
| API Key | 账户身份验证和权限凭证 | sk-xxxxxxxxxxxx |
| Base URL | API 请求入口地址 | https://api1.link-ai.cc/v1 |
| 模型名 | 具体调用的模型标识 | gpt-4o, claude-3-sonnet |
三者之间的关系：
- API Key 只代表身份，不代表有所有模型的权限
- 具体能访问哪些模型，取决于账户的分组、渠道和模型权限配置
- 有余额不等于所有模型都可用，需要在后台确认目标模型已开通
- Base URL 决定请求发到哪个端点，不同端点可能支持不同的模型和协议
- 模型名必须和后台支持的模型列表完全一致
Base URL 和普通网页 URL 有什么区别？
Base URL 看起来像一个网页地址，但它们是完全不同的东西：
- 网页 URL：供浏览器打开，展示 HTML 页面
- Base URL：供 API 客户端发送请求，返回 JSON 数据
因此：
- 浏览器直接访问 Base URL（如 GET
https://api1.link-ai.cc/v1）返回 404 是正常行为，不代表 API 不可用 - API 客户端会向
/v1/chat/completions、/v1/models等具体接口发 POST/GET 请求 - 在 guides 页面中，API Base URL 只作为
<code>文本展示，不应作为<a href>外链
常见 Base URL 示例（LinkAI）：
https://api1.link-ai.cc/v1— 普通请求通道（OpenAI-compatible 模式）https://api2.link-ai.cc/v1— 长请求直连通道（OpenAI-compatible 模式）https://api1.link-ai.cc— Claude Code / Anthropic Messages 原生模式（不带 /v1）https://api2.link-ai.cc— Claude Code 长请求直连（不带 /v1）
/v1 到底要不要带？
带不带 /v1 取决于客户端使用的 API 模式，不是绝对规则。
| 场景 | 常见 Base URL | 是否带 /v1 | 说明 |
|---|---|---|---|
| Cursor / OpenAI-compatible | https://api1.link-ai.cc/v1 |
带 /v1 | 普通自定义 OpenAI API 配置 |
| Codex CLI / OpenAI-compatible | https://api1.link-ai.cc/v1 |
带 /v1 | 不要填 Claude Code 原生地址 |
| Cline / Continue / LobeChat / NextChat | https://api1.link-ai.cc/v1 |
通常带 /v1 | 按 OpenAI-compatible 模式填写 |
| Claude Code / Anthropic Messages 原生模式 | https://api1.link-ai.cc |
通常不带 /v1 | 适用于 Anthropic Messages 原生格式 |
| 长请求直连（OpenAI-compatible） | https://api2.link-ai.cc/v1 |
带 /v1 | OpenAI-compatible 模式长请求 |
| 长请求直连（Claude Code 原生） | https://api2.link-ai.cc |
不带 /v1 | Claude Code 原生模式长请求 |
📝 关键区分
实际填写时要按客户端的 API 模式区分：OpenAI-compatible 模式通常带 /v1，Anthropic Messages 原生模式通常不带 /v1。
新手配置时最容易填错什么？
以下是新手最容易犯的错误清单：
- 把官网地址当成 Base URL：例如填了
https://api.openai.com而不是中转站地址 - 忘记 /v1 或错误添加 /v1：Claude Code 原生模式不需要 /v1，OpenAI-compatible 模式需要 /v1
- 模型名和后台列表不一致：例如填了
claude-3-opus但后台只开通了claude-3-sonnet - API Key 粘贴多了空格：Key 前后多余的空格会导致 401
- 有余额但没有模型权限：余额和模型权限是两套系统
- api1 / api2 选择错误：普通请求用 api1，长请求用 api2
- 客户端模式选错：Anthropic Messages 和 OpenAI-compatible 混用会导致 404 或 model not found
- 把 API Base URL 当网页链接打开：浏览器 GET /v1 返回 404 是正常的，不代表 API 不可用
相关指南：
401、403、404、model not found 分别代表什么？
| 错误 | 常见含义 | 优先检查 | 相关指南 |
|---|---|---|---|
| 401 | API Key 无效、缺失、粘贴错误 | 重新生成 Key，检查 Bearer 格式 | invalid API Key 排查 |
| 403 | 账户或模型权限不足，分组/渠道未开通 | 检查模型权限、用户分组、渠道状态 | API 中转站安全检查 |
| 404 / model not found | 模型名不存在、模型权限未开、Base URL 模式不匹配 | 检查模型名、/v1、后台模型列表 | model not found 排查 |
| no available channel | 模型有路由但暂时无可用渠道 | 检查渠道状态、模型权限、上游状态 | no available channel 排查 |
| tool_call message | 工具调用结构被直接显示 | 检查客户端 tools/function calling 兼容 | tool_call message 排查 |
如何确认配置真的可用？
按以下 6 步验证配置：
- 登录后台确认账户有额度
- 查看模型列表，确认目标模型已开通
- 复制 API Key，注意不要带前后空格
- 按客户端模式填写 Base URL（OpenAI-compatible 带 /v1，Claude Code 原生不带 /v1）
- 先用低成本模型或小请求测试，观察 usage 和错误返回
- 查看 usage、raw quota、completion_tokens 和消费记录
LinkAI 国内用户的充值额度按 1 RMB = 1 USD 额度计入账户，适合先用小额额度做配置测试。重点是先用小请求验证 Base URL、模型权限、usage 返回和消费记录。
相关指南：
可以用 AI API Doctor 检查什么？
AI API Doctor 是独立的 API 配置诊断工具，可以辅助检查：
- Base URL 是否可达
- API Key 格式是否正确
- 模型列表是否能获取
- 常见 401 / 403 / 404 / 429 / 503 / 524 错误
- 客户端配置是否可能混用模式
AI API Doctor 可作为配置排查辅助工具，用于检查 Base URL、API Key、模型列表和常见错误；最终是否可用仍应以客户端实际请求结果和后台记录为准。
什么时候适合注册 LinkAI 做小额测试？
适合使用 LinkAI 的场景：
- 想用一个 OpenAI-compatible Base URL 接入多个模型
- 想先小额测试 Cursor / Codex / Cline / LobeChat
- 想看 usage、raw quota 和消费记录
- 想排查模型权限和错误透传
- 想区分 api1 普通请求和 api2 长请求
开始使用 LinkAI API
注册后即可获取 API Key，支持 api1 普通请求和 api2 长请求双通道
FAQ
API Key 是什么？
API Key 是调用 API 时用于识别账户身份和验证权限的密钥，通常以 sk- 开头。每个 API Key 绑定一个账户，可以查看该账户的额度、usage 和消费记录。API Key 只代表身份，不代表有所有模型的权限，具体能访问哪些模型取决于账户的分组和渠道配置。
Base URL 是什么？
Base URL 是 API 请求发送到的入口地址，格式类似
https://api.example.com/v1。它是配置值，不是普通网页链接，浏览器直接访问可能返回 404，但 API 客户端可以正常请求。不同 API 服务提供者的 Base URL 不同，同一服务也可能提供多个通道（如普通请求和长请求）。Base URL 要不要带 /v1？
取决于客户端使用的 API 模式。OpenAI-compatible 模式（如 Cursor、Codex、Cline、LobeChat、NextChat）通常需要带 /v1，例如
https://api1.link-ai.cc/v1。Claude Code 的 Anthropic Messages 原生模式通常不带 /v1，例如 https://api1.link-ai.cc。实际填写时要按客户端的 API 模式区分。为什么浏览器打开 Base URL 会显示 404？
Base URL 是 API 端点，不是网页。API 客户端会向 /v1/chat/completions、/v1/models 等具体接口发请求，而不是在浏览器里打开 Base URL 本身。浏览器 GET 请求这些路径返回 404 是正常行为，不代表 API 不可用。
API Key 有余额为什么还会 403？
余额只代表账户有额度，不等于所有模型都有权限。403 表示当前账户、分组或渠道没有目标模型的访问权限。需要检查用户分组、渠道配置、模型名是否和后台列表一致，以及 Base URL 是否为 OpenAI-compatible 模式。具体参考 API 中转站安全检查清单。
model not found 是模型不存在吗？
model not found 或 404 不一定代表模型真的不存在。常见原因包括：模型名拼写与后台列表不一致、模型权限未开通、Base URL 模式不匹配（如填了 Claude Code 原生地址却请求 OpenAI-compatible 模式）、或模型确实不在该服务支持的列表中。具体参考 model not found 排查指南。
Cursor 的 Base URL 应该怎么填？
Cursor 通常走 OpenAI-compatible 模式，Base URL 应填写带 /v1 的地址，例如
https://api1.link-ai.cc/v1（普通请求）或 https://api2.link-ai.cc/v1（长请求）。具体参考 Cursor API Provider 配置。Codex CLI 的 Base URL 应该怎么填？
Codex CLI 通常走 OpenAI-compatible 模式，Base URL 应填写带 /v1 的地址，例如
https://api1.link-ai.cc/v1 或 https://api2.link-ai.cc/v1（长任务推荐）。不要填写 Claude Code 的 Anthropic 原生地址。具体参考 Codex CLI API Provider。Claude Code 的 Base URL 为什么可能不带 /v1？
Claude Code 可能使用 Anthropic Messages 原生模式，这个模式通常不带 /v1 后缀，例如
https://api1.link-ai.cc（普通请求）或 https://api2.link-ai.cc（长请求）。如果 Claude Code 通过 OpenAI-compatible 模式接入，才需要带 /v1。具体参考 Claude Code / Codex / Cursor Base URL 配置指南。输出失败或 empty response 会不会扣费？
是否扣费要结合后台 usage、raw quota、prompt_tokens、completion_tokens 和消费记录判断。如果没有可用输出、completion_tokens=0、content 为空、请求异常结束，可以联系 LinkAI 核查。具体参考 API 扣费透明指南。
tool_call message 显示出来是什么原因？
tool_call 是模型的工具调用结构，正常情况下客户端应该消费或执行它，而不是直接展示给用户。如果直接显示，通常是客户端不支持 tools/function calling、API 模式不匹配，或协议转换没有正确处理。具体参考 tool_call message 排查指南。
不确定配置是否正确怎么办？
如果不确定是 Base URL、模型权限、客户端模式还是请求格式问题，可以用 AI API Doctor（aiapidoctor.com）辅助检查配置。它可以检查 Base URL 是否可达、API Key 格式是否正确、模型列表是否能获取，以及常见错误码。