Studio

File: 13-studio.md

Loading documentation...

# Studio

## Overview

Audio editing system with projects, assets, clips, timeline editing, and rendering via FFmpeg.

## Features
- Create projects and add media assets
- Create clips on a timeline
- Render outputs (audio/video) with status tracking

## Data Model
- `StudioProject` → user_id, name, description, status
- `StudioProjectAsset` → studio_project_id, media_id, name
- `StudioProjectClip` → studio_project_id, studio_project_asset_id, start_time, duration, volume
- `StudioProjectTimeline` → studio_project_id, clips (JSON)
- `StudioProjectOutput` → studio_project_id, media_id, format, status

## Key API Endpoints
- Projects: `/api/studio/projects` (list/show/store/update/delete)
- Assets: `/api/studio/projects/{id}/assets` (store)
- Clips: `/api/studio/projects/{id}/clips` (store)
- Timeline: `/api/studio/projects/{id}/timeline` (update)
- Render: `/api/studio/projects/{id}/render` (POST)
- Media: `/api/studio/media` (GET)

## Usage Examples
```javascript
// Create project
const project = await apiPost('/api/studio/projects', { name: 'Episode 1 Edit' });

// Add asset
await apiPost(`/api/studio/projects/${projectId}/assets`, { media_id });

// Create clip
await apiPost(`/api/studio/projects/${projectId}/clips`, {
  studio_project_asset_id: assetId,
  start_time: 12.5,
  duration: 30.0,
  volume: 0.9
});

// Update timeline
await apiPut(`/api/studio/projects/${projectId}/timeline`, { clips: [...] });

// Render output
await apiPost(`/api/studio/projects/${projectId}/render`, { format: 'mp3' });
```

## Tips
- Ensure FFmpeg is installed on the server
- Use media clips for social snippets
- Monitor render status and show progress

Studio

Studio

📝 Page Notes

Add New Note