Saltar para o conteúdo

Documentos do desenvolvedor UlazAI

Autenticação

Modelo de autenticação

Os endpoints API de imagem e vídeo suportam autenticação de chave API. Para externo integrações, use uma chave API com o Authorization cabeçalho.

Importante: /api/register/ e /api/login/ são atualmente desativado e retornar 403. Use o fluxo de login da web e a chave API gestão em vez disso.

Configuração recomendada

  1. Faça login em /contas/login/.
  2. Crie uma chave API em seu painel ou via POST /api/api-keys/ enquanto autenticado.
  3. Envie solicitações para /api/v1/... com sua chave dentro Authorization.
  4. Para descoberta de modelo, ligue /api/v1/models/image/ e /api/v1/models/video/.

Formatos de cabeçalho de autorização

O back-end aceita vários formatos de cabeçalho de autenticação.

Authorization: Bearer YOUR_API_KEY
Authorization: Token YOUR_API_KEY
Authorization: YOUR_API_KEY

Crie uma chave API (autenticada por sessão)

Se você estiver conectado com uma sessão do navegador, poderá criar chaves programaticamente.

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

A resposta inclui a chave completa uma vez. Armazene-o imediatamente.

Solução de problemas de autenticação

  • 401 significa que a chave está faltando, é inválida ou foi revogada.
  • 402 pode indicar que não há créditos adquiridos para uso de API.
  • Os créditos de boas-vindas são apenas para o site e não podem ser usados via API.