常见问题

历史数据最少要多少个点？

至少达到模型的最小上下文：hora-1.0 为每个实体 16 个点。清洗补齐的点也计入长度，但预测起点前有长缺口，或缺失占比达到 35% 时，请求会被拒绝（见缺失判断规则）。见模型与能力上限。

预测步长 h 最大是多少？

请求字段允许 1 至 2048，但模型有自己的最大步长：hora-1.0 为 1,024。超出返回 HORIZON_EXCEEDS_MODEL。

freq 必须传吗？

默认预设下可以省略，服务会从数据推断；数据不规则或有多个实体时，建议显式传入。raw 预设必须传。注意小写 m 表示分钟，月末写 ME 或 M，月初写 MS。见频率字符串。

数据有缺失或重复怎么办？

default 预设会自动去重、排序、补齐短缺口，并把每一处改动写进清洗报告。不确定数据会被怎样处理时，先用免费的 /v1/clean 预演。不希望数据被修改时，用 strict 预设或 clean_series: false。

时间戳没有时区会怎样？

按 options.timezone 解析；未提供时按 UTC 解析，并在清洗报告中注明。响应中的时间戳一律为 UTC。见时区处理。

哪些请求会计费？

只有成功的 /v1/forecast，按「喂给模型的观测点 + 预测点」计。错误响应与 /v1/clean 都不计费。见计量、额度与限流。

收到 429 怎么办？

看 X-RateLimit-Policy：forecast-rpm 与 clean-rpm 等待 Retry-After 秒后重试；forecast-daily-points 要到下一个 UTC 零点才恢复。

支持协变量吗？

API 已接受协变量：series 行上额外的数值字段是历史协变量，future_covariates 提供预测窗口内的值。目前没有模型使用协变量，每列报告 model_unsupported；是否交给了模型以 model_input[].covariates 的逐列报告为准。见协变量支持现状。

支持幂等键吗？

POST /v1/forecast 支持 Idempotency-Key。键按 API 密钥隔离，保存 24 小时；同键同请求体的重试返回首次保存的结果（带 X-Idempotent-Replayed: true），不会重复计费。上游 5xx、超时与 429 不保存，可以用同一个键重试。详见认证与请求头。

能在浏览器里直接调用吗？

不建议。API 密钥等同于账号凭据，请只在服务端使用，不要写进前端代码或提交到代码仓库。

sqx_test_* 密钥能用吗？

不能。真实 API 只接受 sqx_live_*，测试密钥会返回 INVALID_API_KEY；文档站也没有 Mock 沙箱。想先看效果，在预测工作台试用；要调 API，在 SequenxAI 平台获取 API 密钥，免费档即可。

API 使用哪个模型？

SequenxAI Omni，模型 id 为 hora-1.0（别名 hora），省略 model 时也使用它；其他任何 id 返回 422 MODEL_NOT_AVAILABLE。可以通过 model_options 调整其行为，见模型与能力上限。我们不做精度声明，请先在自己的数据上回测再依赖预测结果。