Qubico - Face Swapper

Seamlessly swap faces between images using Qubico's advanced AI technology. Transfer facial features, expressions, and characteristics from one person to another while maintaining natural-looking results with high-quality face detection and blending algorithms.

Endpoint

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

Request Headers

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

Parameters

Parameter	Type	Required	Description
`type`	string	Yes	Feature type identifier. Must be `FACE_SWAPPER`
`model`	string	Yes	AI model identifier. Must be `Qubico/image-toolkit`
`promptObject`	object	Yes	Configuration object containing all face swapping parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
`targetImageUrl`	string	Yes	Path to the target image where the face will be swapped onto	-
`swapImageUrl`	string	Yes	Path to the source image containing the face to be transferred	-
`output_format`	string	Yes	Output format for the face-swapped image. Must be `png`	-

Supported Output Formats

Format	Description	Best For
`png`	High quality lossless format with transparency support	Professional use, detailed images, archival quality

Image Requirements

Requirement	Description
Format	PNG, JPEG, or WebP formats supported
Face Detection	Images must contain clearly visible human faces
Resolution	Higher resolution images (1024px+) provide better results
Lighting	Well-lit faces with minimal shadows work best
Angle	Front-facing or slight angle faces produce optimal results

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": "FACE_SWAPPER",
"model": "Qubico/image-toolkit",
"promptObject": {
  "targetImageUrl": "development/images/2025_02_18_11_09_03_936_human.jpg",
  "swapImageUrl": "development/images/2025_02_18_11_10_30_356_human3.jpeg",
  "output_format": "png"
}
}'

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'FACE_SWAPPER',
  model: 'Qubico/image-toolkit',
  promptObject: {
    targetImageUrl: 'development/images/2025_02_18_11_09_03_936_human.jpg',
    swapImageUrl: 'development/images/2025_02_18_11_10_30_356_human3.jpeg',
    output_format: 'png'
  }
})
})

import requests

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

data = {
"type": "FACE_SWAPPER",
"model": "Qubico/image-toolkit",
"promptObject": {
  "targetImageUrl": "development/images/2025_02_18_11_09_03_936_human.jpg",
  "swapImageUrl": "development/images/2025_02_18_11_10_30_356_human3.jpeg",
  "output_format": "png"
}
}

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

Interactive Playground

API Playground

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

AI Model *

Target Image URL *

Path to the target image where the face will be swapped onto

Source Face Image URL *

Path to the source image containing the face to be transferred

Output Format *

Format of the output face-swapped image

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": "FACE_SWAPPER",
  "model": "Qubico/image-toolkit",
  "promptObject": {
    "targetImageUrl": "development/images/2025_02_18_11_09_03_936_human.jpg",
    "swapImageUrl": "development/images/2025_02_18_11_10_30_356_human3.jpeg",
    "output_format": "png"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "f1a2c3e4-b5d6-7890-cdef-123456789012",
  "userId": "user-12345",
  "teamId": "team-67890",
  "teamUser": {
    "teamId": "team-67890",
    "userId": "user-12345",
    "userName": "John Doe",
    "userAvatar": "https://example.com/avatar.jpg",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 25000,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-01-15T15:00:00.000Z",
    "updatedBy": "SYSTEM"
  },
  "model": "Qubico/image-toolkit",
  "type": "FACE_SWAPPER",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-01-15T15:00:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "targetImageUrl": "development/images/2025_02_18_11_09_03_936_human.jpg",
      "swapImageUrl": "development/images/2025_02_18_11_10_30_356_human3.jpeg",
      "output_format": "png"
    },
    "resultObject": [
      "development/images/2025_01_15_15_00_45_001_face_swapped.png"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_15_00_45_001_face_swapped.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20250115T150000Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases

Social Media Content: Create fun and engaging content for social platforms
Memes & Viral Content: Generate humorous face-swapped images for entertainment
Profile Pictures: Create unique avatars using celebrity or character faces
Party Photography: Add entertainment value to event and party photos
Digital Costumes: Transform photos for themed events or holidays

Creative & Artistic Projects

Digital Art: Create surreal and artistic compositions with face swapping
Photo Manipulation: Enhance creative photography projects
Character Design: Visualize characters by combining different facial features
Concept Art: Create mockups for film, game, or animation projects
Portfolio Work: Demonstrate digital art and photo editing skills

Professional & Commercial Applications

Marketing Campaigns: Create engaging advertising content with face swapping
Product Demonstrations: Show how makeup, accessories, or treatments might look
Brand Campaigns: Create personalized marketing materials
Training Materials: Generate diverse representation in educational content
Stock Photography: Create varied demographic representations

Film & Media Production

Pre-visualization: Test casting decisions and character looks
Concept Development: Explore different character appearances
Reference Materials: Create visual references for makeup and prosthetics
Storyboarding: Visualize scenes with different actors or characters
Digital Doubles: Create reference images for CGI and VFX work

Research & Development

Identity Studies: Research facial recognition and identity perception
Technology Testing: Validate face detection and manipulation algorithms
User Experience: Test how users interact with face-swapping technology
Academic Research: Study facial features and identity transformation
Algorithm Development: Train and test machine learning models

Tips for Best Results

Image Quality Guidelines: Use high-quality source images for optimal results
- High resolution: Use images with at least 1024x1024 pixels for best quality
- Clear faces: Ensure faces are clearly visible and well-lit
- Minimal shadows: Avoid harsh shadows that can interfere with face detection
- Sharp focus: Use in-focus images with good detail definition
Face Selection Best Practices: Choose appropriate source and target images
- Similar angles: Use images with similar face angles for natural-looking results
- Comparable lighting: Match lighting conditions between source and target images
- Face size: Similar face sizes in both images produce better swapping results
- Expression matching: Consider facial expressions for more convincing swaps
Lighting & Environment: Optimize environmental factors
- Even lighting: Consistent lighting across the face improves detection accuracy
- Avoid backlighting: Strong backlighting can make faces difficult to detect
- Minimal occlusion: Avoid sunglasses, masks, or other face obstructions
- Clear backgrounds: Simple backgrounds help focus the AI on facial features
Technical Considerations: Understand technical limitations and requirements
- Face detection: Ensure both images contain clearly detectable human faces
- Processing time: Larger images may require longer processing times
- Quality vs speed: Higher resolution inputs produce better but slower results
- Format support: PNG output provides the highest quality results
Ethical Usage Guidelines: Use face swapping technology responsibly
- Consent: Only use images where you have permission to modify faces
- Privacy: Respect privacy rights and avoid unauthorized use of personal images
- Attribution: Give credit when using recognizable faces or personalities
- Context: Consider the context and potential impact of face-swapped content
Advanced Techniques: Enhance results with advanced approaches
- Pre-processing: Adjust lighting and contrast before face swapping
- Post-processing: Fine-tune results with additional image editing
- Batch processing: Process multiple variations to select the best result
- Quality validation: Review results for naturalness and visual consistency

Endpoint​

Request Headers​

Parameters​

Prompt Object Parameters​

Supported Output Formats​

Image Requirements​

Code Examples​

Interactive Playground​

API Playground

Generated cURL Command:

Response Format​

Use Cases​

Entertainment & Social Media​

Creative & Artistic Projects​

Professional & Commercial Applications​

Film & Media Production​

Research & Development​

Tips for Best Results​