GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
All resources

· reAPI Team

Suno Speech Beta and API Guide: Modes, Prompts, and Cost

Suno Speech beta and API guide: Simple vs Advanced mode fields, script and tone prompting, background_music control, beta quirks, and $0.06 API pricing.

Suno Speech Beta and API Guide: Modes, Prompts, and Cost

Suno Speech is not a conventional text-to-speech reader. Released into public beta on October 1, 2026 across Suno's web, iOS, and Android apps, it generates a spoken performance and an original musical score together in a single take[1][2]. Instead of exporting dry narration from a TTS engine and ducking a stock bed underneath in an editor, the model paces the voice and the backing instruments at the same time.

That single-pass architecture is also why people run into surprises during their first ten generations. Treat it like a flat voice synthesizer and you get wandering accents, overly theatrical pauses, or unwanted backing instruments[1][5]. Treat it as a directed audio scene, or control it cleanly through the Suno Speech API on reAPI, and the outputs become predictable enough to drop into intros, podcasts, ad reads, and product demos[3]. Below is how the two modes actually work, how to keep spoken scripts from drifting into singing, and what we observed running both modes live on November 19, 2026.

Simple vs Advanced mode in Suno Speech

When calling the Suno Speech API (model: "suno-speech" on POST /api/v1/audio/generations), the single most important rule is that Simple mode and Advanced mode are strictly mutually exclusive[3]. You pick one with custom_mode, and every parameter from the opposite mode is rejected before billing[3].

FieldModeRequiredLimits and behavior
custom_modeBothYesfalse selects Simple mode; true selects Advanced mode[3]
promptSimple (false) onlyConditional1 to 3,000 characters after trimming. Describes the scene; Suno writes the spoken lines. Rejected when custom_mode is true[3]
scriptAdvanced (true) onlyConditional1 to 5,000 characters after trimming. Exact text to speak, multiline (\n) supported. Rejected when custom_mode is false[3]
toneAdvanced (true) onlyNoUp to 1,000 characters after trimming. Controls delivery, pace, accent, room feel, and score style[3]
varietyAdvanced (true) onlyNoInteger 0 to 4 (0 tightest adherence, 1 balanced, 4 maximum variation)[3]
vocal_genderAdvanced (true) onlyNo"f" or "m" to steer the speaker voice[3]
background_musicAdvanced (true) onlyNoBoolean. true scores an original backing track under the voice; false requests dry spoken audio[3]

Simple mode fits fast ideation when you want the model to invent the copy itself, such as a morning weather bumper, a mock dramatic trailer, or a pep talk[1][2]. You pass only custom_mode: false and prompt. The moment you need exact wording (brand copy, tutorial scripts, spoken poetry, or dialogue lines), switch to custom_mode: true and put the exact text in script[3].

One detail trips up developers porting code from suno-music: in suno-speech, sending variety, tone, vocal_gender, or background_music while custom_mode is false returns an HTTP 400 validation error, and sending prompt while custom_mode is true does the same[3]. In our November 19, 2026 validation checks on reAPI, both invalid combinations were rejected immediately at 0 credits before any upstream task was created.

Writing scripts and tone briefs that stay spoken

Browse early feedback on r/SunoAI and two recurring frustrations stand out: speakers occasionally drift into a sing-song cadence, and backing instruments show up when the user expected clean narration[5]. In Advanced mode, four concrete habits fix most of that drift.

Separate what is said from how it is read

Keep stage directions out of script and put them in tone. A useful tone brief covers up to five short slots:

  1. Speaker profile and register (for example, "calm news anchor" or "tired detective narrating late at night").
  2. Pacing and rhythm ("measured pace, clear articulation, short pauses between sentences").
  3. Accent or region, stated plainly ("neutral American English").
  4. Acoustic space ("close-mic podcast studio, dry room").
  5. Score cue only when background_music is true ("subtle warm Rhodes chords, very low under the voice").

If you leave tone vague or poetic ("ethereal dreamy ballad mood"), the Suno Speech generator pulls toward its musical training distribution and starts half-singing the phrasing. Plain broadcast or voice-acting terminology ("dry studio voiceover, conversational, non-musical cadence") anchors the delivery to speech.

Use background_music explicitly instead of guessing

In the web app beta, Speech defaults toward pairing voice with original music because that is the feature's headline pitch[1][2]. Through the API in Advanced mode, background_music gives you an explicit boolean switch[3]:

  • Set background_music: false when you plan to drop the voiceover into a video timeline that already has its own soundtrack or sound effects.
  • Set background_music: true when you want a self-contained scored read, such as a meditation track, bedtime story over soft piano, or hype intro over drums[2].

Keep variety at 0 or 1 for scripted copy

variety accepts 0 through 4[3]. For commercial scripts, tutorials, or anything where mispronouncing a product name wastes a take, start with variety: 0 or variety: 1. Higher values (3 or 4) push the model toward theatrical improvisation and wider stylistic swings between the two returned takes, which helps comedy bits or dramatic readings but hurts strict script fidelity.

Format script with punctuation and line breaks

script accepts multiline text (\n) up to 5,000 characters[3]. Short sentences with standard commas, periods, and line breaks between paragraphs give the model natural breath points. Spell out tricky acronyms phonetically if you hear a garbled read on the first pass, and test one parameter change at a time (tone, then variety) rather than rewriting every field together.

Calling the Suno Speech API with Simple and Advanced payloads

Both modes submit to POST /api/v1/audio/generations with model: "suno-speech" and return an asynchronous task ID[3]. Poll GET /api/v1/tasks/{id} until status reaches "completed" or "failed". Every completed request returns two takes in output.audio_urls[] along with matching entries in output.tracks[][3].

Simple mode request (custom_mode: false)

curl -X POST https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-speech",
    "custom_mode": false,
    "prompt": "A short cheerful morning weather intro about sunny skies"
  }'

Advanced mode request (custom_mode: true)

curl -X POST https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-speech",
    "custom_mode": true,
    "script": "Welcome to today\u2019s briefing.\nThe weather is clear and sunny across the coast.",
    "tone": "Warm, calm female narrator, gentle pace, close-mic studio delivery",
    "variety": 1,
    "vocal_gender": "f",
    "background_music": true
  }'

What we observed in live paid test runs (November 19, 2026)

We ran both payloads above through the live reAPI gateway on November 19, 2026 to verify real end-to-end execution rather than relying on schema parsing alone:

  • The Simple mode task completed in 21.9 seconds and returned two playable MP3 tracks hosted on the reAPI CDN (HTTP 200, audio/mpeg).
  • The Advanced mode task (script + tone + variety: 1 + vocal_gender: "f" + background_music: true) completed in 19.8 seconds and likewise returned two playable MP3 tracks (HTTP 200, audio/mpeg).
  • Submitting Simple mode with variety: 1 or Advanced mode with prompt returned HTTP 400 pre-charge validation errors with 0 credits deducted.

Those timings are single-day observations on short scripts, not an SLA guarantee. Longer 2,000-character scripts naturally take longer to render.

Known beta quirks and how Speech compares to Voices and TTS

In the October 1, 2026 launch post, Suno's Chief Product Officer Jack Brody was blunt about the beta status: "Occasionally, British accents can wander off to Australia and back.. Dramatic pauses may be very dramatic."[1] Early testers on the r/SunoAI launch thread echoed that reality, pointing out occasional word mispronunciations (even in the promo video itself) and unpredictable mid-sentence pauses[5].

Because every request generates two takes, reviewing both takes before rerunning saves credits. Even so, you should know where this model stops and other tools fit better:

  • No one-click Voice or Persona attachment yet. Suno's cloned Voices (suno-voice-generate) and Personas (POST /api/v1/audio/suno/persona) attach to song generation via persona_id and persona_model[3]. On suno-speech, persona_id is not part of the request schema; voice character is steered only through vocal_gender and tone[3]. If you need a consistent cloned brand narrator across 100 episodes, a dedicated voice-cloning TTS model is still more consistent.
  • No word-level streaming or SSML phoneme tags. suno-speech is an async batch generation model returning finished MP3 files, not a low-latency WebSocket streaming TTS engine for real-time voice agents[3].
  • Where Suno Speech genuinely wins. When a short piece needs expressive pacing tightly coupled to custom background music (podcast intros, comedy sketches, narrated social reels, bedtime stories, game flavor audio) without spending 30 minutes sourcing and mixing royalty-free stems[1][2].

Suno Speech pricing: web beta vs pay-per-request API

Suno opened the Suno Speech beta to all web, iOS, and Android users on October 1, 2026, following each account's existing Suno plan and credit rules[1][2]. If you want programmatic access without managing a consumer app subscription, reAPI bills suno-speech at a flat per-request rate that does not vary with script length or background_music setting[4].

Usage pattern on reAPI (checked Nov 19, 2026)RequestsTotal takes returnedCost (USD)[4]Credits (1 credit = $0.001)[4]
Single Suno Speech API call (Simple or Advanced)12$0.06[4]60
Short podcast season (10 intros, 2 takes each)1020$0.60[4]600
Batch ad-read prototyping (50 variations)50100$3.00[4]3,000

Failed or validation-rejected requests are refunded automatically. Check the live Suno model page for current rates before committing a large batch[4].

Frequently asked questions

How do I create a voiceover with Suno Speech?

In Suno's web or mobile app, open the Create view, pick Speech (beta), enter your idea or script, and describe the voice and musical mood[1][2]. Through the Suno Speech API on reAPI, send model: "suno-speech" with custom_mode: true, your exact lines in script, delivery cues in tone, and background_music: false (dry voiceover) or true (scored voiceover)[3].

Is Suno Speech free to try?

Suno opened the public beta to all users on web and mobile on October 1, 2026, subject to each Suno account's plan and daily credit limits[1][2]. On reAPI, suno-speech is pay-per-request at $0.06 (60 credits) per two-take generation with no monthly subscription required[4].

Does Suno support an official API for Speech?

Suno does not publish a general public REST API for developers. Its native Suno Speech beta runs inside the Suno web, iOS, and Android apps[2]. Developers integrating spoken audio into apps use API gateways such as reAPI's Suno API, which exposes suno-speech alongside the rest of the 19-operation Suno family on a single endpoint[3].

Can Suno Speech use my cloned Voice or Persona?

Not directly on suno-speech today. Cloned Voices (suno-voice-generate) and Personas attach via persona_id on music generation (suno-music)[3], whereas suno-speech steers voice characteristics through vocal_gender (f or m) and the tone field[3].

Why did Suno Speech add background music or start singing my script?

Suno Speech is trained to generate voice and original music together[1]. If your prompt uses musical genre adjectives or leaves background_music enabled, the model may add instruments or melodic cadence. Switch to Advanced mode (custom_mode: true), set background_music: false, keep variety at 0 or 1, and write plain broadcast direction in tone[3].

Why did my Suno Speech API request fail with HTTP 400?

Almost always because Simple and Advanced fields were mixed in the same JSON body. In Simple mode (custom_mode: false), send only prompt and omit script, tone, variety, vocal_gender, and background_music. In Advanced mode (custom_mode: true), send script (and optional direction fields) and omit prompt[3].

Fitting Suno Speech into a production audio stack

Use a standard streaming TTS API when you need sub-second latency, strict pronunciation dictionaries, or an identical cloned narrator across hundreds of files. Use Suno Speech when the audio benefits from musical framing, expressive reads, or fast two-take creative variations where voice and backing score belong together[1][2]. For automated workflows, start in Advanced mode with background_music set explicitly, keep variety low until your pronunciation checks out, and build around the fact that every Suno Speech call gives you two complete MP3 takes to pick from[3].

Inspect the complete field schema in the reAPI Suno API documentation or try Simple and Advanced requests interactively in the Speech channel on the Suno model page.

References

  1. Suno (Jack Brody). Introducing Speech (beta). Published October 1, 2026. Retrieved November 2026 from suno.com/blog/introducing-speech-beta
  2. Suno Release Notes. Introducing Speech (beta). Published October 1, 2026. Retrieved November 2026 from suno.com/release-notes/introducing-speech-beta
  3. reAPI. Suno API Documentation. Retrieved November 2026 from reapi.ai/docs/suno
  4. reAPI. Suno Model Page & Live Pricing. Retrieved November 2026 from reapi.ai/models/suno
  5. r/SunoAI Community Discussion. Introducing Speech (beta). Posted October 2026. Retrieved November 2026 from old.reddit.com/r/SunoAI/comments/1wve1wx/sunocom_introducing_speech_beta

More Posts

All resources