请求 ID
记录 APIONE 响应中的请求标识。不同接口或线路可能返回X-Request-ID、X-Maxx-Trace-Id 或 X-Maxx-Request-ID,请保留实际收到的字段名和值。反馈问题时提供请求时间和时区、模型 ID、完整端点、状态码、错误码及请求标识。
不要提交完整 API Key、敏感提示词或未脱敏文件。

控制台请求明细可按时间、来源、API Key 和请求 ID 筛选,并核对状态、耗时、Token 与费用。
何时重试
超时建议
- 文本请求分别设置连接超时和读取超时。
- 流式请求以首个事件和持续读取为边界,不要套用过短的普通请求超时。
- 视频生成是异步任务。创建成功后轮询任务状态,不要让一个 HTTP 连接等待生成结束。
智能路由边界
APIONE 会在同一模型的可用线路间选择或切换。若模型、权限、余额或请求参数本身有误,切换线路不能解决问题。所有线路都不可用时,请求仍可能失败。推荐的退避策略
首次失败后等待短时间,再按指数增加等待,并加入随机抖动,避免多个请求同时重试。总尝试次数应有限,业务侧还要设置总时间预算。maxAttempts 包含首次请求;最后一次 HTTP 失败会保留原响应,便于读取状态码与错误正文。Retry-After 支持秒数和 HTTP 日期,缺失或无效时使用退避等待。
调用方应检查最终响应的 ok 状态,并按业务设置超时。请求体使用可重放的字符串或字节数据;SDK 已自动重试时,应统筹总尝试次数。
将下面两个 JavaScript 代码块依次合并,保存为 example.mjs。先按快速开始设置 APIONE_API_KEY,在同一终端运行 node example.mjs。使用 Node.js 18 或更高版本,内置 fetch 无需额外依赖。
读取请求标识
防止重复创建
文本查询通常可以安全重试,但图像、视频或其他创建类请求可能已经被服务端接收。连接中断不代表任务没有创建。应用应保存以下信息:
状态未知时先查询记录或任务,不要立即重新创建。
超时分层
生产检查单
- 为测试和生产使用不同 API Key,便于限额、撤销和审计。
- 记录状态码、耗时、模型与请求 ID,不记录完整密钥。
- 限制最大并发和重试总量,避免故障期间放大流量。
- 对流式输出处理半途错误、客户端取消和不完整 JSON。
- 对媒体任务区分“创建成功”“生成成功”和“结果已下载”。
- 监控成功率、首字节时间、总耗时、429 与 5xx 比例。

