---
title: API 接入常见问题
description: 快速查找 Base URL、模型、流式、客户端、超时和可用性监控的常见问题。
---

<aside className="docs-publication" data-pagefind-ignore>文档由 <a href="https://1zheai.com/editorial/#publisher">1折AI</a> 维护。<a href="https://1zheai.com/editorial/">来源、商业关系与纠错说明</a>。发现错误，请向 <a href="mailto:support@1zheai.com">support@1zheai.com</a> 提供页面地址与可核查依据，不要发送密钥或账号资料。</aside>

## 地址、密钥与模型

<AccordionGroup>
<Accordion title="Base URL 到底要不要带 /v1？">

OpenAI SDK 填 `https://1zheai.com/v1`；Anthropic SDK 与 Claude Code 填 `https://1zheai.com`。直接用 curl 时填写完整请求路径。桌面工具有些会自动补全路径，见[地址对照表](/docs/base-url/)。

</Accordion>
<Accordion title="有 ChatGPT 或 Claude 订阅，还需要本站密钥吗？">

需要。本站接入使用在本站控制台创建的 API 密钥；消费级客户端的订阅与本站 API 凭据是不同的接入方式。工具也必须支持自定义供应商或 API 地址。

</Accordion>
<Accordion title="模型列表里有，为什么调用还失败？">

列表展示的是当前密钥可见的模型，不是实时推理成功率。还要核对接口协议、可选参数与上游状态，见[模型查询接口](/docs/api-models/)。

</Accordion>
<Accordion title="其他平台的模型名称能直接照搬吗？">

从本站模型列表复制完整 ID。不同供应商可能使用不同前缀、别名和日期版本，不要靠猜测改名。迁移步骤见[迁移指南](/docs/migration/)。

</Accordion>
</AccordionGroup>

## 请求与客户端

<AccordionGroup>
<Accordion title="调用成功，但拿不到文字？">

先确认响应协议。Chat Completions 读 `choices[].message.content`，Messages 遍历 `content` 文本块，Responses 遍历 `output` 或使用 SDK 的 `output_text`。工具调用响应也可能没有普通文字。

</Accordion>
<Accordion title="上一轮的内容为什么没记住？">

多轮对话需要客户端传入历史。反复使用同一密钥不会自动创建服务端会话。Responses 的会话相关扩展需单独确认支持，不要默认依赖。

</Accordion>
<Accordion title="流式已经收到文字，算成功了吗？">

还需要确认结束事件或最终状态。中途错误、断流和输出截断都可能发生在已经收到部分文字之后。详见[流式输出](/docs/streaming/)。

</Accordion>
<Accordion title="超时后可以一直重试吗？">

不建议。超时可能发生在请求已被处理之后。先查调用日志，再按有限次数、退避与总等待时间执行重试，避免 SDK 和应用各重试一轮。见[超时与重试](/docs/retries/)。

</Accordion>
<Accordion title="能把 API 密钥直接放进网页前端吗？">

不要将密钥编译到浏览器脚本或公开仓库。让你的服务端持有凭据并调用接口，浏览器只连接你自己的后端；演示代码中的环境变量用于服务端或本地终端。

</Accordion>
</AccordionGroup>

## 服务状态与帮助

<AccordionGroup>
<Accordion title="运行时间监控正常，为什么模型还是报错？">

监控检查官网、控制台与 API 入口的 HTTP 可访问性，不代表每个模型的推理成功率。监控与应用部署在同一台服务器，整机故障时监控也会暂停；历史数据从启用后开始累计。

</Accordion>
<Accordion title="联系支持时需要准备什么？">

提供发生时间与时区、客户端版本、模型 ID、完整请求路径、HTTP 状态码、请求 ID 和脱敏后的错误信息。删除密钥、认证请求头及私人对话内容；可以按[排错模板](/docs/troubleshooting/)整理。

</Accordion>
</AccordionGroup>