> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fortapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 鉴权、base_url、模型、计费、错误等高频问题速查

<AccordionGroup>
  <Accordion title="base_url 要不要带 /v1？">
    看协议：

    * **OpenAI 协议**：带 `/v1` —— `https://www.fortapi.com/v1`。
    * **Anthropic SDK**：`ANTHROPIC_BASE_URL` **不带** `/v1` —— `https://www.fortapi.com`，SDK 会自己补 `/v1/messages`。多写 `/v1` 反而会 404。
  </Accordion>

  <Accordion title="提示 401 / 鉴权失败怎么办？">
    * 用的必须是 **FortAPI** 令牌（`sk-...`），不是 OpenAI / Anthropic 官方 key。
    * 检查有没有多余的空格或换行。
    * 在控制台 **「令牌」** 确认这把 key 没被禁用、没过期。
    * 详见 [错误码](/zh/errors)。
  </Accordion>

  <Accordion title="提示 404 / model not found？">
    * 模型名拼错了，或该名字不在主站「价格」页上。核对后重填。
    * 也可能是 base\_url 写错（见上面 `/v1` 的问题）。
  </Accordion>

  <Accordion title="提示 403 / 余额不足？">
    账号余额用完了（**是 403，不是 402**）。控制台首页看余额，充值后即可恢复。也可能是令牌被禁用或分组无权访问该模型。见 [计费与额度](/zh/billing)。
  </Accordion>

  <Accordion title="怎么切换模型 / 换一家厂商？">
    只改请求里的 `model` 字段即可，**同一把 key** 能调 OpenAI / Claude / Gemini / Grok 等所有模型，FortAPI 自动转换协议。可用模型名见主站「价格」页。
  </Accordion>

  <Accordion title="API key 丢了能再看吗？">
    能。回到控制台 **「令牌」** 页，点该令牌的“眼睛”图标即可重新查看，或用“复制密钥”复制完整 key。
  </Accordion>

  <Accordion title="流式（stream）没输出 / 卡住？">
    * 确认请求里传了 `stream: true`，并用 SDK 的流式遍历方式读取（见 [API 参考](/zh/api-reference) 的流式示例）。
    * 自己解析裸 SSE 时，注意每行以 `data: ` 开头、以 `data: [DONE]` 收尾。
    * 客户端 / 代理若开了响应缓冲，会让流式看起来“卡住”，关掉缓冲即可。
  </Accordion>

  <Accordion title="频繁 429 怎么办？">
    触发了限流。用指数退避重试，别原地高频重试。详见 [限流](/zh/rate-limits)。
  </Accordion>

  <Accordion title="OpenAI 协议和 Claude 协议有什么区别？该用哪个？">
    两个协议都支持、同一把 key 通用。现有 OpenAI / LangChain 代码用 OpenAI 协议；需要 Claude 的 thinking 块等原生能力用 Claude 协议。选型表见 [API 参考](/zh/api-reference)。
  </Accordion>
</AccordionGroup>

还有问题？邮件 [support@fortapi.com](mailto:support@fortapi.com)，附上报错里的 `request id` 能更快定位。