Kling VIDEO 3.0 Pro è il profilo professionale del modello VIDEO 3.0 di Kuaishou. La modalità Pro documentata produce video 1080p da un brief testuale o da una scena guidata da immagini, con clip da tre a quindici secondi. L’edizione 3.0 combina audio nativo, controlli di coerenza del soggetto e regia su più inquadrature, offrendo a una breve produzione un modo chiaro per specificare aspetto, azione, copertura della camera e suono.
Inizia dall’azione principale della scena. In un’inquadratura guidata da testo, descrivi soggetto, ambiente, luce e punto di vista che rende leggibile l’azione. In una guidata da immagini, lascia che l’immagine iniziale definisca aspetto e composizione, poi usa il testo per ciò che cambia nel tempo. Per un concept di prodotto, un’immagine preparata può mostrare l’oggetto su una superficie da studio mentre il prompt descrive una lenta rivelazione del materiale e della forma.
La regia su più inquadrature offre copertura automatica o una sequenza personalizzata. La generazione automatica pianifica cambi di inquadratura e angolazione della camera a partire dal brief; una scena adatta a una vista continua può comunque restare un’unica inquadratura. Uno storyboard personalizzato consente di definire contenuto e durata di ogni inquadratura. Il profilo del produttore per inquadrature personalizzate ne permette da una a sei, con al massimo 512 caratteri per inquadratura e almeno un secondo per ciascuna; la somma delle loro durate deve coincidere con la durata totale del clip.
Per una breve narrazione, descrivi una vista d’ambientazione, l’azione principale e un dettaglio conclusivo come inquadrature separate. Specifica il trattamento della camera e ciò che il pubblico deve notare in ognuna. Mantieni coerente l’aspetto di un soggetto ricorrente nel brief, cambiando deliberatamente azione e copertura. Il campo del prompt unico nel riferimento del produttore accetta fino a 2.500 caratteri; una sequenza personalizzata usa descrizioni separate per ciascuna inquadratura.
I riferimenti dei soggetti possono sostenere una scena guidata da immagini quando personaggio, prodotto o ambientazione devono restare riconoscibili. Scegli viste chiare che comunichino le caratteristiche da mantenere e denomina coerentemente ogni soggetto di riferimento. Il profilo documentato guidato da immagini consente fino a tre elementi preparati. Mantieni focalizzati i ruoli dei riferimenti invece di combinare più risorse che danno istruzioni contrastanti sull’aspetto del soggetto.
I fotogrammi iniziale e finale forniscono confini visivi per una transizione condizionata da immagini. Prepara fotogrammi coerenti sul soggetto e sulla scena prevista, poi descrivi il movimento che li collega. L’input di fotogrammi supportato dal produttore usa immagini JPG, JPEG o PNG, con file non superiori a 10 MB, dimensioni di almeno 300 pixel e rapporto d’aspetto dell’immagine iniziale tra 1:2.5 e 2.5:1. Un’attività controllata da fotogrammi e uno storyboard personalizzato hanno una propria gestione degli input, quindi organizza il materiale per il flusso selezionato prima di scrivere il brief completo.
L’audio nativo può combinare battute, atmosfera e recitazione visiva. L’audio è disattivato per impostazione predefinita nel riferimento del produttore e viene abilitato per una scena audiovisiva. Il profilo linguistico 3.0 comprende cinese, inglese, giapponese, coreano e spagnolo, insieme all’alternanza di lingue e ai dialetti o accenti supportati. La guida del produttore afferma che il dialogo inserito in un’altra lingua viene tradotto in inglese. Assegna ogni battuta al soggetto previsto e distingui il dialogo dal suono di sfondo, così il brief audio spiega chi parla e ciò che circonda l’azione.
Un brief con due personaggi può identificare Parlante A e Parlante B, dare a ciascuno una breve battuta e descrivere la risposta visibile tra loro. Mantieni il dialogo proporzionato alla durata del clip e identifica il parlante quando cambia la vista. Indicazioni vocali e riferimento di un personaggio hanno scopi differenti; il brief deve specificare l’interpretazione desiderata invece di presumere che un’immagine di riferimento contenga le parole da pronunciare.
VIDEO 3.0 migliora anche la gestione delle scritte visibili in una scena guidata da immagini. Se un’insegna, un’etichetta o una didascalia sono importanti, identificale nel brief e preservane l’aspetto di riferimento. Controlla ortografia, leggibilità e movimento di quelle scritte nel clip completato, soprattutto quando veicolano un messaggio di prodotto o di campagna. La funzione del modello dedicata alle scritte guida la generazione invece di sostituire un controllo visivo finale.
Il profilo Pro è 1080p; quello Standard è 720p. La modalità 4K selezionata separatamente dal produttore è un altro profilo di output, quindi Pro non va considerato un sinonimo di qualsiasi impostazione a risoluzione superiore. Per la generazione da testo, le scelte documentate di inquadratura comprendono 16:9, 9:16 e 1:1. Scegli il fotogramma per la collocazione prevista e mantieni leggibile la composizione al suo interno.
La generazione viene eseguita come un’attività il cui risultato riuscito rende disponibili il file video completato 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 il video con brief e risorse di riferimento, poi controlla continuità del soggetto, ordine richiesto delle inquadrature, movimento di camera, dialogo e scritte. Usa il clip selezionato come concept cinematografico, scena di prodotto o breve narrazione e apporta una revisione mirata alla parte che non ha raggiunto il risultato previsto.
", "aboutText": "Kling VIDEO 3.0 Pro è il profilo professionale del modello VIDEO 3.0 di Kuaishou. La modalità Pro documentata produce video 1080p da un brief testuale o da una scena guidata da immagini, con clip da tre a quindici secondi. L’edizione 3.0 combina audio nativo, controlli di coerenza del soggetto e regia su più inquadrature, offrendo a una breve produzione un modo chiaro per specificare aspetto, azione, copertura della camera e suono.\n\nInizia dall’azione principale della scena. In un’inquadratura guidata da testo, descrivi soggetto, ambiente, luce e punto di vista che rende leggibile l’azione. In una guidata da immagini, lascia che l’immagine iniziale definisca aspetto e composizione, poi usa il testo per ciò che cambia nel tempo. Per un concept di prodotto, un’immagine preparata può mostrare l’oggetto su una superficie da studio mentre il prompt descrive una lenta rivelazione del materiale e della forma.\n\nLa regia su più inquadrature offre copertura automatica o una sequenza personalizzata. La generazione automatica pianifica cambi di inquadratura e angolazione della camera a partire dal brief; una scena adatta a una vista continua può comunque restare un’unica inquadratura. Uno storyboard personalizzato consente di definire contenuto e durata di ogni inquadratura. Il profilo del produttore per inquadrature personalizzate ne permette da una a sei, con al massimo 512 caratteri per inquadratura e almeno un secondo per ciascuna; la somma delle loro durate deve coincidere con la durata totale del clip.\n\nPer una breve narrazione, descrivi una vista d’ambientazione, l’azione principale e un dettaglio conclusivo come inquadrature separate. Specifica il trattamento della camera e ciò che il pubblico deve notare in ognuna. Mantieni coerente l’aspetto di un soggetto ricorrente nel brief, cambiando deliberatamente azione e copertura. Il campo del prompt unico nel riferimento del produttore accetta fino a 2.500 caratteri; una sequenza personalizzata usa descrizioni separate per ciascuna inquadratura.\n\nI riferimenti dei soggetti possono sostenere una scena guidata da immagini quando personaggio, prodotto o ambientazione devono restare riconoscibili. Scegli viste chiare che comunichino le caratteristiche da mantenere e denomina coerentemente ogni soggetto di riferimento. Il profilo documentato guidato da immagini consente fino a tre elementi preparati. Mantieni focalizzati i ruoli dei riferimenti invece di combinare più risorse che danno istruzioni contrastanti sull’aspetto del soggetto.\n\nI fotogrammi iniziale e finale forniscono confini visivi per una transizione condizionata da immagini. Prepara fotogrammi coerenti sul soggetto e sulla scena prevista, poi descrivi il movimento che li collega. L’input di fotogrammi supportato dal produttore usa immagini JPG, JPEG o PNG, con file non superiori a 10 MB, dimensioni di almeno 300 pixel e rapporto d’aspetto dell’immagine iniziale tra 1:2.5 e 2.5:1. Un’attività controllata da fotogrammi e uno storyboard personalizzato hanno una propria gestione degli input, quindi organizza il materiale per il flusso selezionato prima di scrivere il brief completo.\n\nL’audio nativo può combinare battute, atmosfera e recitazione visiva. L’audio è disattivato per impostazione predefinita nel riferimento del produttore e viene abilitato per una scena audiovisiva. Il profilo linguistico 3.0 comprende cinese, inglese, giapponese, coreano e spagnolo, insieme all’alternanza di lingue e ai dialetti o accenti supportati. La guida del produttore afferma che il dialogo inserito in un’altra lingua viene tradotto in inglese. Assegna ogni battuta al soggetto previsto e distingui il dialogo dal suono di sfondo, così il brief audio spiega chi parla e ciò che circonda l’azione.\n\nUn brief con due personaggi può identificare Parlante A e Parlante B, dare a ciascuno una breve battuta e descrivere la risposta visibile tra loro. Mantieni il dialogo proporzionato alla durata del clip e identifica il parlante quando cambia la vista. Indicazioni vocali e riferimento di un personaggio hanno scopi differenti; il brief deve specificare l’interpretazione desiderata invece di presumere che un’immagine di riferimento contenga le parole da pronunciare.\n\nVIDEO 3.0 migliora anche la gestione delle scritte visibili in una scena guidata da immagini. Se un’insegna, un’etichetta o una didascalia sono importanti, identificale nel brief e preservane l’aspetto di riferimento. Controlla ortografia, leggibilità e movimento di quelle scritte nel clip completato, soprattutto quando veicolano un messaggio di prodotto o di campagna. La funzione del modello dedicata alle scritte guida la generazione invece di sostituire un controllo visivo finale.\n\nIl profilo Pro è 1080p; quello Standard è 720p. La modalità 4K selezionata separatamente dal produttore è un altro profilo di output, quindi Pro non va considerato un sinonimo di qualsiasi impostazione a risoluzione superiore. Per la generazione da testo, le scelte documentate di inquadratura comprendono 16:9, 9:16 e 1:1. Scegli il fotogramma per la collocazione prevista e mantieni leggibile la composizione al suo interno.\n\nLa generazione viene eseguita come un’attività il cui risultato riuscito rende disponibili il file video completato 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 il video con brief e risorse di riferimento, poi controlla continuità del soggetto, ordine richiesto delle inquadrature, movimento di camera, dialogo e scritte. Usa il clip selezionato come concept cinematografico, scena di prodotto o breve narrazione e apporta una revisione mirata alla parte che non ha raggiunto il risultato previsto.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "61b7f383b4398128ebecebabe3304fa2fbd0ae88de265212b1df3a42d55e5939", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "kwaivgi/kling-v3.0-proKling VIDEO 3.0 Pro è il profilo video professionale 1080p di Kuaishou per scene guidate da testo e immagini. Combina clip da tre a quindici secondi, audio nativo, fotogrammi di confine guidati e regia in una o più inquadrature per concept cinematografici e brevi produzioni.
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 3.0 Pro è il profilo professionale del modello VIDEO 3.0 di Kuaishou. La modalità Pro documentata produce video 1080p da un brief testuale o da una scena guidata da immagini, con clip da tre a quindici secondi. L’edizione 3.0 combina audio nativo, controlli di coerenza del soggetto e regia su più inquadrature, offrendo a una breve produzione un modo chiaro per specificare aspetto, azione, copertura della camera e suono.
Inizia dall’azione principale della scena. In un’inquadratura guidata da testo, descrivi soggetto, ambiente, luce e punto di vista che rende leggibile l’azione. In una guidata da immagini, lascia che l’immagine iniziale definisca aspetto e composizione, poi usa il testo per ciò che cambia nel tempo. Per un concept di prodotto, un’immagine preparata può mostrare l’oggetto su una superficie da studio mentre il prompt descrive una lenta rivelazione del materiale e della forma.
La regia su più inquadrature offre copertura automatica o una sequenza personalizzata. La generazione automatica pianifica cambi di inquadratura e angolazione della camera a partire dal brief; una scena adatta a una vista continua può comunque restare un’unica inquadratura. Uno storyboard personalizzato consente di definire contenuto e durata di ogni inquadratura. Il profilo del produttore per inquadrature personalizzate ne permette da una a sei, con al massimo 512 caratteri per inquadratura e almeno un secondo per ciascuna; la somma delle loro durate deve coincidere con la durata totale del clip.
Per una breve narrazione, descrivi una vista d’ambientazione, l’azione principale e un dettaglio conclusivo come inquadrature separate. Specifica il trattamento della camera e ciò che il pubblico deve notare in ognuna. Mantieni coerente l’aspetto di un soggetto ricorrente nel brief, cambiando deliberatamente azione e copertura. Il campo del prompt unico nel riferimento del produttore accetta fino a 2.500 caratteri; una sequenza personalizzata usa descrizioni separate per ciascuna inquadratura.
I riferimenti dei soggetti possono sostenere una scena guidata da immagini quando personaggio, prodotto o ambientazione devono restare riconoscibili. Scegli viste chiare che comunichino le caratteristiche da mantenere e denomina coerentemente ogni soggetto di riferimento. Il profilo documentato guidato da immagini consente fino a tre elementi preparati. Mantieni focalizzati i ruoli dei riferimenti invece di combinare più risorse che danno istruzioni contrastanti sull’aspetto del soggetto.
I fotogrammi iniziale e finale forniscono confini visivi per una transizione condizionata da immagini. Prepara fotogrammi coerenti sul soggetto e sulla scena prevista, poi descrivi il movimento che li collega. L’input di fotogrammi supportato dal produttore usa immagini JPG, JPEG o PNG, con file non superiori a 10 MB, dimensioni di almeno 300 pixel e rapporto d’aspetto dell’immagine iniziale tra 1:2.5 e 2.5:1. Un’attività controllata da fotogrammi e uno storyboard personalizzato hanno una propria gestione degli input, quindi organizza il materiale per il flusso selezionato prima di scrivere il brief completo.
L’audio nativo può combinare battute, atmosfera e recitazione visiva. L’audio è disattivato per impostazione predefinita nel riferimento del produttore e viene abilitato per una scena audiovisiva. Il profilo linguistico 3.0 comprende cinese, inglese, giapponese, coreano e spagnolo, insieme all’alternanza di lingue e ai dialetti o accenti supportati. La guida del produttore afferma che il dialogo inserito in un’altra lingua viene tradotto in inglese. Assegna ogni battuta al soggetto previsto e distingui il dialogo dal suono di sfondo, così il brief audio spiega chi parla e ciò che circonda l’azione.
Un brief con due personaggi può identificare Parlante A e Parlante B, dare a ciascuno una breve battuta e descrivere la risposta visibile tra loro. Mantieni il dialogo proporzionato alla durata del clip e identifica il parlante quando cambia la vista. Indicazioni vocali e riferimento di un personaggio hanno scopi differenti; il brief deve specificare l’interpretazione desiderata invece di presumere che un’immagine di riferimento contenga le parole da pronunciare.
VIDEO 3.0 migliora anche la gestione delle scritte visibili in una scena guidata da immagini. Se un’insegna, un’etichetta o una didascalia sono importanti, identificale nel brief e preservane l’aspetto di riferimento. Controlla ortografia, leggibilità e movimento di quelle scritte nel clip completato, soprattutto quando veicolano un messaggio di prodotto o di campagna. La funzione del modello dedicata alle scritte guida la generazione invece di sostituire un controllo visivo finale.
Il profilo Pro è 1080p; quello Standard è 720p. La modalità 4K selezionata separatamente dal produttore è un altro profilo di output, quindi Pro non va considerato un sinonimo di qualsiasi impostazione a risoluzione superiore. Per la generazione da testo, le scelte documentate di inquadratura comprendono 16:9, 9:16 e 1:1. Scegli il fotogramma per la collocazione prevista e mantieni leggibile la composizione al suo interno.
La generazione viene eseguita come un’attività il cui risultato riuscito rende disponibili il file video completato 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 il video con brief e risorse di riferimento, poi controlla continuità del soggetto, ordine richiesto delle inquadrature, movimento di camera, dialogo e scritte. Usa il clip selezionato come concept cinematografico, scena di prodotto o breve narrazione e apporta una revisione mirata alla parte che non ha raggiunto il risultato previsto.
POST /v1/videostext, imagevideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti kwaivgi/kling-v3.0-pro | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Campoduration | Tipointeger | RequisitoObbligatorio | Valori e limiti 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimo: 1 Massimo: 600 | Predefinito— |
Camporesolution | Tipostring | RequisitoFacoltativo | Valori e limiti 720p | Predefinito— |
Campoaspect_ratio | Tipostring | RequisitoFacoltativo | Valori e limiti 16:9, 9:16, 1:1 | Predefinito— |
Campogenerate_audio | Tipoboolean | RequisitoFacoltativo | Valori e limiti false, true Condizioni: Omettere questa opzione seleziona il prezzo con audio. Impostala su false per selezionare il prezzo senza audio. Controlla has_audio nel risultato per sapere se è stata restituita una traccia audio. | Predefinito— |
Campoframe_images | Tipoarray | RequisitoFacoltativo | Valori 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_references | Tipoarray | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Camposize | Tipostring | RequisitoFacoltativo | Valori e limiti 1280x720, 720x1280, 720x720 Schema: ^[1-9][0-9]*x[1-9][0-9]*$ | Predefinito— |
Campocallback_url | Tipostring | RequisitoFacoltativo | Valori e limiti Schema: ^https:// | Predefinito— |
Camposession_id | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campotrace | Tipoobject | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campouser | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
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-v3.0-pro
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-v3.0-pro
prompt: Tipo: string · Numero massimo di byte UTF-8: 10.000 · Sono richiesti caratteri diversi dagli spazi: Sì
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt, duration |
Parametromaterial_types | Contrattotext, image |
Parametroadditional_properties | Contrattofalse |
Parametrooptional_controls | Contrattoresolution, 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
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 | Componente del costo | Risoluzione di riferimento | Modalità di riferimento | Audio di riferimento | Unità di fatturazione | Condizioni di fatturazione | Costo |
|---|---|---|---|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Componente del costo— | Risoluzione di riferimento— | Modalità di riferimento— | Audio di riferimento— | 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 |
| ConfigurazioneVideo in uscita · tariffa di riferimento | Listino delle tariffe— | Quantità prevista— | Componente del costoreference_output_rate | Risoluzione di riferimento— | Modalità di riferimento— | Audio di riferimento— | Unità di fatturazioneper secondo in output | Condizioni di fatturazione— | Costo Output · Tariffa di riferimento per secondo di video in uscita · Stima solo a fini di confronto $0.224 per secondo in output |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Componente del costo— | Risoluzione di riferimento— | Modalità di riferimento— | Audio di riferimento— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneopzione audio: with_audio | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.336 per secondo di video |
| ConfigurazioneDa immagine a video (immagini dei fotogrammi) · 1080p · tariffa di riferimento | Listino delle tariffe— | Quantità prevista— | Componente del costoreference_output_rate | Risoluzione di riferimento1080p | Modalità di riferimentoDa immagine a video (fotogrammi) | Audio di riferimentoSenza audio | Unità di fatturazioneper secondo in output | Condizioni di fatturazione— | Costo Output · Tariffa di riferimento per secondo di video in uscita · Stima solo a fini di confronto $0.224 per secondo in output |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Componente del costo— | Risoluzione di riferimento— | Modalità di riferimento— | Audio di riferimento— | Unità di fatturazioneper secondo di video | Condizioni di fatturazionemodalità di generazione: image_to_video; risoluzione: 720p | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.224 per secondo di video |
| ConfigurazioneDa testo a video · 1080p · tariffa di riferimento | Listino delle tariffe— | Quantità prevista— | Componente del costoreference_output_rate | Risoluzione di riferimento1080p | Modalità di riferimentoDa testo a video | Audio di riferimentoSenza audio | Unità di fatturazioneper secondo in output | Condizioni di fatturazione— | Costo Output · Tariffa di riferimento per secondo di video in uscita · Stima solo a fini di confronto $0.224 per secondo in output |
| ConfigurazioneDa testo a video · 480p · tariffa di riferimento | Listino delle tariffe— | Quantità prevista— | Componente del costoreference_output_rate | Risoluzione di riferimento480p | Modalità di riferimentoDa testo a video | Audio di riferimentoSenza audio | Unità di fatturazioneper secondo in output | Condizioni di fatturazione— | Costo Output · Tariffa di riferimento per secondo di video in uscita · Stima solo a fini di confronto $0.224 per secondo in output |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Componente del costo— | Risoluzione di riferimento— | Modalità di riferimento— | Audio di riferimento— | Unità di fatturazioneper secondo di video | Condizioni di fatturazionemodalità di generazione: text_to_video; risoluzione: 720p | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.224 per secondo di video |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Componente del costo— | Risoluzione di riferimento— | Modalità di riferimento— | Audio di riferimento— | Unità di fatturazione— | Condizioni di fatturazione— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.672 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 →
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.
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Condizioni di fatturazione | Costo |
|---|---|---|
| ConfigurazionePrezzo del video | Condizioni 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. |
| ConfigurazionePrezzo del video | Condizioni di fatturazioneopzione audio: with_audio | Costo Output · Prezzo del video $0.336 per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
| ConfigurazionePrezzo del video | Condizioni di fatturazionemodalità di generazione: text_to_video; risoluzione: 480p | 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. |
| ConfigurazionePrezzo del video | Condizioni di fatturazionemodalità di generazione: text_to_video; risoluzione: 720p | 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. |
| ConfigurazionePrezzo del video | Condizioni di fatturazionemodalità di generazione: image_to_video; risoluzione: 720p | 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. |
| ConfigurazionePrezzo del video | Condizioni di fatturazionemodalità di generazione: text_to_video; risoluzione: 1080p | 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. |
| ConfigurazionePrezzo del video | Condizioni di fatturazionemodalità di generazione: image_to_video; risoluzione: 1080p | 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. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')\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\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\nURL firmati di contenuti di tua proprietà
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\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())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\nSalva 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.
503 result_pending_check + id originale + X-Should-Retry:false; non ripetere mai l'operazione originale
| Campo | Tipo | Significato |
|---|---|---|
Campoindex | Tipointeger | SignificatoPosizione di questo video nell'elenco dei risultati, con indice a partire da zero. |
Campocontent_url | Tipostring | SignificatoURL HTTPS firmato per il download di questo video completato. |
Camposha256 | Tipostring | null | SignificatoDigest SHA-256 dei byte video originali; null se non disponibile. |
Camposize_bytes | Tipointeger | null | SignificatoDimensione del file video originale in byte; null se non disponibile. |
Campoduration_ms | Tipointeger | null | SignificatoDurata misurata del video in millisecondi; null se non disponibile. |
Campowidth | Tipointeger | null | SignificatoLarghezza del video in pixel; null se non disponibile. |
Campoheight | Tipointeger | null | SignificatoAltezza del video in pixel; null se non disponibile. |
Campovideo_codec | Tipostring | null | SignificatoIdentificatore del codec video; null se non registrato. |
Campohas_audio | Tipoboolean | null | SignificatoIndica se il video contiene una traccia audio; null se non misurato. |
Campoaudio_codec | Tipostring | null | SignificatoIdentificatore del codec audio; null quando non è registrato alcun identificatore. |
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta404 · not_found_error | CondizioneL'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_error | CondizioneLa chiave API non corrisponde all'account autenticato. | Passaggio successivoVerifica la chiave API e l'accesso all'account prima dell'invio. |
Risposta400 · invalid_request_error | CondizioneNon è 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_unavailable | CondizioneNon è 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_error | CondizioneUn 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_error | CondizioneIl 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_error | CondizioneLa 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_check | CondizioneIl 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_unavailable | CondizioneIl 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_ready | CondizioneIl 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. |
Ailoot Ultra kwaivgi/kling-v3.0-pro
Usa i percorsi dei metodi indicati sopra.