Developer Documentation

JewelMusic API Documentation

Integrate AI-powered music distribution, transcription, and cultural preservation features into your applications with our comprehensive API.

Documentation Sections

Everything you need to integrate with the JewelMusic platform

Getting Started
Quick start guide, authentication, and basic API usage
API Reference
Complete endpoint documentation with examples
AI Features
Transcription, lyric enhancement, and music analysis
Distribution
Music distribution to DSPs and streaming platforms
Webhooks
Real-time notifications and event handling
SDKs & Libraries
Official libraries for popular programming languages
API Overview

RESTful API with Modern Standards

Our API follows REST principles with JSON payloads, standard HTTP methods, and comprehensive error handling. All endpoints are secured with API key authentication and support rate limiting.

Base URL: https://api.jewelmusic.art/v1
Authentication: API Key (Bearer token)
Rate Limit: 1000 requests/hour (adjustable)
Response Format: JSON with consistent structure
Quick Example
# Upload and transcribe audio
curl -X POST \
https://api.jewelmusic.art/v1/transcription \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "audio=@song.mp3" \
-F "language=auto" \
-F "cultural_context=georgian"

# Response
{
"job_id": "trans_abc123",
"status": "processing",
"estimated_time": 45
}

Core API Endpoints

Essential endpoints for music processing, distribution, and management

Audio Transcription API
POST
/v1/transcription

Description

Upload audio files for AI-powered transcription with support for 150+ languages and cultural context awareness.

Parameters

audioFile (required)
languageString (auto/specific)
cultural_contextString (optional)
formatString (srt/vtt/json)

Response

{
"job_id": "trans_abc123",
"status": "completed",
"transcription": {
"text": "Traditional song lyrics...",
"confidence": 0.97,
"language": "ka",
"cultural_tags": ["polyphonic", "folk"]
}
}
Music Analysis API
POST
/v1/analysis

Description

Analyze musical structure, extract stems, identify instruments, and get cultural classification for any audio file.

Parameters

audioFile (required)
analysis_typeArray (structure/stems/cultural)
qualityString (standard/premium)

Response

{
"structure": {
"tempo": 120,
"key": "C major",
"time_signature": "4/4"
},
"cultural": {
"region": "Caucasus",
"style": "Traditional Folk"
}
}
Music Distribution API
POST
/v1/distribution/release

Description

Submit music for distribution to global streaming platforms including Spotify, Apple Music, Amazon Music, and more.

Parameters

audio_filesArray[File] (required)
metadataObject (required)
artworkFile (required)
platformsArray (optional)

Response

{
"release_id": "rel_xyz789",
"status": "pending_review",
"platforms": [
"spotify", "apple_music", "amazon"
],
"estimated_live_date": "2025-01-15"
}
Developer Tools

SDKs & Code Examples

Official libraries and code examples to get you started quickly

Go
Go SDK
Official Go library for JewelMusic API integration
go get github.com/jewelmusic/go-sdk
JS
JavaScript SDK
NPM package for Node.js and browser applications
npm install @jewelmusic/sdk
Py
Python SDK
PyPI package for Python applications and data science
pip install jewelmusic-python

Need Help Getting Started?

Our developer support team is here to help you integrate JewelMusic into your applications.