Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
Noch kein Bild. Senden Sie das Formular ab, um ein Bild zu generieren.
Entdecken Sie verschiedene Anwendungsfälle und Parameterkonfigurationen
Transparente Preisgestaltung ohne versteckte Gebühren. Bezahlen Sie nach Verbrauch.
| Regel & Modalität | Channel | Guthaben | Preis (USD) | Offizieller / Referenzpreis | Tägliche Ersparnis |
|---|---|---|---|---|---|
image-face-swap imageapipass | Regular | 5per run | $0.023 | - | - |
Vollständige Anleitung zur Verwendung von image-face-swap
Integrieren Sie produktionsreifen KI-Gesichtstausch mit einem einzigen API-Aufruf in Ihre App.
Die Image Face Swap API auf ApiPass ermöglicht es Ihnen, Gesichter in Fotos programmgesteuert mit beeindruckender, lebensechter Genauigkeit zu ersetzen. Unterstützt durch fortschrittliche Algorithmen für Gesichtserkennung, Ausrichtung und Überblendung akzeptiert die API ein Basisbild und ein Referenz-Gesichtsbild und liefert anschließend ein sauberes, wasserzeichenfreies Ergebnis, das Beleuchtung, Pose und Ausdruck des Originalfotos bewahrt. Ob Sie Social-Media-Tools, kreative Content-Plattformen, Foto-Apps oder Entertainment-Produkte entwickeln: Die API liefert nahtlose Face Swaps in großem Umfang — ohne Cold Starts, mit konstantem Durchsatz und unkomplizierter REST-Integration.
Jede Anfrage erfordert face_image und image. face_image liefert die Identitätsquelle, während image das Zielfoto ist, dessen erkanntes Gesicht ersetzt werden soll.
target_index legt fest, welches erkannte Gesicht im Zielbild ersetzt werden soll. Der Standardwert ist 0, es werden Integer-Strings akzeptiert, und der Wert muss nicht negativ sein.
Vom Korrigieren geschlossener Augen in Gruppenporträts und dem Erstellen professioneller Headshots bis hin zur Generierung von Memes, Gender Swaps, Celebrity-Transformationen und Malerei-Overlays — die API ist flexibel genug, um eine breite Palette kreativer und kommerzieller Anwendungen zu unterstützen.
Das Modell passt Hautton, Lichtrichtung und Schattenkonsistenz zwischen Quell- und Zielgesicht automatisch an und erzeugt Ergebnisse, die natürlich und vollständig integriert wirken statt zusammengesetzt — ohne manuelle Retusche.
Kopfneigung, Blickrichtung und Gesichtsausdruck der ursprünglichen Person bleiben während des gesamten Tauschs erhalten, sodass das Endergebnis glaubwürdig bleibt und zum Kontext des Basisfotos passt.
Wenn ein Foto mehr als eine Person enthält, verwenden Sie den Parameter target_index, um genau festzulegen, welches Gesicht getauscht werden soll — erstes Gesicht, zweites Gesicht, drittes und so weiter. Kein Rätselraten, keine Überraschungen, sondern jedes Mal konsistente und vorhersehbare Ergebnisse.
Jede Antwort liefert ein wasserzeichenfreies JPEG-, PNG- oder WEBP-Bild, das sofort in Verbraucher-Apps, Marketingmaterialien oder visuellen Design-Workflows verwendet werden kann; optionale Base64-Codierung und synchroner Modus sind über API-Parameter verfügbar.
Der Integrationsablauf entspricht anderen von APIPASS unterstützten asynchronen Bildmodellen auf ApiPass.
Wählen Sie apipass/image-face-swap als Modell und bereiten Sie die Eingabe mit face_image, image, optionalem target_index, optionalem output_format und optionalem enable_base64_output vor.
Senden Sie den Payload an den ApiPass-Endpunkt /api/v1/jobs/createTask. Der Adapter schreibt den Modellnamen in apipass/image-face-swap um und übermittelt den normalisierten Payload an APIPASS.
Verfolgen Sie die Aufgabenausführung über /api/v1/jobs/recordInfo oder konfigurieren Sie callBackUrl, um asynchrone Benachrichtigungen bei Abschluss zu erhalten.
Nachdem die Aufgabe erfolgreich abgeschlossen wurde, lesen Sie die URLs der per Face Swap erzeugten Bilder aus resultJson.resultUrls im Antwortobjekt der Aufgabe.
Diese Empfehlungen folgen den Schutzmechanismen des Adapters und dem aktuellen APIPASS-Parametervertrag.
Wählen Sie ein face_image mit einem sichtbaren, unverdeckten Gesicht und ausreichender Auflösung für Identitätsdetails. Vermeiden Sie starke Unschärfe, extreme Winkel und deutliche Verdeckungen.
Wenn das Zielbild mehr als ein Gesicht enthält, setzen Sie target_index explizit, damit die angeforderte Ersetzung bei erneuten Versuchen stabil bleibt.
Lassen Sie enable_sync_mode auf false gesetzt. ApiPass nutzt ein asynchrones Webhook-/Callback-System und verwaltet die Aufgaben-ID intern, um Statusabfragen und Ergebnisse zu verarbeiten.
Erstellen Sie freigegebene Porträtvarianten für Avatare, Profilbilder, Kampagnen-Mockups oder interne visuelle Tests, wenn Sie die Zustimmung der dargestellten Personen haben.
Erstellen Sie Vorschauen für Charakter-, Kostüm- oder Szenenkonzepte, indem Sie eine ausgewählte Identitätsquelle mit einer Zielkomposition kombinieren.
Ermöglichen Sie Kunden, sich selbst in Produkten zu sehen, indem ihre Gesichter auf professionelle Modelbilder getauscht werden, was das Kaufvertrauen deutlich erhöht und Retourenquoten senkt.
Das Dokument verwendet apipass/image-face-swap, da dies der aktuelle SUPPORT_MODEL-Wert ist, der von der Codebasis und dem Beispielskript verwendet wird.
Die Readme- und API-Abschnitte erklären, dass ApiPass apipass/image-face-swap an den apipass/image-face-swap-Endpunkt von ApiPass weiterleitet, passend zu get_provider_model_name.
Das JSON dokumentiert dieselbe Validierung, die im Adapter für face_image, image, target_index, output_format, enable_base64_output und enable_sync_mode implementiert ist.
Alle APIs erfordern eine Authentifizierung über Bearer Token.
Authorization: Bearer
Erstellen Sie eine neue Image Face Swap-Aufgabe über die einheitliche Jobs-API von ApiPass
ApiPass hält den öffentlichen Anfrage-Umschlag stabil. Face-Swap-Parameter werden im input-Objekt übergeben und vom WaveSpeed-Adapter normalisiert.
1{
2 "model": "apipass/image-face-swap",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "face_image": "https://example.com/face.jpeg",
6 "image": "https://example.com/target.jpeg",
7 "target_index": 0,
8 "output_format": "jpeg",
9 "enable_base64_output": false,
10 "enable_sync_mode": false
11 },
12 "channel": "auto"
13}modelErforderlichstringDer öffentliche ApiPass-Modellname für Image Face Swap.
"apipass/image-face-swap"
callBackUrlOptionalstringOptionale Benutzer-Callback-URL für Benachrichtigungen von ApiPass beim Abschluss der Aufgabe.
"https://your-domain.com/api/callback"
channelOptionalstringSie können den entsprechenden Provider innerhalb von APIPASS über den Parameter channel angeben; diese Provider übernehmen die eigentlichen Aufgaben zur Bild- und Videogenerierung. APIPASS bietet derzeit drei Provider-Optionen:
Der Standardwert für den Parameter channel ist auto. Wenn aktiviert, verteilt APIPASS Aufgaben automatisch auf verfügbare Provider basierend auf Echtzeit-Preis- und Stabilitätsmetriken, um minimale Kosten und zuverlässige Leistung auszubalancieren. Behalten Sie den Standardwert auto bei, sofern Sie keine benutzerdefinierten Routing-Anforderungen haben.
Verfügbare Optionen:
auto
Das input-Objekt enthält die Face-Swap-Parameter, die vom WaveSpeed-Adapter akzeptiert werden.
input.face_imageErforderlichstring | array<string>URL des Quell-Gesichtsbilds. Direkte API-Anfragen können einen String senden; der Playground-Uploader sendet ein Array mit einem einzelnen Element, und der Adapter verwendet die erste nicht leere URL.
"https://static.wavespeed.ai/examples/face.jpeg"
input.imageErforderlichstring | array<string>URL des Zielbilds. Direkte API-Anfragen können einen String senden; der Playground-Uploader sendet ein Array mit einem einzelnen Element, und der Adapter verwendet die erste nicht leere URL.
"https://static.wavespeed.ai/examples/source.jpeg"
input.target_indexOptionalnumberNullbasierter Index des zu ersetzenden Zielgesichts. Standardmäßig 0. Der Adapter akzeptiert Ganzzahl-Strings wie "2" und lehnt negative Werte ab.
0
input.output_formatOptionalstringOptionales Ausgabeformat. Der Adapter erfordert einen nicht leeren String, wenn dieses Feld vorhanden ist, und normalisiert jpg zu jpeg.
Verfügbare Optionen:
"jpeg"
input.enable_base64_outputOptionalbooleanGibt an, ob eine base64-Ausgabe von WaveSpeed angefordert werden soll. Standardmäßig false. ApiPass wandelt erfolgreiche Ausgaben in resultJson.resultUrls um.
false
input.enable_sync_modeOptionalbooleanWird aus Gründen der Provider-Kompatibilität akzeptiert, aber der WaveSpeed-Adapter setzt diesen Wert zwangsweise auf false, da ApiPass Aufgaben im Webhook-Modus sendet.
false
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "apipass/image-face-swap",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "face_image": "https://static.wavespeed.ai/examples/0e20bb80259f4840ba394ec2e7f213be/1752459933783339486_bT840WSP.jpeg",
9 "image": "https://static.wavespeed.ai/examples/0e20bb80259f4840ba394ec2e7f213be/1752459923195240956_OHfc951Y.jpeg",
10 "target_index": 0,
11 "output_format": "jpeg",
12 "enable_base64_output": false,
13 "enable_sync_mode": false
14 }
15 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_image_face_swap_1767168190655"
6 }
7}codeStatuscode. 200 zeigt an, dass die ApiPass-Aufgabe erfolgreich erstellt wurde.
messageVon ApiPass zurückgegebene Antwortnachricht.
data.taskIdAufgabenkennung, die für spätere Statusabfragen verwendet wird. Intern speichert der Adapter die WaveSpeed-Anfrage-ID als Provider-Aufgaben-ID.
flux
flux
Generate photorealistic images with robust text
Ab
0 Credits
Nano Banana 2 Lite, aka Gemini 3.1 Flash-Lite Image, is a newly released image model from Google DeepMind built for fast 1K image generation, efficient creative iteration, prompt-based image editing, and responsive visual output in product-facing creative scenarios.
Ab
0 Credits
OpenAI
OpenAI
Generate intentionally designed visuals with less prompting using the latest OpenAI GPT Image 2 model.
Ab
0 Credits
Fast image generation model built on Gemini 3.1 Flash Image. Supports text-to-image, image editing, multi-image fusion with up to 14 reference images, Google Search grounding, and outputs up to 4K resolution.
Ab
0 Credits
apipass
apipass
Seamlessly remove watermarks, logos, and unwanted text from your images at scale with our powerful AI-driven API.
Ab
0 Credits
seedream
seedream
Ab
0 Credits
grok
grok
Grok Imagine is xAI’s AI video generation model for creating high-quality videos with realistic motion, native audio, and synchronized speech. Grok Imagine 1.5 introduces faster generation speeds, improved motion physics, and stronger visual consistency for modern AI video applications.
Ab
0 Credits
seedream
seedream
Ab
0 Credits
OpenAI
OpenAI
Bring your ideas to life with sharper, faster, more precise image generation using the GPT Image 2.5 API.
Ab
0 Credits
Luma
Luma
Ab
0 Credits
seedream
seedream
Ab
0 Credits