# Suno V6 API on Wizzx - Model ID: `suno` (Suno Suno V6) - Submit: `POST https://api.wizzx.ai/api/v1/music/generate` - Status: `GET https://api.wizzx.ai/api/v1/task/{task_id}` - Idempotency: optional `Idempotency-Key: ` header on submit - Auth: header `Authorization: Bearer $WIZZX_API_KEY` (server-side only) - Price: from $0.002/request, billed in credits; failed tasks are refunded - Page: https://wizzx.ai/model/suno - JSON Schema: https://wizzx.ai/api/models/suno/schema - API reference: https://docs.wizzx.ai/api-reference/endpoint/submit-music ## Flow 1. POST the JSON body to the submit URL. The response contains `data.task_id`. 2. Poll `GET /api/v1/task/{task_id}` until `data.status` is `SUCCEEDED`, then read the output URLs from `data.result_urls`. 3. Stop on `FAILED` or `REVIEW_REQUIRED`. Do not resubmit automatically. ## Parameters | Field | Type | Required | Default | Allowed | Description | |---|---|---|---|---|---| | `prompt` | string | no | | ≤ 5,000 | Inspiration mode: describe the song (max 3000 characters). Custom mode: enter your lyrics (max 5000 characters). | | `task_id` | string | no | | | Task ID of one of your finished Suno tasks (copy it from the result panel or History). | | `audio_url` | string | no | | | Public http(s) link to an audio file (MP3, WAV or M4A; under 8 minutes). | | `audio_index` | integer | no | 1 | 1 – 20 | Which track of the source task to use (1 = first). | | `custom` | boolean | no | false | | On: the prompt is lyrics and you set the style. Off: the prompt describes what you want. | | `instrumental` | boolean | no | false | | Generate music without vocals. | | `continue_at` | number | no | | 1 – … | Where the continuation starts; must be before the end of the track. | | `start_s` | number | no | | 0 – … | | | `fade_duration` | number | no | 3 | 0.1 – … | | | `speed` | number | no | 1.25 | 0.25 – 4 | 0.25-4, for example 1.25. | | `stem_type` | string | no | lead_vocal | lead_vocal · backing_vocals · drum_kit · bass · piano · acoustic_guitar · electric_guitar · synth · string_section · brass_section · percussion · sound_effects | The API accepts 100+ instruments; these are the most common. | | `name` | string | no | | ≤ 80 | Max 80 characters. | | `sound_type` | string | no | one-shot | one-shot · loop | | | `lyrics_model` | string | no | | classic · remi | | | `variation_category` | string | no | | subtle · normal · high | | | `end_s` | number | no | | 0 – … | | | `keep_pitch` | boolean | no | true | | | | `bpm` | integer | no | | 1 – 300 | | | `infill_lyrics` | string | no | | ≤ 5,000 | Lyrics for the replaced section. Use the prompt for the surrounding lyrics. | | `description` | string | no | | ≤ 1,000 | | | `version` | string | no | v6 | v6 · v6-wild · v6-mini · v5.5 · v5 | All versions cost the same. Upload Cover and Upload Extend require V6; Add Stem requires V5.5 or V6. | | `title` | string | no | | ≤ 80 | Max 80 characters. | | `style` | string | no | | ≤ 1,000 | Style tags, for example synthwave, female vocal, cinematic. | | `negative_tags` | string | no | | ≤ 1,000 | Max 1000 characters. | | `vocal_gender` | string | no | | Male · Female | | | `max_mode` | boolean | no | false | | Higher quality at double the price. | | `duration` | integer | no | | 10 – 360 | Optional target length in seconds (10-360). The actual length may differ. | | `persona_task_id` | string | no | | | Task ID of a finished Create Persona or Create Voice task. | | `custom_model_task_id` | string | no | | | Task ID of a finished Create Custom Model task. Replaces the version. | ## Example body ```json { "custom": false, "instrumental": false, "version": "v6", "max_mode": false, "prompt": "Late-night city lo-fi piano with the sound of rain" } ```