Luma API Quickstart

import requests
import time

class LumaAPI:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = 'https://api.kie.ai/api/v1/modify'
        self.headers = {
            'Authorization': f'Bearer {api_key}',
            'Content-Type': 'application/json'
        }
    
    def modify_video(self, prompt, video_url, **options):
        data = {
            'prompt': prompt,
            'videoUrl': video_url,
            'callBackUrl': options.get('callBackUrl'),
            'watermark': options.get('watermark'),
            **options
        }
        
        # Remove None values
        data = {k: v for k, v in data.items() if v is not None}
        
        response = requests.post(f'{self.base_url}/generate', 
                               headers=self.headers, json=data)
        result = response.json()
        
        if not response.ok or result.get('code') != 200:
            raise Exception(f"Generation failed: {result.get('msg', 'Unknown error')}")
        
        return result['data']['taskId']
    
    def wait_for_completion(self, task_id, max_wait_time=900):
        start_time = time.time()
        
        while time.time() - start_time < max_wait_time:
            status = self.get_task_status(task_id)
            success_flag = status['successFlag']
            
            if success_flag == 0:
                print("Task is generating, continue waiting...")
            elif success_flag == 1:
                print("Generation completed successfully!")
                return status['response']
            elif success_flag == 4:
                print("Generation succeeded but callback failed")
                return status['response']
            elif success_flag == 2:
                create_error = status.get('errorMessage', 'Task creation failed')
                print(f"Task creation failed: {create_error}")
                if status.get('errorCode'):
                    print(f"Error code: {status['errorCode']}")
                raise Exception(create_error)
            elif success_flag == 3:
                generate_error = status.get('errorMessage', 'Task created successfully but generation failed')
                print(f"Generation failed: {generate_error}")
                if status.get('errorCode'):
                    print(f"Error code: {status['errorCode']}")
                raise Exception(generate_error)
            else:
                print(f"Unknown status: {success_flag}")
                if status.get('errorMessage'):
                    print(f"Error message: {status['errorMessage']}")
            
            time.sleep(10)  # Wait 10 seconds
        
        raise Exception('Generation timeout')
    
    def get_task_status(self, task_id):
        response = requests.get(f'{self.base_url}/record-info?taskId={task_id}',
                              headers={'Authorization': f'Bearer {self.api_key}'})
        result = response.json()
        
        if not response.ok or result.get('code') != 200:
            raise Exception(f"Status check failed: {result.get('msg', 'Unknown error')}")
        
        return result['data']

# Usage Example
def main():
    api = LumaAPI('YOUR_API_KEY')
    
    try:
        # Video Modification
        print('Starting video modification...')
        task_id = api.modify_video(
            'A futuristic cityscape at night with towering glass spires reaching into a starry sky. Neon lights in blue and purple illuminate the buildings while flying vehicles glide silently between the structures. Holographic advertisements flicker and change on building facades.',
            'https://example.com/input-video.mp4',
            callBackUrl='https://your-callback-url.com/luma-callback',
            watermark='your-watermark-id'
        )
        
        # Wait for completion
        print(f'Task ID: {task_id}. Waiting for completion...')
        result = api.wait_for_completion(task_id)
        
        print('Video modified successfully!')
        print(f'Result Video URLs: {result["resultUrls"]}')
        print(f'Original Video URLs: {result["originUrls"]}')
        
        # Download videos
        for i, url in enumerate(result['resultUrls']):
            filename = f'modified_video_{i+1}.mp4'
            download_video(url, filename)
        
    except Exception as error:
        print(f'Error: {error}')

def download_video(url, filename):
    response = requests.get(url, stream=True)
    response.raise_for_status()
    
    with open(filename, 'wb') as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)
    print(f'Downloaded: {filename}')

if __name__ == '__main__':
    main()