歌曲生成接口

开发中

正式环境（默认全球加速）

https://api.yoy-ai.com

POST

/suno/audios

最后修改时间：2025-12-09 12:03:01

请求参数

Header 参数

Body 参数application/json

示例

{
    "action": "generate",
    "prompt": "A song for Christmas",
    "model": "chirp-v4",
    "custom": false,
    "instrumental": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.yoy-ai.com/suno/audios' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer asdasdasda9998fads' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "generate",
    "prompt": "A song for Christmas",
    "model": "chirp-v4",
    "custom": false,
    "instrumental": false
}'

返回响应

🟢200成功

application/json

Body

示例

同步回调的结果异步回调的结果

{
    "success": true,
    "data": [
        {
            "state": "succeeded",
            "id": "2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5",
            "title": "Winter Wonderland",
            "image_url": "https://cdn1.suno.ai/image_2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5.png",
            "lyric": "[Verse]\nSnowflakes falling all around\nGlistening white\nCovering the ground\nChildren laughing\nFull of delight\nIn this winter wonderland tonight\nSanta's sleigh\nUp in the sky\nRudolph's nose shining bright\nOh my\nHear the jingle bells\nRinging so clear\nBringing joy and holiday cheer\n[Verse 2]\nRoasting chestnuts by the fire's glow\nChristmas lights\nThey twinkle and show\nFamilies gathering with love and cheer\nSpreading warmth to everyone near",
            "audio_url": "https://cdn1.suno.ai/2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5.mp3",
            "video_url": "https://cdn1.suno.ai/2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5.mp4",
            "created_at": "2024-05-10T16:21:37.624Z",
            "model": "chirp-v3",
            "prompt": "A song for Christmas",
            "style": "holiday"
        },
        {
            "state": "succeeded",
            "id": "5dca232b-17cc-4896-a2d1-4b59178bf410",
            "title": "Winter Wonderland",
            "image_url": "https://cdn1.suno.ai/image_5dca232b-17cc-4896-a2d1-4b59178bf410.png",
            "lyric": "[Verse]\nSnowflakes falling all around\nGlistening white\nCovering the ground\nChildren laughing\nFull of delight\nIn this winter wonderland tonight\nSanta's sleigh\nUp in the sky\nRudolph's nose shining bright\nOh my\nHear the jingle bells\nRinging so clear\nBringing joy and holiday cheer\n[Verse 2]\nRoasting chestnuts by the fire's glow\nChristmas lights\nThey twinkle and show\nFamilies gathering with love and cheer\nSpreading warmth to everyone near",
            "audio_url": "https://cdn1.suno.ai/5dca232b-17cc-4896-a2d1-4b59178bf410.mp3",
            "video_url": "https://cdn1.suno.ai/5dca232b-17cc-4896-a2d1-4b59178bf410.mp4",
            "created_at": "2024-05-10T16:21:37.624Z",
            "model": "chirp-v3",
            "prompt": "A song for Christmas",
            "style": "holiday"
        }
    ]
}

🟢200异步回调结果

修改于 2025-12-09 12:03:01

歌词生成接口