docs.api.box
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Suno API
Common APIFile Upload API
Suno API
Common APIFile Upload API
  1. Suno API
  • API.box Documentation
  • Quick Start
  • Generate Music
    • Music Generation Callbacks
    • Music Extension Callbacks
    • Upload and Cover Audio Callbacks
    • Upload and Extend Audio Callbacks
    • Add Instrumental Callbacks
    • Add Vocals Callbacks
    • Music Cover Generation Callbacks
    • Replace Music Section Callbacks
    • Generate Music
      POST
    • Extend Music
      POST
    • Upload And Cover Audio
      POST
    • Upload And Extend Audio
      POST
    • Add Instrumental
      POST
    • Add Vocals
      POST
    • Get Music Generation Details
      GET
    • Recovery Audio
      POST
    • Get Recovery Audio Details
      GET
    • Get Timestamped Lyrics
      POST
    • Boost Music Style
      POST
    • Generate Music Cover
      POST
    • Replace Music Section
      POST
    • Get Music Cover Details
      GET
    • Generate Persona
      POST
    • Generate Mashup
      POST
  • Suno Voice
    • Suno Voice Validation Phrase Callbacks
    • Suno Voice Generation Callbacks
    • Suno Voice Regenerate Phrase Callbacks
    • Suno Voice Generate Verification Phrase
      POST
    • Suno Voice Get Verification Phrase
      GET
    • Suno Voice Create Custom Voice
      POST
    • Suno Voice Get Custom Voice Record
      GET
    • Suno Voice Regenerate Verification Phrase
      POST
    • Suno Voice Check Availability
      POST
  • Lyrics Generation
    • Lyrics Generation Callbacks
    • Generate Lyrics
    • Get Lyrics Generation Details
  • Generate Sounds
    • Generate Sounds
  • WAV Conversion
    • WAV Format Conversion Callbacks
    • Convert to WAV Format
    • Get WAV Conversion Details
  • Vocal Removal
    • Audio Separation Callbacks
    • MIDI Generation Callbacks
    • Vocal and Instrument Separation
    • Get Audio Separation Details
    • Generate MIDI from Audio
    • Get MIDI Generation Details
  • Music Video Generation
    • Music Video Generation Callbacks
    • Create Music Video
    • Get Music Video Details
  1. Suno API

API.box Documentation

Complete API.box documentation - Your gateway to affordable and stable AI music API services

Welcome to API.box Documentation#

This documentation provides comprehensive guides and references for integrating API.box, a platform offering affordable and stable AI music API services that seamlessly integrate into your projects.

About API.box#

API.box delivers advanced AI music capabilities through easy-to-integrate APIs, including music generation, lyrics creation, audio processing, and video production. Our platform is designed for developers and businesses who need:
99.9% Uptime - Reliable and stable API performance
Affordable Pricing - Transparent, usage-based pricing system
20-Second Streaming Output - Fast delivery with streaming response
High Concurrency - Scalable solutions that grow with your needs
24/7 Support - Professional technical assistance
Watermark-Free - Commercial-ready music generation

Quick Start Guides#

Get started quickly with our comprehensive API quick start guides:

🎵 Music Generation APIs#

Generate Music
Create high-quality music from text descriptions using advanced AI models with support for various styles and genres.
Extend Music
Extend existing music tracks with AI-powered continuation, maintaining musical coherence and style.
Upload and Cover Audio
Transform existing audio with new styles and arrangements using AI music processing.
Upload and Extend Audio
Upload your own audio files and extend them with AI-generated content.
Add Vocals
Generate vocal tracks for instrumental music using advanced AI models.
Add Instrumental
Create instrumental accompaniment for vocal tracks with AI-powered arrangement.

✍️ Lyrics Creation APIs#

Generate Lyrics
Create AI-powered lyrics for your songs with customizable themes and styles.
Get Timestamped Lyrics
Retrieve lyrics with precise timestamps for synchronization with audio tracks.

🔊 Audio Processing APIs#

Separate Vocals from Music
Extract vocals and instrumental tracks separately using advanced AI audio separation.
Convert to WAV Format
Convert generated music to high-quality WAV format for professional use.
Boost Music Style
Enhance and refine music styles with AI-powered audio processing.

🎬 Music Video APIs#

Create Music Video
Generate visual music videos from audio tracks using AI video generation technology.

🛠️ Utility APIs#

Get Music Generation Details
Monitor and retrieve detailed information about your music generation tasks.
Get Remaining Credits
Check your account credit balance and usage statistics.
Get Lyrics Generation Details
Track the status and details of your lyrics generation requests.
Get WAV Conversion Details
Monitor WAV format conversion tasks and download status.
Get Vocal Separation Details
Check the progress of vocal separation tasks and access separated audio files.
Get Music Video Details
Track music video generation progress and retrieve download links.

Documentation Features#

Interactive Examples - Test APIs directly in our documentation
Code Samples - Ready-to-use examples in multiple programming languages
Comprehensive Guides - Step-by-step integration instructions
API Reference - Complete parameter documentation and response schemas
Best Practices - Optimization tips and common use cases
Callback Documentation - Webhook integration guides for all endpoints

Key Features#

🚀 Latest AI Music Models#

We provide APIs for the latest AI music models, including Suno V5, V5_5, V4.5PLUS, V4.5, V4_5ALL, and V4, offering high-quality music generation. Supports creation of both vocal and instrumental tracks, music extension, and multi-format downloads.

💎 Watermark-Free Commercial Use#

All music generated through our API is watermark-free, making it immediately suitable for commercial projects. This removes the need for additional fees, enabling creators and developers to effortlessly integrate high-quality tracks into their workflows.

⚡ 20-Second Streaming Output#

We ensure rapid delivery with streaming output, enabling developers to integrate AI-generated music seamlessly into their workflows without delays. This feature supports real-time applications and live content creation.

🏗️ High-Concurrency Architecture#

Our API is built to handle multiple simultaneous requests, ensuring reliable performance even under heavy traffic. This makes it ideal for large-scale applications and high-demand platforms.

💰 Transparent and Affordable Pricing#

We offer cost-effective and transparent pricing plans, making it accessible to creators and enterprises. Our transparent, usage-based model ensures predictable costs as shown on API.box.

🔧 Comprehensive Developer Support#

We streamline integration with detailed, developer-friendly API documentation, ensuring a hassle-free implementation process. Supported by an experienced technical team.

Getting Started#

1.
Sign Up - Create your free account at API.box
2.
Get API Key - Obtain your authentication credentials from the API key management page
3.
Choose Your API - Select from our comprehensive API collection
4.
Follow Quick Start - Use our Quick Start Guide for rapid integration
5.
Test & Deploy - Verify your integration and go live

AI Model Versions#

Choose the right model for your needs:

V4_5ALL - Extended Capabilities#

Supports longer lyrics (5000 characters) and style descriptions (1000 characters). Perfect for projects requiring more detailed creative control.

V4 - Improved Vocals#

Enhanced vocal quality with refined audio processing, up to 4 minutes duration. Ideal when vocal clarity is most important.

V4_5 - Better Song Structure#

Improved song organization with clear verse/chorus patterns, max 1 minute duration. Ideal for short, well-structured compositions.

V4_5PLUS - Richer Tones#

Most advanced model with enhanced tonal variety and new creative approaches, up to 8 minutes duration. Best for highest quality and longest tracks.

V5 - Latest Model#

Cutting-edge model with enhanced quality and capabilities. Our newest offering for premium music generation.

V5_5 - Custom voice character#

Unleash Your Voice: Custom Models Tailored to Your Unique Taste. Use V5_5 anywhere the API accepts V5 for the same request parameters and character limits (see OpenAPI for each endpoint).

Use Cases#

🎮 Game Developers#

Generate dynamic background music, sound effects, and adaptive audio for gaming experiences with our music generation and extension APIs.

🎬 Content Creators#

Create royalty-free music for videos, podcasts, and social media content with unlimited commercial use through our watermark-free output.

🏢 Businesses#

Integrate AI music generation into apps, websites, and services for enhanced user experiences using our high-concurrency APIs.

🎭 Music Producers#

Prototype songs, generate ideas, and create full compositions with professional-quality output. Use vocal separation for remixing and audio processing.

🎤 Karaoke & Entertainment#

Leverage timestamped lyrics and vocal separation features for karaoke applications and interactive music experiences.

Support & Community#

24/7 Support - Contact our technical team anytime
Email Support - support@api.box
Documentation Updates - Regular improvements and new features
API Status - Monitor real-time service status
Developer Resources - Comprehensive guides and best practices

Callback Integration#

All major endpoints support webhook callbacks for real-time notifications:
Music Generation Callbacks
Lyrics Generation Callbacks
Music Extension Callbacks
Audio Processing Callbacks
Music Video Callbacks
WAV Conversion Callbacks
Upload & Cover Callbacks
Upload & Extend Callbacks
Add Vocals Callbacks
Add Instrumental Callbacks

API Base URL#

All API requests should be made to:
https://apibox.erweima.ai

Authentication#

All API requests require authentication using Bearer tokens:
Get your API key from the API Key Management Page.
Ready to get started? Choose an API above and follow the quick start guide to begin integrating powerful AI music capabilities into your projects. Visit API.box to create your account and start generating amazing music today!
Next
Quick Start
Built with