Kling 4.0 Flash

Kling 4.0 Flash è il modello più leggero della famiglia Kling 4.0 di Kuaishou. Su SeedRouter copre la generazione da testo a video e quella basata su riferimenti: fino a 10 immagini di riferimento, 5 video di riferimento e 7 elementi (soggetti con un nome creati da 2–4 immagini o un breve video), ciascuno menzionato nel prompt. Ogni clip dura 3–20 secondi a 720p con audio. Invia la richiesta, conserva l'ID attività restituito e leggi il video finito dall'attività. I media vengono inviati come URL.

ID modello

Consulta la pagina del modello per i prezzi attuali.

Esempio rapido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4-0-flash",
    "prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

La risposta è un’attività ({"id": "task_...", "status": "processing"}), non il video finito. Interroga GET /v1/tasks/{task_id} per il risultato. Conserva le chiavi API nel codice lato server.

Parametri

Ogni clip ha l’audio; non c’è un interruttore audio. Non ci sono campi per il primo fotogramma, quelli intermedi o l’ultimo, né campi negative_prompt, watermark o un campo voices autonomo: associa una voce a un elemento con voice_url. Lo schema è rigoroso: i campi sconosciuti vengono rifiutati anziché ignorati. callback_url non è disponibile; interroga l’attività invece.

Menzioni

Ogni media o elemento che invii è facoltativo; se non ne invii nessuno, la richiesta genera un video dal solo testo. Quando invii media o elementi, indicali nel prompt:

Ogni @ seguito da una lettera, una cifra, un trattino basso o un carattere cinese deve indicare un media o un elemento di questa richiesta, altrimenti la richiesta viene rifiutata prima di qualsiasi addebito. I nomi vengono confrontati partendo dai più lunghi e senza distinguere maiuscole e minuscole. Un nome che termina con una lettera, una cifra o un trattino basso non può essere seguito direttamente da un altro di questi caratteri: @image_12 con una sola immagine viene rifiutato; scrivi @image_1 2 o @image_1,.

I video di riferimento più gli elementi video sono al massimo 5, e immagini, video ed elementi insieme sono al massimo 15.

{
  "model": "kling-4-0-flash",
  "prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
  "image_urls": ["https://example.com/dancer.png"],
  "video_urls": ["https://example.com/routine.mp4"],
  "keep_original_sound": false,
  "duration": 8
}

Elementi

Un elemento è un soggetto con un nome che puoi riutilizzare nel prompt. Ne esistono due tipi:

I nomi contengono 1–20 lettere, cifre, trattini bassi o caratteri cinesi e sono univoci senza distinguere maiuscole e minuscole. image_N, video_N, keyframe_N, object_N, audio_N, first_frame e last_frame sono riservati.

{
  "model": "kling-4-0-flash",
  "prompt": "@Mira opens the shop door and greets the morning crowd",
  "elements": [
    {
      "name": "Mira",
      "image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
      "tag": "character",
      "description": "baker in a flour-dusted apron"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 6
}

Input media

Immagini, video e audio sono URL HTTP(S) pubblici. Gli URI di dati base64 non sono accettati: carica i file nel tuo archivio e passa i loro URL. I video di riferimento e gli elementi video insieme devono durare 2–20 secondi; la loro durata viene letta quando la richiesta viene accettata e un video la cui durata non può essere letta viene rifiutato prima di qualsiasi addebito.

Dimensioni di fatturazione

Consulta la sezione prezzi del modello per le tariffe attuali. Kling 4.0 Flash viene addebitato al secondo di video a 720p:

text, reference images, image elements:   cost = duration × standard rate
reference videos or video elements:       cost = (output + max(output, input)) × video-input rate

input è la somma delle durate dei video di riferimento e degli elementi video, arrotondata per eccesso ai secondi interi. Viene misurata quando la richiesta viene accettata, quindi l’importo riservato è l’importo addebitato. Esempio: una clip di 5 secondi guidata da un video di riferimento di 7,2 secondi addebita 5 + 8 = 13 secondi; con un video di riferimento di 3 secondi addebita 5 + 5 = 10 secondi. Le attività non riuscite non vengono addebitate.

Schema di output

La presentazione restituisce l’attività:

{"id": "task_...", "model": "kling-4-0-flash", "status": "processing", "created_at": 1789689600}

Ottieni l’attività

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interroga ogni 10–20 secondi finché status non è completed o failed. Un timeout di rete durante l'interrogazione non significa che la generazione non sia riuscita: conserva l'ID attività e riprendi a controllarlo. Non creare un'altra attività per verificare l'avanzamento.

Attività completata

{
  "id": "task_...",
  "model": "kling-4-0-flash",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689800,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Nei nostri test le clip di 5 secondi sono tornate come MP4 (H.264) a 1280 × 720 con una traccia AAC stereo, 91–103 secondi dopo l’invio; il file dura circa un fotogramma in più rispetto a duration (5,04 secondi per 5).

Errori

Le richieste rifiutate prima della creazione di un’attività restituiscono un errore HTTP con un oggetto error e non vengono addebitate. Un’attività che fallisce dopo l’accettazione restituisce HTTP 200 quando interrogata, con status: "failed" e un oggetto error.

Consulta il catalogo di errori condiviso per codici, stati HTTP e indicazioni di ripetizione.

{
  "id": "task_...",
  "model": "kling-4-0-flash",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Se l’invio stesso scade, controlla le tue attività prima di inviare di nuovo: la prima richiesta potrebbe essere stata accettata.

Suggerimenti

• Descrivi soggetto, luogo, movimento della telecamera, luce e suono; l'audio della clip segue il prompt.
• Usa Flash per provare prompt, proporzioni e riferimenti a basso costo, poi passa l’inquadratura riuscita a Kling 4.0 quando ti servono 1080p, fotogrammi chiave, modifica o estensione.
• Assegna a un personaggio ricorrente un elemento con due o tre viste chiare invece di una sola immagine di riferimento.
• Aggiungi no text, no logos per evitare segni inventati.

Correlati

• Playground e prezzi di Kling 4.0 Flash
• Riferimento API Kling 4.0
• Scarica OpenAPI
• Markdown copiabile