语音产品动态Suno Speech API

Suno Speech API:一条音轨同时生成配音和配乐

了解 Suno Speech(Beta)的两种模式、请求参数、计费及任务查询。

TTAPI约 5 分钟阅读
本文导读

你将了解

  • 了解配音和配乐如何生成
  • 选择灵感模式或自定义模式
  • 提交任务、取回音频并估算成本
要点

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 中的精确文本,可配置语气、人声性别、变化程度和背景音乐。

Suno Speech API 请求字段
字段模式说明
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 描述内容、声音及节奏,由模型撰写并演绎,适合草稿、占位旁白或措辞尚未确定的想法。

发布前同时检查文本和声音。品牌名、审定脚本或必须逐字保留的内容应使用自定义模式。

灵感模式的 Speech 请求
cURL
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 等较高设置。

自定义模式的 Speech 请求
cURL
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,交付前应逐条试听。试听不通过时,每次只改一个条件以便对照。

查询 Speech 任务
cURL
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 可减少返工。

TTAPI Suno 音频操作价格
操作价格单位
语音6 quota · $0.06每个任务
音乐生成6 quota · $0.06每个任务
音效1.2 quota · $0.012每个任务

价格来自 TTAPI 价格页,生产使用前请确认账户的实际费用。

继续接入

查看 Suno Music API

从模型详情进入 API 文档,核对当前的接入方式。