Face Swap API – Fast, High-Quality Face Replacement for Images & Videos

Overview

The Face Swap API enables seamless face replacement in both images and videos using advanced AI technology. Whether you're building a photo editor, video creation tool, or social media application, our API provides production-ready face swapping capabilities with high-quality results.

Key Features

• Image Face Swap: Swap single or multiple faces in static images
• Video Face Swap: Replace faces in video content with frame-by-frame precision
• Batch Processing: Submit multiple tasks in a single API request
• HD Enhancement: Optional face enhancement for professional-quality results
• Flexible Face Selection: Automatic or manual face targeting in videos

Authentication

All API requests require authentication using an API key. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

API Host: https://us-center.deep-api.com

Image Face Swap API

Pricing

Endpoint

POST /api/aigc/task/submit

Request Headers

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters

Response Format

{
  "code": 100000,
  "message": "Request Success",
  "data": {
    "credits_consumed": 5,
    "creation_id": "acaaf3ec58b14e98a22f7506b8736421",
    "task_id_list": [16224172]
  }
}

Response Fields:

• code: Status code (100000 = success)
• credits_consumed: Total credits used for this request
• creation_id: Unique identifier grouping all tasks in the request
• task_id_list: Array of task IDs in submission order

Code Example

curl --location --request POST \
  'https://us-center.deep-api.com/api/aigc/task/submit' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "aigc_type": "image_face_swap",
    "callback_url": "https://your-domain.com/result/callback",
    "task_list": [
      {
        "additional_params": {
          "target_image_url": "https://your-storage.com/target-image.jpg",
          "target_face_url": "https://your-storage.com/source-face.png"
        },
        "callback_params": {
          "user_id": "12345",
          "custom_data": "any_value"
        }
      }
    ]
  }'

Video Face Swap API

Pricing

Endpoint

POST /api/aigc/task/submit

Request Parameters

Response Format

{
  "code": 100000,
  "message": "Request Success",
  "data": {
    "credits_consumed": 100,
    "creation_id": "3fe766593eed425e83bf7a36b7321c31",
    "task_id_list": [16222903]
  }
}

Code Example

curl --location --request POST \
  'https://us-center.deep-api.com/api/aigc/task/submit' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "aigc_type": "multiple_video_face_swap",
    "callback_url": "https://your-domain.com/callback",
    "task_list": [
      {
        "additional_params": {
          "target_video_url": "https://your-storage.com/video.mp4",
          "face_swap_list": [
            {
              "src": "https://your-storage.com/face1.jpg",
              "target": "https://your-storage.com/target1.jpg"
            },
            {
              "src": "https://your-storage.com/face2.jpg",
              "target": "https://your-storage.com/target2.jpg"
            }
          ],
          "face_enhance": 1,
          "start_trim_sec": 0.0,
          "end_trim_sec": 5.875
        },
        "callback_params": {
          "project_id": "abc123"
        }
      }
    ]
  }'

Webhook Callbacks

Upon task completion, results are sent to your callback_url via POST request.

⚠️ Important:
Each task triggers two separate callbacks:

1. Process Start Callback (process_status = 1) – Sent immediately when the AI starts processing your task.
2. Process Complete Callback (process_status = 2) – Sent when the task finishes (successfully or failed).

You should handle both callbacks properly:

• Use the start callback to update UI or mark task as “in progress”
• Use the complete callback to retrieve results and finalize the task
• Avoid treating “start” callback as a completion event

Webhook Request Structure

Webhook Retry Logic

• Your endpoint must return HTTP 200 to confirm receipt
• Non-200 responses trigger up to 4 retries at intervals: 5s, 30s, 120s, 300s
• Implement proper error handling to receive callbacks reliably

Status Codes

Best Practices

Image Quality Requirements

Performance Optimization

1. Batch Processing: Submit multiple tasks in one request to reduce overhead
2. Video Trimming: Use start_trim_sec and end_trim_sec to process only necessary segments
3. Face Enhancement: Enable only when high quality is essential (doubles credit cost)
4. Webhook Reliability: Implement idempotency using task_id to handle duplicate callbacks

FAQ

Use Cases

Social Media Applications

Create engaging content with face swap filters and effects for viral social media posts.

Entertainment & Gaming

Build avatar systems, character customization tools, or entertainment apps with real-time face swapping.

Video Production

Automate face replacement in video editing workflows for content creators and production studios.

Marketing & Advertising

Generate personalized marketing materials with customer faces in promotional content.

Support

Need help integrating the Face Swap API? Contact our technical support team for:

• API key provisioning
• Integration assistance
• Credit balance inquiries
• Technical troubleshooting

API Version: v1
Last Updated: October 2025