PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Suno
  • Get Started
    • Overview
    • Quickstart
    • Make Instruction: How to Use PiAPI to Build a Workflow on Make?
  • Endpoints
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Text to Image
        • Image to Image
        • Kontext
      • Get task
    • Gemini
      • Gemini-2.5-flash-image
      • Nano Banana Pro
      • Get task
    • Qwen Image
      • Text to Image
      • Image Edit
      • Get task
    • Faceswap
      • Multi Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • Kling
      • Lipsync With PiAPI Kling API Examples
      • Motion Brush With PiAPI Kling API Example
      • Kling Elements Video Generation API
      • Kling Effects Video Generation
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Get Task
      • Create Task
      • Kling Virtual Try-On
      • Kling Effects
      • Kling Sound
      • Kling Avatar
    • Veo3
      • Veo3 Text to Video
      • Veo3 Image to Video
      • Veo3.1 Text to Video
      • Veo3.1 Image to Video
      • Get task
    • Sora2
      • Sora2-preview Text to Video
      • Sora2 Text to Video
      • Sora2-Pro Text to Video
      • Sora2 Remove Watermark
      • Get task
    • WanX
      • Generate WanX Task with LoRA Using PiAPI
      • Available LoRA Types for Wanx
      • Use Cases for Wanx LoRA
      • Use Cases for Wanx Control Camera
      • Create Task
      • Get Task
    • Hailuo
      • Hailuo Director Mode Example
      • Generate Video
      • Get Task
    • Skyreels
      • Create Task
      • Get Task
    • Framepack
      • Create Task
      • Get Task
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Available Hunyuan Lora models
      • Get Task
      • Generate Video
    • Luma Dream Machine
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Create Task
      • Get Task
    • LLM
      • Use Cases for GPT-4o Image API
      • How To Avoid Timeouts in Completion API
      • GPT-4o Image Generation API
      • LLM API | Basic Completions
    • Suno
      • Music
        POST
      • Lyrics
        POST
      • Get task
        GET
    • Song(Udio)
      • Song API Task Creation Examples
      • [Udio] Song Extend
      • Get Task
      • Create Task
      • [Udio] Generate Lyrics
    • Mmaudio
      • Get Task
      • Generate Audio
    • DiffRhythm
      • Generate Audio
      • Get Task
    • Ace Step
      • Create Task
        • Text to Audio
        • Audio to Audio
        • Audio Edit
        • Audio Extend
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Trellis
      • Create Task
      • Get Task
    • Joycaption
      • Image Caption
      • Get Task
    • Midjourney
      • PiAPI Penalties on Midjourney Usage
      • Detailed Explaination on Midjourney Task Result
      • Midjourney V7 API Instructions
      • Create Task
        • Imagine
        • Upscale
        • Variation
        • Reroll
        • Describe
        • Seed
        • Blend
        • Inpaint
        • Outpaint
        • Pan
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
    • AI Hug
      • Get Task
      • Create Task
    • Tools
      • File Upload API
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
      • Video Upscale
      • Video Upscale-Get Task
      • Video Remove Background
      • Video Remove Background-Get task
    • PiAPI Account Management
      • PiAPI Account Info
      • Task List Info
      • User Task History
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
    • Bulk Generation Service
    • Billings
    • PiAPI MCP Server
    • Workspace Manual
      • Host-your-account (HYA) | Back-up Account
      • Host-your-account (HYA) | Debug Checklist
      • Host-your-account (HYA) | Connected Account Status
    • Announcements
      • PiAPI 2025 January 1st Pricing Update
      • The discontinued support for midjourney
  1. Suno

Get task

GET
https://api.piapi.ai/api/v1/task/{task_id}
This endpoint retrieves the output of a Suno task.

Request

Path Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.piapi.ai/api/v1/task/' \
--header 'x-api-key;'

Responses

🟢200Success
application/json
Body

Examples
{
    "timestamp": 1765248943,
    "data": {
        "task_id": "b90d65e9-b446-468d-aa4b-5003e2b79970",
        "model": "suno",
        "task_type": "music",
        "status": "completed",
        "config": {
            "service_mode": "",
            "webhook_config": {
                "endpoint": "https://webhook.site/3486fee2-1a11-4377-a5d6-ee09088ceb66",
                "secret": ""
            }
        },
        "input": {
            "make_instrumental": false,
            "mv": "chirp-crow",
            "prompt": "[Verse]\nMove your paws\nLeft and right\nJump around\nFeel the light\nWhiskers twitch\nTails in the air\nDancing cats\nEverywhere\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Verse 2]\nTiptoe steps\nSoft and sweet\nTiny paws\nUnbeatable beat\nMeow to the rhythm\nClaws precise\nEvery move\nFeline paradise\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Bridge]\nOoh-ooh\nBounce and sway (ooh-ooh!)\nMoonlit grooves\nNight turns to day\nLean and stretch\nStrike your pose\nEvery kitty steals the show\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow",
            "tags": "romantic raga",
            "task_id": "",
            "title": "Cat Dance"
        },
        "output": [
            {
                "audio_url": "https://cdn1.suno.ai/1c5ddaf1-4ca2-4e5a-9da6-395b6e705e1b.mp3",
                "created_at": "2025-12-09 10:54:16",
                "id": "1c5ddaf1-4ca2-4e5a-9da6-395b6e705e1b",
                "image_large_url": "https://cdn2.suno.ai/image_large_1c5ddaf1-4ca2-4e5a-9da6-395b6e705e1b.jpeg",
                "image_url": "https://cdn2.suno.ai/image_1c5ddaf1-4ca2-4e5a-9da6-395b6e705e1b.jpeg",
                "is_handle_updated": false,
                "is_video_pending": null,
                "major_model_version": "v5",
                "metadata": {
                    "audio_prompt_id": null,
                    "concat_history": null,
                    "duration": 144.88,
                    "error_message": null,
                    "error_type": null,
                    "gpt_description_prompt": null,
                    "history": null,
                    "prompt": "[Verse]\nMove your paws\nLeft and right\nJump around\nFeel the light\nWhiskers twitch\nTails in the air\nDancing cats\nEverywhere\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Verse 2]\nTiptoe steps\nSoft and sweet\nTiny paws\nUnbeatable beat\nMeow to the rhythm\nClaws precise\nEvery move\nFeline paradise\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Bridge]\nOoh-ooh\nBounce and sway (ooh-ooh!)\nMoonlit grooves\nNight turns to day\nLean and stretch\nStrike your pose\nEvery kitty steals the show\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow",
                    "stream": true,
                    "tags": "romantic raga",
                    "type": "gen"
                },
                "model_name": "chirp-crow",
                "reaction": null,
                "status": "SUCCESS",
                "task_id": "55160059",
                "title": "Cat Dance",
                "video_url": ""
            },
            {
                "audio_url": "https://cdn1.suno.ai/d41a89a1-dd8e-407e-a424-9bc01c3bf8c9.mp3",
                "created_at": "2025-12-09 10:54:16",
                "id": "d41a89a1-dd8e-407e-a424-9bc01c3bf8c9",
                "image_large_url": "https://cdn2.suno.ai/image_large_d41a89a1-dd8e-407e-a424-9bc01c3bf8c9.jpeg",
                "image_url": "https://cdn2.suno.ai/image_d41a89a1-dd8e-407e-a424-9bc01c3bf8c9.jpeg",
                "is_handle_updated": false,
                "is_video_pending": null,
                "major_model_version": "v5",
                "metadata": {
                    "audio_prompt_id": null,
                    "concat_history": null,
                    "duration": 112.24,
                    "error_message": null,
                    "error_type": null,
                    "gpt_description_prompt": null,
                    "history": null,
                    "prompt": "[Verse]\nMove your paws\nLeft and right\nJump around\nFeel the light\nWhiskers twitch\nTails in the air\nDancing cats\nEverywhere\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Verse 2]\nTiptoe steps\nSoft and sweet\nTiny paws\nUnbeatable beat\nMeow to the rhythm\nClaws precise\nEvery move\nFeline paradise\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Bridge]\nOoh-ooh\nBounce and sway (ooh-ooh!)\nMoonlit grooves\nNight turns to day\nLean and stretch\nStrike your pose\nEvery kitty steals the show\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow",
                    "stream": true,
                    "tags": "romantic raga",
                    "type": "gen"
                },
                "model_name": "chirp-crow",
                "reaction": null,
                "status": "SUCCESS",
                "task_id": "55160060",
                "title": "Cat Dance",
                "video_url": ""
            }
        ],
        "meta": {
            "created_at": "2025-12-09T02:54:09.985633568Z",
            "started_at": "2025-12-09T02:54:10.935722743Z",
            "ended_at": "2025-12-09T02:55:43.749656353Z",
            "usage": {
                "type": "llm",
                "frozen": 0,
                "consume": 400000
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    }
}
Modified at 2025-12-09 03:30:41
Previous
Lyrics
Next
Song API Task Creation Examples