Kling v1.5
Kling v1.5 è un modello video con un flusso di lavoro image-to-video documentato. Parti da un'immagine statica preparata e descrivi il movimento, il punto di vista e la composizione finale per una breve ripresa di un personaggio, un oggetto o un ambiente.
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.
Kling v1.5 è un'edizione di Kling per la generazione video che, nel catalogo documentato dei modelli, include la funzione image-to-video. Un'immagine statica fornita costituisce il punto di partenza visivo, mentre il brief scritto descrive come deve muoversi la scena. Usala per sviluppare il gesto di un personaggio, il movimento di un oggetto o la trasformazione di un ambiente a partire da un'immagine la cui composizione sia già adatta alla ripresa.
Prepara l'immagine mettendo al centro i dettagli importanti del soggetto. Per un personaggio servono un volto, una posa e un abbigliamento ben leggibili; per un oggetto occorrono un contorno chiaro e caratteristiche dei materiali visibili. Lascia nella composizione lo spazio necessario al movimento previsto. Conserva l'immagine statica originale insieme alla sequenza completata per valutare direttamente i cambiamenti nell'aspetto.
Scrivi l'azione come un evento osservabile. Per esempio, descrivi una persona seduta che si volta verso una finestra o un nastro di tessuto che si muove in una brezza leggera. Specifica la direzione e la conclusione desiderata. Quando compaiono più oggetti, identifica quello che agisce e quelli che restano al loro posto.
Spiega il ruolo della camera. Un punto di vista fisso può rendere facile esaminare un piccolo gesto, mentre un punto di vista in movimento può mostrare un nuovo lato della scena. Descrivi tale movimento in relazione al soggetto. Chiedere di avvicinarsi al soggetto e chiedere al soggetto di avvicinarsi alla camera esprime intenzioni visive diverse.
La scheda image-to-video documentata elenca durate di cinque e dieci secondi, modalità std e pro e inquadrature orizzontali, verticali e quadrate. Scegli le impostazioni offerte dal flusso di lavoro selezionato prima di valutare il risultato. Quando confronti diverse proposte di ripresa, conserva la modalità, la durata e il formato effettivi insieme all'immagine sorgente e al prompt.
Per la presentazione di un oggetto, definisci la caratteristica visiva che il movimento deve mostrare. Può trattarsi di una superficie riflettente, della piega di un materiale o della forma di una maniglia. Mantieni l'azione sufficientemente mirata da lasciare visibile il dettaglio importante. Valuta l'oggetto durante tutto il movimento e nella vista finale usata nel montaggio.
Per una scena con un personaggio, descrivi un gesto significativo e il rapporto del personaggio con gli oggetti vicini. Esamina nel tempo il volto, le mani, l'abbigliamento e le proporzioni del corpo. Verifica che il gesto arrivi alla conclusione prevista e che la scena mantenga una disposizione coerente degli elementi in primo piano e sullo sfondo.
Conserva la clip generata completa e i suoi materiali sorgente. Esamina l'apertura, l'azione centrale e la conclusione come un'unica sequenza, quindi basa le revisioni su una discrepanza concreta. Una nota come «il personaggio si volta dalla parte opposta alla finestra» fornisce al brief successivo una correzione specifica, preservando il resto della scena.
Ailoot Ultra · Video POST /v1/videos kling-v1-5
kling-v1-5Introduzione
Kling v1.5 è un modello video con un flusso di lavoro image-to-video documentato. Parti da un'immagine statica preparata e descrivi il movimento, il punto di vista e la composizione finale per una breve ripresa di un personaggio, un oggetto o un ambiente.
- Input accettati
- Testo · Immagini
- Risultati
- Video
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Video POST /v1/videos
- Tipi di input
text,image- Tipi di output
video
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti kling-v1-5 Condizioni: Usa esattamente questo selettore di instradamento di Ailoot. | Predefinito— |
Campomode | Tipostring | RequisitoFacoltativo | Valori e limiti std, pro Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinitostd |
Campoaspect_ratio | Tipostring | RequisitoFacoltativo | Valori e limiti 16:9, 9:16, 1:1 Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Campoduration | Tipointeger | RequisitoFacoltativo | Valori e limiti 5, 10 Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Campoend_image | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Campoimage | Tipostring or array<string> | RequisitoObbligatorio | Valori e limiti Condizioni: Fornisci un URL reale e raggiungibile della tua immagine. Una lista è accettata solo quando lo schema del parametro prevede un array. | Predefinito— |
Camponegative_prompt | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Condizioni: Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt, image |
Parametrooptional | Contrattomode, aspect_ratio, duration, end_image, negative_prompt |
Parametromaterial_types | Contrattotext, image |
Parametroconditions | ContrattoUsa esattamente questo selettore di instradamento di Ailoot., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Fornisci un URL reale e raggiungibile della tua immagine. Una lista è accettata solo quando lo schema del parametro prevede un array., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato., Usa il campo documentato per il modello selezionato e le opzioni indicate; ometti un valore facoltativo non specificato. |
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 |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $6 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
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
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-5", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')
p['image']=os.environ['AILOOT_IMAGE_URL']
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.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
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.
Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.
Se occorre verificare la risposta originale
Conserva l'id pubblico dell'attività o dell'operazione restituito e tutte le intestazioni. Consulta solo l'attività originale; unknown o result_pending_check non autorizza un'altra creazione.
Campi della risposta
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campopolling_url | Tipostring |
Campoprovider_task_id | Tipostring |
Campotask_id | Tipostring |
Campostatus | Tipostring |
Campovideo_url | Tipostring |
Errori e passaggi successivi
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneUn campo obbligatorio, il selettore del modello, il tipo o la rappresentazione dei dati in ingresso non è valido. | Passaggio successivoEsamina i dettagli di validazione restituiti prima di preparare una richiesta separata. |
Risposta | CondizioneLa richiesta originale o il relativo risultato è sconosciuto o richiede una verifica. | Passaggio successivoConserva gli identificatori e le intestazioni originali; consulta solo i record di stato o della libreria supportati. Non inviare di nuovo la richiesta di creazione. |
Alias
Alias del modello
Ailoot Ultra kling-v1-5
Alias dei percorsi dei metodi
/v1/videos/generations
ID di chiamata correlati
FAQ · Kling v1.5
- Quali input e risultati sono disponibili?
POST /v1/videos·kling-v1-5:text,image→video- Quali campi usa la richiesta?
POST /v1/videos·kling-v1-5:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt