ModAPIS服务组件
| 组件 | 地址 | 说明与自检方式 |
|---|---|---|
| 官网与文档 | modapis.com | 本站（modapis.com）：模型目录、定价、文档与法务页面。 |
| API 网关 | api.modapis.com | 全部模型调用走此域名（https://api.modapis.com/v1）。自检：带有效 Key 请求 GET /v1/models 返回模型清单；无 Key 得到 401 即代表端点在线。 |
| 控制台 | api.modapis.com | 注册、创建 API Key、用量与账单、任务日志（与 API 网关同域）。 |
以上端点均无计划内停机窗口；扩容与版本发布以更新日志提前公告。拿不准时，先跑一次上面的自检请求再联系我们。
任务状态口径
视频 / 音乐走统一任务接口：POST /v1/videos 提交后返回任务 id，轮询 GET /v1/videos/{id} 直到终态。状态字段取值与含义如下：
| status | 含义 |
|---|---|
| queued | 已受理，排队调度中（提交成功后的初始状态） |
| in_progress | 上游生成中，progress 字段带进度百分比 |
| completed | 生成完成，结果视频地址在顶层 url 字段 |
| failed | 失败终态，error 字段带 message 与 code，不扣 credits |
调用示例见快速开始；鉴权失败（401）与错误响应的格式与排查入口也在该页第 5、6 节。
故障补偿与公告
- 失败不计费：5xx、超时、上游拒任务一律自动退回 credits，账单逐条对应请求 ID，可下载 CSV 对账。
- 单模型费率调整提前 14 天公告，存量 credits 不受影响。
- 事件与恢复进展通过更新日志公告；紧急问题邮件[email protected]，反馈时带上响应头 X-Oneapi-Request-Id 与任务 id。
关于本页
本页为静态口径说明页（不逐秒刷新）：它回答「服务分几块、各自怎么确认在线、出问题找谁」。 需要证明某次请求真实可达时，以你自己的带 Key 自检请求与控制台日志为准，而不是任何状态图标。