异步批处理

OpenAPI 定义批处理任务提交与状态查询的请求形状。它适用于由预签名 CSV 或 Parquet URL 引用的大负载数据集。

1. 提交与查询

POST /batch/forecast 成功后按规范返回 HTTP 202、job_id 与状态。随后可使用 GET /batch/jobs/{job_id} 查询进度和输出文件 URL。

batch-contract.sh

curl -X POST "https://api.sequenxai.com/v1/batch/forecast" \
-H "Authorization: Bearer $SEQUENX_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: your-idempotency-key" \
-d '{
  "input_file_url": "https://storage.example.com/presigned/timeseries.parquet",
  "format": "parquet",
  "h": 24,
  "freq": "1h",
  "level": [80, 90]
}'

契约说明：OpenAPI 另有 …/cn/v1/… 区域前缀，当前边缘未挂；端点上线后请暂用 /v1。

2. 尚待产品化确认的内容

规模阈值、队列优先级、完成时延、轮询间隔、文件存储兼容性和 SDK 封装都将在真实服务运行后以版本化文档公布。