Saltar para o conteúdo
UlazAI

Documentos do desenvolvedor UlazAI

Erros e limites

Preços Painel Estúdio de imagem

Tratamento de erros e limites da plataforma

Use tratamento estruturado para erros API e valide as entradas do lado do cliente para reduzir novas tentativas.

Respostas HTTP comuns

Código Significado Causa típica
400 Solicitação inválida Prompt ausente, tamanho não suportado, parâmetros de modelo inválidos
401 Não autorizado Chave/token de sessão API ausente ou inválido
402 Pagamento necessário Créditos adquiridos insuficientes ou restrição de acesso API
403 Proibido Os pontos de extremidade de registro/login API foram desabilitados intencionalmente
404 Não encontrado ID de geração que não pertence ao usuário atual ou incompatibilidade de endpoint
500 Erro no servidor Falha do provedor upstream ou tempo limite da rede

Solicitar limites para impor o lado do cliente

  • prompt: máximo de 5.000 caracteres no endpoint unificado.
  • image_urls: máximo de 14 URLs no endpoint unificado.
  • size: específico do modelo, validar em relação matriz do modelo.
  • quality: valores específicos do modelo para Seedream 5 Lite, Nano Banana 2, Ideograma e Qwen.
  • O uso de API requer créditos adquiridos; os créditos de boas-vindas são apenas para o site.

Estratégia de nova tentativa

Comportamento de produção recomendado:

  • Não tente novamente 400, 401, 402, ou 403 sem alterar a entrada ou autenticação.
  • Tentar novamente 500 com espera exponencial e chaveamento de idempotência em sua camada de aplicativo.
  • Pesquise o endpoint de status antes de iniciar trabalhos de geração duplicados.