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.
- 1Anahtarı bir kez oluşturup kopyalayın
- 2Yerel medyayı izin=true ile gönder
- 3Durum PENDING veya PROCESSING iken sorgulayın
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öntem | Uç nokta | Amaç | Kredi formülü |
|---|---|---|---|
| POST | /api/v1/face-swap/image | Görüntünün yüzünü değiştirme | 6 |
| POST | /api/v1/face-swap/video | Videoda yüz değiştirme | max(9, 3 × ceil(serverMeasuredInputSeconds)) |
| POST | /api/v1/face-swap/gif | GIF yüz değiştirme | max(9, 3 × ceil(serverMeasuredInputSeconds)) |
| POST | /api/v1/face-swap/multiple | Çok yüzlü resim değiştirme | 6 × selectedTargetFaces |
| GET | /api/v1/tasks | Görev geçmişi | 0 |
Çalışılan kredi örnekleri
66 kredimax(9, 3 × ceil(4))12 kredimax(9, 3 × ceil(8))24 kredimax(9, 3 × ceil(18))54 krediUç 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.
/api/v1/face-swap/imageGö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
/api/v1/face-swap/videoVideoda 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
/api/v1/face-swap/gifGIF 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
/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
/api/v1/tasksGö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.
Authorization: Bearer YOUR_API_KEYJavaScript 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+
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
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 --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.