ドキュメントAPI リファレンスエピソード・カットAPI

エピソード・カットAPI

エピソードとカットの作成・取得・更新を行うAPIエンドポイントです。

GET /api/v1/projects/[projectId]/episodes

プロジェクトのエピソード一覧を取得します。

// レスポンス
{
  "data": [
    {
      "id": "ep_001",
      "number": 1,
      "title": "第1話「始まり」",
      "total_cuts": 300,
      "status": "in_progress"
    }
  ]
}

POST /api/v1/projects/[projectId]/episodes

新しいエピソードを作成します。

// リクエスト
{
  "number": 2,
  "title": "第2話「出会い」"
}

// レスポンス (201 Created)
{
  "id": "ep_002",
  "number": 2,
  "title": "第2話「出会い」",
  "total_cuts": 0,
  "status": "not_started"
}

GET /api/v1/episodes/[id]/cuts

エピソード内のカット一覧を取得します。

// レスポンス
{
  "data": [
    {
      "id": "cut_001",
      "number": "C-001",
      "duration_seconds": 3.5,
      "duration_frames": 84,
      "processes": [
        {
          "name": "レイアウト",
          "status": "completed",
          "assignee": "山田太郎"
        }
      ]
    }
  ]
}