Zum Inhalt springen
UlazAI

UlazAI Entwicklerdokumentation

Authentifizierung

Preise Armaturenbrett Bildstudio

Authentifizierungsmodell

Bild- und Video-API-Endpunkte unterstützen die API-Schlüsselauthentifizierung. Für externe Integrationen verwenden Sie einen API-Schlüssel mit dem Authorization Kopfzeile.

Wichtig: /api/register/ und /api/login/ sind derzeit deaktiviert und zurück 403. Verwenden Sie den Web-Login-Flow und den API-Schlüssel stattdessen das Management.

Empfohlenes Setup

  1. Melden Sie sich an unter /Konten/Anmeldung/.
  2. Erstellen Sie einen API-Schlüssel in Ihrem Dashboard oder über POST /api/api-keys/ während authentifiziert.
  3. Senden Sie Anfragen an /api/v1/... mit deinem Schlüssel drin Authorization.
  4. Für die Modellerkennung rufen Sie uns an /api/v1/models/image/ und /api/v1/models/video/.

Autorisierungsheaderformate

Das Backend akzeptiert mehrere Authentifizierungsheaderformate. 

Authorization: Bearer YOUR_API_KEY
Authorization: Token YOUR_API_KEY
Authorization: YOUR_API_KEY

Erstellen Sie einen API-Schlüssel (sitzungsauthentifiziert)

Wenn Sie mit einer Browsersitzung angemeldet sind, können Sie Schlüssel programmgesteuert erstellen. 

curl -X POST https://ulazai.com/api/api-keys/ \
  -H "Content-Type: application/json" \
  -H "X-CSRFToken: YOUR_CSRF_TOKEN" \
  -H "Cookie: sessionid=YOUR_SESSION" \
  -d '{
    "name": "Production key"
  }'

Die Antwort beinhaltet einmalig den vollständigen Schlüssel. Bewahren Sie es sofort auf.

Fehlerbehebung bei der Authentifizierung

  • 401 bedeutet, dass der Schlüssel fehlt, ungültig oder widerrufen ist.
  • 402 kann angeben, dass für die Nutzung von API keine Credits erworben wurden.
  • Willkommensguthaben gelten nur für die Website und können nicht über API verwendet werden.