Skip to main content

​
Modelli popolari

La generazione di video richiede tipicamente più tempo rispetto a quella di immagini. Preparati a tempi di elaborazione più lunghi in base alla durata e alle impostazioni di qualità del video.

​
Step 1: Genera un video

Effettua una richiesta POST a /generate/video/kling/kling-2.5 con il tuo prompt e i parametri video. L’API restituisce immediatamente un job ID. 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.video("kling/kling-2.5", {
  prompt: "a majestic eagle soaring over snow-capped mountains at sunrise",
  duration: 5,
  aspect_ratio: "16:9"
});

console.log(`Job ID: ${job.job_id}`);
Sostituisci con il tuo token APIPer sostituire il segnaposto YOUR_API_TOKEN negli esempi qui sopra, dovrai generare un token API su krea.ai/settings/api-tokens. Segui le istruzioni nella pagina Chiavi API e fatturazione se hai bisogno di aiuto.
Esempio di risposta 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_time": "60-120 seconds"
}

​
Step 2: Effettua il polling per i risultati

La generazione di video richiede più tempo rispetto a quella di immagini. Effettua polling su /jobs/{job_id} ogni 5 secondi per verificare i progressi.
Webhook disponibili!Configura i webhook per ricevere notifiche al completamento dei job. Consulta la guida ai Webhook per iniziare.
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

async function waitForVideo(jobId) {
  const completed = await krea.jobs.wait(jobId, { intervalMs: 5000 });
  return completed.result.urls[0];
}

const videoUrl = await waitForVideo(job.job_id);
console.log(`Video ready: ${videoUrl}`);
Esempio di risposta completata 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2025-01-15T10:30:00.000Z",
  "completed_at": "2025-01-15T10:31:45.000Z",
  "result": {
    "urls": ["https://gen.krea.ai/videos/your-video.mp4"]
  }
}
Webhook disponibili!Configura i webhook per ricevere notifiche al completamento dei job. Consulta la guida ai Webhook per iniziare.

​
Parametri comuni

Per l’elenco dettagliato dei parametri di tutti i modelli, consulta la pagina Model APIs.
ParametroTipoDescrizione
promptstringDescrizione dettagliata del contenuto del video
durationnumberDurata del video in secondi. I valori supportati dipendono dal modello.
aspect_ratiostringRapporto d’aspetto del video, ad esempio 16:9, 9:16 o 1:1
start_imagestringURL immagine sorgente opzionale per i modelli image-to-video
end_imagestringURL del frame finale opzionale per i modelli supportati
modestringModalità di qualità opzionale per i modelli che la espongono
modelstringModello di generazione video da utilizzare
Suggerimenti sui prompt per video migliori:
  • Sii specifico sul movimento e sui movimenti di camera
  • Descrivi la scena, l’illuminazione e l’atmosfera
  • Menziona il timing (ad esempio, “panoramica lenta”, “zoom rapido”)
  • Includi riferimenti stilistici (ad esempio, “cinematografico”, “stile documentario”)
La generazione di video costa più di quella di immagini. Consulta Chiavi API e fatturazione per i prezzi per modello e per come ricaricare il saldo della tua API.