Kling V4 Flash

Contratto APIMaster per kling-v4-flash, verificato il 2026-11-07. Canale 317: testo, primo fotogramma, riferimenti, modifica ed estensione. Solo 720p, 24 fps, 3–20 secondi; modello distinto da Kling V4.

Kling V4 Flash

Endpoint e autenticazione

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

Parametri

JSON con Authorization: Bearer YOUR_API_KEY; model=kling-v4-flash. prompt richiesto salvo un singolo fotogramma iniziale. duration/seconds: interi JSON 3–20, predefinito 5; null equivale ad assente, 0 rifiutato. Entrambi devono essere validi e uguali. Modifica senza durata: durata del flusso video arrotondata per eccesso. resolution solo 720p. aspect_ratio o size: 16:9, 9:16, 1:1, 21:9; auto solo nei riferimenti. Predefiniti: testo 16:9, riferimenti auto, modifica segue la sorgente. Primo fotogramma ed estensione rifiutano aspect_ratio/size non vuoti. audio solo true, watermark solo false.

Parametro	Tipo JSON	Obbligatorio	Predefinito	Funzione e limiti
model	string	Sì	kling-v4-flash	Sempre kling-v4-flash per tutte e cinque le operazioni; kling-v4 è un modello diverso.
prompt	string	Secondo la modalità	—	Descrive scena, movimento o modifica. Facoltativo solo con un fotogramma iniziale. @Image1 e @Video1 sono numerati separatamente da 1 per ciascun array; il video modificato è @Video1.
duration	integer / null	No	5	Intero JSON 3–20 secondi, normalmente 5. Modifica senza entrambi i campi: durata della traccia video arrotondata per eccesso. Estensione: durata del NUOVO segmento. null equivale a omesso; 0, valori non interi e stringhe numeriche sono rifiutati.
seconds	integer / null	No	—	Alias di duration, stessi limiti. Preferire un solo campo; se presenti entrambi devono essere validi e uguali, altrimenti 400.
resolution	string	No	720p	Solo 720p: livello qualitativo, non garanzia del lato corto a 720px. 1080p e scelta della qualità tramite mode non supportati.
aspect_ratio	string	No	Secondo la modalità	Testo/riferimenti/modifica: 16:9, 9:16, 1:1, 21:9; auto solo per riferimenti. Predefiniti: testo 16:9, riferimenti auto, modifica come origine. Immagine iniziale/estensione rifiutano valori non vuoti; stringa vuota = omesso.
size	string	No	—	Alias di aspect_ratio, non risoluzione o dimensioni in pixel. I due campi devono coincidere. Ometterli entrambi per immagine iniziale ed estensione.
image_urls	string[]	Secondo la modalità	—	Array di URL pubblici di immagini. Auto accetta un’immagine iniziale; riferimenti solo immagini richiedono reference esplicito. Riferimenti/modifica: ≤10 immagini contando reference_image. Non mescolare rappresentazioni del primo fotogramma; estensione senza immagini.
first_frame_image	string	Secondo la modalità	—	URL pubblico dell’unico fotogramma iniziale, alternativo a un elemento image_urls o al ruolo first_frame. Entrambi i lati ≥300px, rapporto 2:5–5:2; ritagliare prima se necessario.
image_with_roles	{url, role}[]	Secondo la modalità	—	Ogni oggetto richiede url pubblico e role. first_frame per l’unico fotogramma iniziale, reference_image per riferimenti/modifica. Niente fotogrammi finali/intermedi/chiave. Totale immagini di riferimento≤10, riferimenti immagine/video≤15.
video_url	string	Secondo la modalità	—	URL pubblico di un video origine con edit/extend esplicito, incompatibile con video_urls. Modifica: MP4/MOV, traccia 3–20s, ciascuna dimensione 700–4553px. Estensione dall’ultimo fotogramma, restituisce solo il nuovo segmento; non usare ID attività/conversazione.
video_urls	string[]	Secondo la modalità	—	Fino a 5 MP4/MOV di riferimento, ciascuna traccia≥3s, ciascun lato 700–4553px, somma≤20s. Edit/extend espliciti possono usare un elemento invece di video_url. Gli eccessi sono rifiutati senza ritaglio; l’array seleziona automaticamente riferimenti.
omni_reference_task_type	string	No	auto	auto deduce testo/immagine iniziale/riferimenti; reference richiede materiale; edit/extend richiedono un video. video_url senza modalità esplicita e due immagini normali in auto non sono validi.
audio_setting	string	No	auto	Solo riferimenti CON VIDEO. auto genera nuovo audio; origin conserva quello del PRIMO video e senza traccia sorgente non ci sarà traccia in uscita. Omettere per modifica, estensione, testo o soli riferimenti immagine.
audio	boolean	No	true	Booleano di compatibilità: omesso oppure true, false rifiutato. Audio originale tramite audio_setting nelle modalità supportate; niente riferimenti audio separati.
watermark	boolean	No	false	Booleano di compatibilità: omesso oppure false, true rifiutato. Non elimina filigrane dal materiale originale.

URL HTTP(S) pubblici diretti senza credenziali incorporate; niente base64/percorsi locali/ID attività. Formati e limiti in byte delle immagini non specificati separatamente. 100MiB è il limite di lettura per ogni video analizzato per riferimenti/modifica, non un limite generale di caricamento.

Modalità e contenuti

Operazione	Selezione e materiali richiesti	Predefiniti ed esclusioni
Testo in video	Nessun materiale, prompt richiesto, tipo auto od omesso.	5s, 16:9; niente audio_setting.
Immagine iniziale in video	Una sola immagine tramite UNA rappresentazione; prompt facoltativo.	5s, rapporto immagine; niente aspect_ratio/size o fotogramma finale.
Riferimenti in video	reference + immagini, ruoli reference_image o video_urls; prompt richiesto.	5s, auto; immagini≤10, video≤5, totale≤15; opzioni audio solo con video.
Modifica video	edit + un video, prompt richiesto; fino a 10 immagini di riferimento.	Durata origine arrotondata per eccesso, rapporto origine; senza ruoli fotogramma/audio_setting.
Estensione video	extend + un video, prompt richiesto.	5 secondi NUOVI; niente immagini, modifica rapporto/audio_setting; non si applicano minimi dimensionali/temporali di modifica/riferimenti.

omni_reference_task_type: auto, reference, edit, extend. Una image_urls, first_frame_image o un ruolo first_frame è il fotogramma iniziale. Più immagini richiedono reference o ruoli reference_image; due image_urls in auto sono rifiutate. video_urls seleziona riferimenti salvo edit/extend esplicito. video_url richiede edit/extend ed esclude video_urls. Modifica/estensione richiedono un video. La modifica accetta riferimenti immagine; l’estensione non accetta immagini/audio_setting e restituisce solo il segmento NUOVO. Usare l’URL pubblico del video, non un ID di attività o conversazione.

URL HTTP(S) pubblici diretti senza credenziali incorporate. Massimo 10 immagini, 15 riferimenti immagine/video totali. Immagini almeno 300×300, rapporto 2:5–5:2. Fino a 5 MP4/MOV, ciascuno almeno 3 secondi, totale massimo 20; modifica: un video 3–20 secondi. Larghezza E altezza 700–4553 pixel. Il gateway legge al massimo 100 MiB per video e misura la traccia video, non contenitore/audio. Questi controlli di dimensioni/durata minima non valgono per l’ingresso di estensione. Il fornitore verifica anche le immagini. audio_setting=origin conserva il suono del primo riferimento video, o silenzio; auto genera suono. Solo riferimenti CON video. La modifica rigenera il suono. Non ammessi URL audio, ultimo/intermedio fotogramma, keyframes, negative_prompt, mode, seed, scene multiple e liste di personaggi/voci.

Pixel di uscita e frequenza fotogrammi

Rapporto / operazione	Pixel documentati	Frequenza
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
Immagine iniziale in video	Rapporto immagine, circa 0,92MP; ad esempio 604×1516 per 2:5.	24 fps

Dimensioni di uscita e requisiti di ingresso sono diversi. Il 21:9 è alto 628px, sotto i 700px per riferimenti/modifica: preparare una fonte conforme. Questo minimo non vale per estensione. Il file può durare circa un fotogramma in più.

Esempi non eseguibili

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

Fatturazione

Base ufficiale nominale: $0.094 per secondo in uscita (720P), $0.0628 per secondo fatturabile con video (720P-input). Testo, immagini, riferimenti senza video ed estensione: uscita/nuovo segmento. Riferimenti video e modifica: uscita + max(ingresso, uscita). Sommare prima tutte le durate delle tracce in ingresso e arrotondare poi la somma per eccesso. Ingresso 3.04 s e uscita 3 s: 3+max(4,3)=7 secondi fatturabili. Un fotogramma aggiuntivo nel file non modifica la durata intera richiesta. Sconti dei pacchetti e coefficienti account sono separati; fanno fede scheda e importo finale del registro. Errore di generazione confermato: rimborso della riserva. Interrompere il controllo non annulla l’attività; un timeout ambiguo non giustifica una nuova generazione.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

Stato, errori e tentativi sicuri

Prima accettazione: HTTP 200, task_id pubblico, queued. GET /v1/videos/{task_id}: queued/in_progress/completed/failed, possibile unknown temporaneo. url e metadata.url richiedono Bearer; anche GET /v1/videos/{task_id}/content. Errore: error.code=generation_failed con messaggio ripulito; parametri errati: HTTP 400. Idempotency-Key: 8–128 caratteri ASCII visibili senza spazi. Stesso account/chiave/richiesta: HTTP 202 senza nuova generazione/riserva; modifiche: 409. GET /v1/video-submissions/by-key legge la ricevuta. accepted+task_ready=true: consultare task_id; pending/submitting o non pronto: attendere. acceptance_unknown: conservare la chiave e contattare assistenza, senza invio automatico. 404 non prova mancata accettazione. Conservazione almeno 30 giorni; protezione del gateway, non ricerca dal fornitore. Importo finale nel registro tramite other.task_id; il controllo non garantisce una fattura. /v1/videos/quote non supportato. Esempi inerti: sostituire gli URL, nuova chiave per ogni nuova operazione.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI