Producer Instructions#

Producer API Documentation#

⚠️ Migration Notice (2026-04, updated 2026-05)#

Producer API is powered by Google Lyria 3 Pro. The legacy FUZZ-* models have been retired upstream and are silently aliased to Lyria 3 Pro — your existing SDK calls continue to work without code changes.

cover_music is supported again (re-enabled 2026-05-20 after a brief gap during the April migration). It accepts a new strength parameter (0–1); the legacy cover_strength field is kept as an alias for back-compat.

The following operations remain unsupported and return HTTP 410 Gone:

music_variation — no direct replacement; re-run create_music with the same prompt and a different seed for an alternate version.

swap_music_vocals — use replace_music targeting the vocals time window.

swap_music_sound — use replace_music targeting the instrumental time window.

The advanced parameters make_instrumental, lyrics_strength, sound_strength, and weirdness are accepted at the API surface for backwards compatibility but are silently ignored — Lyria 3 Pro does not support them. To produce instrumental output, include "instrumental, no vocals" in your sound prompt and leave lyrics empty.

Why Choose Producer API?#

Suno v5 Quality at Lightning Speed#

Key Features#

Authentication & Endpoints#

Base Configuration#

Available Endpoints#

Pricing & Rate Limits#

Available Models#

Backwards Compatibility#

Sample Outputs#

The samples below were generated under the legacy FUZZ models and are kept here for reference only. New generations use Lyria 3 Pro and are not directly comparable to these clips.

Instrumental (prompt: "A chill lofi hip hop beat with soft piano and vinyl crackle")#

Vocal (prompt: "Energetic pop rock with electric guitar and drums", with lyrics)#

API Parameters#

Request Body Schema#

Important: The sound parameter can be used independently to achieve prompt-based generation similar to description/prompt mode.

Deprecated Parameters#

Legacy alias kept: cover_strength is accepted as a legacy alias for the new strength parameter on cover_music. Existing SDK calls that pass cover_strength continue to work without code changes.

Critical Parameter Guidelines#

Sound Parameter#

Lyrics Parameter#

Why This Matters#

Examples#

"Energetic rock anthem with distorted electric guitars, driving drums, and powerful vocals"
"Calm ambient meditation music with soft piano, gentle strings, and nature sounds"
"90s hip-hop beat with vinyl scratches, deep bass, and smooth jazz samples"
"Instrumental cinematic orchestral piece, no vocals, sweeping strings and brass"

[Verse 1]
Walking through the city lights
Feeling the rhythm of the night
Every step a new surprise
Under these electric skies

[Chorus]
We're alive, we're free tonight
Dancing till the morning light

sound: "music"
sound: "test"
lyrics: "la la la"
lyrics: "test lyrics here"

Usage Examples#

1. Create Music (Sound Only)#

2. Create Music with Lyrics#

3. Create Instrumental Track#

4. Extend Music#

5. Replace Music Section#

6. Cover an Existing Track#

7. Create with Webhook#

Task Query & Response#

Query Task Status#

Response Examples#

Success (200 OK)#

{
  "code": 200,
  "data": [
    {
      "clip_id": "abc123",
      "title": "Epic Orchestral Trailer",
      "sound": null,
      "lyrics": null,
      "lyrics_id": "e59f87f2-2252-5d52-b60d-6f00cfab6041",
      "lyrics_timing_markers": [[0, 0], [5, 9.874], [7, 19.748]],
      "image_url": "https://storage.googleapis.com/producer-app-public/assets/...jpg",
      "audio_url": "https://storage.googleapis.com/producer-app-public/clips/...m4a",
      "wav_url": "https://storage.googleapis.com/producer-app-public/clips/...wav",
      "video_url": null,
      "created_at": "2026-04-27T14:11:57.984846Z",
      "mv": null,
      "seed": null,
      "duration": null,
      "state": "succeeded"
    }
  ],
  "message": "success"
}

Note on Lyria 3 Pro responses: sound, lyrics, mv, seed, and duration may be null because the upstream does not echo these back. The new fields wav_url, lyrics_id, and lyrics_timing_markers are exposed when available.

Processing (202 Accepted)#

{
  "code": 202,
  "type": "not_ready",
  "error": "Task is still processing. Please wait a few seconds and try again."
}

Deprecated Operation (410 Gone)#

{
  "type": "endpoint_deprecated",
  "error": "'swap_music_vocals' is no longer supported by the upstream model platform. Use 'replace_music' with start_s/end_s targeting the vocals segment to achieve a similar effect.",
  "docs": "https://docs.musicapi.ai"
}

Error (500 Internal Server Error)#

{
  "code": 500,
  "error": "Internal Server Error"
}

HTTP Status Codes#

Upload & Download#

Upload Audio#

{ "message": "success", "task_id": "<uuid>" }

Auto-refund: If the upstream upload fails, the 2-credit charge is automatically refunded.

Download MP3/WAV#

{ "message": "success", "task_id": "<uuid>" }

Auto-refund: If the upstream download fails, the 2-credit charge is automatically refunded.

Best Practices#

Polling Strategy#

Optimization Tips#

Performance Advantages#

Credit Management#

Need Help?#