Vai al contenuto
UlazAI

Documenti per sviluppatori UlazAI

Errori e limiti video

Prezzi Pannello di controllo Studio d'immagine

Limiti di validazione e integrazione

Applica la convalida lato client prima di inviare le richieste. La maggior parte dei fallimenti arriva da combinazioni di modelli non valide (durata, rapporto, qualità o tipo di input).

Risposte HTTP comuni

Codice Significato Causa tipica
400 Richiesta non valida Rapporto/durata/qualità non supportato, prompt mancante, URL non valido
401 Non autorizzato Sessione o contesto di autenticazione API mancante
402 Pagamento richiesto Crediti insufficienti per il batch di lavori richiesto
404 Non trovato Slug del modello sconosciuto o ID lavoro sconosciuto
429 Tariffa limitata Limiti di richieste per utente superati

Protezioni specifiche del modello

  • model_slug deve esistere in matrice del modello video.
  • aspect_ratio e duration_seconds deve corrispondere esattamente alle opzioni del modello.
  • quality_mode è richiesto quando un modello dispone di preimpostazioni di qualità.
  • Hailuo 2.3 ne richiede uno input_image_urls voce e non supporta due immagini.
  • wan_2_6_v2v ne richiede uno input_video_urls ingresso.
  • Kling 3.0 supporta opzionale start_frame_url, end_frame_url, e elements con una rigorosa convalida della forma.
  • La dimensione del batch è limitata a 4 lavori per richiesta.

Limiti di lunghezza Prompt

  • Kling 3.0 e Kling 2.6: 2500 caratteri.
  • Grok Imagine Video: 5000 caratteri.
  • Hailuo 2.3 Standard/Pro: 5000 caratteri.
  • La maggior parte dei modelli rimanenti segue la convalida standard prompt nei servizi di generazione.

Limiti di tariffa

  • /api/v1/video-studio/generate/: 24 richieste POST per utente all'ora.
  • Endpoint dello strumento Video Studio: 24 richieste POST per utente all'ora.
  • Veo 3.1 azioni di estensione e upscaling: 48 richieste POST per utente all'ora.

Riprovare la strategia

  • Non riprovare 400 o 404 senza correggere i dati della richiesta.
  • Non riprovare 402 finché il conto non avrà abbastanza crediti.
  • Riprova 429 con backoff e rispettare i limiti di velocità del server.
  • In caso di errori temporanei, riprovare solo dopo aver controllato lo stato corrente del lavoro per evitare duplicati.