Get Music Video Details

GET

/api/v1/mp4/record-info

Retrieve detailed information about a music video generation task.

Usage Guide

Use this endpoint to check the status of a video generation task

Access the video URL once generation is complete

Track processing progress and any errors that may have occurred

Status Descriptions

PENDING: Task is waiting to be processed

SUCCESS: Video generation completed successfully

CREATE_TASK_FAILED: Failed to create the video generation task

GENERATE_MP4_FAILED: Failed during video file creation

Developer Notes

The video URL is only available in the response when status is SUCCESS

Error codes and messages are provided for failed tasks

Videos are retained for 14 days after successful generation

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Success

Body

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.kie.ai/api/v1/mp4/record-info?taskId=taskId_774b9aa0422f' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 成功示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "988e****c8d3",
        "musicId": "e231****-****-****-****-****8cadc7dc",
        "callbackUrl": "https://api.example.com/callback",
        "musicIndex": 0,
        "completeTime": "2025-01-01 00:10:00",
        "response": {
            "videoUrl": "https://example.com/s/04e6****e727.mp4"
        },
        "successFlag": "SUCCESS",
        "createTime": "2025-01-01 00:00:00",
        "errorCode": null,
        "errorMessage": null
    }
}

Create Music Video

Get Music Video Details

Usage Guide#

Status Descriptions#

Developer Notes#

Request

Responses

Usage Guide

Status Descriptions

Developer Notes