Suno Speech 可在同一音轨中生成配音和原创配乐。用 POST /suno/v1/speech 提交任务,按每次 6 quota(约 $0.06)计费,凭 jobId 用 Fetch V2 取回。
Suno Speech(Beta)是什么
Suno 于 2026 年 10 月 1 日开放 Speech(Beta),定位为在同一条音轨中生成说话声和音乐的音频模型。可给它一个想法、一首诗或完整台词,再描述语气和配乐风格。
官方示例覆盖戏剧朗读、语音配乐、冥想、诗歌、鼓励和睡前故事。Beta 版仍可能出现口音变化或停顿过长。
调用 Speech 接口
用 POST /suno/v1/speech 和 TT-API-KEY 提交,返回 jobId,后续使用 Fetch V2 或 hookUrl 取回。
custom=false 是默认灵感模式,根据简短描述生成内容。custom=true 的自定义模式朗读 prompt 中的精确文本,可配置语气、人声性别、变化程度和背景音乐。
| 字段 | 模式 | 说明 |
|---|---|---|
| custom | 两种模式 | false 为灵感模式(默认),true 为自定义模式 |
| gpt_description_prompt | 灵感模式 | 描述想生成的配音,最多 3,000 字符 |
| prompt | 自定义模式 | 必须提供朗读文本,最多 5,000 字符 |
| tags | 自定义模式 | 语气、节奏、情绪和场景,最多 1,000 字符 |
| vocal_gender | 自定义模式 | Male 或 Female |
| background_music | 自定义模式 | 是否添加背景音乐,默认 true |
| variety | 自定义模式 | off、normal(默认)、high、extra 或 max |
| audio_format | 两种模式 | audioUrl 对应格式为 mp3、m4a 或 wav |
| hookUrl | 两种模式 | 可选的任务完成回调地址 |
字段及限制以 TTAPI Suno Speech 接口文档为准,写入校验逻辑前请核对。
用简短需求生成配音
用 gpt_description_prompt 描述内容、声音及节奏,由模型撰写并演绎,适合草稿、占位旁白或措辞尚未确定的想法。
发布前同时检查文本和声音。品牌名、审定脚本或必须逐字保留的内容应使用自定义模式。
curl --request POST \
--url 'https://api.ttapi.io/suno/v1/speech' \
--header "TT-API-KEY: $TTAPI_KEY" \
--header 'Content-Type: application/json' \
--data '{
"custom": false,
"gpt_description_prompt": "Read a short evening news brief about a new city library opening, in a calm male voice at a steady pace.",
"audio_format": "mp3",
"hookUrl": "https://example.com/webhooks/suno"
}'按自定义脚本朗读
把完整脚本放进 prompt,再用 tags 指定语气、速度、情绪和场景。需要特定性别时设 vocal_gender。background_music 默认 true,仅需旁白时设为 false。
variety 控制和 tags 风格的偏离程度。需要表现稳定可用 off 或 normal,探索演绎时再试 high 等较高设置。
curl --request POST \
--url 'https://api.ttapi.io/suno/v1/speech' \
--header "TT-API-KEY: $TTAPI_KEY" \
--header 'Content-Type: application/json' \
--data '{
"custom": true,
"prompt": "The lighthouse keeper climbed the last step and looked out at the quiet sea. Tonight, every ship had found its way home. He turned down the lamp, smiled, and whispered goodnight to the waves.",
"tags": "warm, unhurried bedtime story narration, gentle pauses, soft lullaby piano and light strings underneath",
"vocal_gender": "Female",
"background_music": true,
"variety": "normal",
"audio_format": "mp3",
"hookUrl": "https://example.com/webhooks/suno"
}'- 脚本不超过 5,000 字符,tags 不超过 1,000 字符
- 把人名、数字和缩写写成期望的读法
- 要另外混入配乐时关闭 background_music
取回音轨并试听
把 jobId、脚本和设置一起记录,通过 Fetch V2 查询或等待 hookUrl 回调。限制轮询次数,并向用户显示待处理状态。
Speech 仍处于 Beta,交付前应逐条试听。试听不通过时,每次只改一个条件以便对照。
curl --request GET \
--url "https://api.ttapi.io/suno/v2/fetch?jobId=$JOB_ID" \
--header "TT-API-KEY: $TTAPI_KEY"- 人名和数字念法正确
- 口音和音色稳定
- 停顿及语速符合 tags
- 背景音乐不盖过人声
Suno Speech 在 TTAPI 上的计费
每个 Speech 任务为 6 quota(约 $0.06),与所列 Suno 歌曲生成单次价格相同。第一次调用后可核对账户账单。
预算应包含重试,三次尝试就是三个任务。明确脚本和 tags 可减少返工。
| 操作 | 价格 | 单位 |
|---|---|---|
| 语音 | 6 quota · $0.06 | 每个任务 |
| 音乐生成 | 6 quota · $0.06 | 每个任务 |
| 音效 | 1.2 quota · $0.012 | 每个任务 |
价格来自 TTAPI 价格页,生产使用前请确认账户的实际费用。