获取 Luma 修改详情

状态描述

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('轮询超时');
}

import requests

def get_task_details(task_id, api_key):
    url = f"https://api.kie.ai/api/v1/modify/record-info"
    headers = {"Authorization": f"Bearer {api_key}"}
    params = {"taskId": task_id}
    
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    
    result = response.json()
    
    if result['code'] != 200:
        raise Exception(f"API 错误: {result['msg']}")
    
    data = result['data']
    
    # 检查任务状态
    if data['successFlag'] == 0:
        print("任务仍在处理中...")
    elif data['successFlag'] == 1:
        print("任务成功完成！")
        if 'response' in data and data['response']:
            print(f"结果 URL: {data['response']['resultUrls']}")
            print(f"原始 URL: {data['response']['originUrls']}")
    elif data['successFlag'] == 2:
        print("创建任务失败")
    elif data['successFlag'] == 3:
        print(f"生成失败: {data.get('errorMessage', '未知错误')}")
    elif data['successFlag'] == 4:
        print("生成成功但回调失败")
    
    return data

# 使用方法
task_details = get_task_details('774d9a7dd608a0e49293903095e45a4c', 'YOUR_API_KEY')

响应字段详情

successFlag

integer

必填

视频生成任务的当前状态：

值	状态	描述
0	生成中	任务正在处理
1	成功	成功完成
2	创建任务失败	创建任务失败
3	生成失败	生成失败
4	回调失败	回调传递失败

response

object

生成结果（仅在 successFlag = 1 时出现）：

显示响应详情

taskId

string

与原始请求匹配的任务标识符

originUrls

array

原始输入视频的 URL

resultUrls

array

生成/修改视频的 URL

paramJson

string

JSON 字符串格式的原始请求参数，用于调试和审计跟踪

createTime

integer

任务创建时间戳（Unix 毫秒）

completeTime

integer

任务完成时间戳（Unix 毫秒），仅在任务完成时出现

errorCode

integer

任务失败时的错误代码（successFlag = 2 或 3）

errorMessage

string

任务失败时的详细错误消息

授权

Authorization

string

header

必填

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

获取 API Key：

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

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

注意：

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

查询参数

taskId

string

必填

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

响应

请求成功

code

enum<integer>

响应状态码

200: 成功 - 请求已成功处理
401: 未授权 - 身份验证凭据缺失或无效
404: 未找到 - 请求的资源或端点不存在
422: 验证错误 - 请求参数未通过验证检查
429: 频率限制 - 此资源的请求限制已超出
455: 服务不可用 - 系统当前正在进行维护
500: 服务器错误 - 处理请求时发生意外错误
501: 生成失败 - 视频生成任务失败

可用选项:

200,

401,

404,

422,

429,

455,

500,

501

msg

string

当 code != 200 时的错误消息

示例:

"success"

data

object

显示子属性

​状态描述

​重要说明

​使用示例

​响应字段详情

授权

查询参数

响应

状态描述

重要说明

使用示例

响应字段详情