Die KI-Frisuren-API

Holen Sie sich Ihren API-Schlüssel

Erstellen Sie ein Konto und erstellen Sie in Ihrem Profilbereich einen API-Schlüssel.

Kaufe Credits (oder nutze den Testmodus)

Besuchen Sie Ihren Profilbereich, um API-Guthaben zu kaufen. Jede erfolgreiche Generierung verbraucht ein Guthaben von Ihrem Kontostand.

Guthaben verfallen nie und können jederzeit verwendet werden. Volumenrabatte sind für Großeinkäufe verfügbar.

Für Tests können Sie den Modus 'test' in der API-Anfrage verwenden. Dies verbraucht kein Guthaben von Ihrem Kontostand, ermöglicht Ihnen jedoch, den vollständigen API-Ablauf zu testen.

Holen Sie sich die Stile

Senden Sie eine GET-Anfrage, um die Stile zu erhalten:

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

Sie erhalten eine JSON-Antwort mit den Stilen, wie unten dargestellt. Beachten Sie, dass das Objekt preview_images die Bilder für beide Geschlechter enthält.

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

Generierung erstellen

Senden Sie eine POST-Anfrage, um eine neue Generierung zu erstellen unter

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

Dein API-Schlüssel sollte in den Headern deiner Anfrage im Feld x-api-key sein.

Die Anfrage sollte als Formulardaten mit den folgenden Feldern gesendet werden:

Bild (erforderlich)

• Es sollte idealerweise ein quadratisches Bild sein, auf dem das Gesicht des Motivs deutlich sichtbar ist. Bilder werden quadratisch zugeschnitten, wenn sie nicht quadratisch sind
• Mit genügend Bereich um das Gesicht und die Haare herum, damit die KI verschiedene Stile generieren kann.
• Die maximale Dateigröße beträgt 8 MB.

Mehrere Stile durch Komma getrennt

Optionen: blond, braun, schwarz, rot, grau

Optionen: männlich, weiblich oder Person (Standard)

Ihre Webhook-URL

Optionen: Test (Standard). Verwenden Sie dies während der Entwicklung, um keine Rechnungen zu erhalten.

Erfolgreiche Antwort

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

Verarbeitung des Ergebnisses (Polling oder Webhook)

Sie haben zwei Optionen zur Verarbeitung des Ergebnisses.

Webhook

Geben Sie eine callback_url im ursprünglichen POST-Anforderung an, um eine Vorschau zu erstellen, und wir senden eine POST-Anforderung an diese URL, wenn die Generierung abgeschlossen ist.

Polling

Senden Sie eine GET-Anforderung an die Vorschau-ID, um den Status zu überprüfen. Beachten Sie, dass Polling schneller als einmal pro Sekunde zu einer Drosselung führen wird.

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

Erfolgreiche Antwort

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

Fehlerantwort

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