Quickstart

Set up an account

To get started, sign up for a developer account by clicking “Sign Up” on the Controlla API Platform.

Create an API key

Navigate to the dashboard and click on “Manage Account & API Keys”. From there, you can create API keys for both personal and organizational use. Be sure to keep your keys secure. Do not share them with others or expose them in any client-side code.

The API uses REST endpoints with JSON payloads. Generate songs by submitting lyrics and style parameters, then track progress with job IDs.

Base URL

https://controlla...

Authentication

All API requests should include your API key in an Authorization HTTP header as follows:

Authorization: Bearer CONTROLLA_API_KEY

Quick Example

# Generate a song
curl -X POST "https://controlla-inc--controlla-enterprise-api-music-api-app-dev.modal.run/song/create" \
  -H "Content-Type: application/json" \
  -d '{
    "lyrics": "Walking through the city lights tonight",
    "genre": "pop", 
    "vibe": "energetic"
  }'

# Check generation status
curl "https://controlla-inc--controlla-enterprise-api-music-api-app-dev.modal.run/song/get/{job_id}"