How it Works

Version 1.0.0 // Full Guide

System Status: Stable

Introduction

Sonic Stream is a high-performance system designed to process, cache, and stream media. It leverages advanced backend technologies to deliver fast and reliable content from across the web directly to your connection.

Built with speed and efficiency in mind, the system handles all the heavy lifting in the background, ensuring you get the best quality with minimal waiting. It provides a seamless unified experience for all your media needs.

Features

Search & Stream

Unified way to search and get a direct stream link instantly.

Smart Caching

Intelligent storage of files to minimize waiting and loading.

Background Processing

Files are prepared asynchronously for zero-lag delivery.

Playlist Support

Queue entire collections for automatic background processing.

Rate Limiting

System-wide protection via IP and Key-based limits.

Maintenance Mode

Dynamic system locking toggled directly via dashboard.

Prerequisites

To run the Sonic Stream system, ensure the following are installed and configured on the host:

  • Python 3.9+: The core system runtime.
  • FFmpeg: Required for professional media processing.
  • Node.js or Deno: Recommended for faster signature solving.

Authentication

Most requests require a secret Access Key passed as a query parameter.

GET Example:https://api.sonic.io/search?q=TRACK&api_key=YOUR_KEY

API Reference

GET/search

Find any track and get a direct stream link instantly. If it's new, we process it in the background.

Query Parameters:
  • q Search text or URL (Required)
  • type audio (default) or video
  • api_key Your secret key (Required)
GET/stream/{id}

Access the binary file stream. Usually called via the URL from /search.

POST/playlist

Queue an entire playlist for background processing.

Error Handling

403

Forbidden

429

Rate Limit

503

Lockout

404

Missing