Kling v2.1 Master è un'edizione video Kling con funzioni text-to-video e image-to-video nel catalogo documentato dei modelli. Scegli un brief scritto della scena quando sviluppi un'idea visiva a partire dal testo, oppure un brief basato su un'immagine quando il soggetto e la composizione sono già definiti. In entrambi i casi, stabilisci l'evento che la ripresa completata deve mostrare.
Per la creazione a partire dal testo, descrivi il soggetto, l'ambientazione e l'azione in un ordine chiaro. Un ballerino che attraversa una sala, un veicolo che passa sotto gli alberi o un oggetto di vetro che cattura una luce mutevole danno ciascuno alla sequenza uno scopo specifico. Includi i dettagli che determinano l'aspetto della scena e mantienili coerenti in tutto il brief.
Per la creazione a partire da un'immagine, prepara un riferimento che mostri le caratteristiche da preservare nella ripresa. Mantieni visibili i volti, i bordi degli oggetti e i materiali distintivi. Descrivi cosa cambia rispetto alla vista iniziale: il gesto del soggetto, un movimento dell'ambiente o la posizione della camera. Tieni a disposizione l'immagine sorgente quando esamini il risultato.
Pianifica l'azione in funzione della sua conclusione. Una persona che posa un oggetto deve terminare con quell'oggetto in un luogo identificabile; una rivelazione deve concludersi con la caratteristica importante visibile. Questo facilita la scelta di un punto di montaggio e la valutazione dell'efficacia del movimento rispetto al suo scopo.
La scheda del modello documentata include durate di cinque e dieci secondi, modalità std e pro e formati orizzontali, verticali e quadrati. Scegli i controlli disponibili nel flusso di lavoro selezionato e conservane i valori effettivi. Valuta la clip risultante rispetto all'azione e all'inquadratura desiderate, anziché in base al nome dell'edizione del modello.
Descrivi separatamente il movimento del soggetto e quello della camera. Per una ripresa in inseguimento, indica quale soggetto viene seguito dalla camera e quali parti dell'ambiente devono attraversare l'inquadratura. Per una ripresa fissa, indica il movimento che avviene al suo interno. Collega le indicazioni sulla camera a ciò che lo spettatore deve notare.
Esamina la continuità nell'intera sequenza. Verifica che il soggetto importante resti riconoscibile, che le interazioni siano coerenti nello spazio e che i tempi lascino margine al raccordo di montaggio previsto. Osserva i cambiamenti nelle mani, nei volti, nei dettagli delle superfici e negli oggetti che si sovrappongono. Valuta il movimento oltre al singolo fotogramma migliore.
Conserva ogni video completato insieme al relativo prompt, riferimento e impostazioni. Usa lo stesso brief quando confronti una scena tra edizioni e annota le differenze visive effettive. Quando correggi una proposta, descrivi il problema osservato e modifica l'istruzione corrispondente, mantenendo gli elementi utili della scena.
", "aboutText": "Kling v2.1 Master è un'edizione video Kling con funzioni text-to-video e image-to-video nel catalogo documentato dei modelli. Scegli un brief scritto della scena quando sviluppi un'idea visiva a partire dal testo, oppure un brief basato su un'immagine quando il soggetto e la composizione sono già definiti. In entrambi i casi, stabilisci l'evento che la ripresa completata deve mostrare.\n\nPer la creazione a partire dal testo, descrivi il soggetto, l'ambientazione e l'azione in un ordine chiaro. Un ballerino che attraversa una sala, un veicolo che passa sotto gli alberi o un oggetto di vetro che cattura una luce mutevole danno ciascuno alla sequenza uno scopo specifico. Includi i dettagli che determinano l'aspetto della scena e mantienili coerenti in tutto il brief.\n\nPer la creazione a partire da un'immagine, prepara un riferimento che mostri le caratteristiche da preservare nella ripresa. Mantieni visibili i volti, i bordi degli oggetti e i materiali distintivi. Descrivi cosa cambia rispetto alla vista iniziale: il gesto del soggetto, un movimento dell'ambiente o la posizione della camera. Tieni a disposizione l'immagine sorgente quando esamini il risultato.\n\nPianifica l'azione in funzione della sua conclusione. Una persona che posa un oggetto deve terminare con quell'oggetto in un luogo identificabile; una rivelazione deve concludersi con la caratteristica importante visibile. Questo facilita la scelta di un punto di montaggio e la valutazione dell'efficacia del movimento rispetto al suo scopo.\n\nLa scheda del modello documentata include durate di cinque e dieci secondi, modalità std e pro e formati orizzontali, verticali e quadrati. Scegli i controlli disponibili nel flusso di lavoro selezionato e conservane i valori effettivi. Valuta la clip risultante rispetto all'azione e all'inquadratura desiderate, anziché in base al nome dell'edizione del modello.\n\nDescrivi separatamente il movimento del soggetto e quello della camera. Per una ripresa in inseguimento, indica quale soggetto viene seguito dalla camera e quali parti dell'ambiente devono attraversare l'inquadratura. Per una ripresa fissa, indica il movimento che avviene al suo interno. Collega le indicazioni sulla camera a ciò che lo spettatore deve notare.\n\nEsamina la continuità nell'intera sequenza. Verifica che il soggetto importante resti riconoscibile, che le interazioni siano coerenti nello spazio e che i tempi lascino margine al raccordo di montaggio previsto. Osserva i cambiamenti nelle mani, nei volti, nei dettagli delle superfici e negli oggetti che si sovrappongono. Valuta il movimento oltre al singolo fotogramma migliore.\n\nConserva ogni video completato insieme al relativo prompt, riferimento e impostazioni. Usa lo stesso brief quando confronti una scena tra edizioni e annota le differenze visive effettive. Quando correggi una proposta, descrivi il problema osservato e modifica l'istruzione corrispondente, mantenendo gli elementi utili della scena.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "990289113b672547ee48ff5df91c32af4ce87ea909f57276847160974c8e5d9a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "kling-v2-1-masterKling v2.1 Master genera video da un testo o da un brief basato su un'immagine. Usalo per un evento visivo definito, pianificando il soggetto, l'azione, le indicazioni sulla camera e la conclusione come un'unica breve ripresa coerente.
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 v2.1 Master è un'edizione video Kling con funzioni text-to-video e image-to-video nel catalogo documentato dei modelli. Scegli un brief scritto della scena quando sviluppi un'idea visiva a partire dal testo, oppure un brief basato su un'immagine quando il soggetto e la composizione sono già definiti. In entrambi i casi, stabilisci l'evento che la ripresa completata deve mostrare.
Per la creazione a partire dal testo, descrivi il soggetto, l'ambientazione e l'azione in un ordine chiaro. Un ballerino che attraversa una sala, un veicolo che passa sotto gli alberi o un oggetto di vetro che cattura una luce mutevole danno ciascuno alla sequenza uno scopo specifico. Includi i dettagli che determinano l'aspetto della scena e mantienili coerenti in tutto il brief.
Per la creazione a partire da un'immagine, prepara un riferimento che mostri le caratteristiche da preservare nella ripresa. Mantieni visibili i volti, i bordi degli oggetti e i materiali distintivi. Descrivi cosa cambia rispetto alla vista iniziale: il gesto del soggetto, un movimento dell'ambiente o la posizione della camera. Tieni a disposizione l'immagine sorgente quando esamini il risultato.
Pianifica l'azione in funzione della sua conclusione. Una persona che posa un oggetto deve terminare con quell'oggetto in un luogo identificabile; una rivelazione deve concludersi con la caratteristica importante visibile. Questo facilita la scelta di un punto di montaggio e la valutazione dell'efficacia del movimento rispetto al suo scopo.
La scheda del modello documentata include durate di cinque e dieci secondi, modalità std e pro e formati orizzontali, verticali e quadrati. Scegli i controlli disponibili nel flusso di lavoro selezionato e conservane i valori effettivi. Valuta la clip risultante rispetto all'azione e all'inquadratura desiderate, anziché in base al nome dell'edizione del modello.
Descrivi separatamente il movimento del soggetto e quello della camera. Per una ripresa in inseguimento, indica quale soggetto viene seguito dalla camera e quali parti dell'ambiente devono attraversare l'inquadratura. Per una ripresa fissa, indica il movimento che avviene al suo interno. Collega le indicazioni sulla camera a ciò che lo spettatore deve notare.
Esamina la continuità nell'intera sequenza. Verifica che il soggetto importante resti riconoscibile, che le interazioni siano coerenti nello spazio e che i tempi lascino margine al raccordo di montaggio previsto. Osserva i cambiamenti nelle mani, nei volti, nei dettagli delle superfici e negli oggetti che si sovrappongono. Valuta il movimento oltre al singolo fotogramma migliore.
Conserva ogni video completato insieme al relativo prompt, riferimento e impostazioni. Usa lo stesso brief quando confronti una scena tra edizioni e annota le differenze visive effettive. Quando correggi una proposta, descrivi il problema osservato e modifica l'istruzione corrispondente, mantenendo gli elementi utili della scena.
POST /v1/videostextvideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti kling-v2-1-master Condizioni: Usa esattamente questo selettore di instradamento di Ailoot. | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza massima: 500 Condizioni: | Predefinito— |
Campomode | Tipostring | RequisitoObbligatorio | Valori e limiti std, pro Condizioni: | Predefinito— |
Campomodel_name | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Valore nativo sostitutivo facoltativo. Omettilo per usare automaticamente il modello selezionato; un valore esplicito viene conservato. | Predefinito— |
Campocfg_scale | Tiponumber | RequisitoFacoltativo | Valori e limiti Minimo: 0 Massimo: 1 Condizioni: | Predefinito— |
Campoaspect_ratio | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: | Predefinito— |
Camponegative_prompt | Tipostring | RequisitoFacoltativo | Valori e limiti Lunghezza massima: 200 Condizioni: | Predefinito— |
Campoduration | Tipointeger | RequisitoFacoltativo | Valori e limiti 5, 10 Condizioni: | Predefinito— |
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt, mode |
Parametrooptional | Contrattomodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parametromaterial_types | Contrattotext |
Parametroconditions | ContrattoUsa esattamente questo selettore di instradamento di Ailoot., Valore nativo sostitutivo facoltativo. Omettilo per usare automaticamente il modello selezionato; un valore esplicito viene conservato. |
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}
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "kling-v2-1-master", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.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)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n 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"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n 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"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}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.
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.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campopolling_url | Tipostring |
Campoprovider_task_id | Tipostring |
Campodata.task_id | Tipostring |
Campodata.task_status | Tipostring |
Campodata.task_result.videos[].url | Tipostring |
| 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. |
Ailoot Ultra kling-v2-1-master
/v1/videos/generations