Video Face Swap API Documentation

Overview

GoAPI's Video Face Swap service enables face replacement in videos using advanced facial recognition and swapping technology. The service supports both single and multiple face swapping operations within MP4 videos.

Pricing

Cost per frame: $0.004

Pricing is calculated based on the total number of frames processed

Model Information

Model Name: Qubico/video-toolkit

Task Type: face-swap

Image Size Limit: Maximum 2048 x 2048 resolution

Capabilities:

Single and multiple face swapping

Support for indexed face selection in both source and target

Processing of standard MP4 videos

Technical Limitations

File Format: MP4 only

File Size: Maximum 10MB

Resolution: Maximum 720p

Frame Limit: Maximum 600 frames per video

Image Size Limit: Maximum 2048 x 2048 resolution

Face-Swapping Logic Based on Algorithmic Face Order

The face-swapping sequence is determined by the model's algorithmic detection of faces. The model assigns order labels to detected faces, and users can generally expect the API to sort faces from left to right by default. However, if faces in a photo/video are positioned diagonally (e.g., one at the top-left and another at the bottom-right), the model may prioritize them as follows:

Top-left face → Labeled 1

Bottom-right face → Labeled 0

Conversely, if one face is at the bottom-left and another at the top-right:

Bottom-left face → Labeled 0

Top-right face → Labeled 1

Examples: How Face Indexing Affects Results

Case 1

swap_faces_index: 0 1
target_faces_index: 1 0
Action: The left face in the source image replaces the right face in the target video, and the right face in the source replaces the left face in the target.

Case 2

swap_faces_index: 0 1
target_faces_index: 0 1
Action: The left face in the source replaces the left face in the target; the right face in the source replaces the right face in the target.

Request

Header Params

Body Params application/json

Example

{
    "model": "Qubico/video-toolkit",
    "task_type": "face-swap",
    "input": {
        "swap_image": "http://example.com",
        "target_video": "http://example.com",
        "swap_faces_index": "string",
        "target_faces_index": "string"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

{ "code": 200, "message": "string", "data": { "task_id": "736fde4d-9029-4915-8189-01353d6982cb", "status": "string", "output": { "video_url": "http://example.com" } } }

Video Faceswap

Video Face Swap API Documentation

Overview

Pricing

Model Information

Technical Limitations

Face-Swapping Logic Based on Algorithmic Face Order

Examples: How Face Indexing Affects Results

Case 1

Case 2

Request

Request Code Samples

Responses

Video Faceswap

Video Face Swap API Documentation#

Overview#

Pricing#

Model Information#

Technical Limitations#

Face-Swapping Logic Based on Algorithmic Face Order#

Examples: How Face Indexing Affects Results#

Case 1#

Case 2#

Request

Request Code Samples

Responses

Video Face Swap API Documentation

Overview

Pricing

Model Information

Technical Limitations

Face-Swapping Logic Based on Algorithmic Face Order

Examples: How Face Indexing Affects Results

Case 1

Case 2