Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
Aucune image pour le moment. Envoyez le formulaire pour générer une image.
Explorez différents cas d'utilisation et configurations de paramètres
Tarifs transparents sans frais cachés. Payez à l'utilisation.
| Règle & Modalité | Channel | Crédits | Prix (USD) | Prix officiel / référence | Économie quotidienne |
|---|---|---|---|---|---|
image-face-swap imageapipass | Regular | 5per run | $0.023 | - | - |
Guide complet d'utilisation de image-face-swap
Intégrez à votre application un échange de visages par IA prêt pour la production avec un seul appel API.
L’API Image Face Swap sur ApiPass vous permet de remplacer automatiquement des visages dans des photos avec une précision saisissante et réaliste. Grâce à des algorithmes avancés de reconnaissance faciale, d’alignement et de fusion, l’API accepte une image de base et une image de visage de référence, puis renvoie un résultat propre, sans filigrane, qui préserve l’éclairage, la pose et l’expression de la photo d’origine. Que vous développiez des outils pour les réseaux sociaux, des plateformes de contenu créatif, des applications photo ou des produits de divertissement, l’API fournit des échanges de visages fluides à grande échelle — sans démarrage à froid, avec un débit constant et une intégration REST simple.
Chaque requête nécessite face_image et image. face_image fournit la source d’identité, tandis que image est la photo cible dont le visage détecté doit être remplacé.
target_index choisit le visage détecté dans l’image cible à remplacer. Sa valeur par défaut est 0, il accepte les chaînes d’entiers et doit être non négatif.
Qu’il s’agisse de corriger des yeux fermés dans des portraits de groupe, de créer des portraits professionnels, de générer des mèmes, des changements de genre, des transformations de célébrités ou des superpositions picturales, l’API est suffisamment flexible pour alimenter un large éventail d’applications créatives et commerciales.
Le modèle adapte automatiquement le teint, la direction de l’éclairage et la cohérence des ombres entre les visages source et cible, produisant des résultats naturels et parfaitement intégrés plutôt que simplement composités — sans retouche manuelle nécessaire.
L’inclinaison de la tête, la direction du regard et l’expression faciale du sujet d’origine sont conservées tout au long de l’échange, de sorte que le résultat final reste crédible et fidèle au contexte de la photo de base.
Lorsqu’une photo contient plusieurs personnes, utilisez le paramètre target_index pour indiquer précisément quel visage échanger — premier visage, deuxième visage, troisième, et ainsi de suite. Aucune approximation, aucune surprise, seulement des résultats cohérents et prévisibles à chaque fois.
Chaque réponse renvoie une image JPEG, PNG ou WEBP sans filigrane, prête à être utilisée immédiatement dans des applications grand public, des supports marketing ou des flux de travail de conception visuelle, avec un encodage Base64 optionnel et un mode synchrone disponibles via les paramètres API.
Le flux d’intégration correspond aux autres modèles d’images asynchrones adossés à APIPASS sur ApiPass.
Choisissez apipass/image-face-swap comme modèle et préparez l’entrée avec face_image, image, target_index optionnel, output_format optionnel et enable_base64_output optionnel.
Envoyez le payload à l’endpoint ApiPass /api/v1/jobs/createTask. L’adaptateur réécrit le nom du modèle en apipass/image-face-swap et soumet le payload normalisé à APIPASS.
Suivez l’exécution de la tâche via /api/v1/jobs/recordInfo ou configurez callBackUrl pour recevoir des notifications asynchrones de fin de traitement.
Une fois la tâche réussie, lisez les URL des images avec échange de visage depuis resultJson.resultUrls dans l’objet de réponse de la tâche.
Ces recommandations suivent les garde-fous de l’adaptateur et le contrat de paramètres APIPASS actuel.
Choisissez une face_image avec un visage visible, non obstrué et une résolution suffisante pour les détails d’identité. Évitez le flou important, les angles extrêmes et les fortes occultations.
Lorsque l’image cible contient plusieurs visages, définissez explicitement target_index afin que le remplacement demandé reste stable lors des nouvelles tentatives.
Conservez enable_sync_mode défini sur false. ApiPass utilise un système asynchrone de webhook/callback et gère l’ID de tâche en interne pour traiter l’interrogation du statut et les résultats.
Créez des variantes de portraits approuvées pour des avatars, des images de profil, des maquettes de campagne ou des tests visuels internes lorsque vous disposez du consentement des personnes représentées.
Prévisualisez des concepts de personnages, de costumes ou de scènes en combinant une source d’identité sélectionnée avec une composition cible.
Permettez aux clients de se voir avec des produits en échangeant leurs visages sur des images de mannequins professionnels, ce qui renforce considérablement la confiance d’achat et réduit les taux de retour.
Le document utilise apipass/image-face-swap car il s’agit de la valeur SUPPORT_MODEL actuelle utilisée par la base de code et le script d’exemple.
Le readme et les sections API expliquent qu’ApiPass transmet apipass/image-face-swap à l’endpoint apipass/image-face-swap d’ApiPass, conformément à get_provider_model_name.
Le JSON documente la même validation que celle implémentée dans l’adaptateur pour face_image, image, target_index, output_format, enable_base64_output et enable_sync_mode.
Toutes les API nécessitent une authentification via un token Bearer.
Authorization: Bearer
Créez une nouvelle tâche Image Face Swap via l’API de tâches unifiée ApiPass
ApiPass conserve une enveloppe de requête publique stable. Les paramètres d’échange de visage sont transmis dans l’objet input et normalisés par l’adaptateur WaveSpeed.
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}modelRequisstringNom du modèle public ApiPass pour Image Face Swap.
"apipass/image-face-swap"
callBackUrlOptionnelstringURL de callback utilisateur facultative pour les notifications de fin de tâche ApiPass.
"https://your-domain.com/api/callback"
channelOptionnelstringVous pouvez spécifier le fournisseur correspondant au sein d’APIPASS via le paramètre channel ; ces fournisseurs prennent en charge les tâches réelles de génération d’images et de vidéos. APIPASS propose actuellement trois options de fournisseur :
La valeur par défaut du paramètre channel est auto. Lorsqu’il est activé, APIPASS répartit automatiquement les tâches entre les fournisseurs disponibles en fonction des tarifs en temps réel et des métriques de stabilité, afin d’équilibrer coût minimal et performances fiables. Conservez la valeur par défaut auto, sauf si vous avez des exigences de routage personnalisées.
Options disponibles :
auto
L’objet input contient les paramètres d’échange de visage acceptés par l’adaptateur WaveSpeed.
input.face_imageRequisstring | array<string>URL de l’image du visage source. Les requêtes API directes peuvent envoyer une chaîne ; l’outil de téléversement du Playground envoie un tableau à un seul élément et l’adaptateur utilise la première URL non vide.
"https://static.wavespeed.ai/examples/face.jpeg"
input.imageRequisstring | array<string>URL de l’image cible. Les requêtes API directes peuvent envoyer une chaîne ; l’outil de téléversement du Playground envoie un tableau à un seul élément et l’adaptateur utilise la première URL non vide.
"https://static.wavespeed.ai/examples/source.jpeg"
input.target_indexOptionnelnumberIndex basé sur zéro du visage cible à remplacer. La valeur par défaut est 0. L’adaptateur accepte les chaînes représentant des entiers, comme "2", et rejette les valeurs négatives.
0
input.output_formatOptionnelstringFormat de sortie facultatif. L’adaptateur exige une chaîne non vide lorsque ce champ est présent et normalise jpg en jpeg.
Options disponibles :
"jpeg"
input.enable_base64_outputOptionnelbooleanIndique s’il faut demander une sortie base64 à WaveSpeed. La valeur par défaut est false. ApiPass convertit les sorties réussies en resultJson.resultUrls.
false
input.enable_sync_modeOptionnelbooleanAccepté pour la compatibilité avec le fournisseur, mais l’adaptateur WaveSpeed force cette valeur à false car ApiPass soumet les tâches en mode webhook.
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}codeCode d’état. 200 indique que la tâche ApiPass a été créée avec succès.
messageMessage de réponse renvoyé par ApiPass.
data.taskIdIdentifiant de tâche utilisé pour les vérifications d’état ultérieures. En interne, l’adaptateur stocke l’ID de requête WaveSpeed comme ID de tâche du fournisseur.
flux
flux
Generate photorealistic images with robust text
À partir de
0 crédits
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.
À partir de
0 crédits
OpenAI
OpenAI
Generate intentionally designed visuals with less prompting using the latest OpenAI GPT Image 2 model.
À partir de
0 crédits
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.
À partir de
0 crédits
apipass
apipass
Seamlessly remove watermarks, logos, and unwanted text from your images at scale with our powerful AI-driven API.
À partir de
0 crédits
seedream
seedream
À partir de
0 crédits
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.
À partir de
0 crédits
seedream
seedream
À partir de
0 crédits
OpenAI
OpenAI
Bring your ideas to life with sharper, faster, more precise image generation using the GPT Image 2.5 API.
À partir de
0 crédits
Luma
Luma
À partir de
0 crédits
seedream
seedream
À partir de
0 crédits