A12
首页 / API 中心

API 中心 Interactive Reference

不用注册、不用写一行代码——在浏览器里直接构造请求、查看响应、复制多语言示例。公测开放后同一套端点切换为真实调度。

⚠️ DEMO 说明:所有响应为本地模拟(含真实延迟感与错误路径),不上传任何数据。公测版端点形态一致,替换为真实后端。
200 OK— msAuth: Bearer a12-sk-demo

      

      

02认证与错误码

所有端点使用 Bearer 认证:Authorization: Bearer $A12_API_KEY。Key 在 控制台 → API Keys 生成,DEMO 中仅存本地。

状态码含义处理建议
200成功
400参数错误(缺字段 / 超范围)检查 schema,字段说明见 API 入门文档
401Key 无效或已删除重新生成 Key;DEMO 中点上方按钮换个 Key
402余额不足(Payment Required)充值后重试;余额归零保数据 72h
404资源不存在核对 deployment_id / gpu_id
409资源被占用(如卡片已满)改用可抢占档或稍后重试
429触发限流按响应头 Retry-After 退避重试
限流(公测目标):读写 10 req/s · 部署类 2 req/min(防误操作风暴)。超限返回 429 + Retry-After,不封号、不罚款。所有响应带 X-Request-Id,报障时一并提交给 支持中心 可直接定位日志。