De AI Kapsels API

Ontvang je API-sleutel

Maak een account aan en maak in je profielsectie een API-sleutel aan.

Koop credits (of gebruik de testmodus)

Ga naar je profielgedeelte om API-credits te kopen. Elke succesvolle generatie zal één credit van je saldo verbruiken.

Credits verlopen nooit en kunnen altijd worden gebruikt. Volumekortingen zijn beschikbaar voor grotere aankopen.

Voor testdoeleinden kun je modus: 'test' gebruiken in het API-verzoek. Dit zal geen credits van je saldo verbruiken, maar stelt je in staat om de volledige API-stroom te testen.

Haal de stijlen op

Stuur een GET-verzoek om de stijlen op te halen:

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

Je zult een JSON-reactie krijgen met de stijlen, zoals hieronder weergegeven. Let op dat het voorbeeld_images object de afbeeldingen bevat voor beide geslachten.

{
  "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"
}

Maak een generatie aan

Stuur een POST-verzoek om een nieuwe generatie aan te maken naar

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

Uw API-sleutel moet in de headers van uw verzoek staan, in het veld x-api-key.

Het verzoek moet worden verzonden als formuliergegevens met de volgende velden:

Afbeelding (verplicht)

• Het zou idealiter een vierkante afbeelding moeten zijn waarop het gezicht van het onderwerp duidelijk zichtbaar is. Afbeeldingen worden bijgesneden tot vierkant als ze dat niet zijn
• Met voldoende ruimte rond het gezicht en haar voor de AI om verschillende stijlen te genereren.
• De maximaal toegestane bestandsgrootte is 8Mb.

Meerdere stijlen gescheiden door een komma

Opties: blond, bruin, zwart, rood, grijs

Opties: man, vrouw of persoon (standaard)

Uw webhook URL

Opties: test. Gebruik tijdens ontwikkeling om te voorkomen dat u in rekening wordt gebracht.

Succesvol antwoord

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

Het resultaat verwerken (polling of webhook)

Je hebt twee opties voor het verwerken van het resultaat.

Webhook

Geef een callback_url op in het oorspronkelijke POST-verzoek om een voorbeeld te maken, en we sturen een POST-verzoek naar die URL wanneer de generatie is voltooid.

Polling

Stuur een GET-verzoek naar de voorbeeld-ID om de status te controleren. Let op dat vaker dan eens per seconde pollt leidt tot throttling.

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

Succesvol antwoord

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

Foutantwoord

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