KIE.AI
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Market
File Upload APICommon API
Market
File Upload APICommon API
  1. Lyrics Generation
  • Getting Started with KIE API (Important)
  • Market
  • Image Models
    • Seedream
      • Seedream3.0 - Text to Image
      • Seedream4.0 - Text to Image
      • Seedream4.0 - Edit
      • Seedream4.5 - Text to Image
      • Seedream4.5 - Edit
      • Seedream5.0 Lite - Text to Image
      • Seedream5.0 Lite - Image to Image
    • Z-image
      • Z-Image
    • Google
      • Google - Nano Banana 2
      • Google - imagen4-fast
      • Google - imagen4-ultra
      • Google - imagen4
      • Google - Nano Banana Edit
      • Google - Nano Banana
      • Google - Nano Banana Pro
    • Flux-2
      • Flux-2 - Pro Image to Image
      • Flux-2 - Pro Text to Image
      • Flux-2 - Image to Image
      • Flux-2 - Text to Image
    • Grok Imagine
      • Grok Imagine - Text to Image
      • Grok Imagine - image to image
    • GPT Image
      • GPT Image-1.5 - Text to Image
      • GPT Image-1.5 - Image to Image
    • Topaz
      • Topaz - Image Upscale
    • Recraft
      • Recraft - Remove Background
      • Recraft - Crisp Upscale
    • Ideogram
      • Ideogram - V3 Reframe
      • Ideogram - Character Edit
      • Ideogram - Character Remix
      • Ideogram - Character
      • Ideogram V3 Text to Image
      • Ideogram V3 Edit
      • Ideogram V3 Remix
    • Qwen
      • Qwen - Text to Image
      • Qwen - Image to Image
      • Qwen - Image Edit
      • Qwen2 - Image Edit
      • Qwen2 - Text To Image
    • 4o Image API
      • 4o Image API Quickstart
      • 4o Image Generation Callbacks
      • Generate 4o Image
      • Get 4o Image Details
      • Get Direct Download URL
    • Flux Kontext API
      • Flux Kontext API Quickstart
      • Image Generation or Editing Callbacks
      • Generate or Edit Image
      • Get Image Details
  • Video Models
    • Grok Imagine
      • Grok Imagine Text to Video
      • Grok Imagine Image to Video
      • Grok Imagine - Video Upscale
    • Kling
      • Kling 2.6 Text to Video
      • Kling 2.6 Image to Video
      • Kling - V2.5 Turbo Image to Video Pro
      • Kling - V2.5 Turbo Text to Video Pro
      • Kling AI Avatar Standard
      • Kling AI Avatar Pro
      • Kling V2.1 Master Image to Video
      • Kling V2.1 Master Text to Video
      • Kling V2.1 Pro
      • Kling V2.1 Standard
      • Kling 2.6 motion-control
      • kling-3.0 motion-control
      • Kling 3.0
    • Bytedance
      • Bytedance Seedance 1.5 Pro
      • Bytedance V1 Pro Fast Image to Video
      • Bytedance V1 Pro Image to Video
      • Bytedance - V1 Pro Text to Video
      • Bytedance - V1 Lite Image to Video
      • Bytedance - V1 Lite Text to Video
    • Hailuo
      • Hailuo 2.3 Pro Image to Video
      • Hailuo 2.3 Standard Image to Video
      • Hailuo Pro Text to Video
      • Hailuo Pro Image to Video
      • Hailuo Standard Text to Video
      • Hailuo Standard Image to Video
    • Sora2
      • Sora2 - Image to Video
      • Sora2 - Text to Video
      • Sora2 - Pro Image to Video
      • Sora2 - Pro Text to Video
      • Sora2 - Watermark Remover
      • Sora2 - Pro Storyboard
      • Sora2 - Characters
      • Sora2 - Characters Pro
    • Wan
      • Wan 2.6 - Image to Video
      • Wan 2.6 - Text to Video
      • Wan 2.6 - Video to Video
      • Wan - Image to Video
      • Wan - Text to Video
      • Wan - 2.2 A14B Speech to Video Turbo
      • Wan - Animate Move
      • Wan - Animate Replace
      • Wan - 2.6-flash-image-to-video
      • Wan - 2-6-flash-video-to-video
      • Wan 2.5 - Image to Video
      • Wan 2.5 - Text to Video
    • Topaz
      • Topaz - Video Upscale
    • Infinitalk
      • Infinitalk - From Audio
    • Runway API
      • Runway API Quickstart
      • AI Video Generation Callbacks
      • AI Video Extension Callbacks
      • Aleph
        • Aleph Video Generation Callbacks
        • Generate Aleph Video
        • Get Aleph Video Details
      • Generate AI Video
      • Get AI Video Details
      • Extend AI Video
  • Music Models
    • ElevenLabs
      • elevenlabs/audio-isolation
      • elevenlabs/sound-effect-v2
      • elevenlabs/speech-to-text
      • elevenlabs/text-to-dialogue-v3
      • elevenlabs/text-to-speech-multilingual-v2
      • elevenlabs/text-to-speech-turbo-2-5
  • Chat Models
    • GPT
      • GPT 5.2
      • GPT 5.4 (response)
    • Claude
      • Claude Haiku 4.5
      • Claude Opus 4.5
      • Claude Opus 4.6
      • Claude Sonnet 4.5
      • Claude Sonnet 4.6
    • Gemini
      • Gemini 2.5 Pro (openai)
      • Gemini 3 Pro (openai)
      • Gemini 3.1 Pro (openai)
      • Gemini 2.5 Flash (openai)
      • Gemini 3 Flash (openai)
      • Gemini 3 Flash
    • Codex
      • GPT Codex
  • Veo3.1 API
    • Veo3.1 API Quickstart
    • Veo3.1 Video Generation Callbacks
    • Get 4K Video Callbacks
    • Generate Veo3.1 Video
    • Extend Veo3.1 Video
    • Get 1080P Video
    • Get 4K Video
    • Get Veo3.1 Video Details
  • Suno API
    • Suno API Quickstart
    • Music Generation
      • Music Generation Callbacks
      • Music Extension Callbacks
      • Audio Upload and Cover Callbacks
      • Audio Upload and Extension Callbacks
      • Add Instrumental Callbacks
      • Add Vocals Callbacks
      • Music Cover Generation Callbacks
      • Replace Music Section Callbacks
      • Generate Music
      • Extend Music
      • Upload And Cover Audio
      • Upload And Extend Audio
      • Add Instrumental to Music
      • Add Vocals to Music
      • Get Music Task Details
      • Get Timestamped Lyrics
      • Boost Music Style
      • Generate Music Cover
      • Get Cover Generation Details
      • Replace Music Section
      • Generate Persona
      • Generate Mashup Music
    • Lyrics Generation
      • Lyrics Generation Callbacks
      • Generate Lyrics
        POST
      • Get Lyrics Task Details
        GET
    • WAV Conversion
      • Convert to WAV Callbacks
      • Convert to WAV Format
      • Get WAV Conversion Details
    • Vocal Removal
      • Audio Separation Callbacks
      • MIDI Generation Callbacks
      • Vocal & Instrument Stem Separation
      • Get Vocal Separation Details
      • Generate MIDI from Audio
      • Get MIDI Generation Details
    • Music Video Generation
      • Music Video Generation Callbacks
      • Create Music Video
      • Get Music Video Details
  • Get Task Details
    GET
  1. Lyrics Generation

Get Lyrics Task Details

GET
/api/v1/lyrics/record-info
Retrieve detailed information about a lyrics generation task.

Usage Guide#

Use this endpoint to check the status of a lyrics generation task
Retrieve generated lyrics content once the task is complete
Track task progress and access any error information if generation failed

Status Descriptions#

PENDING: Task is waiting to be processed
SUCCESS: Lyrics generated successfully
CREATE_TASK_FAILED: Failed to create the task
GENERATE_LYRICS_FAILED: Failed during lyrics generation
CALLBACK_EXCEPTION: Error occurred during callback
SENSITIVE_WORD_ERROR: Content filtered due to sensitive words

Developer Notes#

Successful tasks will include multiple lyrics variations
Each lyrics set includes both content and a suggested title
Error codes and messages are provided for failed tasks

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Responses

🟢200
application/json
Request successful
Body

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.kie.ai/api/v1/lyrics/record-info?taskId=11dc****8b0f' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - 成功示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "11dc****8b0f",
        "param": "{\"prompt\":\"A song about peaceful night in the city\"}",
        "response": {
            "taskId": "11dc****8b0f",
            "data": [
                {
                    "text": "[Verse]\n我穿越城市黑暗夜\n心中燃烧梦想的烈火",
                    "title": "钢铁侠",
                    "status": "complete",
                    "errorMessage": ""
                }
            ]
        },
        "status": "SUCCESS",
        "type": "LYRICS",
        "errorCode": null,
        "errorMessage": null
    }
}
Previous
Generate Lyrics
Next
Convert to WAV Callbacks
Built with