API 参考

所有 CINE-OS 功能都可通过 REST API 访问。所有端点需要认证。

认证

所有 API 请求需要有效会话。使用 Web 界面进行认证，或实现 OAuth 流程。

未认证的 API 端点返回 401 Unauthorized。

GET /api/projects

POST /api/projects
Content-Type: application/json

{
  "name": "我的项目",
  "description": "可选描述"
}

GET /api/projects/:id

PATCH /api/projects/:id
Content-Type: application/json

{
  "name": "更新后的名称"
}

DELETE /api/projects/:id

POST /api/projects/:id/parse
Content-Type: application/json

{
  "content": "剧本文本内容..."
}

解析结构化剧本并创建资产、场景和节拍。

POST /api/projects/:id/generate-all

批量生成所有项目的描述和提示词。

GET /api/projects/:id/assets

POST /api/projects/:id/assets
Content-Type: application/json

{
  "name": "角色名称",
  "type": "character"
}

POST /api/projects/:id/assets/:assetId/generate-description

POST /api/projects/:id/assets/:assetId/generate-image

GET /api/projects/:id/scenes

POST /api/projects/:id/scenes
Content-Type: application/json

{
  "title": "场景标题",
  "location": "地点名称"
}

GET /api/projects/:id/scenes/:sceneId/beats

POST /api/projects/:id/beats/:beatId/generate-prompts

POST /api/projects/:id/beats/:beatId/generate-image

POST /api/studio/generate
Content-Type: application/json

{
  "prompt": "电影级镜头..."
}

返回 base64 图像和上传后的 URL。

所有端点返回 JSON：

{
  "success": true,
  "data": { ... }
}

错误响应：

{
  "success": false,
  "error": "错误信息"
}