KIE.AI
English
  • English
  • Chinese
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Music Generation
  • 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
      POST
    • Extend Music
      POST
    • Upload And Cover Audio
      POST
    • Upload And Extend Audio
      POST
    • Add Instrumental to Music
      POST
    • Add Vocals to Music
      POST
    • Get Music Task Details
      GET
    • Get Timestamped Lyrics
      POST
    • Boost Music Style
      POST
    • Create Suno Cover Task
      POST
    • Get Cover Generation Details
      GET
    • Replace Music Section
      POST
    • Generate Persona
      POST
  • Lyrics Generation
    • Lyrics Generation Callbacks
    • Generate Lyrics
      POST
    • Get Lyrics Task Details
      GET
  • WAV Conversion
    • Convert to WAV Callbacks
    • Convert to WAV Format
      POST
    • Get WAV Conversion Details
      GET
  • Vocal Removal
    • Audio Separation Callbacks
    • MIDI Generation Callbacks
    • Separate Vocals from Music
    • 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
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Music Generation

Get Music Task Details

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

Usage Guide#

Use this endpoint to check task status and access generation results
Task details include status, parameters, and generated tracks
Generated tracks can be accessed through the returned URLs

Status Descriptions#

PENDING: Task is waiting to be processed
TEXT_SUCCESS: Lyrics/text generation completed successfully
FIRST_SUCCESS: First track generation completed
SUCCESS: All tracks generated successfully
CREATE_TASK_FAILED: Failed to create task
GENERATE_AUDIO_FAILED: Failed to generate audio
CALLBACK_EXCEPTION: Error during callback process
SENSITIVE_WORD_ERROR: Content filtered due to sensitive words

Developer Notes#

For instrumental tracks (instrumental=true), no lyrics data will be included
Maximum query rate: 3 requests per second per task
Response includes direct URLs to audio files, images, and streaming endpoints

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/generate/record-info?taskId=5c79****be8e' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - 成功示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "5c79****be8e",
        "parentMusicId": "",
        "param": "{\"prompt\":\"A calm piano track\",\"style\":\"Classical\",\"title\":\"Peaceful Piano\",\"customMode\":true,\"instrumental\":true,\"model\":\"V3_5\"}",
        "response": {
            "taskId": "5c79****be8e",
            "sunoData": [
                {
                    "id": "e231****-****-****-****-****8cadc7dc",
                    "audioUrl": "https://example.cn/****.mp3",
                    "streamAudioUrl": "https://example.cn/****",
                    "imageUrl": "https://example.cn/****.jpeg",
                    "prompt": "[Verse] 夜晚城市 灯火辉煌",
                    "modelName": "chirp-v3-5",
                    "title": "钢铁侠",
                    "tags": "electrifying, rock",
                    "createTime": "2025-01-01 00:00:00",
                    "duration": 198.44
                }
            ]
        },
        "status": "SUCCESS",
        "type": "GENERATE",
        "errorCode": null,
        "errorMessage": null
    }
}
Previous
Add Vocals to Music
Next
Get Timestamped Lyrics
Built with