L'API AIcoiffures

Obtenez votre clé API

Créez un compte, et dans votre section de profil créez une clé API.

Achetez des crédits (ou utilisez le mode test)

Visitez votre section de profil pour acheter des crédits API. Chaque génération réussie consommera un crédit de votre solde.

Les crédits n'expirent jamais et peuvent être utilisés à tout moment. Des remises sur volume sont disponibles pour les achats en gros.

Pour les tests, vous pouvez utiliser mode: 'test' dans la demande API. Cela ne consommera aucun crédit de votre solde mais vous permettra de tester le flux complet de l'API.

Obtenez les styles

Envoyez une demande GET pour obtenir les styles :

https://api.aihairstyles.com/api/styles

Vous obtiendrez une réponse JSON avec les styles, comme ci-dessous. Remarquez que l'objet preview_images contient les images pour les deux sexes.

{
  "description": "Bob - disheveled",
  "preview_images": {
    "man-white": "https://ik.imagekit.io/aicosmetic/AAA-hairstyle_images/models/man-white/00037.png?updatedAt=1710976848880",
    "woman-white": "https://ik.imagekit.io/aicosmetic/AAA-hairstyle_images/models/woman-white/bob%20dishevled.png?updatedAt=1707320590149"
  },
  "preview_image": "https://ik.imagekit.io/aicosmetic/null",
  "sex": "feminine",
  "id": 817941,
  "tags": "disheveled, bob"
}

Créer une génération

Envoyez une demande POST pour créer une nouvelle génération à

https://api.aihairstyles.com/api/preview

Votre clé API doit être dans les en-têtes de votre requête, dans le champ x-api-key.

La demande doit être envoyée en tant que données de formulaire avec les champs suivants :

Image (requis)

• Il devrait idéalement s'agir d'une image carrée avec le visage du sujet clairement visible. Les images seront recadrées pour être carrées si elles ne le sont pas déjà.
• Avec suffisamment d'espace autour du visage et des cheveux pour que l'IA puisse générer différents styles.
• La taille de fichier maximale autorisée est de 8 Mo.

Styles multiples séparés par une virgule

Options : blond, brun, noir, roux, gris

Options : masculin, féminin ou personne (par défaut)

Votre URL de webhook

Options : test. Utilisez pendant le développement pour éviter d'être facturé.

Réponse réussie

{
  "data": {
    "id": 1234,
    "inputUrl": "https://ik.imagekit.io/aicosmetic/f8b915b2-57df-49b7/123123123"
  },
  "message": "Job created successfully",
  "status": "success"
}

Gestion du résultat (sondage ou webhook)

Vous avez deux options pour gérer le résultat.

Webhook

Spécifiez une callback_url dans la requête POST originale pour créer un aperçu, et nous enverrons une requête POST à cette URL lorsque la génération sera terminée.

Sondage

Envoyez une requête GET à l'ID d'aperçu pour vérifier le statut. Notez que sonder plus d'une fois par seconde entraînera un throttling.

https://aihairstyles.com/api/preview/[preview_id]

Réponse réussie

{
  "data": {
    "images": [
      "https://ik.imagekit.io/aicosmetic/3291-preview-723335832172-7679_Se7y5RMBR"
    ],
    "status": "done"
  },
  "message": "",
  "status": "success"
}

Réponse d'erreur

{
  "data": null,
  "message": "Invalid API key",
  "status": "error"
}