---
title: "Suno Speech"
description: "Suno voice model that turns a script or scene idea into expressive narration, optionally with original background music, two takes per request. Suno has no official API; Yir accesses it unofficially through third-party channels"
seo:
  title: "Suno Speech API Documentation: Parameters & Examples"
  description: "Suno Speech API documentation: model ID suno/suno-speech, input modes, parameters, defaults and request examples. Suno voice model that turns a script or scene idea into expressive narration, optionally with original background music, two takes per request. Suno has no official API; Yir accesses it unofficially through third-party channels."
---

{/* Generated by scripts/generate-model-pages.mjs from openapi/model-contracts.json. Do not edit; write notes in docs/models/_notes/ */}

| Model ID | Alias | Endpoint |
| --- | --- | --- |
| `suno/suno-speech` | `suno-speech` | [Audio generation](/docs/guides/music-generation) |

## Input modes

| Mode | References | Reference roles |
| --- | --- | --- |
| `text` Text only | — | — |

Prompt limit: 1,000 characters; longer prompts are rejected with 400.

## Parameters

| Parameter | Description | Values | Default | Required |
| --- | --- | --- | --- | --- |
| `lyrics_optimizer` | Auto lyrics: Write lyrics from the prompt. Omit input.lyrics; some models add a lyrics-writing charge (see the quote). | `false`, `true` | `false` | No |
| `n` | Outputs per request: Number of outputs from one API request (one Job), not the application batch size. For multiple Jobs, submit separate requests; n=1 does not prevent application-managed batching. | `2` | `2` | No |

## Examples

`text` input:

```json
{
  "model": "suno/suno-speech",
  "input": {
    "type": "text",
    "prompt": "Warm indie folk, acoustic guitar and soft vocals, a quiet morning walk",
    "lyrics": "[Verse]\nMorning light on an empty street\n[Chorus]\nWalk with me, slow and sweet"
  },
  "parameters": {
    "lyrics_optimizer": false,
    "n": 2
  }
}
```

The authoritative contract is `GET /v1/models/suno/suno-speech?view=contract`. A valid parameter does not mean every channel can run it, so [quote](/docs/concepts/billing#get-a-quote) the complete request. Prices and channels are listed in [Model Market](https://yir.ai/models).