Get Luma Modify Details

Status Descriptions

0: GENERATING - Task is currently being processed
1: SUCCESS - Task completed successfully
2: CREATE_TASK_FAILED - Failed to create the task
3: GENERATE_FAILED - Task creation succeeded but generation failed
4: CALLBACK_FAILED - Generation succeeded but callback failed

Important Notes

Generated videos are stored temporarily and may expire
Check the response object for generated video URLs when status is SUCCESS
Use polling with reasonable intervals (recommended: 30 seconds) to avoid rate limiting

Usage Examples

Polling Implementation
Single Status Check

async function pollTaskStatus(taskId, maxWaitTime = 900000) { // 15 minutes
  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(`Task ${taskId} status: ${status.successFlag}`);
      
      if (status.successFlag === 1) {
        // Success
        console.log('Video generation completed!');
        console.log('Result URLs:', status.response.resultUrls);
        return status;
      } else if (status.successFlag === 2 || status.successFlag === 3) {
        // Failed
        throw new Error(`Generation failed: ${status.errorMessage || 'Unknown error'}`);
      }
      
      // Still processing, wait before next check
      await new Promise(resolve => setTimeout(resolve, 30000)); // 30 seconds
      
    } catch (error) {
      console.error('Error checking status:', error);
      break;
    }
  }
  
  throw new Error('Polling timeout');
}

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 Error: {result['msg']}")
    
    data = result['data']
    
    # Check task status
    if data['successFlag'] == 0:
        print("Task is still processing...")
    elif data['successFlag'] == 1:
        print("Task completed successfully!")
        if 'response' in data and data['response']:
            print(f"Result URLs: {data['response']['resultUrls']}")
            print(f"Original URLs: {data['response']['originUrls']}")
    elif data['successFlag'] == 2:
        print("Failed to create task")
    elif data['successFlag'] == 3:
        print(f"Generation failed: {data.get('errorMessage', 'Unknown error')}")
    elif data['successFlag'] == 4:
        print("Generation succeeded but callback failed")
    
    return data

# Usage
task_details = get_task_details('774d9a7dd608a0e49293903095e45a4c', 'YOUR_API_KEY')

Response Field Details

successFlag

integer

required

Current status of the video generation task:

Value	Status	Description
0	GENERATING	Task is being processed
1	SUCCESS	Completed successfully
2	CREATE_TASK_FAILED	Failed to create task
3	GENERATE_FAILED	Generation failed
4	CALLBACK_FAILED	Callback delivery failed

response

object

Generation results (only present when successFlag = 1):

Show Response details

taskId

string

Task identifier matching the original request

originUrls

array

URLs of the original input videos

resultUrls

array

URLs of the generated/modified videos

paramJson

string

Original request parameters in JSON string format, useful for debugging and audit trails

createTime

integer

Task creation timestamp (Unix milliseconds)

completeTime

integer

Task completion timestamp (Unix milliseconds), only present when task is finished

errorCode

integer

Error code when task fails (successFlag = 2 or 3)

errorMessage

string

Detailed error message when task fails

Authorizations

Authorization

string

header

required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Note:

Keep your API Key secure and do not share it with others
If you suspect your API Key has been compromised, reset it immediately in the management page

Query Parameters

taskId

string

required

Unique identifier of the video generation task

Response

Request successful

code

enum<integer>

Response status code

200: Success - Request has been processed successfully
401: Unauthorized - Authentication credentials are missing or invalid
404: Not Found - The requested resource or endpoint does not exist
422: Validation Error - The request parameters failed validation checks
429: Rate Limited - Request limit has been exceeded for this resource
455: Service Unavailable - System is currently undergoing maintenance
500: Server Error - An unexpected error occurred while processing the request
501: Generation Failed - Video generation task failed

Available options:

200,

401,

404,

422,

429,

455,

500,

501

msg

string

Error message when code != 200

Example:

"success"

data

object

Show child attributes

​Status Descriptions

​Important Notes

​Usage Examples

​Response Field Details

Authorizations

Query Parameters

Response

Status Descriptions

Important Notes

Usage Examples

Response Field Details