Co robi API do zamiany twarzy
API do zamiany twarzy przyjmuje dwa obrazy i zwraca nowy. Obraz źródłowy pokazuje twarz, której chcesz użyć. Obraz docelowy to zdjęcie, które chcesz zmienić. API znajduje twarz na obrazie docelowym, zastępuje ją twarzą ze źródła i dopasowuje odcień skóry, światło i kąt, tak aby wynik wyglądał jak jedno zdjęcie.
Programiści używają go na przykład do spersonalizowanych kartek z życzeniami, kampanii typu „wstaw siebie na plakat”, narzędzi do awatarów i profili, postaci w grach oraz aplikacji fotobudek na wydarzeniach. Zamiast trenować i hostować własne modele, wysyłasz jedno żądanie HTTP i dostajesz obraz.
Zanim zaczniesz
Potrzebujesz trzech rzeczy:
- Konta Morfran. Nowe konta dostają 50 darmowych kredytów, co wystarcza na dziesięć pojedynczych zamian twarzy.
- Klucza API. Utwórz go w panelu w sekcji Klucze API. Trzymaj go na swoim serwerze i nigdy nie umieszczaj go w kodzie przeglądarki ani aplikacji mobilnej.
- Dwóch publicznych adresów URL obrazów. JPG, PNG lub WebP. Źródło powinno pokazywać jedną wyraźną twarz, zwróconą mniej więcej w stronę aparatu.
Każde żądanie wysyła klucz w nagłówku X-API-Key. Bazowy adres URL to https://api.morfran.com.
Twoja pierwsza zamiana twarzy z curl
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"}'
Domyślnie wywołanie jest synchroniczne: API czeka na wynik (do około 60 sekund) i zwraca odpowiedź JSON z linkiem do gotowego obrazu na cdn.morfran.com oraz liczbą użytych kredytów. Pobierz obraz od razu, bo wyniki są usuwane po godzinie.
To samo żądanie w JavaScript (Node.js)
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);
Uruchamiaj to na swoim serwerze, nie w przeglądarce, żeby twój klucz pozostał prywatny.
To samo żądanie w Pythonie
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())
Długie zadania: użyj trybu async
Jeśli twoja aplikacja nie powinna czekać na otwartym żądaniu, dodaj ?async=true do adresu URL. API od razu odpowiada identyfikatorem zadania. Następnie co kilka sekund odczytuj wynik przez GET /v1/face-swap/{taskId}, aż będzie gotowy. To dobrze działa za kolejką zadań albo wtedy, gdy twój serwer ma krótki limit czasu żądania.
Zdjęcia grupowe: zamień do ośmiu twarzy
Do zdjęcia zespołu lub rodziny użyj POST /v1/face-swap/group. Zmienia do ośmiu twarzy w jednym wywołaniu; MaxFaces ustala limit. Grupowa zamiana twarzy kosztuje 10 kredytów, pojedyncza 5 kredytów. Pełna lista pól znajduje się w dokumentacji API i w schemacie OpenAPI.
Obsługa błędów i kredytów
- 401: brak klucza API lub klucz jest błędny. Sprawdź nagłówek
X-API-Key. - 402: za mało kredytów. Kup pakiet kredytów w panelu.
- 422: nie znaleziono twarzy. Poproś użytkownika o wyraźniejsze zdjęcie z jedną twarzą.
Nieudane żądania nie są rozliczane. Kredyty są pobierane tylko za gotowe obrazy, więc ponowna próba po błędzie 422 nie kosztuje podwójnie. Saldo możesz w każdej chwili sprawdzić przez GET /v1/credits/balance, co jest bezpłatne.
Wskazówki dla lepszych wyników
- Użyj wyraźnej twarzy źródłowej. Jedna osoba, przodem do aparatu, otwarte oczy, bez okularów przeciwsłonecznych, dobre światło.
- Dopasuj kąt. Twarz patrząca prosto przed siebie najlepiej wtapia się w obraz docelowy, na którym osoba też patrzy mniej więcej w aparat.
- Twarze muszą być wystarczająco duże. Twarzy, która na obrazie docelowym ma szerokość zaledwie kilku pikseli, nie da się dobrze zamienić.
- Podobne światło pomaga. Twarz sfotografowana w świetle dziennym wygląda najbardziej naturalnie na zdjęciu docelowym zrobionym w świetle dziennym.
- Testuj na prawdziwych obrazach. Wykorzystaj kilka darmowych kredytów na zdjęcia podobne do tych, które będą przesyłać twoi użytkownicy.
Zgoda i prywatność
Zamieniaj tylko twarz osoby, która się na to zgodziła. Nie używaj zamiany twarzy do wprowadzania ludzi w błąd, podszywania się pod kogoś ani tworzenia treści, które szkodzą prawdziwej osobie. Jeśli publikujesz wyniki, oznacz je jako wygenerowane przez AI. Przesłane obrazy i wyniki są usuwane z naszego magazynu w ciągu godziny i nie używamy ich do trenowania modeli AI. Nadużycia można zgłaszać przez stronę kontaktową; są rozpatrywane w ciągu 48 godzin.
Użycie z agenta AI
Ta sama zamiana twarzy jest dostępna na serwerze MCP Morfran pod adresem https://api.morfran.com/mcp, więc asystenci tacy jak Claude mogą ją wywołać z twoim kluczem API. Konfigurację opisuje sekcja MCP w dokumentacji.
Pytania
Ile kosztuje API do zamiany twarzy?
Pojedyncza zamiana twarzy kosztuje 5 kredytów, a grupowa zamiana twarzy (do ośmiu twarzy) kosztuje 10 kredytów. Nowe konta dostają 50 darmowych kredytów. Potem kupujesz pakiety kredytów; nie ma subskrypcji. Pakiety znajdziesz w cenniku.
Ile trwa zamiana twarzy?
Większość wyników wraca w czasie synchronicznego oczekiwania wynoszącego około 60 sekund. Przy długich zadaniach lub krótkich limitach czasu serwera użyj ?async=true i odczytaj wynik za pomocą identyfikatora zadania.
Czy mogę wysyłać obrazy jako base64 zamiast adresów URL?
Przykłady tutaj używają publicznych adresów URL, bo to najprostszy sposób. Schemat OpenAPI wymienia wszystkie pola wejściowe, które akceptuje ten endpoint.
Jak długo są przechowywane wyniki?
Przesłane obrazy i wyniki są usuwane w ciągu godziny. Zapisz obraz wynikowy u siebie zaraz po jego otrzymaniu.
Czy mogę to wypróbować bez pisania kodu?
Tak. Zaloguj się i otwórz Playground. Uruchamia on tę samą zamianę twarzy w przeglądarce i pokazuje odpowiadające jej żądanie API.