modelli

Kling: Video O1

Markdown · JSON

Kling: Video O1

Kling VIDEO O1 è il modello video di Kuaishou guidato da riferimenti per generare e modificare scene con testo, immagini, elementi dei soggetti e un clip sorgente. Usa il suo profilo di generazione da tre a dieci secondi per la continuità visiva, le transizioni guidate tra fotogrammi e modifiche mirate a filmati esistenti.

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 VIDEO O1 è il modello video unificato di Kuaishou guidato da riferimenti. Combina una descrizione testuale con immagini, elementi dei soggetti preparati o un video sorgente per guidare nuove scene e modifiche mirate a filmati esistenti. La sua interfaccia fondamentale è un brief visivo: identifica il materiale di riferimento, descrivine il ruolo e indica l’aspetto, l’azione o la trasformazione desiderati nel video risultante.

Una nuova inquadratura può partire da testo, un’immagine iniziale o un insieme di riferimenti visivi. Usa un’immagine per definire un personaggio o un oggetto e descrivi a parole ambientazione, azione e punto di vista. Quando più riferimenti contribuiscono con caratteristiche diverse, assegna esplicitamente i loro ruoli. Un brief di prodotto può prendere l’oggetto da un’immagine e l’ambiente da un’altra, poi descrivere il movimento dell’oggetto in quell’ambientazione.

Il prompt di O1 può indicare immagini, elementi e video con marcatori di riferimento specifici, come <<<image_1>>> o <<<video_1>>>. Mantieni questi marcatori associati alla risorsa effettivamente fornita e spiega che cosa ricavarne. Il limite del prompt del produttore è di 2.500 caratteri. Un’istruzione concisa che identifica soggetto e cambiamento è più utile di una raccolta di termini di stile non collegati.

Per riferimenti basati su immagini senza un input video, il limite combinato documentato è di sette immagini di riferimento ed elementi multi-immagine in totale. Con un video di riferimento, il limite di immagini ed elementi è quattro. Questi limiti riguardano gli elementi basati su immagini; altri tipi di elementi hanno regole separate di compatibilità. Scegli il materiale che fornisce informazioni essenziali sull’aspetto o sulla scena invece di riempire il limite con viste ridondanti.

Gli input immagine usano JPG, JPEG o PNG, forniti come URL accessibile o dati immagine, con file fino a 10 MB, dimensioni di almeno 300 pixel e rapporto d’aspetto tra 1:2.5 e 2.5:1. Prepara soggetti chiari e conserva i dettagli importanti nel ritaglio. Se il lavoro richiede che un personaggio o un prodotto resti riconoscibile, specifica quali caratteristiche devono restare e controllale lungo tutto il clip completato.

I fotogrammi iniziale e finale condizionano una transizione tra confini visivi. Il flusso documentato O1 con fotogrammi di confine richiede un fotogramma iniziale quando viene fornito quello finale e non supporta il controllo iniziale/finale con più di due immagini nell’array. Quando vengono usati entrambi i fotogrammi di confine, elementi aggiuntivi dei soggetti non fanno parte di quella configurazione O1. Mantieni distinta un’attività controllata da fotogrammi dalla modifica di un video di base fornito.

Un video sorgente può avere due ruoli distinti. Come clip di base, è il filmato da modificare: indica un’aggiunta, una rimozione, un trattamento di stile o un cambiamento di composizione specifici, precisando ciò che deve restare. La modifica segue la durata del clip in ingresso e non combina quel lavoro sul video di base con il controllo dei fotogrammi di confine o la generazione di più inquadrature. Come riferimento di caratteristiche, il video fornisce contenuto, stile o informazioni di camera per una nuova inquadratura.

Un prompt con video di riferimento può anche richiedere un’inquadratura precedente o successiva. Identifica il clip sorgente e descrivi il nuovo evento visibile, come la continuazione dell’azione del soggetto o la rivelazione dell’ambiente circostante. Il riferimento comunica qui informazioni visive; controlla raccordo e continuità del soggetto prima di assemblare il nuovo segmento con il filmato originale.

Il profilo di ingresso video del produttore accetta una sorgente MP4 o MOV, fino a 200 MB, con durata minima di tre secondi. Il profilo dettagliato specifica dimensioni da 720 a 2160 pixel e frame rate da 24 a 60 fps, con rapporto d’aspetto in ingresso tra 1:2.5 e 2.5:1. Quel flusso documentato con video sorgente restituisce video a 24 fps. La durata esatta consentita dipende anche dal profilo di modello selezionato. L’intervallo di nuova generazione di O1 è da tre a dieci secondi, distinto dall’intervallo del successivo 3.0 Omni.

Le modalità O1 del produttore offrono output 720p Standard o 1080p Pro. L’inquadratura dei nuovi piani supporta le scelte documentate orizzontali, verticali e quadrate dove il flusso selezionato usa quel controllo; una modifica di video di base segue l’inquadratura sorgente. L’audio della sorgente può essere mantenuto o scartato. Il flusso di riferimenti e modifica di O1 deve restare distinto dal successivo profilo 3.0 Omni con audio nativo e storyboard personalizzato.

La generazione produce un’attività il cui risultato completato contiene il file video e la durata effettiva. La documentazione dei risultati del produttore afferma che i video generati vengono eliminati dopo 30 giorni, quindi salva prontamente il clip completato. Conserva risorse sorgenti e brief con il risultato, poi controlla cambiamento richiesto, uso dei riferimenti e continuità. Per una modifica, confronta l’area interessata e le parti che devono restare. Per una nuova inquadratura guidata da riferimenti, verifica che ogni risorsa abbia fornito le informazioni visive previste. Mantieni disponibile il clip completato per il successivo montaggio o la sequenza di produzione.

Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1

kwaivgi/kling-video-o1

Kuaishou /kwaivgi/kling-video-o1

Introduzione

Kling VIDEO O1 è il modello video di Kuaishou guidato da riferimenti per generare e modificare scene con testo, immagini, elementi dei soggetti e un clip sorgente. Usa il suo profilo di generazione da tre a dieci secondi per la continuità visiva, le transizioni guidate tra fotogrammi e modifiche mirate a filmati esistenti.

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
Formato di output
byte MP4 originali; nessuna normalizzazione o transcodifica
CampoTipoRequisitoValori e limitiPredefinito
CampomodelTipostringRequisitoObbligatorioValori e limiti
kwaivgi/kling-video-o1
Predefinito—
CampopromptTipostringRequisitoObbligatorioValori e limitiPredefinito—
CampodurationTipointegerRequisitoObbligatorioValori e limiti
5, 10
Minimo: 1
Massimo: 600
Predefinito—
CamporesolutionTipostringRequisitoFacoltativoValori e limiti
720p
Predefinito—
Campoaspect_ratioTipostringRequisitoFacoltativoValori e limiti
16:9, 9:16, 1:1
Predefinito—
Campogenerate_audioTipobooleanRequisitoFacoltativoValori e limiti
false, true
Predefinito—
Campoframe_imagesTipoarrayRequisitoFacoltativoValori e limiti
Numero minimo di elementi: 1
Numero massimo di elementi: 2
Contenuto in input: Array di oggetti fotogramma. Ogni oggetto contiene type=image_url, image_url con url e frame_type. Usa un URL HTTPS dell'immagine e imposta frame_type su first_frame o last_frame. Ogni ruolo del fotogramma compare al massimo una volta.
Chiavi esatte: type, image_url, frame_type
Condizioni: Queste chiavi descrivono ogni oggetto fotogramma; image_url contiene solo url. Ometti frame_images per una richiesta di solo testo.
Predefinito—
Campoinput_referencesTipoarrayRequisitoFacoltativoValori e limitiPredefinito—
CamposizeTipostringRequisitoFacoltativoValori e limiti
1280x720, 720x1280, 720x720
Schema: ^[1-9][0-9]*x[1-9][0-9]*$
Predefinito—
Campocallback_urlTipostringRequisitoFacoltativoValori e limiti
Schema: ^https://
Predefinito—
Camposession_idTipostringRequisitoFacoltativoValori e limitiPredefinito—
CampotraceTipoobjectRequisitoFacoltativoValori e limitiPredefinito—
CampouserTipostringRequisitoFacoltativoValori e limitiPredefinito—
Combinazioni di materiali in input

Da testo a video · Un prompt scritto. · Obbligatorio: model, prompt, duration

Fornisci il prompt come testo e la durata in secondi interi. Scegli una risoluzione supportata; aggiungi un rapporto d'aspetto oppure usa una dimensione elencata.

model: Tipo: string · kwaivgi/kling-video-o1

prompt: Tipo: string · Numero massimo di byte UTF-8: 10.000 · Sono richiesti caratteri diversi dagli spazi: Sì

Da immagine a video · Un prompt scritto e un'immagine del primo fotogramma. · Obbligatorio: model, prompt, duration, frame_images

frame_images è un array. Ogni oggetto fotogramma contiene type, image_url e frame_type; image_url contiene url. Imposta type su image_url. Usa first_frame con last_frame facoltativo. Ogni ruolo del fotogramma può comparire al massimo una volta. Fornisci un URL HTTPS pubblico dell'immagine per ogni fotogramma. Scegli una risoluzione supportata; aggiungi un rapporto d'aspetto oppure usa una dimensione elencata.

Chiavi esatte: type, image_url, frame_type

model: Tipo: string · kwaivgi/kling-video-o1

prompt: Tipo: string · Numero massimo di byte UTF-8: 10.000 · Sono richiesti caratteri diversi dagli spazi: Sì

Parametri e ciclo di vita del metodo
ParametroContratto
Parametrocontent_typeContrattoapplication/json
ParametrorequiredContrattomodel, prompt, duration
Parametromaterial_typesContrattotext, image
Parametroadditional_propertiesContrattofalse
Parametrooptional_controlsContrattoresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user

Ciclo di vita: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

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.

ConfigurazioneListino delle tariffeQuantità previstaUnità di fatturazioneCondizioni di fatturazioneCosto
ConfigurazioneTariffe base dei tokenListino delle tariffeTariffa baseQuantità prevista—Unità di fatturazione—Condizioni di fatturazione—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
ConfigurazionePrezzo del videoListino delle tariffe—Quantità prevista—Unità di fatturazioneper secondo di videoCondizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva.Costo
Output · Prezzo del video · Stima solo a fini di confronto $0.224 per secondo di video
ConfigurazioneCosto stimato della generazioneListino delle tariffe—Quantità previstastima per una generazioneUnità di fatturazione—Condizioni di fatturazione—Costo
Output · Costo di generazione stimato · Stima solo a fini di confronto $1.12 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 →

Dettagli della tariffa di riferimento

I listini di riferimento del modello non modificano la selezione del metodo, i preventivi o gli addebiti. Gli addebiti attivi usano le tariffe del metodo Ailoot selezionato.

Riferimenti tariffari delle configurazioni video

Prezzi per configurazione

ConfigurazioneCondizioni di fatturazioneCosto
ConfigurazionePrezzo del videoCondizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva.Costo
Output · Prezzo del video $0.224 per secondo di video

Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata.

Esempi di richieste

Ailoot Ultra · Video

curl · crea un video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":5,"model":"kwaivgi/kling-video-o1","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Ricevi e salva i risultati

Ailoot Ultra · Video

URL firmati di contenuti di tua proprietà

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_id}/content
Verifica lo stato dell’attività
GET stato dell’operazione originale
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Altre letture di contenuto
Salva ogni output completato di tua proprietà
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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Conserva tutti i risultati completati

Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.

Conserva ogni risultato effettivo di tua proprietà e i metadati misurati restituiti.

Se occorre verificare la risposta originale

503 result_pending_check + id originale + X-Should-Retry:false; non ripetere mai l'operazione originale

Campi della risposta
CampoTipoSignificato
CampoindexTipointegerSignificatoPosizione di questo video nell'elenco dei risultati, con indice a partire da zero.
Campocontent_urlTipostringSignificatoURL HTTPS firmato per il download di questo video completato.
Camposha256Tipostring | nullSignificatoDigest SHA-256 dei byte video originali; null se non disponibile.
Camposize_bytesTipointeger | nullSignificatoDimensione del file video originale in byte; null se non disponibile.
Campoduration_msTipointeger | nullSignificatoDurata misurata del video in millisecondi; null se non disponibile.
CampowidthTipointeger | nullSignificatoLarghezza del video in pixel; null se non disponibile.
CampoheightTipointeger | nullSignificatoAltezza del video in pixel; null se non disponibile.
Campovideo_codecTipostring | nullSignificatoIdentificatore del codec video; null se non registrato.
Campohas_audioTipoboolean | nullSignificatoIndica se il video contiene una traccia audio; null se non misurato.
Campoaudio_codecTipostring | nullSignificatoIdentificatore del codec audio; null quando non è registrato alcun identificatore.
Errori e passaggi successivi
RispostaCondizionePassaggio successivo
Risposta404 · not_found_errorCondizioneL'accesso al video non è disponibile oppure questo ID video non è stato trovato.Passaggio successivoVerifica l'accesso al video. Per un video esistente, usa l'ID pubblico originale e la stessa chiave API.
Risposta401 · authentication_errorCondizioneLa chiave API non corrisponde all'account autenticato.Passaggio successivoVerifica la chiave API e l'accesso all'account prima dell'invio.
Risposta400 · invalid_request_errorCondizioneNon è stato possibile leggere la richiesta oppure l'indice di download non è valido.Passaggio successivoCorreggi il corpo della richiesta. Per un download, scegli un indice di uscita restituito dall'attività originale.
Risposta422 · price_unavailableCondizioneNon è possibile determinare il prezzo della configurazione video selezionata.Passaggio successivoScegli una configurazione video supportata e completa le opzioni obbligatorie prima di inviare una richiesta corretta.
Risposta422 · invalid_request_errorCondizioneUn input video o l'attività originale di continuazione non è valido.Passaggio successivoUsa input HTTPS validi. Per la continuazione, usa l'ID video pubblico del tuo originale completato con la stessa chiave API.
Risposta402 · billing_errorCondizioneIl saldo disponibile o i limiti non consentono di riservare l'importo.Passaggio successivoControlla il saldo disponibile e i limiti prima di inviare una nuova richiesta.
Risposta503 · server_errorCondizioneLa verifica video, l’archiviazione o l’accesso al servizio sono temporaneamente indisponibili.Passaggio successivoAttendi che il servizio sia disponibile. Se hai già un ID video, verifica quell'attività originale invece di creare un'altra generazione.
Risposta503 · result_pending_checkCondizioneIl risultato video originale e l'addebito devono essere verificati.Passaggio successivoConserva l'ID video restituito e verifica quell'attività. Non inviare una richiesta di generazione sostitutiva mentre la verifica è in corso.
Risposta503 · owned_result_unavailableCondizioneIl download del video esistente è temporaneamente indisponibile.Passaggio successivoVerifica in seguito la stessa attività video e scarica il risultato esistente. Una nuova generazione crea un'operazione separata.
Risposta409 · video_not_readyCondizioneIl contenuto video non è stato pubblicato.Passaggio successivoVerifica lo stato dell'attività originale. Scarica dopo che segnala completed; se segnala failed, segui l'avviso di verifica dell'addebito.

Alias

Alias del modello

Ailoot Ultra kwaivgi/kling-video-o1

Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

ID di chiamata correlati

kwaivgi/kling-video-o1

FAQ · Kling: Video O1
Quali input e risultati sono disponibili?

POST /v1/videos · kwaivgi/kling-video-o1: text, image → video

Quali campi usa la richiesta?

POST /v1/videos · kwaivgi/kling-video-o1: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user

Quali limiti si applicano?

POST /v1/videos · kwaivgi/kling-video-o1: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 2; frame_images.min_items: 1

Maggiori dettagli

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento
Scegli un piano scontato per richieste regolari.
Codice fino al 50%
Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.
Spese nella cronologia
Modello, token e importo sono salvati per ogni richiesta.

Scegli abbonamento · Consulta prezzi dei modelli

Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale
Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.
Licenza reseller
Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.
Documenti sul sito
Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

Richiedi licenza reseller · Offerta e accordo di licenza