Quick Start Guide

Getting Started with JewelMusic API

Start distributing your music globally with our AI-powered platform in just 5 minutes

1
Create Your Partner Account
Apply for partner access and get your API credentials

JewelMusic is currently in limited beta. To get started, you'll need to apply for partner access:

  1. Submit your application at partners.jewelmusic.art
  2. Include your organization details and use case
  3. Wait for approval (typically 24-48 hours)
  4. Receive your API credentials via secure email

Your API key will look like:

jml_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
2
Install the SDK
Choose your preferred programming language and install our SDK

Node.js / JavaScript

npm install @jewelmusic/sdk

Python

pip install jewelmusic

Ruby

gem install jewelmusic

PHP

composer require jewelmusic/sdk
3
Initialize the Client
Configure your API client with your credentials
// JavaScript Example
import { JewelMusic } from '@jewelmusic/sdk';

const client = new JewelMusic({
  apiKey: process.env.JEWELMUSIC_API_KEY,
  environment: 'production',
  region: 'global' // or 'us', 'eu', 'asia'
});

// Test your connection
const status = await client.getStatus();
console.log('Connected to JewelMusic:', status);
# Python Example
from jewelmusic import JewelMusic
import os

client = JewelMusic(
    api_key=os.environ['JEWELMUSIC_API_KEY'],
    environment='production',
    region='global'
)

# Test your connection
status = client.get_status()
print(f'Connected to JewelMusic: {status}')
4
Make Your First API Call
Upload and transcribe your first track
// Upload and transcribe a track
const track = await client.tracks.upload({
  file: './my-song.mp3',
  metadata: {
    title: 'My Traditional Song',
    artist: 'Artist Name',
    language: 'georgian',
    genre: 'folk'
  }
});

// Get AI transcription
const transcription = await client.transcription.create({
  trackId: track.id,
  languages: ['ka', 'en'], // Georgian and English
  includeTimestamps: true
});

console.log('Transcription:', transcription.lyrics);
5
Distribute Your Music
Send your music to streaming platforms worldwide
// Create a release
const release = await client.releases.create({
  title: 'My Album',
  artist: 'Artist Name',
  releaseDate: '2025-09-01',
  tracks: [track.id],
  artwork: './album-cover.jpg',
  metadata: {
    label: 'Independent',
    copyright: '© 2025 Artist Name',
    language: 'Georgian',
    genre: 'World Music'
  }
});

// Distribute to DSPs
const distribution = await client.distribution.create({
  releaseId: release.id,
  platforms: ['spotify', 'apple-music', 'youtube-music'],
  territories: ['worldwide'],
  pricing: {
    tier: 'standard'
  }
});

console.log('Distribution status:', distribution.status);

What You Can Build

Powerful features available through our API

Real-time Transcription
Transcribe music in 150+ languages with 99.7% accuracy
Global Distribution
Distribute to 150+ streaming platforms worldwide
Fraud Protection
AI-powered fraud detection for streaming and royalties

Ready to Get Started?

Apply for partner access and start building with JewelMusic today