Geliştirici API · v1

Resimler, videolar, GIF'ler ve grup fotoğrafları için Yüz Değiştirme API’si

Kararlı versiyonlu yollar aracılığıyla FaceSwapAI web stüdyolarıyla aynı üretim görevi hattını kullanın. Kimlik doğrulama, gerçek kredi formülleri, dosya limitleri, görev durumları ve hata davranışı çalışan işleyicilerden belgelenir.

Canlı prodüksiyon sözleşmesi · OpenAPI 3.1 · 30 Ağustos 2026'da güncellendi

Hızlı başlangıç

Doğrulanmış hesabınızda bir anahtar oluşturun, sunucunuzdan çok parçalı bir istek gönderin, ardından eşleşen GET yolunu döndürülen görev kimliğiyle yoklayın. Sırrı tarayıcı ve mobil istemci paketlerinin dışında tutun.

  1. 1Anahtarı bir kez oluşturup kopyalayın
  2. 2Yerel medyayı izin=true ile gönder
  3. 3Durum PENDING veya PROCESSING iken sorgulayın
cURL
curl --request POST https://faceswapai.com/api/v1/face-swap/image \
  --header "Authorization: Bearer $FACESWAPAI_API_KEY" \
  --form "sourceImage=@./source.jpg" \
  --form "targetImage=@./target.jpg" \
  --form "consent=true"

Uç noktalar ve tam fiyatlandırma

YöntemUç noktaAmaçKredi formülü
POST/api/v1/face-swap/imageGörüntünün yüzünü değiştirme6
POST/api/v1/face-swap/videoVideoda yüz değiştirmemax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/gifGIF yüz değiştirmemax(9, 3 × ceil(serverMeasuredInputSeconds))
POST/api/v1/face-swap/multipleÇok yüzlü resim değiştirme6 × selectedTargetFaces
GET/api/v1/tasksGörev geçmişi0

Çalışılan kredi örnekleri

Bir görüntü görevi66 kredi
Dört saniyelik videomax(9, 3 × ceil(4))12 kredi
Sekiz saniyelik GIFmax(9, 3 × ceil(8))24 kredi
On sekiz saniyelik GIFmax(9, 3 × ceil(18))54 kredi

Uç noktaya göre istek alanları

Hedef ortama göre rotayı seçin ve ardından aşağıdaki çok parçalı alanları tam olarak gönderin. İsteğe bağlı restorasyon kontrolleri 0'dan 1'e kadar sayıları kabul eder.

POST/api/v1/face-swap/image

Görüntünün yüzünü değiştirme

Bir kaynak kimliğini bir hedef fotoğrafa uygulayın.

Gerekli
sourceImagetargetImageconsent=true
İsteğe bağlı
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/video

Videoda yüz değiştirme

Yüklenen hedef videonun tamamına tek bir kaynak kimliği uygulayın.

Gerekli
sourceImagetargetVideoconsent=true
İsteğe bağlı
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/gif

GIF yüz değiştirme

Yüklenen hedef GIF boyunca tek bir kaynak kimliği uygulayın.

Gerekli
sourceImagetargetGifconsent=true
İsteğe bağlı
faceRestoreVisibilityrestoreVisibility
POST/api/v1/face-swap/multiple

Çok yüzlü resim değiştirme

Bir grup fotoğrafta birden ona kadar seçilen yüzü değiştirin.

Gerekli
sourceImagetargetFace0consent=true
İsteğe bağlı
targetFace1...targetFace9faceBox0...faceBox9
GET/api/v1/tasks

Görev geçmişi

Kimliği doğrulanmış hesaba ait görevleri listeleyin.

İsteğe bağlı
pagepageSizestatustaskType

Her medya görevini yoklayın

Medya POST isteği taskId döndürdükten sonra, durum PENDING veya PROCESSING iken taskId sorgu parametresiyle aynı medya yoluna GET gönderin. COMPLETED, FAILED ve CANCELLED terminal durumlardır.

Taşıyıcı kimlik doğrulaması

Anahtarı her istekte Yetkilendirme olarak gönderin: Taşıyıcı YOUR_API_KEY. API anahtarları, doğrulanmış hesabı ve onun canlı kredi bakiyesini devralır. Uygulama düzeyinde kimlik doğrulama sınırı dakikada 300 istektir; üretim kapasitesi kuyruğa bağımlı olmaya devam ediyor.

HTTP
Authorization: Bearer YOUR_API_KEY

JavaScript ve Python örnekleri

Bu sunucu tarafı örnekleri iki yerel dosya gönderir, HTTP hatalarını reddeder, eşleşen görev yolunu yoklar ve geçici sonuç URL'sini yazdırır. Her alan canlı OpenAPI sözleşmesinden gelir.

JavaScriptNode.js 18+
JavaScript · Node.js 18+
import { readFile } from 'node:fs/promises';

const apiUrl = 'https://faceswapai.com/api/v1/face-swap/image';
const headers = {
  Authorization: 'Bearer ' + process.env.FACESWAPAI_API_KEY,
};
const form = new FormData();
form.set('sourceImage', new Blob([await readFile('./source.jpg')]), 'source.jpg');
form.set('targetImage', new Blob([await readFile('./target.jpg')]), 'target.jpg');
form.set('consent', 'true');

const submitted = await fetch(apiUrl, { method: 'POST', headers, body: form });
if (!submitted.ok) throw new Error(submitted.status + ': ' + await submitted.text());
const { taskId } = await submitted.json();

let task;
do {
  await new Promise((resolve) => setTimeout(resolve, 2000));
  const polled = await fetch(apiUrl + '?taskId=' + encodeURIComponent(taskId), { headers });
  if (!polled.ok) throw new Error(polled.status + ': ' + await polled.text());
  task = await polled.json();
} while (task.status === 'PENDING' || task.status === 'PROCESSING');

console.log(task.status === 'COMPLETED' ? task.result?.url : task.result?.error);
Pythonrequests 2.x
Python · requests 2.x
import os
import time
import requests

api_url = "https://faceswapai.com/api/v1/face-swap/image"
headers = {"Authorization": "Bearer " + os.environ["FACESWAPAI_API_KEY"]}

with open("source.jpg", "rb") as source, open("target.jpg", "rb") as target:
    response = requests.post(
        api_url,
        headers=headers,
        files={"sourceImage": source, "targetImage": target},
        data={"consent": "true"},
        timeout=60,
    )
response.raise_for_status()
task_id = response.json()["taskId"]

while True:
    time.sleep(2)
    response = requests.get(api_url, headers=headers, params={"taskId": task_id}, timeout=30)
    response.raise_for_status()
    task = response.json()
    if task["status"] not in ("PENDING", "PROCESSING"):
        break

result = task.get("result") or {}
print(result.get("url") if task["status"] == "COMPLETED" else result.get("error"))

Gönder, ardından anket yap

Başarılı POST gerekli kredileri ayırır ve taskId döndürür. Durum PENDING veya PROCESSING iken aynı medya yolunu sorgulayın. COMPLETED, FAILED ve CANCELLED terminal durumlardır. Kuyruk veya sağlayıcı hatası bekleyen rezervasyonu tam olarak bir kez iade eder.

cURL
curl --get https://faceswapai.com/api/v1/face-swap/image \
  --header "Authorization: Bearer $FACESWAPAI_API_KEY" \
  --data-urlencode "taskId=YOUR_TASK_ID"
PENDING
Kabul edildi ve sıraya alındı
PROCESSING
Çalışıyor
COMPLETED
Sonuç mevcut
FAILED
Genel bir hatayla durduruldu
CANCELLED
İptal edildi

Formatlar ve sınırlar

Resimler, 30 MB'a kadar JPG, PNG, WebP, GIF, BMP, HEIC veya HEIF'i kabul eder. Video, 100 MB'a ve 600 saniyeye kadar MP4, MOV, WebM veya AVI'yi kabul eder. 100 MB, tipik bir 1080p telefon videosunun yaklaşık 1–2 dakikasına denk gelir; daha uzun klipleri sıkıştırın veya kısaltın. GIF hedefleri 30 MB ve 30 saniye ile sınırlıdır. Çoklu yüz girişlerinin her biri 15 MB ve seçilen on yüz ile sınırlıdır.

HTTP hataları ve yeniden denemeler

İsteği veya hesap durumunu değiştirmeden 400, 401, 402, 403 veya 413 yanıtlarını yeniden denemeyin. 429'dan geri çekilin. Bir gecikmeden sonra 500 veya 503 yeniden denenebilir; kredi rezervasyonları görev iadesi yolu tarafından korunur.

Mevcut üretim sınırları

Talep etmediği şeyler de dahil olmak üzere, bugün mevcut olan genel v1 sözleşmesine karşı plan yapın.

  • Medya görevleri eşzamansızdır ve yoklama kullanır. Mevcut genel v1 sözleşmesi bir web kancasını açığa çıkarmamaktadır.
  • Genel toplu iş yolu, kimlik anahtarı alanı, canlı kamera yolu, yayınlanmış SLA veya garantili tamamlanma süresi yoktur.
  • API anahtarları korumalı bir sunucuya aittir. Sonuçlar geçicidir, üretim kapasitesi kuyruğa bağlıdır ve kabul edilen arızalar belgelenmiş geri ödeme yolunu kullanır.

Onay, gizlilik ve filigran

Her nesil için onay=true gerekir; bu, yüklenen her yüzü kullanma izniniz olduğu anlamına gelir. Görev ortamı geçicidir. Ücretsiz deneme yoktur: her görev tek seferlik kredilerle ödenir ve hiçbir sonuç filigran veya hesap e-postası içermez.

Yüz Değiştirme API SSS

Ücretsiz bir Yüz Değiştirme API anahtarı var mı?

API anahtarı oluşturmak ücretsizdir. Üretim, hesap kredi bakiyesini kullanır. Ücretsiz deneme veya ücretsiz API katmanı yoktur: her görev tek seferlik kredilerle ödenir; 600 kredi $19,99'dan başlar.

API videoyu ve birden fazla yüzü destekliyor mu?

Evet. Sürümlendirilmiş rotalar görüntü, video, GIF ve çok yüzlü görüntü görevlerini kapsar. Video ve GIF fiyatlandırması, ölçülen medya meta verilerinden hesaplanır.

Bir sonucun hazır olduğunu nasıl anlarım?

POST yanıtından taskId değerini okuyun ve durum PENDING veya PROCESSING iken eşleşen GET yolunu sorgulayın. COMPLETED geçici sonuç URL’sini içerir; FAILED ve CANCELLED da terminal durumlardır.

API'yi doğrudan tarayıcıdan arayabilir miyim?

Tarayıcı kodundaki gizli anahtarı açığa çıkarmayın. İstekleri kendi sunucunuzdan, sunucusuz işlevinizden veya diğer korumalı arka uçtan gönderin.