Suno Music API

# ── Inspiration (一句描述，模型自动写词谱曲) ──
curl -X POST https://apimodels.app/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "model": "suno-v5", "description": "an upbeat synthwave track about a night drive", "mv": "chirp-v5" }'

# ── Custom (自带歌词 + 风格 + 标题) ──
curl -X POST https://apimodels.app/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "model": "suno-v5", "lyrics": "[Verse]\n...", "tags": "pop, female voice", "title": "Night" }'

# Poll → data.resultUrls (2 mp3s) + data.resultJson (JSON string: parse for clipIds/titles/…)
curl "https://apimodels.app/api/v1/audio/generations?task_id=TASK_ID" -H "Authorization: Bearer YOUR_API_KEY"

# 每个"编辑类"模式由它专属的 *_clip_id 字段自动识别；clipId = JSON.parse(data.resultJson).clipIds[]

# 哼唱成曲 — 把一段哼唱/清唱采样变成完整歌曲
curl -X POST https://apimodels.app/api/v1/audio/generations -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "model":"suno-v5", "chop_sample_clip_id":"<clipId>", "chop_sample_start_s":0, "chop_sample_end_s":30,
        "lyrics":"[Verse 1]\n...", "tags":"pop, female voice", "title":"hum to song" }'

# 局部编辑 — 只替换 [start,end] 秒区间的歌词/旋律
curl -X POST https://apimodels.app/api/v1/audio/generations -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "model":"suno-v5", "infill_clip_id":"<clipId>", "infill_start_s":10, "infill_end_s":20, "lyrics":"[Verse]\n新片段", "tags":"pop" }'

# 加人声 — 给纯音乐加演唱人声（overpainting_clip_id + 歌词）
# 加伴奏 — 给清唱配伴奏（underpainting_clip_id，无需歌词）
# 重制  — 整体重制（remaster_clip_id + variation_category: low|medium|high）
# 续写  — continue_clip_id + continue_at；翻唱 — cover_clip_id

# 生成歌词（同步返回文本，免费；把结果填进上面的 lyrics 字段即可）
curl -X POST https://apimodels.app/api/v1/audio/lyrics -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "prompt": "my love" }'
# → { "code":200, "data": { "lyric": "[Verse 1]\n...", "title": "...", "tags": "..." } }