# MusicAPI ## Docs - [MusicAPI Docs — Suno-Style AI Music Generation API](https://docs.musicapi.ai/introduction.md): Start here: authenticate, send your first music generation request, and poll for the finished track. Free trial credits, first call in about two minutes. - [Credits & Costs - What Each API Call Costs | MusicAPI](https://docs.musicapi.ai/credits-usage-guide.md): What each call costs: 20 credits per generation on v4.5+ models, 15 on legacy, 30 for stems. Purchased credits never expire; plan credits reset monthly. - [Music API FAQ & Troubleshooting | AI Music Generation Help](https://docs.musicapi.ai/faq.md): Find answers to common questions about AI music generation with Suno API and Udio API. Learn how to use the AI music SDK, resolve technical issues, and optimize text-to-music and AI vocal generation. Get troubleshooting tips for concurrent audio processing, API errors, and more. - [Common Scenarios - Music API Use Cases & Best Practices](https://docs.musicapi.ai/special-scenarios.md): Discover practical use cases for the Music API, from AI-generated custom songs to extending music clips and creating unique personas. - [Error Handling - Music API Error Codes & Solutions](https://docs.musicapi.ai/error-handling.md): Find solutions to common Music API errors, including validation errors, authorization issues, forbidden actions, server errors, and timeouts. - [Webhook Integration Guide](https://docs.musicapi.ai/webhook-guide.md): Get a POST callback when a track finishes instead of polling: webhook_url setup, signature checks with webhook_secret, retry behaviour and payload examples. - [How to Get a Suno API Key (2026) - MusicAPI](https://docs.musicapi.ai/get-suno-api-key.md): Create a free account and generate a Suno-compatible music API key in two minutes, then authenticate your first request with the copy-paste curl example. - sonic [Sonic Instructions | AI Music Generation with Sonic V4 API](https://docs.musicapi.ai/sonic-instructions.md): Model reference for sonic-v4, sonic-v4-5 and sonic-v5: which mv value to send, the credit cost per call, and the create, extend and cover options each supports. - riffusion(Deprecated) [Riffusion API - Generate Music with Riffusion (2026 Guide)](https://docs.musicapi.ai/riffusion-instructions.md): Generate Riffusion tracks from a text prompt, your own lyrics, or a hummed audio upload, plus covers, extensions and stem swaps. Commercial-use terms included. - producer [Producer AI API - Docs, Examples & Endpoints | MusicAPI](https://docs.musicapi.ai/producer-api-overview.md): Producer API reference: create, extend, cover and replace sections, then download WAV or MP3. Retired fuzz-2.0 and fuzz-2.0-raw names still work as aliases. - producer [Producer API Request Examples - Complete Integration Guide | MusicAPI](https://docs.musicapi.ai/producer-api-examples.md): Comprehensive Producer API request examples for all operations: create, extend, cover, replace, swap vocals, swap instrumentals, and variations. Production-ready code samples with best practices. - studio(Unavailable) [Studio Instructions | AI Music Generation with Studio Model](https://docs.musicapi.ai/studio-instructions.md): Learn how to use the Studio AI music generation model for professional-quality tracks. The Studio model leverages advanced AI vocal synthesis and music composition to produce high-quality AI-generated music. Explore features, best practices, and API integration details. - nuro [Nuro Instruction](https://docs.musicapi.ai/nuro-instruction.md): The Nuro endpoints are retired and now return HTTP 410. Migrate vocal tracks to /sonic/create and instrumentals to /producer/create on your existing key. - nuro [Error handling](https://docs.musicapi.ai/nuro-error-handling.md): Legacy Nuro error codes, kept for reference only now the API returns HTTP 410. See the Sonic and Producer error guides for currently supported responses. ## API Docs - sonic [Concat Music API | Seamlessly Merge AI-Generated Music with Sonic](https://docs.musicapi.ai/concat-music.md): Use the concat-music POST API to merge AI-generated music segments into a seamless full-length track with Sonic V4 API. Ensure smooth transitions and high-quality audio for professional music production. Learn about request parameters, audio formats, and best practices. - sonic [│ Upload and Extend Music - MusicAPI ](https://docs.musicapi.ai/upload-extend-music.md): One-stop API to upload audio and extend with new content. Supports auto_concat, webhook, custom lyrics and AI description modes. - sonic [Upload and Cover Music - MusicAPI ](https://docs.musicapi.ai/upload-cover-music.md): One-stop API to upload audio and create cover versions. Supports auto_concat, webhook, custom lyrics and AI description modes. - sonic [Create Persona API | AI Voice Model Training with Sonic](https://docs.musicapi.ai/create-persona.md): Use the create-persona POST API to generate a custom AI voice model from any song URL with Sonic V4 API. Create your unique persona and use its vocal characteristics to generate new AI-powered music. Learn about request parameters, training process, and best practices. - sonic [sample](https://docs.musicapi.ai/sample-this-song.md): Generate a complete song from a short audio sample or hummed melody. - sonic [mashup](https://docs.musicapi.ai/mashup.md): Generate a new song based on two existing songs. - sonic [Get BPM - MusicAPI](https://docs.musicapi.ai/get-bgm.md): Get the BPM (Beats Per Minute) of a song including average, max and min values. Analyze song tempo with clip_id parameter. - sonic [Get VOX (Vocal Extraction) - MusicAPI](https://docs.musicapi.ai/get-vox.md): Extract vocal audio from a song. Specify time range (up to 30 seconds) to extract vocals from specific portions. - sonic [AI Music API – Get WAV from Song ID: Convert Original MP3 to High-Quality WAV](https://docs.musicapi.ai/wav.md): AI Music API's WAV feature converts any generated song from MP3 to lossless WAV format by Song ID. Perfect for professional audio editing, mastering, and high-fidelity playback. - sonic [Get the midi data of the specified clip id in suno](https://docs.musicapi.ai/get-midi.md): Export a generated song as MIDI note data from its clip id, ready to import into a DAW or notation software. Costs 15 credits per conversion. - sonic [Get the lyric timeline for the specified suno clip_id.](https://docs.musicapi.ai/get-suno-lyrics-timeline.md): Fetch word-level timestamped lyrics for any generated clip: aligned lyric timings for karaoke, live captions and subtitle tracks. Costs 1 credit per call. - sonic [Upsample Tags ｜ MusicAPI](https://docs.musicapi.ai/upsample-tags.md): get the AI-enhanced tags - sonic [AI Music API – Stems Basic: Extract Vocals and Instrumental from Song ID (2 Tracks)](https://docs.musicapi.ai/stems-basic.md): Use AI Music API's Stems Basic feature to split any song by Song ID into two high-quality audio tracks: isolated vocals and pure instrumental. Perfect for karaoke, remixes, podcasts, and content creation. - sonic [AI Music API – Stems Full: Extract 12 Detailed Vocal and Instrument Tracks from Song ID](https://docs.musicapi.ai/stems-full.md): AI Music API's Stems Full feature extracts up to 12 individual stems from a song by Song ID, including lead vocals, backing vocals, drums, bass, piano, guitar, and more — giving creators maximum control for mixing and production. - sonic [replace section](https://docs.musicapi.ai/replace-section.md): Rewrite one section of an existing song by supplying overlapping replacement lyrics and matching timings. The rest of the track is preserved. 15 credits. - sonic [upload music](https://docs.musicapi.ai/upload-music.md): Upload a local audio file to get a clip id for cover, extend and stem operations. Returns the id directly, or pass callback_url to upload asynchronously. - sonic [create voice](https://docs.musicapi.ai/create-voice.md): Clone a voice from an audio file with clear vocals: submit a public URL, poll the returned task id, then reuse the persona in later generations. 5 credits. - sonic [Get Music Results - Suno-Style Task API | MusicAPI Docs](https://docs.musicapi.ai/get-sonic-music.md): Retrieve generated songs by task id: audio URLs, task states and metadata. Polling and webhook patterns for the Suno-style music generation API. - riffusion(Deprecated) [create music (with lyrics)](https://docs.musicapi.ai/riffusion-create-with-lyrics.md): Generate a Riffusion song from lyrics you supply: send the lyric text plus a style prompt, receive a task id, then poll it for the finished audio track. - riffusion(Deprecated) [create music (with description)](https://docs.musicapi.ai/riffusion-craete-with-prompt.md): Generate a Riffusion track from a plain-text style description, no lyrics needed. Send a prompt, get a task id, then poll that id for the finished audio. - riffusion(Deprecated) [cover music](https://docs.musicapi.ai/riffusion-cover-music.md): Create a Riffusion cover of an existing or self-uploaded song, re-recording it in a new style while keeping the original melody and structure intact. - riffusion(Deprecated) [extend music](https://docs.musicapi.ai/riffusion-extend-music.md): Extend a Riffusion track or a song you uploaded yourself, continuing it with newly generated content from the point in the timeline that you choose. - riffusion(Deprecated) [replace music section](https://docs.musicapi.ai/riffusion-replace-music-section.md): Regenerate a chosen time range inside a Riffusion track or an uploaded song, leaving all of the surrounding audio exactly as it was before the edit. - riffusion(Deprecated) [swap music sound](https://docs.musicapi.ai/riffusion-swap-music-sound.md): Swap the backing instrumentation of a track with Riffusion stem swaps: describe the new sound you want in the prompt and keep the original vocal take. - riffusion(Deprecated) [swap music vocals](https://docs.musicapi.ai/riffusion-swap-music-vocals.md): Swap the vocal performance on a track with Riffusion stem swaps: describe the new voice you want while keeping the existing instrumental backing. - riffusion(Deprecated) [upload](https://docs.musicapi.ai/riffusion-upload.md): Upload your own audio to Riffusion and get back a clip id you can pass to the cover, extend, replace-section and stem-swap operations. Costs 2 credits. - riffusion(Deprecated) [get music](https://docs.musicapi.ai/riffusion-get.md): Poll a Riffusion task id to retrieve finished audio URLs, generation state and track metadata. The recommended polling interval is 15 to 25 seconds. - producer [POST Create Music - Producer API Endpoint | MusicAPI](https://docs.musicapi.ai/create-producer-music.md): Producer API endpoint to generate AI music tracks. Supports create, extend, cover, replace, swap vocals/instrumentals, and variations. FUZZ-2.0 model with 30-second generation time. - producer [Upload music to producer API](https://docs.musicapi.ai/upload-music-producer.md): upload music to producer , get the audio id , and use the clip id to create music. - producer [Download music files from producer ](https://docs.musicapi.ai/download-producer-music.md): Download music files in specified format according to clip id, mp3/wav - producer [GET Music Task Status - Producer API Endpoint | MusicAPI](https://docs.musicapi.ai/get-producer-music.md): Query Producer API task status and retrieve generated music. Returns audio_url, video_url, metadata, and generation details. Free polling with no credit cost. - producer [Extend an existing music track](https://docs.musicapi.ai/extend-producer-music.md): Extend a Producer clip from a chosen timestamp for a set number of seconds. If the upstream extension fails the 12-credit charge is refunded automatically. - producer [Replace a section of an existing music track](https://docs.musicapi.ai/replace-producer-music-section.md): Replace the audio between two timestamps in a Producer clip while keeping the surrounding sections intact. Failed replacements are refunded automatically. - producer [Cover an existing music track](https://docs.musicapi.ai/cover-producer-music.md): Re-record an existing Producer clip in a new style while keeping its structure. A 0-1 strength value controls how far the cover diverges from the original. - studio(Unavailable) [Description Mode API | AI Music Generation with Studio Model](https://docs.musicapi.ai/description-mode.md): Use the description-mode POST API to generate AI-powered music with the Studio model by providing a detailed text description. Create professional-quality tracks with AI-driven composition and vocal synthesis. Learn about request parameters, response formats, and best practices. - studio(Unavailable) [Extend Mode API | AI Music Extension with Studio Model](https://docs.musicapi.ai/extend-mode.md): Use the extend-mode POST API to seamlessly extend AI-generated music using the Studio model. Generate high-quality, natural-sounding music continuations with AI-driven composition and vocal synthesis. Learn about request parameters, response formats, and best practices. - studio(Unavailable) [Custom Mode API | Tailored AI Music Generation with Studio Model](https://docs.musicapi.ai/custom-mode.md): Use the custom-mode POST API to create unique AI-generated music tailored to your specific needs with the Studio model. Customize your tracks with detailed parameters, leveraging AI vocal synthesis and composition to produce professional-quality music. Learn about request parameters, response formats, and best practices. - studio(Unavailable) [Instrumental Mode API | AI Instrumental Music Generation with Studio Model](https://docs.musicapi.ai/instrumental-mode.md): Use the instrumental-mode POST API to generate high-quality instrumental music using the Studio model. Create AI-composed tracks without vocals, ideal for background music, soundtracks, and custom compositions. Learn about request parameters, response formats, and best practices. - studio(Unavailable) [Get Music API | Retrieve AI-Generated Music by Task ID](https://docs.musicapi.ai/get-studio-music.md): Use the get-music GET API to retrieve AI-generated music details using a task ID with the Studio and Sonic models. Access metadata, download links, and processing status for your generated tracks. Learn about request parameters, response formats, and best practices. - lyrics generation [Lyrics Generation API | AI-Powered Song Lyrics Creation](https://docs.musicapi.ai/lyrics-generation.md): Use the lyrics-generation POST API to generate AI-crafted song lyrics based on themes, moods, and styles. Leverage advanced AI models to create unique and high-quality lyrics for any genre. Learn about request parameters, response formats, and best practices. - nuro [create vocal music](https://docs.musicapi.ai/create-nuro-music.md): Retired endpoint: Nuro vocal generation now returns HTTP 410. Use POST /api/v1/sonic/create to generate vocal tracks with the same API key you already have. - nuro [create instrument music](https://docs.musicapi.ai/create-nuro-bgm.md): Retired endpoint: Nuro instrumental generation now returns HTTP 410. Use POST /api/v1/producer/create for background music and instrumental tracks instead. - nuro [get music](https://docs.musicapi.ai/get-nuro-music.md): Retired endpoint: Nuro task lookup returns HTTP 410 and old task ids can no longer be queried. Poll /sonic/task/{id} or /producer/task/{id} instead. - [get-credits](https://docs.musicapi.ai/get-credits.md): Check your remaining balance with a single GET call. Returns subscription credits and never-expiring extra credits so you can alert before you hit zero.