Crea un processo
Una richiesta video include comunemente prompt, modello e proprietà dei fotogrammi, come durata, proporzioni, risoluzione o riferimenti, solo quando il modello scelto le supporta.
Salva immediatamente l'ID del processo. Serve per mostrare l'avanzamento, supportare l'annullamento nella tua interfaccia e ottenere il contenuto finale.
Processo di generazione video
bash
curl --request POST https://cicora.ai/api/v1/videos \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "google/veo-3.1",
"prompt": "Slow aerial movement above a river at sunrise",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "720p"
}'Interroga lo stato
- Leggi un processo tramite GET /videos/{video_id}.
- Considera lo stato terminale come fonte attendibile per il completamento.
- Usa un intervallo di polling crescente e interrompilo quando l'utente lascia la pagina.
Lavora con il risultato
Dopo il completamento, usa l'URL o il contenuto restituito dal processo e verifica che il file sia pronto prima di mostrare un lettore.
Conserva prompt, modello, parametri e ID del processo per l'assistenza, ma non conservare i riferimenti di input più a lungo di quanto richieda il tuo prodotto.