Model ID
Put this value in the request body's `model` field — not the display name above.
by suno · Suno AI music generation, V5 engine. Produces 2 complete songs per run (with lyrics and cover art); supports inspiration mode (one line becomes a song) plus custom lyrics, styles and instrumentals. Async task via POST /v1/music/generations.
POST /v1/music/generationshttps://api.xxb69.xyz/v1curl https://api.xxb69.xyz/v1/music/generations \
-H "Authorization: Bearer sk-gpushare-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5",
"prompt": "一首关于夏天海边散步的轻快中文流行歌"
}'
# 一次生成产出 2 首完整歌曲(含歌词与封面图),按次计费
# 自定义歌词改传 "lyrics"(≤3000 字);纯音乐传 "instrumental": truecurl https://api.xxb69.xyz/v1/music/generations/$TASK_ID \
-H "Authorization: Bearer sk-gpushare-xxxxxxxx"
# 成功后返回 2 首歌曲的音频链接This is an async task: submit for a task ID, then poll until it settles. Polling itself is free.
Billed per call: one call produces 2 complete songs — not per track, not per second.
Sign in and any personal discount on your account will show up here. Sign in
Models like this bill for real per image / per second / per call and are mostly async tasks, so there is no one-click test here. Use the sample code above, or generate in the matching workbench (which has a parameter panel and a cost estimate).
404 model_not_foundYou passed the display name instead of the model ID.✗ Suno V5→✓ suno-v5
→ Copy the Model ID at the top of this page
402 quota_exceededInsufficient account balance. All your API keys share one balance.
401 / 403The API key is invalid, or it has a model allowlist that doesn't include this ID.
→ Check the key's status and allowed models
400 invalid_requestYou must pass at least one of `prompt` or `lyrics` (both may be omitted for instrumentals, but then pass `instrumental: true`).
→ Check your request body against the sample code above
本页的 Markdown 版本：/models/suno-v5.md