Suno audio generation

POST

/suno/audios

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "async_mode": false,
    "action": "generate",
    "prompt": "string",
    "model": "chirp-v4-5",
    "custom": true,
    "instrumental": true,
    "audio_id": "string",
    "audio_url": "string",
    "continue_at": 0,
    "style": "string",
    "persona_type": "string",
    "lyric": "string",
    "style_negative": "string",
    "persona_id": "string",
    "persona_root_id": "string",
    "style_influence": 0,
    "weirdness": 0,
    "audio_influence": 0,
    "vocal_gender": "m",
    "replace_section_start": 0,
    "replace_section_end": 0,
    "overpainting_start": 0,
    "overpainting_end": 0,
    "underpainting_start": 0,
    "underpainting_end": 0,
    "sample_start": "string",
    "sample_end": "string",
    "sound": {
        "description": "string",
        "type": "one_shot",
        "key": "A min",
        "bpm": 1,
        "property1": "string",
        "property2": "string"
    },
    "property1": "string",
    "property2": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://aigc.ff-api.cn/suno/audios' \
--header 'X-API-Key;' \
--header 'Content-Type: application/json' \
--data '{
    "async_mode": false,
    "action": "generate",
    "prompt": "string",
    "model": "chirp-v4-5",
    "custom": true,
    "instrumental": true,
    "audio_id": "string",
    "audio_url": "string",
    "continue_at": 0,
    "style": "string",
    "persona_type": "string",
    "lyric": "string",
    "style_negative": "string",
    "persona_id": "string",
    "persona_root_id": "string",
    "style_influence": 0,
    "weirdness": 0,
    "audio_influence": 0,
    "vocal_gender": "m",
    "replace_section_start": 0,
    "replace_section_end": 0,
    "overpainting_start": 0,
    "overpainting_end": 0,
    "underpainting_start": 0,
    "underpainting_end": 0,
    "sample_start": "string",
    "sample_end": "string",
    "sound": {
        "description": "string",
        "type": "one_shot",
        "key": "A min",
        "bpm": 1,
        "property1": "string",
        "property2": "string"
    },
    "property1": "string",
    "property2": "string"
}'

返回响应

🟢200

application/json

Suno audio generation result. Sync mode returns success/data; async mode returns task_id.

Bodyapplication/json

示例

Synchronous generation resultAsynchronous generation result

{
    "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",
            "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"
        }
    ]
}

🟠422

修改于 2026-06-11 14:34:05

Suno lyrics generation