Video Face Swap

Perform advanced face swapping in videos using cutting-edge AI technology through the 1min.AI API. This feature allows you to seamlessly replace faces in video content while maintaining natural expressions, movements, and lighting conditions.

Key Features

• Advanced Face Detection: Precise face detection and tracking throughout video sequences
• Natural Movement: Maintains facial expressions and head movements realistically
• High Quality: Professional-grade results with smooth transitions
• Lighting Preservation: Adapts swapped faces to match original lighting conditions
• Multiple Formats: Support for various video input and output formats
• Frame-by-Frame Processing: Ensures consistency across all video frames

Supported Models

The Video Face Swap API uses specialized computer vision models:

Qubico Models:

• Qubico/video-toolkit - Qubico Video Faceswap (Primary model for video face swapping)

Note: This feature uses specialized computer vision models optimized for video face manipulation rather than general-purpose language models.

API Reference

POSThttps://api.1min.ai/api/features

Request Headers

Field	Value
API-KEY	<api-key>
Content-Type	application/json

Request Parameters

Field Name	Type	Description	Required
type	string	Must be "VIDEO_FACE_SWAPPER"	✔️
model	string	Must be "Qubico/video-toolkit"	✔️
conversationId	string	Must be "VIDEO_FACE_SWAPPER"	✔️
promptObject.targetVideoUrl	string	Target video URL or asset key (video to modify)	✔️
promptObject.swapImageUrl	string	Source face image URL or asset key (face to insert)	✔️
promptObject.swapFacesIndex	array	Index of faces to swap from source image	❌
promptObject.targetFacesIndex	array	Index of faces to target in video	❌

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "VIDEO_FACE_SWAPPER",
"model": "Qubico/video-toolkit",
"conversationId": "VIDEO_FACE_SWAPPER",
"promptObject": {
  "targetVideoUrl": "your-target-video-asset-key",
  "swapImageUrl": "your-face-image-asset-key"
}
}'

JavaScript

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'VIDEO_FACE_SWAPPER',
  model: 'Qubico/video-toolkit',
  conversationId: 'VIDEO_FACE_SWAPPER',
  promptObject: {
    targetVideoUrl: 'your-target-video-asset-key',
    swapImageUrl: 'your-face-image-asset-key'
  }
})
})

Python

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "VIDEO_FACE_SWAPPER",
"model": "Qubico/video-toolkit",
"conversationId": "VIDEO_FACE_SWAPPER",
"promptObject": {
  "targetVideoUrl": "your-target-video-asset-key",
  "swapImageUrl": "your-face-image-asset-key"
}
}

response = requests.post(url, headers=headers, json=data)

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

Face Swap Model *Qubico Video Toolkit

Target Video URL/Asset Key *

Face Image URL/Asset Key *

Swap Faces Index (Source Image)

Target Faces Index (Video)

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "VIDEO_FACE_SWAPPER",
  "model": "Qubico/video-toolkit",
  "conversationId": "VIDEO_FACE_SWAPPER",
  "promptObject": {
    "targetVideoUrl": "your-target-video-asset-key",
    "swapImageUrl": "your-face-image-asset-key"
  }
}'

Response Format

{}

Technical Requirements

Input Specifications

Target Video Requirements:

• Formats: MP4, MOV, AVI, MKV, WebM
• Resolution: 720p to 4K supported
• Duration: Maximum 60 seconds per video
• File Size: Maximum 50MB
• Frame Rate: 24-60 FPS supported

Face Image Requirements:

• Formats: JPG, PNG, WebP
• Resolution: Minimum 256x256 pixels
• Quality: High-resolution images produce better results
• Face Visibility: Clear, front-facing portraits work best
• File Size: Maximum 10MB

Output Specifications

• Default Format: MP4 with H.264 encoding
• Quality Levels: High (1080p), Medium (720p), Low (480p)
• Audio: Original audio preserved by default
• Processing Time: Varies by video length and quality settings

Use Cases

Entertainment & Creative

• Content Creation: Create entertaining social media content
• Film Production: Preview casting choices or create placeholder footage
• Personal Projects: Fun videos for friends and family
• Parody Content: Create comedic content with face swaps

Professional Applications

• Marketing: Create personalized advertising content
• Training Videos: Protect privacy while maintaining engagement
• Demonstration: Show products or services with different presenters
• Accessibility: Replace speakers while maintaining original content