L'intégration est vraiment légère. Publiez une photo de référence vers une URL, interrogez une seconde URL jusqu'à ce que le statut bascule, lisez le lien de l'image dans la charge utile. Une heure de travail si vous avez déjà livré quelque chose d'asynchrone.
Puis quelqu'un demande combien coûte son exécution pour chaque nouvel employé, et l'après-midi disparaît. Une douzaine de points de terminaison d'image sur la même plateforme transforment chacun un portrait en photo de tête. Le moins cher coûte 0,028 $, et c'est un prix réduit. Le plus cher prend 0,229768 $ pour une seule image. La majeure partie de cet écart remonte aux paliers de résolution, aux indicateurs de qualité et à la promotion en cours, ce qui n'est pas la même chose qu'un écart dans la qualité du visage obtenu.
Voici une carte fonctionnelle de cette décision pour quiconque intègre une API de photo de tête IA dans un produit. Chaque prix, nom de champ et énumération ci-dessous provient des propres schémas d'Atlas Cloud et de son point de terminaison de tarification du 18 août 2026.
Points clés
- Une photo de tête n'est pas une catégorie de modèle en soi dans la couche API. C'est un appel d'édition d'image avec une intention fixe, donc le point de terminaison que vous choisissez détermine votre coût par utilisateur bien plus que le prompt.
- Le point de terminaison dédié aux photos de tête accepte exactement deux champs et renvoie une image. Les points de terminaison d'édition généraux acceptent une douzaine de champs et attendent que vous décriviez le résultat vous-même.
- Omettre le paramètre de taille dans un appel d'édition Seedream vous place silencieusement dans le palier de prix supérieur, ce qui double la facture sans aucune erreur à détecter.
- Tous les modèles de la plateforme partagent une même boucle de soumission et d'interrogation, donc changer de point de terminaison plus tard revient à modifier une chaîne de modèle plutôt qu'à réécrire.
- Vous pouvez confirmer le style de sortie avant d'écrire du code : le générateur de photo de tête IA gratuit offre à chaque compte éligible une exécution en pleine résolution.
Pourquoi les développeurs choisissent une API de photo de tête IA plutôt qu'un site de photo de tête
Les sites grand public de photo de tête sont construits autour d'une session. Vous téléchargez, vous attendez, vous téléchargez, et le quota se réinitialise le lendemain. Rien dans cette boucle ne survit au contact avec un produit qui doit intégrer quatre cents employés ce trimestre et réconcilier la dépense contre un centre de coût.
Ce qu'une API apporte n'est pas vraiment la génération. C'est la comptabilité qui l'entoure. Chaque soumission renvoie un identifiant et un statut que vous pouvez interroger, ce qui fait la différence entre une facture que vous pouvez expliquer et une que vous ne pouvez pas.
Il y a un second avantage, plus discret. Les points de terminaison d'outils publient leurs schémas, vous pouvez donc lire toute la surface d'entrée avant de vous engager sur l'un d'eux. Atlas Cloud expose une famille de ces outils d'image à usage unique, et leurs formes de requête sont presque identiques :
| Point de terminaison d'outil | Champs requis | Champs optionnels | Prix par image |
|---|---|---|---|
| atlascloud/tool/headshot | model, image | aucun | 0,045 $ |
| atlascloud/photo-cleanup | model, image | output_format | 0,02 $ |
| atlascloud/image-upscaler | model, image | outscale, output_format | 0,01 $ |
L'entrée photo de tête est la plus stricte des trois : une photo entrante, une photo sortante.
Où se situe Atlas Cloud pour les développeurs qui construisent des fonctionnalités de photo de tête
Il vaut la peine de voir ce que le modèle renvoie réellement avant d'écrire du code d'intégration, car le style de sortie est fixe et vous le voulez ou non. Atlas Cloud conserve ses outils à usage unique sur une seule page, et l'index des outils IA est l'endroit où se trouve le générateur de photo de tête aux côtés de la mise à l'échelle et du nettoyage. La page de l'outil indique que chaque utilisateur éligible bénéficie d'un essai gratuit, et sa FAQ ajoute que la génération gratuite inclut un téléchargement complet en haute résolution.
Passé ce premier essai, le même modèle devient un terrain de jeu facturé. Le bac à sable de photo de tête IA affiche son prix sur le bouton Exécuter avant que vous ne soumettiez, et un avis au-dessus du chargeur explique que les actifs vont vers le stockage Atlas Cloud plutôt que d'être extraits d'un lien que vous collez. Si vous préférez écrire le prompt vous-même et contrôler la tenue, l'arrière-plan et le cadrage, la famille Nano Banana 2 couvre la voie d'édition générale, et sa variante Lite se trouve être moins chère par image que l'outil fixe. La section sur la tarification détaille ce que ce compromis coûte.
Deux façons d'appeler l'API de générateur de photo de tête IA
Les deux chemins utilisent la même chaîne de modèle. La différence est qu'une personne regarde ou non le résultat revenir.
Méthode 1 : Tester l'API de photo de tête professionnelle dans le bac à sable
Connectez-vous, ouvrez le bac à sable lié ci-dessus, et téléchargez un portrait frontal clair. La description du schéma pour le champ d'entrée est exactement cette phrase, donc le modèle est réglé pour un plan de face plutôt qu'un profil trois quarts ou un recadrage de groupe.
Le bouton Exécuter porte le coût de l'exécution que vous allez effectuer, et c'est le nombre à budgéter. La page marketing n'affiche aucun prix, donc le bac à sable est l'endroit où se trouve le chiffre. Un décalage utile à connaître pendant que vous y êtes : le texte de la page de l'outil mentionne le choix entre tenue professionnelle, décontractée chic et un look studio simple, mais le schéma publié n'a pas de champ de style. Quoi que suggère le texte, le point de terminaison renvoie le traitement professionnel par défaut du modèle.
Méthode 2 : Appeler l'API de photo de tête IA depuis votre propre code
Le flux d'exécution est constitué de deux requêtes HTTP. Y arriver nécessite trois étapes.
Étape 1 : Créer une clé API. Générez-en une dans la console Atlas Cloud, copiez-la et conservez-la côté serveur. Les points de terminaison d'outils prennent la même clé que tous les modèles de la plateforme.
Étape 2 : Consulter la documentation API. L'authentification, le point de terminaison d'image partagé et le contrat d'interrogation se trouvent dans la documentation API. Chaque modèle publie également son propre schéma OpenAPI, et celui-ci est atlascloud-tool-headshot.json, à lire avant de deviner les noms de champs. La page du modèle comporte également un onglet API à côté du bac à sable, donc la forme de la requête est à un clic de l'endroit où vous l'avez testée. Une chose qui m'a coûté du temps ici : la liste publique des modèles de la plateforme renvoyait 466 entrées lorsque j'ai vérifié et l'outil de photo de tête n'y figurait pas, même si ses outils frères pour la mise à l'échelle et le nettoyage de photos y étaient. Le schéma, le readme et la tarification se résolvent normalement, donc le point de terminaison est actif. La seule recherche dans le catalogue ne le fera pas apparaître.
Étape 3 : Envoyer la première requête. La soumission est asynchrone et renvoie un identifiant de prédiction.
Bash1curl -X POST https://api.atlascloud.ai/api/v1/model/generateImage \ 2 -H "Content-Type: application/json" \ 3 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \ 4 -d '{ 5 "model": "atlascloud/tool/headshot", 6 "image": "https://your-cdn.com/portraits/emp-4192.jpg" 7 }'
Interrogez jusqu'à ce que le statut se stabilise :
Bash1curl -s https://api.atlascloud.ai/api/v1/model/prediction/<PREDICTION_ID> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
La charge utile terminée contient outputs, un tableau qui reste vide jusqu'à la fin du travail puis contient l'URL de l'image hébergée. status est votre condition de boucle et prend les valeurs created, processing, completed ou failed.
Testez une chose sur ce premier appel plutôt que de supposer. Le schéma type image comme une référence d'image sans dire où le fichier peut résider, et le bac à sable est franc sur son propre côté de cette question. L'avis vert au-dessus de son chargeur indique « URLs non acceptées : les images et vidéos doivent être soumises via des champs de téléchargement dédiés. » Les modèles d'édition frères documentent leurs entrées comme des URL. Confirmez quelle forme votre clé prend avant de câbler un travail par lots autour d'elle.
Cette forme de requête est la partie à internaliser. La même clé, le même POST et le même appel d'interrogation atteignent tous les modèles d'image de la plateforme, donc passer de l'outil fixe de photo de tête à un éditeur entièrement promptable plus tard signifie modifier la chaîne de modèle et ajouter les champs que ce modèle accepte. Rien d'autre dans votre travailleur ne change.
Tarification de l'API de photo de tête IA par image générée
Chaque chiffre ci-dessous provient du point de terminaison de calcul de tarification de la plateforme le 18 août 2026, tarifé par rapport à la requête exacte que j'enverrais. Tous ont renvoyé un indicateur de réduction de 100, ce qui signifie qu'aucune promotion n'était en cours, à l'exception des deux variantes dans la sous-section suivante.
Le point de terminaison dédié aux photos de tête se situe à 0,045 $, ce qui place mille photos de tête générées à 45 $. Nano Banana 2 Lite Edit le sous-cote à 0,04 $, donc le même volume coûte 40 $, et son readme précise que le nombre d'images de référence en entrée n'affecte pas le prix. Économiser ces 5 $ par millier signifie écrire et maintenir votre propre prompt de photo de tête, ce qui est une vraie décision plutôt qu'une évidence.
Les valeurs par défaut sont là où l'argent fuit. Seedream v5.0 Pro Edit facture 0,045 $ à 1024×1024 ou 2048×1152, mais son paramètre de taille par défaut est 2048×2048, ce qui tombe dans le palier supérieur à 0,09 $. Omettez le champ et vous payez le double sans aucune erreur à détecter. Le même modèle ajoute 0,003 $ pour chaque image d'entrée au-delà de la première, ce qu'une requête à deux images confirme en facturant 0,048 $. GPT Image 2 Edit répète le motif sous un angle différent : la qualité par défaut est moyenne à 0,071728 $, et passer à haute amène une seule image 1024×1024 à 0,229768 $.
Les paliers de résolution sont la dernière variable. Nano Banana 2 Edit facture 0,08 $, 0,12 $ et 0,16 $ pour 1k, 2k et 4k, tandis que la variante Lite offre uniquement 1k. Pour une photo de profil qui finit affichée à quelques centaines de pixels, payer pour du 4k, c'est dépenser pour des pixels que personne ne verra.
Points de terminaison développeur avec réduction dans la gamme de l'API de photo de tête IA
Deux variantes portaient une réduction active le jour de la rédaction :
| Point de terminaison | Prix catalogue | Prix actuel | Réduction |
|---|---|---|---|
| google/nano-banana-2-lite/edit-developer | 0,04 $ | 0,028 $ | 30 % de réduction |
| google/nano-banana-2/edit-developer | 0,08 $ | 0,04 $ | 50 % de réduction |
Aucune page de modèle n'explique en quoi un point de terminaison développeur diffère du standard au-delà du prix, donc traitez le chiffre sans réduction comme le nombre durable lorsque vous construisez un modèle de coût. Ces indicateurs ont déjà bougé auparavant, et la façon honnête de vérifier est de tarifer votre requête exacte par rapport à la plateforme plutôt que de faire confiance à un chiffre d'un article, y compris celui-ci.
Ce que l'API de photo de tête IA change sur un visage
Le point de terminaison fixe est tranché. Son readme décrit le travail comme transformer un portrait décontracté en une photo de tête professionnelle de qualité studio, ce qui signifie en pratique que l'arrière-plan et les vêtements sont remplacés tandis que le visage est censé rester reconnaissable.
J'ai passé un portrait par les deux chemins pour voir où ils divergent.
Exécuté le 19 août 2026. L'entrée est une personne fictive générée par IA, pas une photographie de quelqu'un de réel.
Les deux sorties sont reconnaissables comme le même visage, et les deux ont fait le travail de mettre une personne en tenue professionnelle sur un fond uni. Les différences sont dans ce que personne n'a demandé. Le point de terminaison fixe a choisi un blazer gris clair sans rien en dessous, a décidé du recadrage et a laissé les longs cheveux ondulés tranquilles. Le point de terminaison d'édition a livré chaque élément nommé dans le prompt, le blazer charbon, la chemise blanche, le fond gris clair, le cadrage tête-épaules, puis est allé plus loin en raccourcissant les cheveux en une forme plus soignée et plus symétrique. Le prompt avait demandé que le visage reste inchangé et ne disait rien sur les cheveux.
Passer par la voie d'édition générale vous rend les décisions, au prix de devoir les énoncer. Comparez ce que chacun accepte :
| Champ | atlascloud/tool/headshot | google/nano-banana-2-lite/edit |
|---|---|---|
| prompt | absent | requis |
| image / images | une image, requis | 1 à 14 images, requis |
| aspect_ratio | absent | 15 valeurs incluant auto |
| résolution | absent | 1k uniquement |
| thinking_level | absent | default, high, minimal |
| enable_base64_output | absent | API uniquement, renvoie BASE64 au lieu d'une URL |
Deux choses à planifier. Le readme de la plateforme pour le palier Lite indique que le modèle peut avoir du mal avec les petits visages, l'orthographe précise et les très fins détails. L'entrée dans ce test a commencé comme un plan en pied où le visage occupait une petite part du cadre et est passée sans problème, donc l'avertissement n'est pas un plancher dur, mais un recadrage de photo de groupe est le cas le plus difficile et mérite d'être filtré. Le même readme indique que les images éditées incluent des informations d'identification de contenu C2PA et un filigrane SynthID imperceptible par défaut. Cette signature voyage avec le fichier. LinkedIn affiche les informations d'identification de contenu sur toute image qui arrive avec des informations C2PA attachées, donc une photo de tête générée de cette manière peut atterrir sur un profil avec sa provenance affichée.
Ce qui est acceptable, tant que le visage est le bon. Les directives de photo de profil de LinkedIn autorisent une illustration ou un rendu artistique de vous-même, à condition que la photo reflète votre ressemblance. Une photo de tête IA passe ce test. Un visage généré qui n'est pas celui de l'utilisateur ne le fait pas.
Exécuter une API de photo de tête IA en production
Quelques points à décider avant de livrer plutôt qu'après.
| Préoccupation | Ce que la plateforme vous donne | Valeur par défaut raisonnable |
|---|---|---|
| Achèvement du travail | Un statut à quatre états sur chaque prédiction | Interroger avec backoff, traiter échec comme réessayable une fois |
| Latence | Aucun chiffre de temps d'achèvement dans le schéma | Mettre en file d'attente, ne jamais bloquer le rendu d'une page dessus |
| Sauter l'interrogation | enable_sync_mode sur les modèles d'édition généraux, absent sur l'outil fixe | Utiliser le mode synchrone uniquement pour les requêtes interactives uniques |
| Gestion des sorties | Tableau outputs d'URL hébergées | Copier vers votre propre stockage à l'achèvement |
| Qualité d'entrée | Le schéma demande un portrait frontal clair, rien de plus spécifique | Filtrer les recadrages de groupe et les petits visages avant de dépenser un appel |
| Consentement | Note d'utilisation responsable demande l'autorisation pour les médias téléchargés | Capturer le consentement au moment du téléchargement, conserver l'enregistrement |
Cette dernière ligne est celle que les équipes oublient. La documentation du point de terminaison elle-même vous demande d'obtenir le consentement avant de modifier ou de générer la ressemblance d'une personne réelle, et d'éviter d'utiliser les résultats pour tromper, harceler ou usurper l'identité. Si votre fonctionnalité transforme automatiquement les photos des employés en photos de tête, l'étape de consentement appartient au flux de téléchargement plutôt que dans un document de politique que personne ne lit.
Foire aux questions
Existe-t-il une API de photo de tête IA pour développeurs avec un niveau gratuit ?
L'API elle-même est facturée dès le premier appel. L'exécution gratuite se trouve sur la page de l'outil, où chaque compte éligible obtient une génération en pleine résolution. Utilisez-la pour confirmer le style de sortie, puis budgétez pour la tarification par image une fois que vous intégrez.
Quelle chaîne de modèle dois-je utiliser pour un appel d'API de photo de tête professionnelle ?
atlascloud/tool/headshot si vous voulez le traitement professionnel fixe sans avoir à maintenir un prompt. google/nano-banana-2-lite/edit si vous avez besoin de contrôle sur la tenue, l'arrière-plan ou le rapport d'aspect et êtes prêt à écrire l'instruction vous-même. Les deux publient sur /api/v1/model/generateImage.
Combien coûte une API de photo de tête IA par image ?
0,045 $ via le point de terminaison dédié au 18 août 2026, sans réduction active. Sur les douze points de terminaison que j'ai tarifés sur la même plateforme, une image éditée unique allait de 0,028 $ à 0,229768 $ selon le modèle, le palier de résolution et le réglage de qualité.
L'API de générateur de photo de tête IA conserve-t-elle le vrai visage de la personne ?
C'est le comportement énoncé : l'outil remplace l'arrière-plan et la tenue plutôt que de générer une nouvelle personne. La fidélité dépend fortement de l'entrée, et un visage petit ou incliné dans la photo source donne au modèle moins de choses à préserver.
Les sorties de l'API de photo de tête IA sont-elles filigranées ou signées ?
Les éditions Nano Banana 2 Lite incluent des informations d'identification de contenu C2PA et un filigrane SynthID par défaut, selon la documentation du modèle sur la plateforme. Le comportement de signature est spécifique au modèle, donc vérifiez le readme pour le point de terminaison que vous choisissez.
Les photos de tête générées via une API peuvent-elles être utilisées sur LinkedIn ?
Oui, à condition que l'image reflète la personne réelle. Les directives de photo de LinkedIn autorisent les rendus artistiques de vous-même et interdisent les photos constituées uniquement de la ressemblance d'autres personnes, d'images libres de droits ou de personnages fictifs.
Conclusion
Si ce dont vous avez besoin est une photo de tête professionnelle standard et que vous préférez ne pas posséder un prompt, le point de terminaison fixe est le chemin le plus court. Deux champs, une sortie, un prix que vous pouvez lire avant de l'appeler.
Dès que votre produit nécessite quelque chose de spécifique, une veste particulière, un arrière-plan de marque, un recadrage portrait qui correspond à votre composant de carte, ce point de terminaison n'a rien à offrir et vous écrivez un prompt, que vous l'ayez prévu ou non. Deux questions le décident, et aucune n'est le prix unitaire. Quelqu'un maintiendra-t-il encore ce prompt dans deux ans ? Et l'écart entre une sortie 1k et une sortie 4k atteindra-t-il jamais l'écran d'un utilisateur ?
