Kling VIDEO 3.0 Standard è il profilo 720p di Kuaishou per generare una scena video da testo o da un’immagine fornita. Usa audio nativo, riferimenti dei soggetti e narrazione su più inquadrature dell’edizione VIDEO 3.0, con una durata flessibile da tre a quindici secondi. Questo profilo è utile per sviluppare una direzione visiva, visualizzare in anteprima una breve narrazione o creare una scena compatta con azione e suono definiti.
Per una scena guidata da testo, definisci soggetto, ambientazione, azione, illuminazione e comportamento della camera. Per una scena guidata da un’immagine, prepara un’immagine iniziale che mostri chiaramente l’aspetto e la composizione da animare. Un brief può mostrare un personaggio accanto a un tavolo da lavoro, poi descriverlo mentre raccoglie un piccolo oggetto e la camera si avvicina all’azione. Nella formulazione, separa il movimento del soggetto da quello della camera.
La generazione su più inquadrature può pianificare automaticamente la copertura della scena dalla sua descrizione. La regia personalizzata di più inquadrature assegna invece contenuto e durata a ciascuna. Il profilo del produttore per inquadrature personalizzate ne accetta da una a sei, al massimo 512 caratteri per inquadratura e almeno un secondo per ciascuna. La somma delle durate deve corrispondere alla durata totale del clip. Quando una vista continua comunica chiaramente la scena, un brief a inquadratura unica evita una transizione superflua.
Un breve storyboard può iniziare con una vista dell’ambientazione, passare all’azione e terminare sul dettaglio che spiega il risultato. Specifica quale soggetto resta in ogni inquadratura e come cambia la composizione. La modalità automatica può adattare la copertura alla scena, mentre una sequenza personalizzata fornisce istruzioni esplicite per le singole parti. Un normale prompt unico accetta fino a 2.500 caratteri nel riferimento del produttore.
I controlli di riferimento dei soggetti aiutano ad ancorare personaggi, oggetti e un’ambientazione. Usa materiale di riferimento chiaro e assegna a ogni soggetto una descrizione stabile. Il profilo documentato guidato da immagini consente fino a tre elementi preparati. Per una scena di prodotto illustrata, un riferimento può definire l’oggetto mentre la composizione iniziale ne stabilisce la posizione; il brief di movimento descrive poi l’evento che accade intorno. Controlla l’aspetto completato lungo l’inquadratura invece di presumere che il riferimento impedisca ogni cambiamento.
I fotogrammi iniziale e finale possono guidare una transizione condizionata da immagini verso una composizione finale desiderata. Usa fotogrammi che comunichino un collegamento plausibile e descrivi l’azione tra essi. Il profilo immagine del produttore accetta JPG, JPEG e PNG, non superiori a 10 MB, con dimensioni di almeno 300 pixel; il rapporto d’aspetto dell’immagine iniziale deve essere tra 1:2.5 e 2.5:1. Prepara i materiali dei fotogrammi per quella specifica attività invece di trattare la descrizione di uno storyboard come un insieme di input intercambiabile.
Il profilo Standard può generare audio nativo quando la modalità è attivata; nel riferimento del produttore l’audio è disattivato per impostazione predefinita. Descrivi battute, atmosfera e suoni pertinenti come parti della scena. VIDEO 3.0 supporta il parlato in cinese, inglese, giapponese, coreano e spagnolo, compresa l’alternanza di lingue e gli accenti o dialetti supportati. La guida del produttore afferma che il dialogo inserito in un’altra lingua viene tradotto in inglese. Rendi chiaro il soggetto che parla in una scena con più personaggi e mantieni il testo abbastanza breve per l’interpretazione prevista.
Un brief di dialogo può assegnare una battuta al Parlante A, una reazione visibile al Parlante B e un cambiamento di punto di vista che segue lo scambio. Descrivi il suono dell’ambientazione separatamente dal dialogo, affinché un effetto di sfondo non diventi un’istruzione ambigua sul parlato. Usa il materiale di riferimento per stabilire l’aspetto dei soggetti e il testo per definire ciò che fanno e dicono.
Le scritte visibili sono un’altra parte del flusso 3.0. Un’immagine sorgente può contenere un’insegna, una didascalia o un’etichetta di prodotto il cui aspetto conta durante l’animazione. Identifica quel testo e il suo ruolo nella scena, poi controlla ortografia, leggibilità e stabilità nel risultato. Per un breve visual di campagna, mantieni il messaggio importante ben visibile nella composizione invece di affidarti a un’etichetta molto piccola sullo sfondo.
L’output Standard è 720p. Pro è il profilo 1080p selezionato separatamente, e il 4K nativo è un’altra modalità del produttore, non un’impostazione automatica di Standard. Le scelte di rapporto d’aspetto da testo comprendono 16:9, 9:16 e 1:1. Scegli formato e inquadratura per la collocazione prevista, poi mantieni quella direzione visiva mentre confronti cambiamenti di azione, luce o ordine delle inquadrature.
Una generazione completata fornisce un file video con 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 brief di scena, immagini di riferimento e profilo selezionato con il clip, così le revisioni successive hanno un punto di partenza coerente. Controlla azione visiva, continuità del soggetto, copertura della camera, dialogo e scritte nel contesto in cui il clip verrà usato. Una correzione mirata al dettaglio errato è più utile di sostituire l’intero brief di scena con istruzioni non collegate.
", "aboutText": "Kling VIDEO 3.0 Standard è il profilo 720p di Kuaishou per generare una scena video da testo o da un’immagine fornita. Usa audio nativo, riferimenti dei soggetti e narrazione su più inquadrature dell’edizione VIDEO 3.0, con una durata flessibile da tre a quindici secondi. Questo profilo è utile per sviluppare una direzione visiva, visualizzare in anteprima una breve narrazione o creare una scena compatta con azione e suono definiti.\n\nPer una scena guidata da testo, definisci soggetto, ambientazione, azione, illuminazione e comportamento della camera. Per una scena guidata da un’immagine, prepara un’immagine iniziale che mostri chiaramente l’aspetto e la composizione da animare. Un brief può mostrare un personaggio accanto a un tavolo da lavoro, poi descriverlo mentre raccoglie un piccolo oggetto e la camera si avvicina all’azione. Nella formulazione, separa il movimento del soggetto da quello della camera.\n\nLa generazione su più inquadrature può pianificare automaticamente la copertura della scena dalla sua descrizione. La regia personalizzata di più inquadrature assegna invece contenuto e durata a ciascuna. Il profilo del produttore per inquadrature personalizzate ne accetta da una a sei, al massimo 512 caratteri per inquadratura e almeno un secondo per ciascuna. La somma delle durate deve corrispondere alla durata totale del clip. Quando una vista continua comunica chiaramente la scena, un brief a inquadratura unica evita una transizione superflua.\n\nUn breve storyboard può iniziare con una vista dell’ambientazione, passare all’azione e terminare sul dettaglio che spiega il risultato. Specifica quale soggetto resta in ogni inquadratura e come cambia la composizione. La modalità automatica può adattare la copertura alla scena, mentre una sequenza personalizzata fornisce istruzioni esplicite per le singole parti. Un normale prompt unico accetta fino a 2.500 caratteri nel riferimento del produttore.\n\nI controlli di riferimento dei soggetti aiutano ad ancorare personaggi, oggetti e un’ambientazione. Usa materiale di riferimento chiaro e assegna a ogni soggetto una descrizione stabile. Il profilo documentato guidato da immagini consente fino a tre elementi preparati. Per una scena di prodotto illustrata, un riferimento può definire l’oggetto mentre la composizione iniziale ne stabilisce la posizione; il brief di movimento descrive poi l’evento che accade intorno. Controlla l’aspetto completato lungo l’inquadratura invece di presumere che il riferimento impedisca ogni cambiamento.\n\nI fotogrammi iniziale e finale possono guidare una transizione condizionata da immagini verso una composizione finale desiderata. Usa fotogrammi che comunichino un collegamento plausibile e descrivi l’azione tra essi. Il profilo immagine del produttore accetta JPG, JPEG e PNG, non superiori a 10 MB, con dimensioni di almeno 300 pixel; il rapporto d’aspetto dell’immagine iniziale deve essere tra 1:2.5 e 2.5:1. Prepara i materiali dei fotogrammi per quella specifica attività invece di trattare la descrizione di uno storyboard come un insieme di input intercambiabile.\n\nIl profilo Standard può generare audio nativo quando la modalità è attivata; nel riferimento del produttore l’audio è disattivato per impostazione predefinita. Descrivi battute, atmosfera e suoni pertinenti come parti della scena. VIDEO 3.0 supporta il parlato in cinese, inglese, giapponese, coreano e spagnolo, compresa l’alternanza di lingue e gli accenti o dialetti supportati. La guida del produttore afferma che il dialogo inserito in un’altra lingua viene tradotto in inglese. Rendi chiaro il soggetto che parla in una scena con più personaggi e mantieni il testo abbastanza breve per l’interpretazione prevista.\n\nUn brief di dialogo può assegnare una battuta al Parlante A, una reazione visibile al Parlante B e un cambiamento di punto di vista che segue lo scambio. Descrivi il suono dell’ambientazione separatamente dal dialogo, affinché un effetto di sfondo non diventi un’istruzione ambigua sul parlato. Usa il materiale di riferimento per stabilire l’aspetto dei soggetti e il testo per definire ciò che fanno e dicono.\n\nLe scritte visibili sono un’altra parte del flusso 3.0. Un’immagine sorgente può contenere un’insegna, una didascalia o un’etichetta di prodotto il cui aspetto conta durante l’animazione. Identifica quel testo e il suo ruolo nella scena, poi controlla ortografia, leggibilità e stabilità nel risultato. Per un breve visual di campagna, mantieni il messaggio importante ben visibile nella composizione invece di affidarti a un’etichetta molto piccola sullo sfondo.\n\nL’output Standard è 720p. Pro è il profilo 1080p selezionato separatamente, e il 4K nativo è un’altra modalità del produttore, non un’impostazione automatica di Standard. Le scelte di rapporto d’aspetto da testo comprendono 16:9, 9:16 e 1:1. Scegli formato e inquadratura per la collocazione prevista, poi mantieni quella direzione visiva mentre confronti cambiamenti di azione, luce o ordine delle inquadrature.\n\nUna generazione completata fornisce un file video con 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 brief di scena, immagini di riferimento e profilo selezionato con il clip, così le revisioni successive hanno un punto di partenza coerente. Controlla azione visiva, continuità del soggetto, copertura della camera, dialogo e scritte nel contesto in cui il clip verrà usato. Una correzione mirata al dettaglio errato è più utile di sostituire l’intero brief di scena con istruzioni non collegate.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "1f2a26dd6ced59953d1d7ccaa402e39095b8edf4c87ad0cb5e5dac53ecfb74b5", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "kwaivgi/kling-v3.0-stdKling VIDEO 3.0 Standard è il profilo video 720p di Kuaishou per brief da testo e immagini. Crea scene da tre a quindici secondi con audio nativo, riferimenti dei soggetti, guida tramite fotogrammi iniziale e finale e narrazione in una o più inquadrature.
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 Standard è il profilo 720p di Kuaishou per generare una scena video da testo o da un’immagine fornita. Usa audio nativo, riferimenti dei soggetti e narrazione su più inquadrature dell’edizione VIDEO 3.0, con una durata flessibile da tre a quindici secondi. Questo profilo è utile per sviluppare una direzione visiva, visualizzare in anteprima una breve narrazione o creare una scena compatta con azione e suono definiti.
Per una scena guidata da testo, definisci soggetto, ambientazione, azione, illuminazione e comportamento della camera. Per una scena guidata da un’immagine, prepara un’immagine iniziale che mostri chiaramente l’aspetto e la composizione da animare. Un brief può mostrare un personaggio accanto a un tavolo da lavoro, poi descriverlo mentre raccoglie un piccolo oggetto e la camera si avvicina all’azione. Nella formulazione, separa il movimento del soggetto da quello della camera.
La generazione su più inquadrature può pianificare automaticamente la copertura della scena dalla sua descrizione. La regia personalizzata di più inquadrature assegna invece contenuto e durata a ciascuna. Il profilo del produttore per inquadrature personalizzate ne accetta da una a sei, al massimo 512 caratteri per inquadratura e almeno un secondo per ciascuna. La somma delle durate deve corrispondere alla durata totale del clip. Quando una vista continua comunica chiaramente la scena, un brief a inquadratura unica evita una transizione superflua.
Un breve storyboard può iniziare con una vista dell’ambientazione, passare all’azione e terminare sul dettaglio che spiega il risultato. Specifica quale soggetto resta in ogni inquadratura e come cambia la composizione. La modalità automatica può adattare la copertura alla scena, mentre una sequenza personalizzata fornisce istruzioni esplicite per le singole parti. Un normale prompt unico accetta fino a 2.500 caratteri nel riferimento del produttore.
I controlli di riferimento dei soggetti aiutano ad ancorare personaggi, oggetti e un’ambientazione. Usa materiale di riferimento chiaro e assegna a ogni soggetto una descrizione stabile. Il profilo documentato guidato da immagini consente fino a tre elementi preparati. Per una scena di prodotto illustrata, un riferimento può definire l’oggetto mentre la composizione iniziale ne stabilisce la posizione; il brief di movimento descrive poi l’evento che accade intorno. Controlla l’aspetto completato lungo l’inquadratura invece di presumere che il riferimento impedisca ogni cambiamento.
I fotogrammi iniziale e finale possono guidare una transizione condizionata da immagini verso una composizione finale desiderata. Usa fotogrammi che comunichino un collegamento plausibile e descrivi l’azione tra essi. Il profilo immagine del produttore accetta JPG, JPEG e PNG, non superiori a 10 MB, con dimensioni di almeno 300 pixel; il rapporto d’aspetto dell’immagine iniziale deve essere tra 1:2.5 e 2.5:1. Prepara i materiali dei fotogrammi per quella specifica attività invece di trattare la descrizione di uno storyboard come un insieme di input intercambiabile.
Il profilo Standard può generare audio nativo quando la modalità è attivata; nel riferimento del produttore l’audio è disattivato per impostazione predefinita. Descrivi battute, atmosfera e suoni pertinenti come parti della scena. VIDEO 3.0 supporta il parlato in cinese, inglese, giapponese, coreano e spagnolo, compresa l’alternanza di lingue e gli accenti o dialetti supportati. La guida del produttore afferma che il dialogo inserito in un’altra lingua viene tradotto in inglese. Rendi chiaro il soggetto che parla in una scena con più personaggi e mantieni il testo abbastanza breve per l’interpretazione prevista.
Un brief di dialogo può assegnare una battuta al Parlante A, una reazione visibile al Parlante B e un cambiamento di punto di vista che segue lo scambio. Descrivi il suono dell’ambientazione separatamente dal dialogo, affinché un effetto di sfondo non diventi un’istruzione ambigua sul parlato. Usa il materiale di riferimento per stabilire l’aspetto dei soggetti e il testo per definire ciò che fanno e dicono.
Le scritte visibili sono un’altra parte del flusso 3.0. Un’immagine sorgente può contenere un’insegna, una didascalia o un’etichetta di prodotto il cui aspetto conta durante l’animazione. Identifica quel testo e il suo ruolo nella scena, poi controlla ortografia, leggibilità e stabilità nel risultato. Per un breve visual di campagna, mantieni il messaggio importante ben visibile nella composizione invece di affidarti a un’etichetta molto piccola sullo sfondo.
L’output Standard è 720p. Pro è il profilo 1080p selezionato separatamente, e il 4K nativo è un’altra modalità del produttore, non un’impostazione automatica di Standard. Le scelte di rapporto d’aspetto da testo comprendono 16:9, 9:16 e 1:1. Scegli formato e inquadratura per la collocazione prevista, poi mantieni quella direzione visiva mentre confronti cambiamenti di azione, luce o ordine delle inquadrature.
Una generazione completata fornisce un file video con 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 brief di scena, immagini di riferimento e profilo selezionato con il clip, così le revisioni successive hanno un punto di partenza coerente. Controlla azione visiva, continuità del soggetto, copertura della camera, dialogo e scritte nel contesto in cui il clip verrà usato. Una correzione mirata al dettaglio errato è più utile di sostituire l’intero brief di scena con istruzioni non collegate.
POST /v1/videostext, imagevideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti kwaivgi/kling-v3.0-std | 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-std
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-std
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.168 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.252 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.168 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.168 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.168 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.168 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.168 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.504 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.168 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.252 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.168 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.168 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.168 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.168 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.168 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-std","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-std
Usa i percorsi dei metodi indicati sopra.