kling-v1-6
Il profilo kling-v1-6 genera video da una descrizione scritta della scena. Pianifica una breve inquadratura con un soggetto, un'azione e una direzione della camera chiari, usando le opzioni documentate di durata di cinque o dieci secondi. La generazione è asincrona: conserva l'identità del compito restituita e recupera il video completato dopo la riuscita del compito originale.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Il selettore esatto kling-v1-6 identifica il profilo Kling da testo a video. Invia JSON a POST /v1/videos/generations con model impostato a kling-v1-6 e la scena scritta in prompt. Anche POST /v1/videos accetta la stessa richiesta di generazione. Una richiesta chiara descrive cosa è visibile, cosa accade durante l'inquadratura e come la camera lo osserva. La richiesta minima della scena fornisce il selettore del modello e prompt, lasciando non specificati i controlli aggiuntivi dell'inquadratura.
Per un'inquadratura di prodotto, descrivi l'oggetto, la superficie, l'illuminazione e un'azione visibile, come una lenta rotazione o un cambiamento della posizione della camera. Per un concept di scena, identifica l'ambientazione, il soggetto principale e il movimento attraverso l'inquadratura. Mantieni l'azione leggibile entro la clip richiesta. Un prompt potrebbe descrivere una piccola barca che attraversa un lago immobile, un campo largo dalla riva, la luce del primo mattino e una camera stabile che segue la direzione della barca.
Il limite del prompt è di 500 caratteri. Il parametro facoltativo negative_prompt può contenere fino a 200 caratteri e descrive gli elementi indesiderati. Le durate documentate per questo profilo sono di 5 e 10 secondi. I valori di mode sono std e pro. cfg_scale è un numero da 0 a 1; la documentazione descrive i valori più alti come una maggiore aderenza al testo. Scegli i controlli per l'inquadratura esatta e conserva i valori inviati insieme al risultato.
L'oggetto camera_control documentato elenca i tipi di camera simple, down_back, forward_up, right_turn_forward e left_turn_forward. La configurazione simple indica i controlli horizontal, vertical, pan, tilt, roll e zoom. L'esempio testuale minimo offre un punto di partenza utile quando una scena può essere descritta senza un oggetto separato di controllo della camera. Assegna al movimento della camera uno scopo chiaro nel prompt, come rivelare il soggetto o seguirne il movimento.
L'invio avvia un compito asincrono. Conserva l'id restituito, l'header X-Ailoot-Task-Id e polling_url, quindi usa GET su quel polling_url con la stessa chiave API Ailoot per leggere il compito originale. Lo stato del compito è in data.task_status: submitted e processing indicano attesa, succeed indica riuscita e failed indica fallimento. La conferma di invio è quindi un risultato intermedio. In caso di riuscita, recupera ogni URL in data.task_result.videos[].url; sono link a file di risultato gestiti da Ailoot. GET /v1/videos/{id}/content recupera il primo output, mentre il parametro di query index seleziona un output restituito in base al suo indice a partire da zero. Conserva la risposta di stato con la clip selezionata. Se si verifica un timeout o una risposta result_pending_check, conserva l'identità originale restituita e controlla quell'operazione, invece di inviare nuovamente l'inquadratura.
Esamina il filmato completato per tutta la sua durata: l'azione desiderata, l'aspetto del soggetto, l'inquadratura e il movimento fanno tutti parte del brief. Questo esatto profilo offre il flusso da testo a video qui descritto. Un compito restituito che richiede ancora una verifica dello stato va seguito usando la sua identità originale, anche quando una richiesta client va in timeout; conserva le informazioni del compito prima di considerare una nuova richiesta di generazione.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6Introduzione
Il profilo kling-v1-6 genera video da una descrizione scritta della scena. Pianifica una breve inquadratura con un soggetto, un'azione e una direzione della camera chiari, usando le opzioni documentate di durata di cinque o dieci secondi. La generazione è asincrona: conserva l'identità del compito restituita e recupera il video completato dopo la riuscita del compito originale.
- Input accettati
- Testo
- Risultati
- Video
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Video POST /v1/videos
- Tipi di input
text- Tipi di output
video
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti kling-v1-6 | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Campomode | Tipostring | RequisitoObbligatorio | Valori e limiti std, pro | Predefinito— |
Campomodel_name | Tipostring | RequisitoFacoltativo | Valori e limiti kling-v1-6 | Predefinito— |
Campocfg_scale | Tiponumber | RequisitoFacoltativo | Valori e limiti Minimo: 0 Massimo: 1 | Predefinito— |
Campoaspect_ratio | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Camponegative_prompt | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campoduration | Tipointeger | RequisitoFacoltativo | Valori e limiti 5, 10 | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt, mode |
Parametrooptional | Contrattomodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parametromaterial_types | Contrattotext |
Parametroconditions | Contrattomodel selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
Alias del metodo: /v1/videos/generations
Ciclo di vita: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Costo |
|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazioneEstimated generation cost | Listino delle tariffe— | Quantità previstastima per una generazione | Costo Input · Costo di generazione stimato · Stima solo a fini di confronto $6 stima prima della generazione This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-6", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Ricevi e salva i risultati
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva tutti i risultati completati
Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Retain the complete response, all actual results, original identifiers, usage and response headers.
Se occorre verificare la risposta originale
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
Campi della risposta
| Campo | Tipo |
|---|---|
Campodata.task_result.videos[].url | Tipostring or array, as returned |
Alias
Alias del modello
Ailoot Ultra kling-v1-6
Alias dei percorsi dei metodi
/v1/videos/generations
ID di chiamata correlati
FAQ · kling-v1-6
- Quali input e risultati sono disponibili?
POST /v1/videos·kling-v1-6:text→video- Quali campi usa la richiesta?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Quali limiti si applicano?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1