API 接入常见问题

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

地址、密钥与模型

Base URL 到底要不要带 /v1？

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

有 ChatGPT 或 Claude 订阅，还需要本站密钥吗？

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

模型列表里有，为什么调用还失败？

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

其他平台的模型名称能直接照搬吗？

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

调用成功，但拿不到文字？

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

上一轮的内容为什么没记住？

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

流式已经收到文字，算成功了吗？

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

超时后可以一直重试吗？

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

能把 API 密钥直接放进网页前端吗？

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

运行时间监控正常，为什么模型还是报错？

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

联系支持时需要准备什么？

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