要点
先写清场景需要的音乐,再选模型。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 查询同一任务,需要后台通知时可接入回调。
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 文档添加续写、片段替换和音轨操作。