Tchaikovsky API Overview

Effective Date: May 26, 2025

Tchaikovsky provides two primary APIs designed to empower developers and creators:

1. MIDI Generator API

This API allows you to generate MIDI music programmatically using our advanced AI engine. You can submit musical ideas, style parameters, and receive generated MIDI files in response.

Key Features:

Natural language prompts to guide music generation.
Support for various genres, moods, and instrumentation.
Real-time generation with configurable length and complexity.
Output in standard MIDI file format for easy integration.

Typical Usage:

{
  "prompt": "Create a chill lo-fi beat with soft piano",
  "length_seconds": 120,
  "genre": "lo-fi",
  "instruments": ["piano", "drums"]
}

The response includes a URL to download the generated MIDI file.

2. Content Search & Download API

This API enables you to search through our extensive indexed library of music tracks and download available content based on licensing and permissions.

Key Features:

Full-text search over metadata, genres, moods, and creators.
Filter by license type, length, and popularity.
Access download URLs for licensed content in MIDI or audio formats.
Supports pagination and sorting options.

Typical Usage:

GET /api/v1/content/search?query=cinematic+score&license=CC-BY&limit=10&page=1

The response includes metadata and download links for each matching track.

Authentication & Access

Access to the APIs requires authentication via API keys or OAuth tokens, ensuring secure and authorized use. Detailed documentation on obtaining credentials and request headers is available in our developer portal.

Rate Limits & Usage Policies

To ensure service stability, API usage is subject to rate limits and fair use policies. Exceeding limits may result in temporary suspension or throttling of requests.

Getting Started

Visit our Help Center for comprehensive API documentation, sample code, SDKs, and support resources.