API Reference

Integrate Orchestria into your workflow. Build custom tools, plugins, and experiences on top of our agent orchestra.

Coming Soon

The Orchestria API is currently in development. Join the waitlist to get early access when we launch. Below is a preview of what's planned.

Authentication

All API requests require a Bearer token. Include your API key in theAuthorization header:

HTTP Header
Authorization: Bearer YOUR_API_KEY

You'll receive your API key upon joining the beta. Keys can be managed from your dashboard.

Base URL

Base URL
https://api.orchestria.ai

Endpoints

POST/v1/sessionsBeta

Create a new music production session. Returns a session ID and initial configuration.

GET/v1/sessions/:idBeta

Retrieve session details, including current stems, version history, and agent states.

POST/v1/sessions/:id/commandBeta

Send a natural-language command to the session. Agents will process and respond in real time.

GET/v1/sessions/:id/stemsBeta

List all stems in the current session version. Returns metadata, format, and download URLs.

POST/v1/sessions/:id/exportComing Soon

Export the current mix or individual stems in WAV, MP3, or MIDI format.

GET/v1/sessions/:id/versionsComing Soon

Retrieve the version history for a session. Each version includes a diff summary.

POST/v1/sessions/:id/rollbackComing Soon

Roll back a session to a previous version by version number.

GET/v1/agentsBeta

List all available agents with their capabilities, supported parameters, and status.

Quick Example

Create a new session and send a command:

cURL
# Create a session
curl -X POST https://api.orchestria.ai/v1/sessions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bpm": 90, "key": "Cm", "genre": "lo-fi"}'

# Send a command
curl -X POST https://api.orchestria.ai/v1/sessions/SESSION_ID/command \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Add warm piano chords with reverb"}'

Rate Limits

During the beta, the following rate limits apply:

  • 60 requests/minute per API key
  • 10 concurrent sessions per account
  • 100 exports/day during the beta period

Need higher limits? Contact us at api@orchestria.tech.

SDKs & Libraries

Official SDKs are in development for:

  • JavaScript / TypeScript (npm)
  • Python (pip)
  • Swift (SPM)

In the meantime, the REST API works with any HTTP client. Community wrappers are welcome — check our GitHub for contribution guidelines.