Vai al contenuto

Kling 4.0 Reference to Video

Integra

ID del modello kling/v4/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling/v4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

File come nell'esempio: 1,175 $ 1175 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Kling Da riferimento a video Input di riferimento3–30 sfino a 1080p #reference-to-video#multi-shot#image-reference#video-reference

Genera video di 3-30 secondi che mantengono l'aspetto di un massimo di 10 immagini di riferimento, 5 video di riferimento e 7 elementi

Kling · Video

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

88 / 2500

Istruzioni di generazione che soddisfano il requisito di fornire `prompt` o `multi_prompt`. Per fare riferimento agli input forniti, usa @Image1, @Video1, @Element1 e così via.

video_urls
Trascina un file oppure · fino a 5

Fino a 5 video di riferimento, richiamati tramite @Video1, @Video2 e così via; ciascuno dura 3–30 secondi (al massimo 30.05 secondi) e la loro durata totale insieme ai video degli elementi non può superare 30 secondi. Ogni file non deve superare 300 MB, con larghezza e altezza comprese tra 700 px e 4553 px. Il rapporto d'aspetto deve essere compreso tra 0.40 e 2.50 e la frequenza fotogrammi tra 23.9 e 60.05 FPS.

resolution predefinito 1080p

Risoluzione dell'output.

aspect_ratio predefinito 16:9

Proporzioni del video, selezionate esplicitamente o derivate dai riferimenti scegliendo 'auto'.

predefinito 5

Durata del video in secondi, da 3 a 30.

Avanzate image · images · multi_prompt · elements
start_image_url
Trascina un file oppure

Immagine facoltativa del primo fotogramma che conta ai fini del limite delle immagini di riferimento. La dimensione massima del file è 30.0 MB; larghezza e altezza devono raggiungere almeno 300 px ciascuna, con un rapporto d'aspetto compreso tra 0.40 e 2.50.

image_urls
Trascina un file oppure · fino a 10

Immagini di riferimento richiamate tramite @Image1, @Image2 e così via, con un massimo di 10 immagini. Ogni file è limitato a 30.0 MB, richiede almeno 300 px in entrambe le dimensioni e deve avere un rapporto d'aspetto compreso tra 0.40 e 2.50.

Istruzioni di generazione inquadratura per inquadratura, con ogni prompt che definisce un'inquadratura la cui durata contribuisce alla durata complessiva del video.

Raccolta di fino a 7 personaggi o oggetti, di cui al massimo 3 possono includere un `voice_id` e al massimo 3 possono usare un video. Richiama questi elementi come @Element1, @Element2 e così via.

POST /run/kling/v4/reference-to-video?wait=20 preventivo → 1,175 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling/v4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Kling 4.0 Reference to Video

Crea video da un `prompt` testuale oltre a immagini di riferimento, video di riferimento ed elementi di personaggi o oggetti, citati nel prompt come @Image1, @Video1 o @Element1. La durata va da 3 a 30 secondi (predefinita: 5), con output a 720p o 1080p e rapporti d'aspetto auto, 16:9, 9:16, 1:1 o 21:9. Usa `multi_prompt` per prompt specifici per ogni inquadratura; in questo caso, la durata totale è la somma delle durate delle inquadrature. I limiti sono 10 immagini, 5 video da 3-30s ciascuno e 7 elementi, di cui un massimo di 3 può includere una voce.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
promptfacoltativo
Tipostring | null
≤ 2500 caratteri
Istruzioni di generazione che soddisfano il requisito di fornire `prompt` o `multi_prompt`. Per fare riferimento agli input forniti, usa @Image1, @Video1, @Element1 e così via.
multi_promptfacoltativo
Tipoobject[]
Istruzioni di generazione inquadratura per inquadratura, con ogni prompt che definisce un'inquadratura la cui durata contribuisce alla durata complessiva del video.
multi_prompt[].promptobbligatorio
Tipostring
1 – 512 characters
Istruzioni testuali per l'inquadratura corrente.
multi_prompt[].durationfacoltativo
Tipointeger
Predefinito5
1 – 30
Durata di una singola inquadratura, misurata in secondi.
durationfacoltativo
Tipointeger
Predefinito5
3 – 30
Durata del video in secondi, da 3 a 30.
start_image_urlfacoltativo image
Tipourl · image
Immagine facoltativa del primo fotogramma che conta ai fini del limite delle immagini di riferimento. La dimensione massima del file è 30.0 MB; larghezza e altezza devono raggiungere almeno 300 px ciascuna, con un rapporto d'aspetto compreso tra 0.40 e 2.50.
image_urlsfacoltativo images
Tipourl[] · image
≤ 10 elementi
Immagini di riferimento richiamate tramite @Image1, @Image2 e così via, con un massimo di 10 immagini. Ogni file è limitato a 30.0 MB, richiede almeno 300 px in entrambe le dimensioni e deve avere un rapporto d'aspetto compreso tra 0.40 e 2.50.
video_urlsfacoltativo videos
Tipourl[] · video
≤ 5 elementi
Fino a 5 video di riferimento, richiamati tramite @Video1, @Video2 e così via; ciascuno dura 3–30 secondi (al massimo 30.05 secondi) e la loro durata totale insieme ai video degli elementi non può superare 30 secondi. Ogni file non deve superare 300 MB, con larghezza e altezza comprese tra 700 px e 4553 px. Il rapporto d'aspetto deve essere compreso tra 0.40 e 2.50 e la frequenza fotogrammi tra 23.9 e 60.05 FPS.
elementsfacoltativo
Tipoobject[]
≤ 7 elementi
Raccolta di fino a 7 personaggi o oggetti, di cui al massimo 3 possono includere un `voice_id` e al massimo 3 possono usare un video. Richiama questi elementi come @Element1, @Element2 e così via.
elements[].frontal_image_urlfacoltativo
Tipourl · image
Immagine frontale che mostra la vista principale dell'elemento. La dimensione massima del file è 30.0 MB; entrambe le dimensioni devono essere di almeno 300 px e il rapporto d'aspetto deve essere compreso tra 0.40 e 2.50.
elements[].reference_image_urlsfacoltativo
Tipourl[] · image
≤ 3 items
Immagini supplementari che mostrano diverse angolazioni dell'elemento, con da 1 a 3 viste. Ogni file può avere una dimensione massima di 30.0 MB, deve misurare almeno 300 px in entrambe le dimensioni e deve avere un rapporto d'aspetto compreso tra 0.40 e 2.50.
elements[].video_urlfacoltativo
Tipourl · video
Rappresentazione video di un elemento al posto delle immagini, della durata di 3–30 secondi (al massimo 30.05 secondi). Il file non deve superare 300 MB; larghezza e altezza devono essere comprese tra 700–4553 px. I rapporti d'aspetto supportati vanno da 0.40 a 2.50, con frequenze fotogrammi di 23.9–60.05 FPS.
elements[].voice_idfacoltativo
Tipostring | null
Voce assegnata all'elemento.
resolutionfacoltativo
Tipoenum
Predefinito1080p
720p1080p
Risoluzione dell'output.
aspect_ratiofacoltativo
Tipoenum
Predefinito16:9
auto16:99:161:121:9
Proporzioni del video, selezionate esplicitamente o derivate dai riferimenti scegliendo 'auto'.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling/v4/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1175,
    "usd": "1.175",
    "charged": 1175,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
video
object {url, content_type, file_name, file_size}Video prodotto dal modello.

Altri modelli: Da riferimento a video

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/kling/v4/reference-to-video.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt