Yüz değiştirme API'si ne yapar
Yüz değiştirme API'si iki görsel alır ve yeni bir görsel döndürür. Kaynak görsel, kullanmak istediğin yüzü gösterir. Hedef görsel, değiştirmek istediğin fotoğraftır. API hedefteki yüzü bulur, kaynaktaki yüzle değiştirir ve sonuç tek bir fotoğraf gibi görünsün diye ten rengini, ışığı ve açıyı uyumlu hale getirir.
Geliştiriciler bunu kişiye özel tebrik kartları, "kendini afişe koy" kampanyaları, avatar ve profil araçları, oyun karakterleri ve etkinliklerdeki fotoğraf kabini uygulamaları gibi işler için kullanır. Kendi modellerini eğitip barındırmak yerine tek bir HTTP isteği gönderir, karşılığında bir görsel alırsın.
Başlamadan önce
Üç şeye ihtiyacın var:
- Bir Morfran hesabı. Yeni hesaplar 50 ücretsiz kredi alır; bu, on tekli yüz değiştirmeye yeter.
- Bir API anahtarı. Panelinde API anahtarları bölümünden oluştur. Anahtarı sunucunda tut, tarayıcı ya da mobil uygulama koduna asla koyma.
- Herkese açık iki görsel URL'si. JPG, PNG ya da WebP. Kaynakta, kameraya aşağı yukarı bakan tek ve net bir yüz olmalı.
Her istek anahtarı X-API-Key başlığında gönderir. Temel URL https://api.morfran.com.
curl ile ilk yüz değiştirmen
curl -X POST https://api.morfran.com/v1/face-swap \
-H "X-API-Key: $MORFRAN_KEY" \
-H "Content-Type: application/json" \
-d '{"SourceImageUrl":"https://example.com/face.jpg","TargetImageUrl":"https://example.com/photo.jpg"}'
Varsayılan olarak çağrı senkrondur: API sonucu bekler (yaklaşık 60 saniyeye kadar) ve cdn.morfran.com üzerindeki hazır görselin bağlantısını ve kullanılan krediyi içeren bir JSON yanıtı döndürür. Görseli hemen indir, çünkü sonuçlar bir saat sonra silinir.
Aynı istek JavaScript (Node.js) ile
const res = await fetch("https://api.morfran.com/v1/face-swap", {
method: "POST",
headers: {
"X-API-Key": process.env.MORFRAN_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
SourceImageUrl: "https://example.com/face.jpg",
TargetImageUrl: "https://example.com/photo.jpg",
}),
});
const data = await res.json();
console.log(res.status, data);
Anahtarın gizli kalsın diye bunu tarayıcıda değil, sunucunda çalıştır.
Aynı istek Python ile
import os
import requests
res = requests.post(
"https://api.morfran.com/v1/face-swap",
headers={"X-API-Key": os.environ["MORFRAN_KEY"]},
json={
"SourceImageUrl": "https://example.com/face.jpg",
"TargetImageUrl": "https://example.com/photo.jpg",
},
timeout=90,
)
print(res.status_code, res.json())
Uzun işler: async modu kullan
Uygulaman açık bir istekte beklememeliyse URL'ye ?async=true ekle. API hemen bir görev kimliğiyle (task id) yanıt verir. Ardından iş bitene kadar birkaç saniyede bir GET /v1/face-swap/{taskId} ile sonucu oku. Bu yöntem bir iş kuyruğunun arkasında ya da kendi sunucunun istek zaman aşımı kısaysa iyi çalışır.
Grup fotoğrafları: sekiz yüze kadar değiştir
Ekip ya da aile fotoğrafı için POST /v1/face-swap/group kullan. Tek çağrıda sekiz yüze kadar değiştirir; sınırı MaxFaces belirler. Grup yüz değiştirme 10 kredi, tekli yüz değiştirme 5 kredi tutar. Alanların tam listesi API dokümantasyonunda ve OpenAPI şemasında var.
Hataları ve kredileri yönet
- 401: API anahtarı eksik ya da yanlış.
X-API-Keybaşlığını kontrol et. - 402: kredi yetersiz. Panelinden bir kredi paketi satın al.
- 422: yüz bulunamadı. Kullanıcıdan tek yüzün olduğu daha net bir fotoğraf iste.
Başarısız istekler ücretlendirilmez. Kredi yalnızca hazır görseller için düşülür, yani 422'den sonra tekrar denemek iki kez ücret çıkarmaz. Bakiyeni istediğin zaman GET /v1/credits/balance ile okuyabilirsin; bu çağrı ücretsizdir.
Daha iyi sonuçlar için ipuçları
- Net bir kaynak yüz kullan. Tek kişi, kameraya dönük, gözler açık, güneş gözlüğü yok, iyi ışık.
- Açıyı eşleştir. Düz karşıya bakan bir yüz, kişinin de aşağı yukarı kameraya baktığı bir hedefe en iyi uyar.
- Yüzler yeterince büyük olsun. Hedefte yalnızca birkaç piksel genişliğindeki bir yüz iyi değiştirilemez.
- Benzer ışık işe yarar. Gün ışığında çekilmiş bir yüz, gün ışığında çekilmiş bir hedef fotoğrafta en doğal görünür.
- Gerçek görsellerinle dene. Ücretsiz kredilerin birkaçını kullanıcılarının yükleyeceklerine benzeyen fotoğraflarda harca.
İzin ve gizlilik
Yalnızca buna onay vermiş birinin yüzünü değiştir. Yüz değiştirmeyi insanları kandırmak, birinin kimliğine bürünmek ya da gerçek bir kişiye zarar veren içerik üretmek için kullanma. Sonuçları yayınlıyorsan yapay zeka ile üretildiklerini belirt. Yüklenen görseller ve sonuçlar bir saat içinde depolamamızdan silinir ve bunları yapay zeka modeli eğitmek için kullanmayız. Kötüye kullanımı iletişim sayfasından bildirebilirsin; 48 saat içinde ele alınır.
Bir yapay zeka ajanından kullan
Aynı yüz değiştirme, Morfran'ın https://api.morfran.com/mcp adresindeki MCP sunucusunda da var; böylece Claude gibi asistanlar onu senin API anahtarınla çağırabilir. Kurulum dokümantasyonun MCP bölümünde anlatılıyor.
Sorular
Yüz değiştirme API'si ne kadar tutar?
Tekli yüz değiştirme 5 kredi, grup yüz değiştirme (sekiz yüze kadar) 10 kredi tutar. Yeni hesaplar 50 ücretsiz kredi alır. Sonrasında kredi paketi satın alırsın; abonelik yok. Paketler için fiyatlar sayfasına bak.
Yüz değiştirme ne kadar sürer?
Sonuçların çoğu yaklaşık 60 saniyelik senkron bekleme içinde gelir. Uzun işler ya da kısa sunucu zaman aşımları için ?async=true kullan ve sonucu görev kimliğiyle oku.
Görselleri URL yerine base64 olarak gönderebilir miyim?
Buradaki örnekler herkese açık URL kullanıyor; en basit yol bu. OpenAPI şeması, endpoint'in kabul ettiği bütün girdi alanlarını listeler.
Sonuçlar ne kadar süre saklanır?
Yüklenen görseller ve sonuçlar bir saat içinde silinir. Sonuç görselini alır almaz kendi tarafında kaydet.
Kod yazmadan deneyebilir miyim?
Evet. Giriş yap ve Deneme alanını aç. Aynı yüz değiştirmeyi tarayıcıda çalıştırır ve karşılık gelen API isteğini gösterir.