atlascloud/face-swap-video

video-ke-video

Face Swap API by Atlas Cloud

atlascloud/face-swap-video

Face-swap-video

Replace the person in a video with a face of your choice. Motion, timing and background are preserved while the character is swapped.

INPUT

Gambar *

Anda dapat drag & drop file atau klik untuk mengunggah

MAX:1

Video *

Anda dapat drag & drop file atau klik untuk mengunggah

MAX:1

Resolusi

OUTPUT

Menunggu

Video yang dihasilkan akan muncul di sini

Konfigurasikan pengaturan Anda dan klik Jalankan untuk memulai

Permintaan Anda akan dikenakan biaya $0.2 per eksekusi. Dengan $10 Anda dapat menjalankan model ini sekitar 50 kali.

Berikut yang dapat Anda lakukan selanjutnya:

Seedance 2.0 Kling v3 Vidu Wan2.7

Parameter

Contoh kode
import requests
import time

# Step 1: Start video generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "atlascloud/face-swap-video",  # Required. Model name
    "image": "example_value",  # Required. Source Face — a clear, front-facing photo of the face to place into the video
    "video": "example_value",  # Required. Target Video — the video whose person will be replaced
    "resolution": "1080P",  # Output video resolution. options: 720P | 1080P
}

generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]

# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"

def check_status():
    while True:
        response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
        result = response.json()

        if result["data"]["status"] in ["completed", "succeeded"]:
            print("Generated video:", result["data"]["outputs"][0])
            return result["data"]["outputs"][0]
        elif result["data"]["status"] == "failed":
            raise Exception(result["data"]["error"] or "Generation failed")
        else:
            # Still processing, wait 2 seconds
            time.sleep(2)

video_url = check_status()

Instalasi

Instal paket dependensi yang diperlukan.

pip install requests

Autentikasi

Semua permintaan API memerlukan autentikasi melalui API key. Anda bisa mendapatkan API key dari dasbor Atlas Cloud.

export ATLASCLOUD_API_KEY="your-api-key-here"

HTTP Headers

import os

API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

Jaga keamanan API key Anda

Jangan pernah mengekspos API key Anda di kode sisi klien atau repositori publik. Gunakan variabel lingkungan atau proxy backend sebagai gantinya.

Kirim permintaan

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "your-model",
    "prompt": "A beautiful landscape"
}

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

Kirim Permintaan

Kirim permintaan pembuatan asinkron. API mengembalikan prediction ID yang dapat Anda gunakan untuk memeriksa status dan mengambil hasil.

POST/api/v1/model/generateVideo

Isi Permintaan

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}

data = {
    "model": "atlascloud/face-swap-video",
    "prompt": "A beautiful sunset over the ocean with gentle waves"
}

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

print(f"Prediction ID: {result['data']['id']}")
print(f"Status: {result['data']['status']}")

Respons

{
  "code": 200,
  "data": {
    "id": "pred_abc123",
    "status": "processing",
    "model": "model-name",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

Periksa Status

Polling prediction endpoint untuk memeriksa status permintaan Anda saat ini.

GET/api/v1/model/prediction/{prediction_id}

Contoh Polling

import requests
import time

prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

while True:
    response = requests.get(url, headers=headers)
    result = response.json()
    status = result["data"]["status"]
    print(f"Status: {status}")

    if status in ["completed", "succeeded"]:
        output_url = result["data"]["outputs"][0]
        print(f"Output URL: {output_url}")
        break
    elif status == "failed":
        print(f"Error: {result['data'].get('error', 'Unknown')}")
        break

    time.sleep(3)

Nilai Status

processingPermintaan masih diproses.

completedPembuatan selesai. Output tersedia.

succeededPembuatan berhasil. Output tersedia.

failedPembuatan gagal. Periksa field error.

Respons Selesai

{
  "data": {
    "id": "pred_abc123",
    "status": "completed",
    "outputs": [
      "https://storage.atlascloud.ai/outputs/result.mp4"
    ],
    "metrics": {
      "predict_time": 45.2
    },
    "created_at": "2025-01-01T00:00:00Z",
    "completed_at": "2025-01-01T00:00:10Z"
  }
}

Unggah File

Unggah file ke penyimpanan Atlas Cloud dan dapatkan URL yang dapat Anda gunakan dalam permintaan API Anda. Gunakan multipart/form-data untuk mengunggah.

POST/api/v1/model/uploadMedia

Contoh Unggah

import requests

url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

with open("image.png", "rb") as f:
    files = {"file": ("image.png", f, "image/png")}
    response = requests.post(url, headers=headers, files=files)

result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")

Respons

{
  "data": {
    "download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
    "file_name": "image.png",
    "content_type": "image/png",
    "size": 1024000
  }
}

Input Schema

Parameter berikut diterima di isi permintaan.

Total: 4Wajib: 3Opsional: 1

modelstringrequired

Model name.

Default: "atlascloud/face-swap-video"

imagestringrequired

Source Face — a clear, front-facing photo of the face to place into the video.

videostringrequired

Target Video — the video whose person will be replaced. MP4/MOV, 2-10s, <=100MB.

resolutionstring

Output video resolution. Higher resolution costs more.

Default: "1080P"

720P1080P

Contoh Isi Permintaan

{
  "model": "atlascloud/face-swap-video",
  "image": "example_image",
  "video": "example_video",
  "resolution": "1080P"
}

Output Schema

API mengembalikan respons prediction dengan URL output yang dihasilkan.

created_atstring

ISO timestamp of when the request was created.

idstring

Unique identifier for the prediction.

modelstring

Model ID used for the prediction.

outputsarray

Array of URLs to the generated content. Empty when status is not completed.

statusstring

Status of the task: created, processing, completed, or failed.

Contoh Respons

{
  "id": "pred_abc123",
  "status": "completed",
  "model": "model-name",
  "outputs": [
    "https://storage.atlascloud.ai/outputs/result.mp4"
  ],
  "metrics": {
    "predict_time": 45.2
  },
  "created_at": "2025-01-01T00:00:00Z",
  "completed_at": "2025-01-01T00:00:10Z"
}

Atlas Cloud Skills

Atlas Cloud Skills mengintegrasikan 400+ model AI langsung ke asisten pengkodean AI Anda. Satu perintah untuk menginstal, lalu gunakan bahasa alami untuk menghasilkan gambar, video, dan mengobrol dengan LLM.

Klien yang Didukung

Claude Code

OpenAI Codex

Gemini CLI

Cursor

Windsurf

VS Code

Trae

GitHub Copilot

Cline

Roo Code

Amp

Goose

Replit

40+ klien yang didukung

Instalasi

npx skills add AtlasCloudAI/atlas-cloud-skills

Atur API Key

Dapatkan API key dari dasbor Atlas Cloud dan atur sebagai variabel lingkungan.

export ATLASCLOUD_API_KEY="your-api-key-here"

Kemampuan

Setelah diinstal, Anda dapat menggunakan bahasa alami di asisten AI Anda untuk mengakses semua model Atlas Cloud.

Pembuatan GambarBuat gambar dengan model seperti Nano Banana 2, Z-Image, dan lainnya.

Pembuatan VideoBuat video dari teks atau gambar dengan Kling, Vidu, Veo, dll.

Obrolan LLMMengobrol dengan Qwen, DeepSeek, dan model bahasa besar lainnya.

Unggah MediaUnggah file lokal untuk pengeditan gambar dan alur kerja gambar-ke-video.

Pelajari lebih lanjut

github.com/AtlasCloudAI/atlas-cloud-skills

MCP Server

Atlas Cloud MCP Server menghubungkan IDE Anda dengan 400+ model AI melalui Model Context Protocol. Berfungsi dengan klien apa pun yang kompatibel dengan MCP.

Klien yang Didukung

Cursor

VS Code

Windsurf

Claude Code

OpenAI Codex

Gemini CLI

Cline

Roo Code

100+ klien yang didukung

Instalasi

npx -y atlascloud-mcp

Konfigurasi

Tambahkan konfigurasi berikut ke file pengaturan MCP di IDE Anda.

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": [
        "-y",
        "atlascloud-mcp"
      ],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Alat yang Tersedia

atlas_generate_imageBuat gambar dari prompt teks.

atlas_generate_videoBuat video dari teks atau gambar.

atlas_chatMengobrol dengan model bahasa besar.

atlas_list_modelsJelajahi 400+ model AI yang tersedia.

atlas_quick_generatePembuatan konten satu langkah dengan pemilihan model terbaik otomatis.

atlas_upload_mediaUnggah file lokal untuk alur kerja API.

Pelajari lebih lanjut

github.com/AtlasCloudAI/mcp-server

Schema API

{
  "info": {
    "title": "AtlasCloud API",
    "version": "1.0.0",
    "description": "AtlasCloud Face Swap (video) tool."
  },
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/model/generateVideo": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Input"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "The request status."
          }
        },
        "x-api-name": "model_run"
      }
    },
    "/api/v1/model/prediction/{request_id}": {
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "request_id",
            "required": true,
            "schema": {
              "description": "Request ID",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "Result of the request."
          }
        },
        "x-api-name": "model_result"
      }
    }
  },
  "components": {
    "schemas": {
      "Input": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "description": "Model name.",
            "default": "atlascloud/face-swap-video"
          },
          "image": {
            "type": "string",
            "description": "Source Face — a clear, front-facing photo of the face to place into the video.",
            "x-format": "image",
            "x-label": "Source Face"
          },
          "video": {
            "type": "string",
            "description": "Target Video — the video whose person will be replaced. MP4/MOV, 2-10s, <=100MB.",
            "x-format": "video",
            "x-label": "Target Video"
          },
          "resolution": {
            "type": "string",
            "description": "Output video resolution. Higher resolution costs more.",
            "default": "1080P",
            "enum": [
              "720P",
              "1080P"
            ],
            "x-ui-component": "select",
            "x-label": "Output Resolution"
          }
        },
        "required": [
          "model",
          "image",
          "video"
        ],
        "x-order-properties": [
          "model",
          "image",
          "video",
          "resolution"
        ]
      },
      "PredictionResponse": {
        "type": "object",
        "properties": {
          "created_at": {
            "description": "ISO timestamp of when the request was created.",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "Unique identifier for the prediction.",
            "type": "string"
          },
          "model": {
            "description": "Model ID used for the prediction.",
            "type": "string"
          },
          "outputs": {
            "description": "Array of URLs to the generated content. Empty when status is not completed.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "status": {
            "description": "Status of the task: created, processing, completed, or failed.",
            "type": "string"
          },
          "urls": {
            "description": "Object containing related API endpoints.",
            "type": "object"
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.atlascloud.ai"
    }
  ]
}

Template Prompt untuk LLM

# atlascloud/face-swap-video

> Replace the person in a video with a face of your choice. Motion, timing and background are preserved while the character is swapped.


## Overview

- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateVideo` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `atlascloud/face-swap-video`


## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:

- **`model`** (`string`, _required_):
  Model name.
  - Default: `"atlascloud/face-swap-video"`

- **`image`** (`string`, _required_):
  Source Face — a clear, front-facing photo of the face to place into the video.

- **`video`** (`string`, _required_):
  Target Video — the video whose person will be replaced. MP4/MOV, 2-10s, <=100MB.

- **`resolution`** (`string`, _optional_):
  Output video resolution. Higher resolution costs more.
  - Default: `"1080P"`
  - Options: "720P", "1080P"



**Required Parameters Example**:

```json
{
  "model": "atlascloud/face-swap-video",
  "image": "",
  "video": ""
}
```


**Full Example**:

```json
{
  "model": "atlascloud/face-swap-video",
  "image": "",
  "video": "",
  "resolution": "1080P"
}
```


### Output Schema

The API returns the following output format:


- **`created_at`** (`string`, _optional_):
  ISO timestamp of when the request was created.

- **`id`** (`string`, _optional_):
  Unique identifier for the prediction.

- **`model`** (`string`, _optional_):
  Model ID used for the prediction.

- **`outputs`** (`array[string]`, _optional_):
  Array of URLs to the generated content. Empty when status is not completed.

- **`status`** (`string`, _optional_):
  Status of the task: created, processing, completed, or failed.

- **`urls`** (`object`, _optional_):
  Object containing related API endpoints.



**Example Response**:

```json
{
  "created_at": "",
  "id": "",
  "model": "",
  "outputs": [
    ""
  ],
  "status": "",
  "urls": {}
}
```


## Usage Examples

### cURL

```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "atlascloud/face-swap-video",
  "image": "",
  "video": "",
  "resolution": "1080P"
}'

# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}

# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```

## Additional Resources

### Documentation

- [Model Playground](https://www.atlascloud.ai/models/atlascloud/face-swap-video)

Memuat...

Face Swap (Video)

Replace the person in a video with a face of your choice.

Source Face — upload a clear, front-facing photo of the face to place into the video.
Target Video — the video whose character is replaced (MP4/MOV, 2-10s).
Click Run.

The original motion, timing, camera movement, lighting and background are preserved, while the character's face is swapped to the source identity.

Face swapping involves real people. Only upload media you have the right to use and obtain consent from the people depicted. Do not use this tool to create misleading or harmful content.

Face Swap API by Atlas Cloud

INPUT

OUTPUT

Parameter

Contoh kode

Instalasi

Autentikasi

HTTP Headers

Kirim permintaan

Kirim Permintaan

Isi Permintaan

Respons

Periksa Status

Contoh Polling

Nilai Status

Respons Selesai

Unggah File

Contoh Unggah

Respons

Input Schema

Contoh Isi Permintaan

Output Schema

Contoh Respons

Atlas Cloud Skills

Klien yang Didukung

Instalasi

Atur API Key

Kemampuan

MCP Server

Klien yang Didukung

Instalasi

Konfigurasi

Alat yang Tersedia

Schema API

Template Prompt untuk LLM

Face Swap (Video)

Jelajahi Model Serupa

Wan-2.2-turbo-spicy Image-to-video Lora

Wan-2.2-turbo-spicy Image-to-video

Wan 2.2 Turbo Image-to-Video

Wan 2.2 Turbo Infinite Image-to-Video

Wan 2.2 Turbo Infinite Image-to-Video LoRA

Wan 2.2 Turbo Spicy Infinite Image-to-Video

Wan 2.2 Turbo Spicy Infinite Image-to-Video LoRA

Video Upscaler

Van-2.6 Text-to-video

Van-2.6 Image-to-video

Wan 2.7 Spicy Image-to-Video

Wan 2.6 Spicy Image-to-Video

Van-2.5 Image-to-video

Van-2.5 Text-to-video

Sync.so Lipsync v3

VEED Lipsync

Satu API untuk semua AI multimedia.

Join our Discord community

INPUT

OUTPUT

Parameter

Contoh kode

Instalasi

Autentikasi

HTTP Headers

Kirim permintaan

Kirim Permintaan

Isi Permintaan

Respons

Periksa Status

Contoh Polling

Nilai Status

Respons Selesai

Unggah File

Contoh Unggah

Respons

Input Schema

Contoh Isi Permintaan

Output Schema

Contoh Respons

Atlas Cloud Skills

Klien yang Didukung

Instalasi