使用教程

已收录 54 篇教程文章

全部入门教程使用指南行业资讯常见问题

入门教程

API 长数字 ID 到前端后变了？JavaScript 精度丢失与字符串传递排查

任务编号末位变化、查询 404 或账单 ID 被合并？沿 JSON 文本、解析、存储和再次请求定位精度丢失，说明为何 String 和 BigInt 可能补救太晚，并用本地样本验证字符串 ID 的完整往返。

2026/11/12

入门教程

API 稳定性测试怎么统计？区分原始请求、重试与最终成功率

稳定性测试不能把重试后的成功当成全新成功。本文用 request_id、attempt 和终态拆分统计，解释 429、503、超时与幂等边界，并用本地模拟脚本计算最终成功率和重试放大倍数。

2026/11/11

入门教程

API 返回 202 却没有结果？异步任务状态、轮询与重复提交排查

区分任务受理、状态查询成功与执行终态，保存原任务身份，设置查询预算并处理 404、结果过期和提交结果未知；用本地状态样本验证，避免轮询失败后重复创建任务。

2026/11/9

入门教程

Webhook 验签失败或重复处理怎么办？原始请求体、时间窗口与幂等排查

从原始请求体、HMAC 拼接、时间戳容差和重放保护四层定位 API 回调问题，配本机模拟代码，区分签名通过与业务只执行一次，避免把 2xx 当成处理完成。

2026/11/8

入门教程

AI API 返回 200 却解码失败？gzip、重复解压与响应头错配排查

区分 HTTP 内容编码、自动解压与 JSON 解析，排查 gzip 重复解压、响应头错配和长度异常；通过本机 HTTPX 示例说明为什么 JSON 能解析仍不代表压缩响应完整。

2026/11/7

入门教程

curl 能连通，Python API 却失败？HTTPX 代理环境变量与 NO_PROXY 排查

核对 HTTPX 的环境代理、显式 proxy 与 NO_PROXY 优先关系，区分目标协议、代理协议和 CA 来源，并用本机标记服务验证实际路由，避免把客户端差异误判为服务商故障。

2026/11/6

入门教程

AI API 并发卡住却没报 429？HTTPX 连接池超时与流式释放排查

区分 PoolTimeout、连接与读取超时，核对连接池限额、流式响应关闭和业务队列预算；用本机 HTTP/1.1 模拟服务复现占满与恢复，不把客户端等待误判为服务商故障。

2026/11/5

入门教程

Docker API 网关退出码 137 就是内存不足吗？OOM 证据与重启排查

区分退出码 137、OOMKilled、停止超时与宿主机内存压力，按容器 ID 和启动时间关联证据，核对实际内存限制，并用离线样例避免把新运行误当成旧故障。

2026/11/4

入门教程

Docker API 网关显示 healthy 却不能用？健康检查、就绪与依赖排查

区分容器存活、网关就绪和业务探针，核对健康检查退出码、连续失败阈值与 Compose 依赖顺序，避免把 healthy、数据库接受连接或重启策略误当成完整可用性证明。

2026/11/3

入门教程

Docker API 网关日志占满磁盘？检查 json-file 轮转与容器实际配置

区分容器输出、应用文件与数据库增长，检查 json-file 的 max-size 和 max-file，说明为什么旧容器不继承新配置，并附安全重建流程与离线检查示例。

2026/10/30

入门教程

API 账单导出对不上怎么办？按请求编号、重试与时区核对

把请求明细、账单汇总和余额流水分开，再用请求编号、尝试编号、UTC 时间和结算时间排除重复扣费与跨日差异，附本地对账示例。

2026/10/29

入门教程

API 中转站服务条款怎么看？退款、停用与退出条件核验

从宣传页、服务条款和实际体验三列入手，核对中转站的主体、余额退款、停用风控、日志范围与迁移退出条件，避免把搜索评价当成服务承诺。

2026/10/28

入门教程

Codex 中转站怎么选？先核对客户端、接口与任务验收

把 Codex 中转站选择拆成客户端、接口和完整任务三层验收：核对配置、工具事件、流式结束、迁移回滚与账单证据，避免把短对话成功误判为可用。

2026/10/27

入门教程

停止生成后为什么还在扣费？API 取消信号、后台任务与账单核对

区分停止显示、取消连接、终止后台任务与账单结算，逐层检查取消信号、重试队列和迟到结果，用本地模拟验证停止按钮的边界。

2026/10/26

入门教程

API 国内可用吗：地区资格、支付与网络连通分别检查

把 API 的地区资格、付款余额、Key 与模型权限、网络入口分开核对，用单变量矩阵定位官网能打开但请求失败的原因，并避免重复充值或绕过限制。

2026/10/25

入门教程

API 免费额度到期会扣钱吗？试用余额、免费模型与付费切换核对

分清赠送余额、免费请求次数和订阅试用，核对到期时区、抵扣范围及付费回退，并用分账算例检查自动充值和续费风险。

2026/10/24

入门教程

模型下线后怎么迁移？保留提示词与任务验收基线

从模型下线、改名、权限变化和隐式回退中区分真实原因，建立可复现的提示词与任务基线，按映射、隔离验收、灰度和账单对账完成可回滚迁移。

2026/10/23

入门教程

Docker API 网关改了 .env 仍不生效？插值、环境变量与容器重建排查

区分 Compose 插值来源、容器环境与应用配置，检查 Shell 和文件覆盖、空值语义及重启与重建差异，按三层证据完成配置变更验收。

2026/10/22

入门教程

One API 和 New API 怎么选？按任务、许可证与迁移风险核对

对照官方资料区分项目能力与部署验收，固定候选版本，检查渠道、权限、计费和数据迁移，用任务矩阵决定是否切换并明确回滚条件。

2026/10/21

入门教程

Docker API 网关配好 HTTPS 后，为什么 IP 端口还能直连？

区分宿主机代理与容器代理，收紧后端端口发布，检查 IPv4、IPv6 和 Docker 防火墙边界，用无凭证、有限时的探针完成入口与重建验收。

2026/10/20

第 1 / 3 页下一页