APIAPI

Production API 参考地图

本页用于人工导航；生成的 API Reference 与 OpenAPI 才是精确机器合约。

API / MCP 成熟度

文档页面是公开的，但 API/MCP 能力是否可用由实时产品 Manifest 和账户权限决定。foundation / experimental 不等于稳定承诺。

Method	Endpoint	权限	用途
GET	/api/v1/product/manifest	read	产品事实与成熟度
GET	/api/v1/openapi	read	机器可读 API 合约
GET	/api/v1/production/capabilities	read	发现可用制作能力
GET	/api/v1/production/verticals	read	列出制作 recipes
POST	/api/v1/production/plans	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	执行一个已确认的计划步骤
POST	/api/v1/production/plans/:planId/generate	spend	启动已确认的持久制作
GET	/api/v1/production/jobs/:jobId	read	读取持久 Job 状态
GET	/api/v1/production/plans/:planId/ledger	read	读取执行 ledger

精确字段以生成合约为准

本页解释意图与权限。精确 schema 请看 /api/v1/docs 与 /api/v1/openapi。

处理 auth、forbidden、invalid id、missing idempotency、credits、preflight、rate limit、infra 等机器错误码和 HTTP 状态。

可重试的 read 与不可盲目重放的 mutate/spend 明确分离。

Workspace · Project · Asset · Entity · Storyboard · Plan · Job已生成 ≠ 已认证