Vai al contenuto

Documenti per sviluppatori UlazAI

Autenticazione

Modello di autenticazione

Gli endpoint API per immagini e video supportano l'autenticazione con chiave API. Per esterno integrazioni, utilizzare una chiave API con il Authorization intestazione.

Importante: /api/register/ e /api/login/ sono attualmente disabilitato e ritornare 403. Utilizzare il flusso di accesso Web e la chiave API invece la gestione.

Configurazione consigliata

  1. Accedi a /account/accesso/.
  2. Crea una chiave API nella dashboard o tramite POST /api/api-keys/ mentre autenticato.
  3. Invia richieste a /api/v1/... con la chiave inserita Authorization.
  4. Per la scoperta del modello, chiama /api/v1/models/image/ e /api/v1/models/video/.

Formati delle intestazioni di autorizzazione

Il backend accetta più formati di intestazione di autenticazione.

Authorization: Bearer YOUR_API_KEY
Authorization: Token YOUR_API_KEY
Authorization: YOUR_API_KEY

Crea una chiave API (autenticata dalla sessione)

Se hai effettuato l'accesso con una sessione del browser, puoi creare chiavi a livello di codice.

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

La risposta include la chiave completa una volta. Conservalo immediatamente.

Risoluzione dei problemi di autenticazione

  • 401 significa che la chiave è mancante, non valida o revocata.
  • 402 può indicare nessun credito acquistato per l'utilizzo di API.
  • I crediti di benvenuto sono disponibili solo sul sito Web e non possono essere utilizzati tramite API.