Code Examples

cURL

Simple Text-to-Video

curl -X POST https://platform.runblob.io/v1/kling/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A golden retriever running through a sunflower field at sunset"
  }'

Kling 2.6 (NEW with Audio)

curl -X POST https://platform.runblob.io/v1/kling/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A majestic lion walking through the African savanna at sunset, cinematic shot",
    "model": "kling_2.6",
    "duration": "10",
    "aspect_ratio": "16:9"
  }'

O1 Photo Generation

curl -X POST https://platform.runblob.io/v1/kling/o1-photo/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic city with flying cars, neon lights, cyberpunk style",
    "img_resolution": "2k",
    "aspect_ratio": "16:9"
  }'

O1 Photo with Reference Images

curl -X POST https://platform.runblob.io/v1/kling/o1-photo/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Combine these images into a beautiful collage with a sunset theme",
    "input_images": [
      "https://your-storage.com/image1.jpg",
      "https://your-storage.com/image2.jpg",
      "https://your-storage.com/image3.jpg"
    ],
    "img_resolution": "2k",
    "aspect_ratio": "1:1"
  }'

Advanced Text-to-Video

curl -X POST https://platform.runblob.io/v1/kling/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic cyberpunk city with neon lights and flying cars",
    "negative_prompt": "blurry, low quality, distorted, unrealistic",
    "version": "1.6",
    "mode": "pro",
    "duration": "10",
    "aspect_ratio": "16:9",
    "cfg_scale": 0.7,
    "seed": 12345,
    "callback_url": "https://yourdomain.com/webhook"
  }'

Image-to-Video with URL

curl -X POST https://platform.runblob.io/v1/kling/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Make this image come alive with motion",
    "image_url": "https://example.com/my-image.jpg",
    "version": "2.1-master",
    "mode": "pro",
    "duration": "10"
  }'

Check Video Status

curl -X GET https://platform.runblob.io/v1/kling/generations/GENERATION_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Check Photo Status

curl -X GET https://platform.runblob.io/v1/kling/o1-photo/generations/GENERATION_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

Simple Client

import requests
import time

class KlingClient:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = "https://platform.runblob.io"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }
    
    def generate(self, prompt, **kwargs):
        response = requests.post(
            f"{self.base_url}/v1/kling/generate",
            headers=self.headers,
            json={"prompt": prompt, **kwargs}
        )
        return response.json()
    
    def generate_from_image(self, prompt, image_url, **kwargs):
        response = requests.post(
            f"{self.base_url}/v1/kling/generate",
            headers=self.headers,
            json={
                "prompt": prompt,
                "image_url": image_url,
                **kwargs
            }
        )
        return response.json()
    
    def status(self, generation_id):
        response = requests.get(
            f"{self.base_url}/v1/kling/generations/{generation_id}",
            headers=self.headers
        )
        return response.json()
    
    def wait_for_completion(self, generation_id, poll_interval=10):
        while True:
            result = self.status(generation_id)
            if result["status"] == "completed":
                return result["video_url"]
            elif result["status"] == "failed":
                raise Exception(f"Generation failed: {generation_id}")
            time.sleep(poll_interval)

# Text-to-Video
client = KlingClient("YOUR_API_KEY")
result = client.generate("A sunset over mountains")
video_url = client.wait_for_completion(result["generation_id"])
print(f"Video ready: {video_url}")

# Image-to-Video
result = client.generate_from_image(
    "Animate this portrait",
    image_url="https://example.com/image.jpg",
    version="2.1-master",
    duration="10"
)
video_url = client.wait_for_completion(result["generation_id"])

# Kling 2.6 (NEW with Audio)
result = client.generate(
    "A majestic lion in the savanna",
    model="kling_2.6",
    duration="10"
)
video_url = client.wait_for_completion(result["generation_id"])

O1 Photo Client

import requests

class KlingO1PhotoClient:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = "https://platform.runblob.io"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }
    
    def generate(self, prompt, **kwargs):
        response = requests.post(
            f"{self.base_url}/v1/kling/o1-photo/generate",
            headers=self.headers,
            json={"prompt": prompt, **kwargs}
        )
        return response.json()
    
    def status(self, generation_id):
        response = requests.get(
            f"{self.base_url}/v1/kling/o1-photo/generations/{generation_id}",
            headers=self.headers
        )
        return response.json()

# Generate image
client = KlingO1PhotoClient("YOUR_API_KEY")
result = client.generate(
    "A futuristic cyberpunk city",
    img_resolution="2k",
    aspect_ratio="16:9"
)
print(f"Image generation started: {result['generation_id']}")

# With reference images
result = client.generate(
    "Beautiful landscape with mountains",
    input_images=[
        "https://example.com/ref1.jpg",
        "https://example.com/ref2.jpg"
    ],
    img_resolution="2k"
)

Image-to-Video with Base64

import base64
import requests

# Read and encode image
with open("input_image.jpg", "rb") as f:
    image_data = base64.b64encode(f.read()).decode("utf-8")

# Create request
response = requests.post(
    "https://platform.runblob.io/v1/kling/generate",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "Animate this portrait with subtle movements and blinking",
        "image_base64": f"data:image/jpeg;base64,{image_data}",
        "version": "2.5",
        "duration": "5",
        "aspect_ratio": "9:16"
    }
)

result = response.json()
print(f"Generation ID: {result['generation_id']}")

Advanced Usage with Error Handling

import requests
import time
from typing import Optional

class KlingAPI:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = "https://platform.runblob.io/v1/kling"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }
    
    def generate(self, prompt: str, version: str = "2.5", 
                 duration: str = "5", **kwargs) -> dict:
        """Create a new video generation."""
        payload = {
            "prompt": prompt,
            "version": version,
            "duration": duration,
            **kwargs
        }
        
        try:
            response = requests.post(
                f"{self.base_url}/generate",
                headers=self.headers,
                json=payload
            )
            response.raise_for_status()
            return response.json()
        except requests.exceptions.HTTPError as e:
            if e.response.status_code == 402:
                raise Exception("Insufficient credits")
            elif e.response.status_code == 401:
                raise Exception("Invalid API key")
            else:
                raise Exception(f"API Error: {e.response.text}")
    
    def get_status(self, generation_id: str) -> dict:
        """Get generation status."""
        try:
            response = requests.get(
                f"{self.base_url}/generations/{generation_id}",
                headers=self.headers
            )
            response.raise_for_status()
            return response.json()
        except requests.exceptions.HTTPError as e:
            if e.response.status_code == 404:
                raise Exception("Generation not found")
            raise Exception(f"API Error: {e.response.text}")
    
    def wait_for_completion(self, generation_id: str, 
                          timeout: int = 600) -> Optional[str]:
        """Wait for generation to complete with timeout."""
        start_time = time.time()
        
        while time.time() - start_time < timeout:
            result = self.get_status(generation_id)
            
            if result["status"] == "completed":
                return result["video_url"]
            elif result["status"] == "failed":
                raise Exception(f"Generation failed")
            
            time.sleep(10)
        
        raise Exception("Generation timeout")

# Usage
try:
    client = KlingAPI("YOUR_API_KEY")
    
    # Generate video
    result = client.generate(
        prompt="A beautiful sunset over the ocean",
        version="2.5",
        duration="5",
        aspect_ratio="16:9"
    )
    
    print(f"Generation started: {result['generation_id']}")
    print(f"Price: {result['price']} credits")
    
    # Wait for completion
    video_url = client.wait_for_completion(result['generation_id'])
    print(f"Video ready: {video_url}")
    
except Exception as e:
    print(f"Error: {str(e)}")

JavaScript / Node.js

Basic Client

const fetch = require('node-fetch');

class KlingAPI {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://platform.runblob.io/v1/kling';
  }

  async generate(params) {
    const response = await fetch(`${this.baseUrl}/generate`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        version: '2.5',
        duration: '5',
        ...params
      })
    });

    if (!response.ok) {
      throw new Error(`API Error: ${response.statusText}`);
    }

    return response.json();
  }

  async getStatus(generationId) {
    const response = await fetch(
      `${this.baseUrl}/generations/${generationId}`,
      {
        headers: {
          'Authorization': `Bearer ${this.apiKey}`
        }
      }
    );

    if (!response.ok) {
      throw new Error(`API Error: ${response.statusText}`);
    }

    return response.json();
  }

  async waitForCompletion(generationId, pollInterval = 10000) {
    while (true) {
      const result = await this.getStatus(generationId);
      
      if (result.status === 'completed') {
        return result.video_url;
      } else if (result.status === 'failed') {
        throw new Error('Generation failed');
      }
      
      await new Promise(resolve => setTimeout(resolve, pollInterval));
    }
  }
}

// Usage
const client = new KlingAPI('YOUR_API_KEY');

client.generate({
  prompt: 'A beautiful sunset over the ocean'
})
  .then(result => {
    console.log('Generation ID:', result.generation_id);
    return client.waitForCompletion(result.generation_id);
  })
  .then(videoUrl => {
    console.log('Video ready:', videoUrl);
  })
  .catch(error => {
    console.error('Error:', error.message);
  });

// Kling 2.6 (NEW with Audio)
client.generate({
  prompt: 'Cinematic mountain landscape',
  model: 'kling_2.6',
  duration: '10'
})
  .then(result => client.waitForCompletion(result.generation_id))
  .then(videoUrl => console.log('Video ready:', videoUrl));

O1 Photo Generation

// Simple photo generation
const photoResponse = await fetch('https://platform.runblob.io/v1/kling/o1-photo/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'A futuristic cyberpunk city with neon lights',
    img_resolution: '2k',
    aspect_ratio: '16:9'
  })
});

const photoData = await photoResponse.json();
console.log('Photo generation ID:', photoData.generation_id);

// With reference images
const photoWithRefsResponse = await fetch('https://platform.runblob.io/v1/kling/o1-photo/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'Beautiful landscape combining these styles',
    input_images: [
      'https://example.com/ref1.jpg',
      'https://example.com/ref2.jpg'
    ],
    img_resolution: '2k',
    aspect_ratio: '1:1'
  })
  });

Image-to-Video with URL

const response = await fetch('https://platform.runblob.io/v1/kling/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'Make this image come alive with motion',
    image_url: 'https://example.com/my-image.jpg',
    version: '2.1-master',
    mode: 'pro',
    duration: '10'
  })
});

const data = await response.json();
console.log('Generation ID:', data.generation_id);

Getting Started

Authentication

API Endpoints

cURL

Simple Text-to-Video

Kling 2.6 (NEW with Audio)

O1 Photo Generation

O1 Photo with Reference Images

Advanced Text-to-Video

Image-to-Video with URL

Check Video Status

Check Photo Status

Python

Simple Client

O1 Photo Client

Image-to-Video with Base64

Advanced Usage with Error Handling

JavaScript / Node.js

Basic Client

O1 Photo Generation

Image-to-Video with URL

Getting Started

Authentication

API Endpoints

​cURL

​Simple Text-to-Video

​Kling 2.6 (NEW with Audio)

​O1 Photo Generation

​O1 Photo with Reference Images

​Advanced Text-to-Video

​Image-to-Video with URL

​Check Video Status

​Check Photo Status

​Python

​Simple Client

​O1 Photo Client

​Image-to-Video with Base64

​Advanced Usage with Error Handling

​JavaScript / Node.js

​Basic Client

​O1 Photo Generation

​Image-to-Video with URL

cURL

Simple Text-to-Video

Kling 2.6 (NEW with Audio)

O1 Photo Generation

O1 Photo with Reference Images

Advanced Text-to-Video

Image-to-Video with URL

Check Video Status

Check Photo Status

Python

Simple Client

O1 Photo Client

Image-to-Video with Base64

Advanced Usage with Error Handling

JavaScript / Node.js

Basic Client

O1 Photo Generation

Image-to-Video with URL