PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Song(Udio)
  • Get Started
    • Overview
    • Quickstart
    • Make Instruction: How to Use PiAPI to Build a Workflow on Make?
  • Endpoints
    • Song(Udio)
      • Song API Task Creation Examples
      • [Udio] Song Extend
      • Get Task
        GET
      • Create Task
        POST
      • [Udio] Generate Lyrics
        POST
    • 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
    • Hailuo
      • Hailuo Director Mode Example
      • Generate Video
      • Get Task
    • 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
    • AI Hug
      • Get Task
      • Create 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
      • 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
    • Faceswap
      • Multi Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Trellis
      • Create Task
      • Get Task
    • Luma Dream Machine
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Create Task
      • 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
    • Skyreels
      • Create Task
      • Get Task
    • Framepack
      • Create Task
      • Get Task
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Get Task
      • Generate Video
    • 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
    • Joycaption
      • Image Caption
      • Get 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
  • Legacy Documentation
    • Midjourney
      • Midjourney Webhook
      • Imagine
      • Reroll
      • Upscale
      • Variation
      • Inpaint
      • Outpaint
      • Pan
      • Describe
      • Blend
      • Seed
      • Fetch
      • Multi Fetch
      • Cancel
    • Face Swap
      • Video Faceswap
      • Multi-face-swap
      • Fetch
    • Dream Machine
      • Video Generation
      • Video Extend
      • Get Video Generation
    • Kling
      • Video Generation
      • Video Extend
      • Get Video Generation
  1. Song(Udio)

[Udio] Generate Lyrics

POST
https://api.piapi.ai/api/v1/task
Uses Udio to synthesize lyrics.

Request

Header Params

Body Params application/json

Example
{
    "model": "music-u",
    "task_type": "generate_lyrics",
    "input": {
        "prompt": "White egrets fly over the vast paddy fields"
    },
    "config": {
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        },
        "service_mode": ""
    }
}

Request 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 POST 'https://api.piapi.ai/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "music-u",
    "task_type": "generate_lyrics",
    "input": {
        "prompt": "White egrets fly over the vast paddy fields"
    },
    "config": {
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        },
        "service_mode": ""
    }
}'

Responses

🟢200Success
application/json
Body

Example
{
    "code": 200,
    "data": {
        "task_id": "8ec657c9-a2b8-4ea7-824f-4547d108a779",
        "model": "music-u",
        "task_type": "generate_lyrics",
        "status": "pending",
        "config": {
            "service_mode": "public",
            "webhook_config": {
                "endpoint": "",
                "secret": ""
            }
        },
        "input": {},
        "output": {
            "lyrics_pairs": [
                {
                    "title": "Winter Wind",
                    "text": "[Verse]\nSnowflakes falling skies so dim\nCold breeze whispers light and slim\nFootsteps fade in frozen sand\nEchoes lost in a snowy land\n\n[Verse 2]\nI walk alone through icy streets\nEach step a heart that's lost its beat\nSilent nights so crystal clear\nWinter wind wipes away my tear\n\n[Chorus]\nWinter wind where do you blow\nThrough the pines and through the snow\nChilling hearts and numbing souls\nWinter's tale forever told\n\n[Verse 3]\nNights are long as shadows grow\nBlankets thick with frost so slow\nFires burn in hearths so bright\nChase away the winter's bite\n\n[Bridge]\nBut even in this icy gloom\nStars above still gently bloom\nGuiding me like whispers kind\nIn the heart of the winter wind\n\n[Chorus]\nWinter wind where do you blow\nThrough the pines and through the snow\nChilling hearts and numbing souls\nWinter's tale forever told"
                },
                {
                    "title": "Winter Wind",
                    "text": "[Verse]\nSnowflakes dance and swirl on high\nSilent whispers from the sky\nFootprints vanish where we tread\nWarmth and shivers in our bed\n\n[Verse 2]\nBreath of frost and cheeks aglow\nTrees like statues in a row\nStars wink through the icy veil\nDreams embark without a sail\n\n[Chorus]\nWinter wind don't let me go\nHold me tight in crystal snow\nEvery chill a sweet embrace\nLife's a wonder in this place\n\n[Verse 3]\nIce skates carve our fleeting flight\nMoonlight paints the world in white\nNorthern lights ignite the night\nFrozen wonder such a sight\n\n[Bridge]\nIn the hush the world stands still\nPeaceful moments winter's thrill\nNature's canvas frost and chill\nEchoes silent hearts they fill\n\n[Chorus]\nWinter wind don't let me go\nHold me tight in crystal snow\nEvery chill a sweet embrace\nLife's a wonder in this place"
                }
            ]
        },
        "meta": {},
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}
Modified at 2025-04-24 12:16:06
Previous
Create Task
Next
Lipsync With PiAPI Kling API Examples