音乐教程Suno v6 音乐 API

Suno v6 音乐 API 入门:为场景配乐

通过 TTAPI 选择三款 Suno v6 模型,提交一个配乐任务,查询并试听结果。

TTAPI约 3 分钟阅读
本文导读

你将了解

  • 写清场景需要的配乐
  • 选择 v6、wild 或 mini
  • 提交任务、查询并试听
要点

先写清场景需要的音乐,再选模型。chirp-v6 适合较可控的成品,wild 用于探索变化,mini 适合快速出草稿。音频就绪后先试听再发布。

从场景需要的声音写起

通过 TTAPI 用 Suno v6 为画面配乐。明确氛围、速度、人声和时长,便于评审时逐项核对。

Suno 提供旗舰、偏探索的 wild 与更快的 mini,TTAPI 对应 ID 为 chirp-v6、chirp-v6-wild 和 chirp-v6-mini。

  • API 密钥留在服务端
  • 先明确情绪、节奏、人声和时长
  • 决定是否使用 hookUrl

按创作目标选择 v6、wild 或 mini

需要可控的人声、清晰编曲并可对照需求验收时,可从 chirp-v6 开始。

希望同一提示词得到更多不同尝试时选 wild;只需尽快拿到草稿可选 mini。比较模型时,固定需求、人声选项和时长。

  • chirp-v6:适合控制成品细节
  • chirp-v6-wild:适合探索变化
  • chirp-v6-mini:适合快速生成草稿

提交 Suno 音乐任务

向 Suno 音乐接口发送风格输入,将 mv 设为文档中的三个 ID 之一。把返回的任务 ID 与用户需求一起持久化。

示例以灵感模式请求 chirp-v6,可仅更换 mv 试另外两款。Fetch V2 查询同一任务,需要后台通知时可接入回调。

提交 Suno v6 音乐任务
cURL
curl --request POST \
  --url 'https://api.ttapi.io/suno/v1/music' \
  --header "TT-API-KEY: $TTAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "custom": false,
  "instrumental": false,
  "mv": "chirp-v6",
  "gpt_description_prompt": "slow cinematic electronic soul, 75 BPM, deep sub-bass, warm Rhodes piano, soft brushes, atmospheric pads, intimate low male vocal",
  "audio_format": "mp3",
  "variety": "normal",
  "hookUrl": "https://example.com/webhooks/suno"
}'

试听生成结果

将音频和原始需求一起展示,检查氛围、人声是否合适,以及配乐能否服务场景。

下方 Fetch 示例只查询一次。应用中应限制重试,等待时继续显示需求。

查询生成结果
cURL
curl --request GET \
  --url "https://api.ttapi.io/suno/v2/fetch?jobId=$JOB_ID" \
  --header "TT-API-KEY: $TTAPI_KEY"
  • 核对氛围和乐器
  • 判断人声是否适合场景
  • 确认通过或记录修改要求
  • 保留原始需求、任务 ID 和 mv

会话结束后恢复任务

用户离开页面后,回来仍应能打开保存的任务。查询出错时保留原始需求并给出重试查询入口。

先跑通从请求到试听的单条路径,再按 TTAPI 文档添加续写、片段替换和音轨操作。

继续接入

查看 Suno Music API

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