Video Generation API

import requests
import time

api_key = "mcp_your_api_key_here"
api_base = "https://a.mcphub.com/api/v3"

# Step 1: Generate I2V video
response = requests.post(
    f"{api_base}/videos/generate",
    headers={
        "X-API-Key": api_key,
        "Content-Type": "application/json"
    },
    json={
        "prompt": "A tiger walking through a lush jungle, camera slowly zooming in",
        "model": "minimax-hailuo-02-6s-768p-i2v",
        "head_image": "https://example.com/tiger_photo.jpg"
    }
)

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

# Step 2: Poll for completion (same as text-to-video)
while True:
    session_data = requests.get(
        f"{api_base}/videos/sessions/{session_id}?page=1&page_size=50",
        headers={"X-API-Key": api_key}
    ).json()

    videos = session_data.get('videos', [])
    if videos and videos[0]['status'] == 'completed':
        video_url = videos[0]['video_url']
        print(f"✅ Animated video ready: {video_url}")
        break

    time.sleep(5)

// TypeScript/JavaScript - Keyframe-to-Video
const apiKey = 'mcp_your_api_key_here';
const apiBase = 'https://a.mcphub.com/api/v3';

// Step 1: Generate KF2V transition
const response = await fetch(`${apiBase}/videos/generate`, {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'Smooth cinematic transition from sunrise to sunset',
    model: 'wan-wan2.1-kf2v-plus-5s-480p',
    head_image: 'https://example.com/sunrise.jpg',   // Start frame
    tail_image: 'https://example.com/sunset.jpg'     // End frame
  })
});

const result = await response.json();
const sessionId = result.session_id;
console.log(`Session ID: ${sessionId}`);

// Step 2: Poll for completion
while (true) {
  const sessionData = await fetch(
    `${apiBase}/videos/sessions/${sessionId}?page=1&page_size=50`,
    { headers: { 'X-API-Key': apiKey } }
  ).then(r => r.json());

  const videos = sessionData.videos || [];
  if (videos.length > 0 && videos[0].status === 'completed') {
    console.log(`✅ Transition video ready: ${videos[0].video_url}`);
    break;
  }

  await new Promise(r => setTimeout(r, 5000));
}

# Python - List all completed sessions
api_key = "mcp_your_api_key_here"

response = requests.get(
    "https://api.mcphub.com/api/v3/videos/sessions",
    headers={"X-API-Key": api_key},
    params={
        "page": 1,
        "page_size": 20,
        "status": "completed"
    }
)

sessions = response.json()
print(f"Total sessions: {sessions['pagination']['total_count']}")
for session in sessions['sessions']:
    print(f"{session['session_id']}: {session['total_videos']} videos")

# Python - Delete a session
api_key = "mcp_your_api_key_here"
session_id = "your-session-id"

response = requests.delete(
    f"https://api.mcphub.com/api/v3/videos/sessions/{session_id}",
    headers={"X-API-Key": api_key}
)

result = response.json()
print(f"Deleted: {result['videos_deleted']} videos")
# Output: Deleted: 5 videos

# Python - Image-to-video generation
api_key = "mcp_your_api_key_here"

response = requests.post(
    "https://api.mcphub.com/api/v3/videos/generate",
    headers={
        "X-API-Key": api_key,
        "Content-Type": "application/json"
    },
    json={
        "prompt": "A tiger walking through jungle",
        "model": "minimax-hailuo-02-6s-768p-i2v",
        "head_image": "https://example.com/tiger.jpg"  # Image to animate
    }
)

result = response.json()
print(f"Session ID: {result['session_id']}")
# Poll session endpoint to get video when ready

Examples

# Minimax Hailuo 02 - Text-to-Video, 6 seconds, 768p
minimax-hailuo-02-6s-768p-t2v

# Minimax Hailuo 02 - Image-to-Video, 6 seconds, 768p
minimax-hailuo-02-6s-768p-i2v

# Luma AI - Text-to-Video, 5 seconds (Flash variant)
luma-ray-2.0-flash-5s-t2v

# Aliyun WAN - Image-to-Video, 5 seconds, 480p (Flash variant)
wan-wan2.2-i2v-flash-5s-480p