iSamurai Face Swap API Documentation

import requests
import base64

API_KEY = "isk_your_api_key_here"
BASE_URL = "https://isamur.ai/api"

# Convert images to base64
def to_base64(file_path):
    with open(file_path, "rb") as f:
        return base64.b64encode(f.read()).decode()

# Generate preview
response = requests.post(
    f"{BASE_URL}/preview-swap-api/",
    headers={
        "Authorization": f"Api-Key {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "source_image_base64": to_base64("face.jpg"),
        "target_image_base64": to_base64("target_frame.jpg"),
        "enhance": False
    }
)

# Save preview image
preview_base64 = response.json()["image_base64"]
with open("preview.jpg", "wb") as f:
    f.write(base64.b64decode(preview_base64))

const API_KEY = "isk_your_api_key_here";

async function toBase64(file) {
    return new Promise((resolve) => {
        const reader = new FileReader();
        reader.onload = (e) => resolve(e.target.result.split(',')[1]);
        reader.readAsDataURL(file);
    });
}

const response = await fetch("https://isamur.ai/api/preview-swap-api/", {
    method: "POST",
    headers: {
        "Authorization": `Api-Key ${API_KEY}`,
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        source_image_base64: await toBase64(sourceFile),
        target_image_base64: await toBase64(targetFrame),
        enhance: false
    })
});

const { image_base64 } = await response.json();
// Display: img.src = `data:image/jpeg;base64,${image_base64}`

{
  "image_base64": "/9j/4AAQSkZJRgABAQAAAQ...",
  "preview_id": "abc123"
}

import requests

API_KEY = "isk_your_api_key_here"
BASE_URL = "https://isamur.ai/api"

# Upload local files and start processing
with open("face.jpg", "rb") as source, open("video.mp4", "rb") as target:
    response = requests.post(
        f"{BASE_URL}/full-process-swap/",
        headers={"Authorization": f"Api-Key {API_KEY}"},
        files={
            "source_image": ("face.jpg", source, "image/jpeg"),
            "target_media": ("video.mp4", target, "video/mp4")
        },
        data={
            "gquality": "720p",
            "name": "My Swap",
            "description": "Demo"
        }
    )

result = response.json()
instance_id = result["faceswap"]["id"]
print(f"Processing started: {instance_id}")

const API_KEY = "isk_your_api_key_here";

async function startFaceSwap(sourceFile, targetFile, quality = "720p") {
    const formData = new FormData();
    formData.append("source_image", sourceFile);
    formData.append("target_media", targetFile);
    formData.append("gquality", quality);
    formData.append("name", "My Swap");

    const response = await fetch("https://isamur.ai/api/full-process-swap/", {
        method: "POST",
        headers: { "Authorization": `Api-Key ${API_KEY}` },
        body: formData
    });
    
    const result = await response.json();
    return result.faceswap.id;
}

import time

while True:
    response = requests.get(
        f"{BASE_URL}/swap-progress/",
        headers={"Authorization": f"Api-Key {API_KEY}"},
        params={"id": instance_id}
    )
    data = response.json()
    print(f"Status: {data['status']} - {data.get('progress_percentage', 0)}%")
    
    if data["status"] == "Done":
        print(f"Output: {data['output_media_url']}")
        break
    elif data["status"] in ["Failed", "Cancelled"]:
        print(f"Error: {data.get('error')}")
        break
    time.sleep(5)

async function waitForCompletion(instanceId) {
    while (true) {
        const response = await fetch(
            `https://isamur.ai/api/swap-progress/?id=${instanceId}`,
            { headers: { "Authorization": `Api-Key ${API_KEY}` } }
        );
        const data = await response.json();
        console.log(`${data.status} - ${data.progress_percentage || 0}%`);
        
        if (data.status === "Done") return data.output_media_url;
        if (["Failed", "Cancelled"].includes(data.status)) throw new Error(data.error);
        await new Promise(r => setTimeout(r, 5000));
    }
}

{"id": "instance_uuid", "type": "faceswap"}

import base64

# Capture a frame from your video (using OpenCV, ffmpeg, etc.)
with open("frame.jpg", "rb") as f:
    frame_b64 = base64.b64encode(f.read()).decode()

response = requests.post(
    f"{BASE_URL}/analyse-frame/",
    headers={
        "Authorization": f"Api-Key {API_KEY}",
        "Content-Type": "application/json"
    },
    json={"target_image_base64": frame_b64}
)

faces = response.json()["analysis"]
for face in faces:
    print(f"Face detected: {face['person_id']}")

{
  "analysis": [
    {"person_id": "P1", "thumbnail": "base64...", "bbox": [x, y, w, h]},
    {"person_id": "P2", "thumbnail": "base64...", "bbox": [x, y, w, h]}
  ]
}

{
  "target_image_base64": "base64_frame...",
  "analysis_results": [
    {
      "person_id": "P1",
      "thumbnail": "base64...",
      "source_image": "base64_of_source_face_1"
    },
    {
      "person_id": "P2", 
      "thumbnail": "base64...",
      "source_image": "base64_of_source_face_2"
    }
  ],
  "enhance": false
}

{"preview_image": "base64_result..."}

with open("action_clip.mp4", "rb") as video:
    response = requests.post(
        f"{BASE_URL}/slowmotion/",
        headers={"Authorization": f"Api-Key {API_KEY}"},
        files={"source_video": video},
        data={
            "slowdown_factor": 4,
            "quality": "720p",
            "mode": "slowmo"
        }
    )
    
project = response.json()["slowmotion"]
print(f"Project ID: {project['id']}")

const formData = new FormData();
formData.append("source_video", videoFile);
formData.append("slowdown_factor", "4");
formData.append("quality", "720p");
formData.append("mode", "slowmo");

const response = await fetch("https://isamur.ai/api/slowmotion/", {
    method: "POST",
    headers: { "Authorization": `Api-Key ${API_KEY}` },
    body: formData
});
const project = (await response.json()).slowmotion;

{ "project_id": "uuid" }

{
  "url": "/api/media/restored/output.jpg",
  "image_base64": "/9j/4AAQSkZ...",
  "status": "success"
}

{
  "user_id": 123,
  "user_credits": 9500,
  "plan_id": 5,
  "plan_name": "Samurai"
}

import requests

API_KEY = "isk_your_api_key_here"
BASE_URL = "https://isamur.ai/api"

# Upload multiple images
files = [
    ("images", ("face1.jpg", open("face1.jpg", "rb"), "image/jpeg")),
    ("images", ("face2.jpg", open("face2.jpg", "rb"), "image/jpeg")),
]

response = requests.post(
    f"{BASE_URL}/gallery/sources/",
    headers={"Authorization": f"Api-Key {API_KEY}"},
    files=files
)

result = response.json()
print(f"Uploaded: {result['message']}")
for img in result["images"]:
    print(f"  ID: {img['id']} - {img['name']}")

const API_KEY = "isk_your_api_key_here";

// Upload multiple images
const formData = new FormData();
formData.append("images", file1);
formData.append("images", file2);

const response = await fetch("https://isamur.ai/api/gallery/sources/", {
    method: "POST",
    headers: { "Authorization": `Api-Key ${API_KEY}` },
    body: formData
});

const result = await response.json();
console.log("Uploaded images:", result.images);

{
  "message": "2 images uploaded successfully",
  "images": [
    {"id": "uuid-1", "name": "face1.jpg", "url": "/media/sources/..."},
    {"id": "uuid-2", "name": "face2.jpg", "url": "/media/sources/..."}
  ]
}

{
  "images": [{"id": "uuid", "name": "face.jpg", "url": "..."}],
  "has_next": true,
  "total": 45
}

{"ids": ["uuid-1", "uuid-2", "uuid-3"]}