APIAPI
Production API リファレンスマップ
人向けの案内です。正確な機械契約は生成 API Reference と OpenAPI です。
API / MCP の成熟度
ドキュメントは公開できますが、API/MCP の利用可否はライブの製品マニフェストとアカウント権限で決まります。foundation / experimental は安定性保証ではありません。
| Method | Endpoint | 権限 | 目的 |
|---|---|---|---|
| GET | /api/v1/product/manifest | read | 製品の事実と成熟度 |
| GET | /api/v1/openapi | read | 機械可読 API 契約 |
| GET | /api/v1/production/capabilities | read | 利用可能な制作 capability を確認 |
| GET | /api/v1/production/verticals | read | 制作 recipe を一覧表示 |
| POST | /api/v1/production/plans | plan | 課金なしの production plan を作成 |
| POST | /api/v1/production/plans/:planId/preflight | read | 実行前の readiness を検証 |
| POST | /api/v1/production/plans/:planId/storyboard/apply | mutate | 承認済み Storyboard を適用 |
| POST | /api/v1/production/plans/:planId/steps/:stepId/execute | spend | 確認済み plan step を実行 |
| POST | /api/v1/production/plans/:planId/generate | spend | 確認済み durable production を開始 |
| GET | /api/v1/production/jobs/:jobId | read | durable job status を取得 |
| GET | /api/v1/production/plans/:planId/ledger | read | execution ledger を取得 |
正確なフィールドは生成契約を参照
ここでは意味と権限を説明します。厳密な schema は /api/v1/docs と /api/v1/openapi。
エラーは状態として扱う
auth、forbidden、invalid id、missing idempotency、credits、preflight、rate limit、infra の machine-readable code / HTTP status を処理します。
Read retry は慎重に
再試行可能な read と、盲目的に再実行してはいけない mutate/spend を区別します。
Workspace · Project · Asset · Entity · Storyboard · Plan · Job生成済み ≠ 認証済み