Introduction
Le modèle prend un seul portrait et renvoie une image générée du sosie de célébrité le plus proche. Il n’y a ni prompt ni paramètre : la photo constitue toute l’entrée.
La requête tient en une URL d’image, facturée à la requête. C’est une fonction en un seul appel pensée pour les produits de divertissement et les réseaux sociaux, pas un outil d’identification.
Fonctionnalités et points forts
Une photo en entrée, une image en sortie : rien d’autre à envoyer
Toute la requête est une seule URL d’image. Pas de prompt, pas de seed, pas de taille, pas d’intensité : la photo envoyée est la seule chose qui fait varier le résultat. Soumettez-la puis interrogez la tâche pour récupérer l’image, comme pour tout autre appel média de ce catalogue ; le prix par requête reste le même, quelle que soit la personne qui apparaît sur l’image.
Une image générée, ni un nom ni un score
La réponse contient une image et rien d’autre : pas de nom de célébrité, pas de liste de candidats classés, pas de pourcentage de ressemblance. Ce qui accompagne l’image, c’est votre texte, pas une affirmation du modèle, et c’est plus sûr ainsi. Construisez le moment autour de l’image elle-même : montrez-la, laissez-la se partager, et évitez d’y accoler un chiffre.
Pour savoir si vous pouvez l’utiliser, traitez-le comme de la reconnaissance faciale
L’entrée est toujours le visage d’une personne réelle, ce qui soumet ce point de terminaison à des règles sur le droit à l’image et les données biométriques qu’aucun autre élément de ce catalogue ne touche. Les données biométriques font l’objet d’une réglementation spécifique dans l’Union européenne et dans certaines régions des États-Unis, où le niveau de consentement exigé peut être élevé. N’envoyez que des photos dont la personne a sciemment donné son accord — jamais celles d’une personnalité publique, jamais des images prises ailleurs — et ne l’utilisez jamais pour identifier, vérifier, surveiller ou constituer une base de visages. Rien de ce qui revient n’est une affirmation factuelle sur une personne réelle ; les images sources envoyées sont supprimées après un jour et les résultats générés après 14 jours.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
image_url | Oui | Un portrait net, à peu près de face, avec un seul visage visible. 1 caractères minimum |
Tarification
$0.05 / requête
Une correspondance que vous n’auriez pas retenue reste une requête aboutie et elle est facturée.
Cas d’utilisation
Un envoi, une image à partager
Utilisez ce point de terminaison quand le moment produit se résume à l’envoi d’une photo suivi d’une image générée à partager. Envoyez le portrait en image_url, interrogez la tâche et affichez l’image renvoyée ; il n’y a ni nom ni score à afficher à côté.
Fonctions de divertissement et de réseaux sociaux
L’interaction « À quelle célébrité ressemblez-vous ? » sous la forme d’un seul appel d’API derrière un envoi de photo. C’est un moment à partager dans une application grand public, pas un outil de production.
Mécaniques de campagne
Une étape interactive légère dans un parcours marketing : on envoie un selfie, on récupère une image à partager. Un appel par participant garde le coût prévisible.
Applications photo et beauté
Une fonction ludique à côté des outils de portrait existants. Elle ne demande ni ingénierie de prompt ni paramètres, et s’intègre donc à une application avec un seul champ de formulaire.
Guide de prompt et conseils pratiques
Attendez-vous à une image, pas à un verdict
Le point de terminaison renvoie une image générée, pas un nom, un classement ou un score de ressemblance. Si votre produit a besoin d’une légende, c’est l’image elle-même qu’il faut présenter : l’API ne vous donne rien d’autre à afficher.
Envoyer un portrait net et de face
Un seul visage bien éclairé, à peu près tourné vers l’objectif et occupant une bonne part du cadre. Photos de groupe, profils marqués, lunettes de soleil, flou de bougé et très petits visages sont les cas où la ressemblance se dégrade ou l’appel échoue.
Vérifier le résultat avant d’itérer
Un visage par image, plutôt de face et bien éclairé. Les profils, les masquages (lunettes de soleil, mains, cheveux sur le visage), le flou de bougé et les très petits visages dégradent la ressemblance ou font échouer l’appel. Il n’y a ni prompt, ni masque, ni intensité, ni seed : si le résultat ne convient pas, la seule solution est une autre photo. La réponse est une image et rien d’autre : ni nom, ni classement, ni indice de confiance.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/look-alike-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.