API fryzur AI

Pobierz swój klucz API

Utwórz konto i w sekcji profilu utwórz klucz API.

Zakup kredytów (lub użyj trybu testowego)

Odwiedź sekcję swojego profilu, aby zakupić kredyty API. Każda udana generacja spowoduje pobranie jednego kredytu z Twojego salda.

Kredyty nie wygasają i można je wykorzystać w dowolnym momencie. Dostępne są zniżki ilościowe dla zakupów hurtowych.

Do testowania możesz użyć trybu: 'test' w żądaniu API. To nie spowoduje pobrania kredytów z Twojego salda, ale pozwoli Ci przetestować pełny przepływ API.

Pobierz style

Wyślij żądanie GET, aby pobrać style:

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

Otrzymasz odpowiedź JSON z stylami, jak poniżej. Zauważ, że obiekt preview_images zawiera obrazy dla obu płci.

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

Utwórz generację

Wyślij żądanie POST, aby utworzyć nową generację do

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

Twój klucz API powinien znajdować się w nagłówkach Twojego żądania, w polu x-api-key.

Żądanie powinno być wysłane jako dane formularza z następującymi polami:

Obraz (wymagany)

• Najlepiej byłoby, gdyby to była kwadratowa grafika z wyraźnie widoczną twarzą podmiotu. Obrazy zostaną przycięte do kwadratu, jeśli nie są kwadratowe.
• Z wystarczającą ilością miejsca wokół twarzy i włosów, aby sztuczna inteligencja mogła generować różne style.
• Maksymalny dozwolony rozmiar pliku to 8Mb.

Wiele stylów oddzielonych przecinkiem

Opcje: blond, brązowy, czarny, rudy, szary

Opcje: mężczyzna, kobieta lub osoba (domyślnie)

Twój adres URL webhooka

Opcje: test. Użyj podczas rozwoju, aby uniknąć naliczania opłat.

Odpowiedź udana

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

Obsługa wyniku (polling lub webhook)

Masz dwie opcje obsługi wyniku.

Webhook

Podaj callback_url w oryginalnym żądaniu POST, aby utworzyć podgląd, a my wyślemy żądanie POST pod ten adres URL po zakończeniu generowania.

Polling

Wyślij żądanie GET do identyfikatora podglądu, aby sprawdzić status. Zauważ, że częstsze odpytywanie niż raz na sekundę spowoduje ograniczenie.

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

Udane odpowiedzi

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

Odpowiedź błędu

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