iRenown

AI Music Production

iRenown
iRenown
Developer

API Documentation

Integrate iRenown into your applications with our RESTful API.

Quick Links

Get API Access

API access is available on Studio tier plans.

Authentication

All API requests require authentication using a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Endpoints

POST/api/v1/tracks

Create a new music production job from a vocal upload.

Request Body

{
  "vocal_url": "string (Required) - URL to the source vocal audio file.",
  "genre": "string (Required) - Target genre (pop, rock, hiphop, edm, rnb, jazz).",
  "title": "string (Optional) - Name of the project.",
  "quality": "string (Optional) - 'standard' or 'premium' (default: standard)."
}
GET/api/v1/tracks/{id}

Retrieve the current status and results of a production job.

POST/api/v1/analyze

Analyze an audio file to detect its native BPM and musical key.

Request Body

{
  "audio_url": "string (Required) - URL to the audio file for analysis."
}

Implementation

const createJob = async () => {
  const res = await fetch('https://api.irenown.com/v1/tracks', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      vocal_url: 'https://storage.com/vocal.mp3',
      genre: 'pop',
      quality: 'premium'
    })
  });
  const data = await res.json();
  console.log('Job ID:', data.job_id);
};

Error Codes

INVALID_API_KEYHTTP 401

API key is missing or invalid.

INSUFFICIENT_CREDITSHTTP 402

Account has 0 premium credits remaining.

RATE_LIMIT_EXCEEDEDHTTP 429

Too many requests within the hourly window.

INVALID_GENREHTTP 400

The provided genre is not supported.

Webhooks

Register a webhook URL in your dashboard to receive real-time notifications when jobs are completed or failed.

Automate your workflow

Coming Q1 2026: Official Webhook SDKs and Playground.

Rate Limits

TierRequests/HourConcurrent Jobs
Studio1,00010
EnterpriseUnlimitedCustom

Need more details?

View our complete API reference with all parameters and responses.