音乐生成(generations) - Open API 开发者文档

请求参数

Body 参数application/json

示例

{
    "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "tags": "heavy metal",
    "mv": "chirp-v3-5",
    "title": "Starry",
    "continue_clip_id": null,
    "continue_at": null,
    "infill_start_s": null,
    "infill_end_s": null
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/suno/v2/generate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "tags": "heavy metal",
    "mv": "chirp-v3-5",
    "title": "Starry",
    "continue_clip_id": null,
    "continue_at": null,
    "infill_start_s": null,
    "infill_end_s": null
}'

返回响应

🟢200成功

application/json

Body

示例

续写上传音乐(成功示例)成功示例

{"id":"3d5f0ee4-1d7b-410a-bafd-60a3978284d1","clips":[{"id":"7070ec00-462e-42ac-9b9f-1074977f473f","video_url":"","audio_url":"","image_url":null,"image_large_url":null,"is_video_pending":false,"major_model_version":"v3","model_name":"chirp-v3","metadata":{"tags":"heavy metal","prompt":"[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way","gpt_description_prompt":null,"audio_prompt_id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","history":[{"id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","continue_at":48.762,"type":"upload","source":"web","infill":false}],"concat_history":null,"type":"gen","duration":null,"refund_credits":null,"stream":true,"infill":false,"has_vocal":true,"is_audio_upload_tos_accepted":true,"error_type":null,"error_message":null},"is_liked":false,"user_id":"4ed4f182-0b5a-4cde-bffe-44fb5237a3aa","display_name":"AmbientLens971","handle":"ambientlens971","is_handle_updated":false,"avatar_image_url":"https://cdn1.suno.ai/defaultOrange.jpg","is_trashed":false,"reaction":null,"created_at":"2024-07-22T07:56:36.710Z","status":"submitted","title":"Starry ","play_count":0,"upvote_count":0,"is_public":false},{"id":"00e6b9e4-c29c-4cfe-8d7a-5b3f06ff5b90","video_url":"","audio_url":"","image_url":null,"image_large_url":null,"is_video_pending":false,"major_model_version":"v3","model_name":"chirp-v3","metadata":{"tags":"heavy metal","prompt":"[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way","gpt_description_prompt":null,"audio_prompt_id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","history":[{"id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","continue_at":48.762,"type":"upload","source":"web","infill":false}],"concat_history":null,"type":"gen","duration":null,"refund_credits":null,"stream":true,"infill":false,"has_vocal":true,"is_audio_upload_tos_accepted":true,"error_type":null,"error_message":null},"is_liked":false,"user_id":"4ed4f182-0b5a-4cde-bffe-44fb5237a3aa","display_name":"AmbientLens971","handle":"ambientlens971","is_handle_updated":false,"avatar_image_url":"https://cdn1.suno.ai/defaultOrange.jpg","is_trashed":false,"reaction":null,"created_at":"2024-07-22T07:56:36.711Z","status":"submitted","title":"Starry ","play_count":0,"upvote_count":0,"is_public":false}],"metadata":{"tags":"heavy metal","prompt":"[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way","gpt_description_prompt":null,"audio_prompt_id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","history":[{"id":"m_2e584f32-7ae3-4b2d-93f6-391f65a01f15","continue_at":48.762,"type":"upload","source":"web","infill":false}],"concat_history":null,"type":"gen","duration":null,"refund_credits":null,"stream":true,"infill":false,"has_vocal":true,"is_audio_upload_tos_accepted":true,"error_type":null,"error_message":null},"major_model_version":"v3","status":"complete","created_at":"2024-07-22T07:56:36.699Z","batch_size":1}