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
JavaScript
Python

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"
}
}'

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'
  }
})
})

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

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

Face Swap Model *

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

Best Practices

For Optimal Results

High-Quality Inputs: Use high-resolution videos and images
Clear Face Visibility: Ensure faces are clearly visible and well-lit
Similar Angles: Face image should match the general angle/pose in the video
Consistent Lighting: Better results with consistent lighting conditions
Stable Footage: Less camera shake produces cleaner swaps

Face Index Parameters

swapFacesIndex: Specifies which face(s) from the source image to use (0-based index)
targetFacesIndex: Specifies which face(s) in the target video to replace (0-based index)
Default: If not specified, the system will automatically detect and use the most prominent faces
Multiple Faces: Use arrays like [0,1] to specify multiple faces for swapping

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

Ethical Guidelines

When using Video Face Swap technology, please consider:

Consent: Always obtain proper consent before using someone's likeness
Disclosure: Clearly label content as AI-generated when sharing publicly
Privacy: Respect individual privacy rights and local regulations
Authenticity: Avoid creating misleading or deceptive content
Legal Compliance: Follow applicable laws regarding deepfakes and synthetic media

Limitations

Processing Time: Complex videos may take several minutes to process
Face Detection: Works best with clearly visible, front-facing faces
Multiple Faces: Currently optimized for single face replacement per video
Extreme Angles: Side profiles and extreme angles may produce variable results
Rapid Movement: Very fast facial movements may affect swap quality

Error Handling

Common error scenarios:

No detectable faces in target video or source image
File format not supported or corrupted files
Files exceeding size or duration limits
Insufficient face visibility or quality
Network timeouts for large file processing

For detailed error codes and troubleshooting, refer to the main API documentation.

Security & Privacy

Data Protection: All uploaded content is processed securely and deleted after processing
No Storage: Videos and images are not permanently stored on our servers
Encryption: All data transmission uses SSL/TLS encryption
Compliance: Adheres to data protection regulations and privacy standards

Key Features​

Supported Models​

API Reference​

Request Headers​

Request Parameters​

Code Examples​

Interactive Playground​

API Playground

Generated cURL Command:

Response Format​

Technical Requirements​

Input Specifications​

Output Specifications​

Best Practices​

For Optimal Results​

Face Index Parameters​

Use Cases​

Entertainment & Creative​

Professional Applications​

Ethical Guidelines​

Limitations​

Error Handling​

Security & Privacy​