Saltar para o conteúdo
UlazAI

Documentos do desenvolvedor UlazAI

Erros e limites de vídeo

Preços Painel Estúdio de imagem

Limites de validação e integração

Aplique a validação do lado do cliente antes de enviar solicitações. A maioria das falhas vem de combinações de modelos inválidos (duração, proporção, qualidade ou tipo de entrada).

Respostas HTTP comuns

Código Significado Causa típica
400 Solicitação inválida Proporção/duração/qualidade não suportada, prompt ausente, URL inválido
401 Não autorizado Sessão ausente ou contexto de autenticação API
402 Pagamento necessário Créditos insuficientes para o lote de trabalhos solicitado
404 Não encontrado Slug de modelo desconhecido ou ID de trabalho desconhecido
429 Taxa limitada Limites de solicitação por usuário excedidos

Protetores específicos do modelo

  • model_slug deve existir no matriz de modelo de vídeo.
  • aspect_ratio e duration_seconds deve corresponder exatamente às opções do modelo.
  • quality_mode é necessário quando um modelo tem predefinições de qualidade.
  • Hailuo 2.3 requer um input_image_urls entrada e não suporta duas imagens.
  • wan_2_6_v2v requer um input_video_urls entrada.
  • Kling 3.0 suporta opcional start_frame_url, end_frame_urle elements com validação de forma rigorosa.
  • O tamanho do lote é limitado a 4 trabalhos por solicitação.

Limites de comprimento Prompt

  • Kling 3.0 e Kling 2.6: 2.500 caracteres.
  • Vídeo Grok Imagine: 5.000 caracteres.
  • Hailuo 2.3 Padrão/Pro: 5.000 caracteres.
  • A maioria dos modelos restantes segue a validação padrão prompt nos serviços de geração.

Limites de taxa

  • /api/v1/video-studio/generate/: 24 solicitações POST por usuário por hora.
  • Endpoints da ferramenta Video Studio: 24 solicitações POST por usuário por hora.
  • Veo 3.1 ações de extensão e upscale: 48 solicitações POST por usuário por hora.

Estratégia de nova tentativa

  • Não tente novamente 400 ou 404 sem corrigir os dados da solicitação.
  • Não tente novamente 402 até que a conta tenha créditos suficientes.
  • Tentar novamente 429 com espera e respeito aos limites de taxa do servidor.
  • Para falhas transitórias, tente novamente somente após verificar o status atual do trabalho para evitar duplicatas.