---
title: "Suno Speech"
description: "Suno 人声模型，按稿子或场景描述生成带情绪的旁白，可同时配原创背景音乐，每次两条。Suno 没有官方 API，Yir 经第三方渠道非官方接入"
seo:
  title: "Suno Speech API 文档：参数与调用示例"
  description: "Suno Speech API 文档：模型 ID suno/suno-speech、输入模式、参数取值与默认值，附请求示例。Suno 人声模型，按稿子或场景描述生成带情绪的旁白，可同时配原创背景音乐，每次两条。Suno 没有官方 API，Yir 经第三方渠道非官方接入。"
---

{/* 由 scripts/generate-model-pages.mjs 根据 openapi/model-contracts.json 生成，请勿手改；补充说明写在 docs/zh/models/_notes/ */}

| 模型 ID | 别名 | 接口 |
| --- | --- | --- |
| `suno/suno-speech` | `suno-speech` | [音频生成](/zh/docs/guides/music-generation) |

## 输入模式

| 模式 | 参考数量 | 参考角色 |
| --- | --- | --- |
| `text` 纯文本 | — | — |

提示词上限：1000 个字符，超出时返回 400。

## 参数

| 参数 | 说明 | 取值 | 默认值 | 必填 |
| --- | --- | --- | --- | --- |
| `lyrics_optimizer` | 自动写词：按提示词自动写词；不能同时传 input.lyrics，部分模型另收写词费用（以报价为准）。 | `false`、`true` | `false` | 否 |
| `n` | 单次请求输出数量：单次 API 请求（一个 Job）的输出数量，不是应用的批量张数。应用可提交多个独立请求组成一批；n=1 不表示应用只能生成一张。 | `2` | `2` | 否 |

## 示例

`text` 输入：

```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
  }
}
```

完整合同以 `GET /v1/models/suno/suno-speech?view=contract` 为准。参数合法不代表每个渠道都能执行，请对完整请求[报价](/zh/docs/concepts/billing#获取报价)。价格与渠道见[模型市场](https://yir.ai/zh/models)。