三条判据
三条判据，让它成为交付制 API。
L—01
计费单位 = 交付单位
1 Frame Credit = 1 份合格成品。失败任务、以及其后的重抽，均不计费。
1 Frame Credit
L—02
质检闸门在服务方这一侧
13 张真实出图，96.4–100。未达阈值的图由我们自费重抽一次。
QC 96.4–100
L—03
上游变更不会传导到调用方
接口锁定在 /v1。其背后的模型发生变化时，你的请求与响应结构保持不变。
/v1
两个都在内测 · 无 SLA
序列 01 — 图像叙事。两个 API，均在内测。
13 帧 · 同一次内测
证据 — 13 帧，一本质检台账。
1910s
江南
1930s
港口
1940s
村落
明信片
PRESET 05
待定
- 13
- 帧
- 96.4
- 最低
- 100
- 最高
- 1
- 重抽
帧图可按需提供
第一年会发生什么
一个下午就能接完。然后呢？
| 天数 | 自己搭建 | 由 arobai 交付 |
|---|---|---|
| 30 | 上游换了模型 — 你重新调参 | 我们吸收掉 |
| 90 | 质检标准变了 — 你搭一套校验 | 我们已在重抽 |
| 180 | 任务静默失败 — 你做埋点 | 你读一条结构化错误 |
| 365 | 没人记得重试逻辑 | 它依然是我们的 |
三步 · 轮询成本极低
三次调用，一次交付。
01 提交
curl -sS https://api.arobai.com/v1/jobs \ -H "Authorization: Bearer $AROBAI_KEY" \ -H "Content-Type: application/json" \ -d '{"series":"01-01","preset":"1910s","prompt":"a family in Jiangnan, 1913"}'# -> 202 accepted · job jb_7f3a2c02 轮询
curl -sS https://api.arobai.com/v1/jobs/jb_7f3a2c \ -H "Authorization: Bearer $AROBAI_KEY"# -> {"status":"passed","qc":97.1}03 取回
curl -sS -o frame.jpg \ https://api.arobai.com/v1/jobs/jb_7f3a2c/frame \ -H "Authorization: Bearer $AROBAI_KEY"# -> 200 image/jpeg · 1.2 MB内测中 — key 人工发放；鉴权头已是最终形态。
已上线不等于已承诺
台账 — 已上线、已实测，不作承诺。
| 产品 | 状态 | 实测 | 接口 | 不作承诺 |
|---|---|---|---|---|
| 01-01 回忆录历史场景配图 API | 内测 | 端到端 10–15 秒 · 5 个预设 | POST /v1/jobs | SLA · 成功率 · 并发 |
| 01-02 人物人生相册 API | 内测 | 每帧 8–9.8 秒 · QC 96.4–100 | POST /v1/lifealbum/jobs | SLA · 成功率 · 并发 |
| 02 文本智能 | 计划中 | — | — | 上线日期 |
| 03 视听生成 | 计划中 | — | — | 上线日期 |
内测期不承诺 SLA；版本策略不受影响，仍锁定 /v1。
编号只增不减
序列 02 与 03 是计划，不是承诺。
序列编号只增不减。新序列不复用已有编号，也不改动你已接入的鉴权、信封与计费单位。
02
文本智能
03
音视频
一段一断言，可独立引用
四个常被问到的问题。
- 什么是交付制 API？
按合格产出计费，不按调用计费。质检在服务商一侧完成：没过质检的成品自动重抽，且不占用你的 Frame Credit 额度。
- 成品没过质检怎么办？
不计费。任务在同一预算内自动重抽，最终要么交付合格成品，要么返回错误码表中公开的一类。失败的成本由我方承担。
- 上游换模型会破坏我的集成吗？
不会。接口锁定在 /v1，响应包络固定。上游模型的更换对调用方不可见，请求与响应的字段结构不随之变动。
- 内测期怎么接入？
内测密钥人工发放。把你的使用场景发到 hello@arobai.com 即可。暂不支持自助开通，不承诺 SLA，序列 02 与 03 没有上线日期。