Project Studio

Organize your TTS content into projects for better management and collaboration.

Project Management

List Projects

curl -X GET https://api.mondialspeech.com/api/v1/projects \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Create Project

curl -X POST https://api.mondialspeech.com/api/v1/projects \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Podcast Ep.1","description":"Introduction episode"}'

Get Project Details

curl -X GET https://api.mondialspeech.com/api/v1/projects/{id} \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Update Project

curl -X PUT https://api.mondialspeech.com/api/v1/projects/{id} \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Podcast Ep.1 Updated","description":"Updated description"}'

Delete Project

curl -X DELETE https://api.mondialspeech.com/api/v1/projects/{id} \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Project TTS Generation

Generate TTS in Project

curl -X POST https://api.mondialspeech.com/api/v1/projects/{projectId}/tts \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"text":"Project content","voiceId":"<VOICE_GUID>","speed":"Fast"}'

Get Project Items

curl -X GET https://api.mondialspeech.com/api/v1/projects/{id}/items \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Project Structure

File Organization

• Project files: wwwroot/media/projects/{userId}/{projectId}/...
• Automatic organization by project
• Version control for project items
• Metadata tracking for each generation

Project Types

Podcast Projects

• Episode organization
• Intro/outro management
• Segment planning
• Voice consistency

Audiobook Projects

• Chapter management
• Character voice mapping
• Progress tracking
• Quality control

Educational Content

• Lesson organization
• Topic grouping
• Progress tracking
• Assessment integration

Marketing Content

• Campaign organization
• Brand voice consistency
• A/B testing support
• Performance tracking

Project Collaboration

Sharing Projects

• Private projects: Only creator access
• Team projects: Shared with team members
• Public projects: Community access

Version Control

• Item history: Track all generations
• Rollback support: Revert to previous versions
• Change tracking: Monitor modifications

Best Practices

Project Organization

1. Clear naming conventions
2. Descriptive descriptions
3. Logical grouping of content
4. Regular cleanup of unused items

Content Management

1. Consistent voice selection
2. Quality standards maintenance
3. Regular backups of important content
4. Documentation of project goals

Error Handling

404 Not Found

{ "error": "Project not found" }

403 Forbidden

{ "error": "Access denied to project" }

400 Bad Request

{ "error": "Invalid project data" }

Use Cases

Content Creators

• Organize podcast episodes
• Manage audiobook chapters
• Plan video voiceovers
• Create educational series

Businesses

• Brand voice consistency
• Marketing campaign organization
• Training material management
• Customer service scripts

Developers

• API testing organization
• Demo content management
• Documentation voiceovers
• Tutorial creation

Related