GET
/
api
/
v1
/
modify
/
record-info
获取 Luma 修改详情
curl --request GET \
  --url https://api.kie.ai/api/v1/modify/record-info \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "774d9a7dd608a0e49293903095e45a4c",
    "paramJson": "{\"callBackUrl\":\"https://example.com/callback\",\"prompt\":\"未来主义城市景观\",\"videoUrl\":\"https://example.com/video.mp4\",\"waterMark\":\"\"}",
    "completeTime": 1755078480000,
    "response": {
      "taskId": "774d9a7dd608a0e49293903095e45a4c",
      "originUrls": [
        "https://tempfile.aiquickdraw.com/kieai/file/veo3-video/1755074605154fqb0m8ge.mp4"
      ],
      "resultUrls": [
        "https://tempfile.aiquickdraw.com/l/f782018c-6be4-4990-96ba-7231cd5a39e7.mp4"
      ]
    },
    "successFlag": 1,
    "createTime": 1755078171000,
    "errorCode": null,
    "errorMessage": null
  }
}

​
状态描述

  • 0: 生成中 - 任务正在处理中
  • 1: 成功 - 任务成功完成
  • 2: 创建任务失败 - 无法创建任务
  • 3: 生成失败 - 任务创建成功但生成失败
  • 4: 回调失败 - 生成成功但回调失败

​
重要说明

  • 生成的视频临时存储，可能会过期
  • 当状态为成功时，检查响应对象中的生成视频 URL
  • 使用合理间隔的轮询（建议：30 秒）以避免频率限制

​
使用示例

async function pollTaskStatus(taskId, maxWaitTime = 900000) { // 15 分钟
  const startTime = Date.now();
  
  while (Date.now() - startTime < maxWaitTime) {
    try {
      const response = await fetch(`https://api.kie.ai/api/v1/modify/record-info?taskId=${taskId}`, {
        headers: {
          'Authorization': 'Bearer YOUR_API_KEY'
        }
      });
      
      const result = await response.json();
      const status = result.data;
      
      console.log(`任务 ${taskId} 状态: ${status.successFlag}`);
      
      if (status.successFlag === 1) {
        // 成功
        console.log('视频生成完成！');
        console.log('结果 URL:', status.response.resultUrls);
        return status;
      } else if (status.successFlag === 2 || status.successFlag === 3) {
        // 失败
        throw new Error(`生成失败: ${status.errorMessage || '未知错误'}`);
      }
      
      // 仍在处理中，等待下次检查
      await new Promise(resolve => setTimeout(resolve, 30000)); // 30 秒
      
    } catch (error) {
      console.error('检查状态时出错:', error);
      break;
    }
  }
  
  throw new Error('轮询超时');
}

​
响应字段详情

​
successFlag
integer
required
视频生成任务的当前状态：
值状态描述
0生成中任务正在处理
1成功成功完成
2创建任务失败创建任务失败
3生成失败生成失败
4回调失败回调传递失败
​
response
object
生成结果（仅在 successFlag = 1 时出现）：
​
paramJson
string
JSON 字符串格式的原始请求参数，用于调试和审计跟踪
​
createTime
integer
任务创建时间戳（Unix 毫秒）
​
completeTime
integer
任务完成时间戳（Unix 毫秒），仅在任务完成时出现
​
errorCode
integer
任务失败时的错误代码（successFlag = 2 或 3）
​
errorMessage
string
任务失败时的详细错误消息

Authorizations

​
Authorization
string
header
required

所有 API 都需要通过 Bearer Token 进行身份验证。

获取 API Key：

  1. 访问 API Key 管理页面 获取您的 API Key

使用方法： 在请求头中添加： Authorization: Bearer YOUR_API_KEY

注意：

  • 请保护好您的 API Key，不要与他人分享
  • 如果您怀疑 API Key 已被泄露，请立即在管理页面重置

Query Parameters

​
taskId
string
required

视频生成任务的唯一标识符

Response

200
application/json

请求成功

The response is of type object.