Docs

Query a single task

GET

/suno/fetch/{task_id}

Request

Path Params

task_id

string

required

Example:

137f929c-08ed-4c24-b58f-e415981b7e73

Header Params

Content-Type

string

required

Example:

application/json

string

required

Example:

application/json

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/suno/fetch/137f929c-08ed-4c24-b58f-e415981b7e73' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json'

Responses

🟢200success

application/json

Body

code

string

required

data

string

required

message

string

required

Example

{
    "code": 200,
    "data": {
        "task_id": "56ea8da3-8507-4118-9f1e-111111111111",
        "status": "completed",
        "input": "{\"custom_mode\":false,\"gpt_description_prompt\":\"blowing in the wind\",\"make_instrumental\":false,\"prompt\":\"\",\"title\":\"\",\"continue_at\":0,\"continue_clip_id\":\"\",\"mv\":\"chirp-v3-0\",\"tags\":\"\"}",
        "clips": {
            "e0fe8bba-fac8-460b-bf1c-111111111111": {
                "id": "e0fe8bba-fac8-460b-bf1c-111111111111",
                "video_url": "https://cdn1.suno.ai/e0fe8bba-fac8-460b-bf1c-111111111111.mp4",
                "audio_url": "https://cdn1.suno.ai/e0fe8bba-fac8-460b-bf1c-111111111111.mp3",
                "image_url": "https://cdn1.suno.ai/image_e0fe8bba-fac8-460b-bf1c-111111111111.png",
                "image_large_url": "https://cdn1.suno.ai/image_large_e0fe8bba-fac8-460b-bf1c-111111111111.png",
                "is_video_pending": false,
                "major_model_version": "v3",
                "model_name": "chirp-v3",
                "metadata": {
                    "tags": "acoustic folk ballad",
                    "prompt": "[Verse]\nLeaves whisper\nTrees sway\nIn the wind\nWe all play\nQuestions fly\nAnswers hide\nIn this world\nSide by side\n\n[Verse 2]\nBirds soar\nClouds roam\nIn the breeze\nWe find home\nSearching for truth\nIn the sky\nAs the wind carries our sigh\n\n[Chorus]\nBlowin' in the breeze\nWe're like the leaves\nWonderin' where life takes us\nWhere it leads\nWith every gust\nWe let go of what we know\nBlowin' in the breeze\nWe're free to grow",
                    "gpt_description_prompt": "blowing in the wind",
                    "audio_prompt_id": "",
                    "history": null,
                    "concat_history": null,
                    "type": "gen",
                    "duration": 108.8,
                    "refund_credits": false,
                    "stream": true,
                    "error_type": null,
                    "error_message": null
                },
                "is_liked": false,
                "is_handle_updated": false,
                "is_trashed": false,
                "reaction": null,
                "created_at": "2024-04-18T14:29:31.760Z",
                "status": "complete",
                "title": "Blowin' in the Breeze",
                "play_count": 0,
                "upvote_count": 0,
                "is_public": false
            },
            "f66f7a6f-a868-464f-b280-111111111111": {
                "id": "f66f7a6f-a868-464f-b280-111111111111",
                "video_url": "https://cdn1.suno.ai/f66f7a6f-a868-464f-b280-111111111111.mp4",
                "audio_url": "https://cdn1.suno.ai/f66f7a6f-a868-464f-b280-111111111111.mp3",
                "image_url": "https://cdn1.suno.ai/image_f66f7a6f-a868-464f-b280-111111111111.png",
                "image_large_url": "https://cdn1.suno.ai/image_large_f66f7a6f-a868-464f-b280-111111111111.png",
                "is_video_pending": false,
                "major_model_version": "v3",
                "model_name": "chirp-v3",
                "metadata": {
                    "tags": "acoustic folk ballad",
                    "prompt": "[Verse]\nLeaves whisper\nTrees sway\nIn the wind\nWe all play\nQuestions fly\nAnswers hide\nIn this world\nSide by side\n\n[Verse 2]\nBirds soar\nClouds roam\nIn the breeze\nWe find home\nSearching for truth\nIn the sky\nAs the wind carries our sigh\n\n[Chorus]\nBlowin' in the breeze\nWe're like the leaves\nWonderin' where life takes us\nWhere it leads\nWith every gust\nWe let go of what we know\nBlowin' in the breeze\nWe're free to grow",
                    "gpt_description_prompt": "blowing in the wind",
                    "audio_prompt_id": "",
                    "history": null,
                    "concat_history": null,
                    "type": "gen",
                    "duration": 103.2,
                    "refund_credits": false,
                    "stream": true,
                    "error_type": null,
                    "error_message": null
                },
                "is_liked": false,
                "is_handle_updated": false,
                "is_trashed": false,
                "reaction": null,
                "created_at": "2024-04-18T14:29:31.761Z",
                "status": "complete",
                "title": "Blowin' in the Breeze",
                "play_count": 0,
                "upvote_count": 0,
                "is_public": false
            }
        }
    },
    "message": "success"
}

Generate lyrics

python openai official library (using AutoGPT, langchain, etc.)