3 つのルール、3 つの数値
納品型 API たらしめる 3 つのルール。
L—01
課金単位 = 納品単位
1 Frame Credit = 1 点の合格フレーム。失敗したジョブと、その後の再生成は課金されません。
1 Frame Credit
L—02
品質ゲートは提供側にある
実測 13 フレームで 96.4–100。基準に届かないフレームは当社負担で一度だけ再生成します。
QC 96.4–100
L—03
上流の変更は届かない
インターフェースは /v1 に固定。背後のモデルが変わっても、リクエストとレスポンスの形は変わりません。
/v1
13 フレーム · 同一実行
証拠 — 13 フレーム、1 冊の QC 台帳。
1910s
江南
1930s
港
1940s
村落
ポストカード
PRESET 05
未定
- 13
- フレーム
- 96.4
- 最小
- 100
- 最大
- 1
- 再生成
フレームは請求に応じて開示
1 年目の現実
接続は半日で終わる。その先は?
| 日数 | 自前で構築 | arobai が納品 |
|---|---|---|
| 30 | 上流のモデル更新 — 再調整はあなた | こちらで吸収 |
| 90 | QC 基準の変更 — ゲートを作るのはあなた | すでに再生成している |
| 180 | ジョブが静かに失敗 — 計測するのはあなた | 型付きエラーを読むだけ |
| 365 | 再試行ロジックを誰も覚えていない | 依然としてこちらのもの |
3 ステップ · ポーリング
3 回の呼び出し、1 回の納品。
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_7f3a2c
02 ポーリング
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
ベータ — キーは手渡しで発行。認証ヘッダーは最終形です。
出荷は約束ではない
台帳 — 提供済み、実測値、約束はしない。
| 製品 | 状態 | 実測 | エンドポイント | 約束しない |
|---|---|---|---|---|
| 01-01 回想シーン API | ベータ | エンドツーエンド 10–15 秒 · 5 プリセット | POST /v1/jobs | SLA · 成功率 · 並列数 |
| 01-02 人生アルバム API | ベータ | 1 フレーム 8–9.8 秒 · QC 96.4–100 | POST /v1/lifealbum/jobs | SLA · 成功率 · 並列数 |
| 02 テキストインテリジェンス | 計画中 | — | — | 提供開始日 |
| 03 音声・映像 | 計画中 | — | — | 提供開始日 |
ベータ:SLA はコミットしません。バージョン方針は変わらず、/v1 に固定のままです。
番号は増えるだけ
シリーズ 02 と 03 は計画であり、約束ではありません。
シリーズ番号は増える一方です。新しいシリーズが既存の番号を再利用することはなく、すでに統合した認証・エンベロープ・課金単位を変更することもありません。
02
テキストインテリジェンス
03
音声・映像
一問一答、一段一主張
よくある四つの質問。
- デリバラブル API とは何ですか?
呼び出し単位ではなく合格した成果物単位で課金します。品質ゲートは提供側にあり、QC に落ちたフレームは自動で再抽選され、Frame Credit を消費しません。
- QC に落ちた場合はどうなりますか?
課金されません。同一の予算内で自動再試行し、合格フレームか、公開されたエラーコードのいずれかを返します。失敗のコストは当方が負担します。
- 上流モデルの変更で連携が壊れますか?
壊れません。インターフェースは /v1 に固定され、レスポンスのエンベロープも変わりません。上流モデルの変更は呼び出し側からは見えません。
- ベータ期間中はどうやって利用しますか?
ベータキーは手動で発行します。用途を hello@arobai.com までお送りください。セルフサービス登録、SLA、シリーズ 02・03 の提供開始日はいずれも未定です。