获取音乐视频详情

GET

/api/v1/mp4/record-info

获取音乐视频生成任务的详细信息。

使用指南

使用此接口检查视频生成任务的状态

生成完成后访问视频URL

跟踪处理进度和可能发生的任何错误

状态说明

PENDING: 任务等待处理中

SUCCESS: 视频生成成功完成

CREATE_TASK_FAILED: 创建视频生成任务失败

GENERATE_MP4_FAILED: 视频文件创建过程中失败

开发者注意事项

视频URL仅在状态为SUCCESS时在响应中可用

对于失败的任务提供错误代码和消息

成功生成后，视频保留14天

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

成功

Bodyapplication/json

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '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
    }
}

创建音乐视频

生成声音

获取音乐视频详情

使用指南#

状态说明#

开发者注意事项#

Request

Responses

使用指南

状态说明

开发者注意事项