{ "aboutHtml": "

Seedance 2.0 Mini è un modello con un nome distinto all’interno della famiglia audiovisiva Seedance 2.0 di ByteDance. Il produttore documenta la generazione di video da testo, la generazione da immagini con primo fotogramma o primo e ultimo fotogramma, la generazione con riferimenti multimodali, la modifica e l’estensione di video. Il suono può essere generato insieme alle immagini. Scegli la modalità di creazione in base al materiale di cui disponi: un brief scritto, un’immagine iniziale fissa, due fotogrammi di confine o un clip da modificare o continuare.

Mini ha un proprio profilo di output. Il produttore elenca video a 480p e 720p con colore a 8 bit, 24 fotogrammi al secondo e output MP4. I rapporti d’aspetto supportati sono 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16; la durata di generazione documentata è di 4–15 secondi. Il controllo della durata consente anche la selezione automatica entro questo intervallo. Le opzioni 1080p e 4K del modello Seedance 2.0 completo sono separate; non sono impostazioni di Mini. La tabella delle capacità della famiglia elenca la restituzione dell’ultimo fotogramma generato, mentre la modalità Draft non è supportata.

Il riferimento omni crea una nuova scena utilizzando informazioni selezionate dal materiale fornito. Un’immagine può definire l’aspetto di un soggetto, la composizione o il trattamento visivo. Un video può definire l’azione, il movimento di camera o un effetto; un riferimento audio può definire il timbro della voce, la melodia o il contenuto parlato. Indica al modello che cosa ricavare da ciascun riferimento, invece di chiedergli di copiarne ogni proprietà. Per esempio, usa una fotografia di prodotto per forma e colore, un breve clip di movimento di camera per l’avvicinamento e un riferimento sonoro per l’atmosfera.

Il flusso di lavoro della famiglia consente fino a nove immagini di riferimento, tre clip video e tre clip audio. I riferimenti video durano 2–15 secondi ciascuno, per non più di 15 secondi complessivi; i riferimenti audio hanno gli stessi limiti di durata per clip e totali. L’audio da solo e il testo con audio senza un riferimento visivo non sono combinazioni di riferimenti supportate. La creazione con solo testo è una modalità supportata separata. Per una sequenza, fornisci le risorse nell’ordine previsto e richiamale coerentemente come Image 1, Video 1 o Audio 1, usando l’ordine all’interno di ciascun tipo di contenuto. Nel prompt scritto non sostituire un riferimento numerato con l’identificatore di una risorsa.

Un’immagine di primo fotogramma definisce l’apertura di un’inquadratura guidata da un’immagine. La modalità primo e ultimo fotogramma definisce entrambi i confini. Se quelle esatte immagini iniziali e finali sono importanti, seleziona la modalità dedicata invece di descrivere i riferimenti come apertura e conclusione in un prompt omni-reference. Quest’ultima soluzione produce un effetto guidato dal prompt e non equivale alla scelta rigorosa dei fotogrammi di confine. Prepara le immagini per la composizione di uscita e specifica l’azione che collega la situazione iniziale a quella finale.

La modifica video cambia un clip esistente invece di usarlo soltanto come ispirazione. Identifica il video da modificare, l’oggetto o la regione da cambiare, il momento e la posizione in cui appare e i dettagli da preservare. Un brief utile è «In Video 1, replace the mug with the vessel shown in Image 1; preserve the hand movement, framing, lighting and table arrangement.» Per una rimozione, indica l’oggetto indesiderato e gli elementi circostanti che devono restare. Il produttore consiglia di riferirsi direttamente al video da modificare o estendere; presentarlo come riferimento può invece comunicare la richiesta di una scena nuova.

L’estensione video aggiunge eventi prima o dopo un clip esistente. Descrivi la direzione della continuazione e ciò che accade dopo o prima. Il flusso documentato può anche collegare due o tre clip con transizioni generate; i tre video in ingresso devono comunque rientrare complessivamente nel limite di 15 secondi di riferimenti. Il tutorial distingue una continuazione che include principalmente il filmato ai confini del clip originale da una richiesta che ne conserva esplicitamente il contenuto. Specifica la composizione desiderata del risultato: soltanto la continuazione oppure una scena contenente il clip fornito e la nuova azione.

Per impartire indicazioni chiare, separa la descrizione della scena stabile dalla sequenza degli eventi. Definisci ogni soggetto con due o tre caratteristiche visive distintive e un’etichetta coerente. Descrivi quindi azioni, ambientazione, illuminazione, movimento di camera, stile visivo e vincoli. In un dialogo, associa ogni battuta a chi la pronuncia e all’azione pertinente. Usa etichette ordinate per le inquadrature invece di considerare le indicazioni temporali esatte come controlli affidabili: il produttore segnala che la precisione dei tempi può essere instabile. Un brief di prodotto articolato in più momenti potrebbe essere: «Image 1 defines Product A. Shot 1: slowly approach Product A on the counter. Shot 2: a hand rotates it toward the light. Shot 3: settle on the front label. Soft room ambience; preserve the printed lettering.»

Prepara i riferimenti secondo le regole di ingresso documentate per la famiglia. I formati immagine supportati comprendono JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF; ogni immagine deve essere inferiore a 30 MB. La guida specifica larghezza e altezza strettamente comprese tra 300 e 6.000 pixel e un rapporto d’aspetto strettamente compreso tra 0.4 e 2.5. I riferimenti video usano MP4 o MOV con video H.264 o H.265 e audio AAC o MP3, hanno un massimo di 200 MB ciascuno e 24–60 fotogrammi al secondo. Larghezza e altezza sono di 300–6.000 pixel, il rapporto d’aspetto è di 0.4–2.5 e il numero totale di pixel è di 407.696–8.295.044. I riferimenti audio usano WAV o MP3 e hanno un massimo di 15 MB ciascuno. Queste sono specifiche del produttore per la preparazione degli input, distinte dai controlli di caricamento di una particolare applicazione.

Il flusso del produttore dedicato ai ritratti richiede una preparazione specifica per immagini o video contenenti volti di persone reali: i caricamenti diretti di riferimenti non sono il percorso standard supportato. Sono documentati come soluzioni separate gli output attendibili del modello, i personaggi digitali predefiniti e un flusso di risorse di persone reali autorizzate. Anche la corrispondenza della voce, la pronuncia e il suono al confine di un clip richiedono un controllo. La guida ai prompt consiglia di descrivere le caratteristiche vocali desiderate e mantenere lo stile del dialogo vicino al riferimento audio. Controlla il risultato finale per la coerenza del soggetto, le parole pronunciate esatte, i tempi dell’azione, le transizioni tra fotogrammi e l’audio finale; perfeziona l’elemento specifico che differisce dal brief.

", "aboutText": "Seedance 2.0 Mini è un modello con un nome distinto all’interno della famiglia audiovisiva Seedance 2.0 di ByteDance. Il produttore documenta la generazione di video da testo, la generazione da immagini con primo fotogramma o primo e ultimo fotogramma, la generazione con riferimenti multimodali, la modifica e l’estensione di video. Il suono può essere generato insieme alle immagini. Scegli la modalità di creazione in base al materiale di cui disponi: un brief scritto, un’immagine iniziale fissa, due fotogrammi di confine o un clip da modificare o continuare.\n\nMini ha un proprio profilo di output. Il produttore elenca video a 480p e 720p con colore a 8 bit, 24 fotogrammi al secondo e output MP4. I rapporti d’aspetto supportati sono 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16; la durata di generazione documentata è di 4–15 secondi. Il controllo della durata consente anche la selezione automatica entro questo intervallo. Le opzioni 1080p e 4K del modello Seedance 2.0 completo sono separate; non sono impostazioni di Mini. La tabella delle capacità della famiglia elenca la restituzione dell’ultimo fotogramma generato, mentre la modalità Draft non è supportata.\n\nIl riferimento omni crea una nuova scena utilizzando informazioni selezionate dal materiale fornito. Un’immagine può definire l’aspetto di un soggetto, la composizione o il trattamento visivo. Un video può definire l’azione, il movimento di camera o un effetto; un riferimento audio può definire il timbro della voce, la melodia o il contenuto parlato. Indica al modello che cosa ricavare da ciascun riferimento, invece di chiedergli di copiarne ogni proprietà. Per esempio, usa una fotografia di prodotto per forma e colore, un breve clip di movimento di camera per l’avvicinamento e un riferimento sonoro per l’atmosfera.\n\nIl flusso di lavoro della famiglia consente fino a nove immagini di riferimento, tre clip video e tre clip audio. I riferimenti video durano 2–15 secondi ciascuno, per non più di 15 secondi complessivi; i riferimenti audio hanno gli stessi limiti di durata per clip e totali. L’audio da solo e il testo con audio senza un riferimento visivo non sono combinazioni di riferimenti supportate. La creazione con solo testo è una modalità supportata separata. Per una sequenza, fornisci le risorse nell’ordine previsto e richiamale coerentemente come Image 1, Video 1 o Audio 1, usando l’ordine all’interno di ciascun tipo di contenuto. Nel prompt scritto non sostituire un riferimento numerato con l’identificatore di una risorsa.\n\nUn’immagine di primo fotogramma definisce l’apertura di un’inquadratura guidata da un’immagine. La modalità primo e ultimo fotogramma definisce entrambi i confini. Se quelle esatte immagini iniziali e finali sono importanti, seleziona la modalità dedicata invece di descrivere i riferimenti come apertura e conclusione in un prompt omni-reference. Quest’ultima soluzione produce un effetto guidato dal prompt e non equivale alla scelta rigorosa dei fotogrammi di confine. Prepara le immagini per la composizione di uscita e specifica l’azione che collega la situazione iniziale a quella finale.\n\nLa modifica video cambia un clip esistente invece di usarlo soltanto come ispirazione. Identifica il video da modificare, l’oggetto o la regione da cambiare, il momento e la posizione in cui appare e i dettagli da preservare. Un brief utile è «In Video 1, replace the mug with the vessel shown in Image 1; preserve the hand movement, framing, lighting and table arrangement.» Per una rimozione, indica l’oggetto indesiderato e gli elementi circostanti che devono restare. Il produttore consiglia di riferirsi direttamente al video da modificare o estendere; presentarlo come riferimento può invece comunicare la richiesta di una scena nuova.\n\nL’estensione video aggiunge eventi prima o dopo un clip esistente. Descrivi la direzione della continuazione e ciò che accade dopo o prima. Il flusso documentato può anche collegare due o tre clip con transizioni generate; i tre video in ingresso devono comunque rientrare complessivamente nel limite di 15 secondi di riferimenti. Il tutorial distingue una continuazione che include principalmente il filmato ai confini del clip originale da una richiesta che ne conserva esplicitamente il contenuto. Specifica la composizione desiderata del risultato: soltanto la continuazione oppure una scena contenente il clip fornito e la nuova azione.\n\nPer impartire indicazioni chiare, separa la descrizione della scena stabile dalla sequenza degli eventi. Definisci ogni soggetto con due o tre caratteristiche visive distintive e un’etichetta coerente. Descrivi quindi azioni, ambientazione, illuminazione, movimento di camera, stile visivo e vincoli. In un dialogo, associa ogni battuta a chi la pronuncia e all’azione pertinente. Usa etichette ordinate per le inquadrature invece di considerare le indicazioni temporali esatte come controlli affidabili: il produttore segnala che la precisione dei tempi può essere instabile. Un brief di prodotto articolato in più momenti potrebbe essere: «Image 1 defines Product A. Shot 1: slowly approach Product A on the counter. Shot 2: a hand rotates it toward the light. Shot 3: settle on the front label. Soft room ambience; preserve the printed lettering.»\n\nPrepara i riferimenti secondo le regole di ingresso documentate per la famiglia. I formati immagine supportati comprendono JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF; ogni immagine deve essere inferiore a 30 MB. La guida specifica larghezza e altezza strettamente comprese tra 300 e 6.000 pixel e un rapporto d’aspetto strettamente compreso tra 0.4 e 2.5. I riferimenti video usano MP4 o MOV con video H.264 o H.265 e audio AAC o MP3, hanno un massimo di 200 MB ciascuno e 24–60 fotogrammi al secondo. Larghezza e altezza sono di 300–6.000 pixel, il rapporto d’aspetto è di 0.4–2.5 e il numero totale di pixel è di 407.696–8.295.044. I riferimenti audio usano WAV o MP3 e hanno un massimo di 15 MB ciascuno. Queste sono specifiche del produttore per la preparazione degli input, distinte dai controlli di caricamento di una particolare applicazione.\n\nIl flusso del produttore dedicato ai ritratti richiede una preparazione specifica per immagini o video contenenti volti di persone reali: i caricamenti diretti di riferimenti non sono il percorso standard supportato. Sono documentati come soluzioni separate gli output attendibili del modello, i personaggi digitali predefiniti e un flusso di risorse di persone reali autorizzate. Anche la corrispondenza della voce, la pronuncia e il suono al confine di un clip richiedono un controllo. La guida ai prompt consiglia di descrivere le caratteristiche vocali desiderate e mantenere lo stile del dialogo vicino al riferimento audio. Controlla il risultato finale per la coerenza del soggetto, le parole pronunciate esatte, i tempi dell’azione, le transizioni tra fotogrammi e l’audio finale; perfeziona l’elemento specifico che differisce dal brief.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d00fe2b375a3d3dab8e45e602a6715fd8b3a9aaa906334a4ca59df995f254f7d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "
•

ByteDance: Seedance 2.0 Mini

ByteDance /bytedance/seedance-2.0-mini

Introduzione

Seedance 2.0 Mini crea brevi video con audio generato facoltativo a partire da testo e riferimenti di immagini, video e audio. Supporta la creazione di scene, modifiche video mirate e continuazioni, con un profilo di output documentato a 480p o 720p.

Input accettati
Testo · Immagini · Audio
Risultati
Video
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.

Seedance 2.0 Mini è un modello con un nome distinto all’interno della famiglia audiovisiva Seedance 2.0 di ByteDance. Il produttore documenta la generazione di video da testo, la generazione da immagini con primo fotogramma o primo e ultimo fotogramma, la generazione con riferimenti multimodali, la modifica e l’estensione di video. Il suono può essere generato insieme alle immagini. Scegli la modalità di creazione in base al materiale di cui disponi: un brief scritto, un’immagine iniziale fissa, due fotogrammi di confine o un clip da modificare o continuare.

Mini ha un proprio profilo di output. Il produttore elenca video a 480p e 720p con colore a 8 bit, 24 fotogrammi al secondo e output MP4. I rapporti d’aspetto supportati sono 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16; la durata di generazione documentata è di 4–15 secondi. Il controllo della durata consente anche la selezione automatica entro questo intervallo. Le opzioni 1080p e 4K del modello Seedance 2.0 completo sono separate; non sono impostazioni di Mini. La tabella delle capacità della famiglia elenca la restituzione dell’ultimo fotogramma generato, mentre la modalità Draft non è supportata.

Il riferimento omni crea una nuova scena utilizzando informazioni selezionate dal materiale fornito. Un’immagine può definire l’aspetto di un soggetto, la composizione o il trattamento visivo. Un video può definire l’azione, il movimento di camera o un effetto; un riferimento audio può definire il timbro della voce, la melodia o il contenuto parlato. Indica al modello che cosa ricavare da ciascun riferimento, invece di chiedergli di copiarne ogni proprietà. Per esempio, usa una fotografia di prodotto per forma e colore, un breve clip di movimento di camera per l’avvicinamento e un riferimento sonoro per l’atmosfera.

Il flusso di lavoro della famiglia consente fino a nove immagini di riferimento, tre clip video e tre clip audio. I riferimenti video durano 2–15 secondi ciascuno, per non più di 15 secondi complessivi; i riferimenti audio hanno gli stessi limiti di durata per clip e totali. L’audio da solo e il testo con audio senza un riferimento visivo non sono combinazioni di riferimenti supportate. La creazione con solo testo è una modalità supportata separata. Per una sequenza, fornisci le risorse nell’ordine previsto e richiamale coerentemente come Image 1, Video 1 o Audio 1, usando l’ordine all’interno di ciascun tipo di contenuto. Nel prompt scritto non sostituire un riferimento numerato con l’identificatore di una risorsa.

Un’immagine di primo fotogramma definisce l’apertura di un’inquadratura guidata da un’immagine. La modalità primo e ultimo fotogramma definisce entrambi i confini. Se quelle esatte immagini iniziali e finali sono importanti, seleziona la modalità dedicata invece di descrivere i riferimenti come apertura e conclusione in un prompt omni-reference. Quest’ultima soluzione produce un effetto guidato dal prompt e non equivale alla scelta rigorosa dei fotogrammi di confine. Prepara le immagini per la composizione di uscita e specifica l’azione che collega la situazione iniziale a quella finale.

La modifica video cambia un clip esistente invece di usarlo soltanto come ispirazione. Identifica il video da modificare, l’oggetto o la regione da cambiare, il momento e la posizione in cui appare e i dettagli da preservare. Un brief utile è «In Video 1, replace the mug with the vessel shown in Image 1; preserve the hand movement, framing, lighting and table arrangement.» Per una rimozione, indica l’oggetto indesiderato e gli elementi circostanti che devono restare. Il produttore consiglia di riferirsi direttamente al video da modificare o estendere; presentarlo come riferimento può invece comunicare la richiesta di una scena nuova.

L’estensione video aggiunge eventi prima o dopo un clip esistente. Descrivi la direzione della continuazione e ciò che accade dopo o prima. Il flusso documentato può anche collegare due o tre clip con transizioni generate; i tre video in ingresso devono comunque rientrare complessivamente nel limite di 15 secondi di riferimenti. Il tutorial distingue una continuazione che include principalmente il filmato ai confini del clip originale da una richiesta che ne conserva esplicitamente il contenuto. Specifica la composizione desiderata del risultato: soltanto la continuazione oppure una scena contenente il clip fornito e la nuova azione.

Per impartire indicazioni chiare, separa la descrizione della scena stabile dalla sequenza degli eventi. Definisci ogni soggetto con due o tre caratteristiche visive distintive e un’etichetta coerente. Descrivi quindi azioni, ambientazione, illuminazione, movimento di camera, stile visivo e vincoli. In un dialogo, associa ogni battuta a chi la pronuncia e all’azione pertinente. Usa etichette ordinate per le inquadrature invece di considerare le indicazioni temporali esatte come controlli affidabili: il produttore segnala che la precisione dei tempi può essere instabile. Un brief di prodotto articolato in più momenti potrebbe essere: «Image 1 defines Product A. Shot 1: slowly approach Product A on the counter. Shot 2: a hand rotates it toward the light. Shot 3: settle on the front label. Soft room ambience; preserve the printed lettering.»

Prepara i riferimenti secondo le regole di ingresso documentate per la famiglia. I formati immagine supportati comprendono JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF; ogni immagine deve essere inferiore a 30 MB. La guida specifica larghezza e altezza strettamente comprese tra 300 e 6.000 pixel e un rapporto d’aspetto strettamente compreso tra 0.4 e 2.5. I riferimenti video usano MP4 o MOV con video H.264 o H.265 e audio AAC o MP3, hanno un massimo di 200 MB ciascuno e 24–60 fotogrammi al secondo. Larghezza e altezza sono di 300–6.000 pixel, il rapporto d’aspetto è di 0.4–2.5 e il numero totale di pixel è di 407.696–8.295.044. I riferimenti audio usano WAV o MP3 e hanno un massimo di 15 MB ciascuno. Queste sono specifiche del produttore per la preparazione degli input, distinte dai controlli di caricamento di una particolare applicazione.

Il flusso del produttore dedicato ai ritratti richiede una preparazione specifica per immagini o video contenenti volti di persone reali: i caricamenti diretti di riferimenti non sono il percorso standard supportato. Sono documentati come soluzioni separate gli output attendibili del modello, i personaggi digitali predefiniti e un flusso di risorse di persone reali autorizzate. Anche la corrispondenza della voce, la pronuncia e il suono al confine di un clip richiedono un controllo. La guida ai prompt consiglia di descrivere le caratteristiche vocali desiderate e mantenere lo stile del dialogo vicino al riferimento audio. Controlla il risultato finale per la coerenza del soggetto, le parole pronunciate esatte, i tempi dell’azione, le transizioni tra fotogrammi e l’audio finale; perfeziona l’elemento specifico che differisce dal brief.

Disponibile in Ailoot · input e metodi

Ailoot Ultra · Video POST /v1/videos
Tipi di input
text, image, audio
Tipi di output
video
Formato di output
byte MP4 originali; nessuna normalizzazione o transcodifica
CampoTipoRequisitoValori e limitiPredefinito
CampomodelTipostringRequisitoObbligatorioValori e limiti
bytedance/seedance-2.0-mini
Predefinito—
CampopromptTipostringRequisitoObbligatorioValori e limitiPredefinito—
CampodurationTipointegerRequisitoObbligatorioValori e limiti
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimo: 1
Massimo: 600
Predefinito—
CamporesolutionTipostringRequisitoFacoltativoValori e limiti
480p, 720p
Predefinito—
Campoaspect_ratioTipostringRequisitoFacoltativoValori e limiti
1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21
Predefinito—
Campogenerate_audioTipobooleanRequisitoFacoltativoValori e limiti
false, true
Condizioni: Omettere generate_audio seleziona il prezzo con audio; false seleziona il prezzo senza audio. Controlla has_audio nel risultato per sapere se è stata restituita una traccia audio.
Predefinito—
Campoframe_imagesTipoarrayRequisitoFacoltativoValori e limiti
Numero minimo di elementi: 1
Numero massimo di elementi: 2
Contenuto in input: Array di oggetti fotogramma. Ciascuno contiene type=image_url, image_url con url e frame_type=first_frame o last_frame. Ogni ruolo compare al massimo una volta. Usa URL HTTPS pubblici.
Chiavi esatte: type, image_url, frame_type
Condizioni: Queste chiavi si applicano a ogni oggetto fotogramma. Ometti frame_images per una richiesta di solo testo.
Predefinito—
Campoinput_referencesTipoarrayRequisitoFacoltativoValori e limiti
Contenuto in input: Array di oggetti di riferimento a immagini o audio. Imposta type su image_url o audio_url e fornisci l'oggetto URL corrispondente contenente url. Il prezzo dei riferimenti video resta non determinabile.
Condizioni: Ometti frame_images per usare la modalità con riferimenti. Usa URL HTTPS pubblici.
Predefinito—
CamposizeTipostringRequisitoFacoltativoValori e limiti
480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720
Schema: ^[1-9][0-9]*x[1-9][0-9]*$
Predefinito—
CamposeedTipointegerRequisitoFacoltativoValori e limiti
Minimo: -9.223.372.036.854.775.808
Massimo: 9.223.372.036.854.775.807
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 un prompt testuale e una durata supportata in secondi interi. Usa una dimensione esatta tra quelle elencate oppure una risoluzione e un rapporto d'aspetto che corrispondano a dimensioni elencate.

model: Tipo: string · bytedance/seedance-2.0-mini

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 l'immagine di un fotogramma. · Obbligatorio: model, prompt, duration, frame_images

frame_images è un array di oggetti con type=image_url, image_url contenente url e frame_type. Usa un URL HTTPS pubblico dell'immagine; first_frame e last_frame possono comparire ciascuno una sola volta. Usa una dimensione di uscita elencata o dimensioni compatibili. Non aggiungere riferimenti video.

Chiavi esatte: type, image_url, frame_type

model: Tipo: string · bytedance/seedance-2.0-mini

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

Reference to video · Un prompt scritto e riferimenti a immagini o audio. · Obbligatorio: model, prompt, duration, input_references

input_references è un array. Ogni oggetto contiene type=image_url oppure type=audio_url e un oggetto URL corrispondente contenente url. Usa collegamenti HTTPS pubblici. Ometti frame_images per selezionare la modalità con riferimenti. Non è possibile determinare il prezzo dei riferimenti video.

model: Tipo: string · bytedance/seedance-2.0-mini

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, audio
Parametroadditional_propertiesContrattofalse
Parametrooptional_controlsContrattoresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, 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 dei token videoListino delle tariffe—Quantità prevista—Unità di fatturazioneper 1K token videoCondizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva.Costo
Output · Prezzo dei token video · Stima solo a fini di confronto $0.007 per 1K token video

La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.

ConfigurazionePrezzo dei token videoListino delle tariffe—Quantità prevista—Unità di fatturazioneper 1K token videoCondizioni di fatturazioneingresso: with_video_inputCosto
reference · Prezzo dei token video · Stima solo a fini di confronto $0.0042 per 1K token video

La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.

ConfigurazionePrezzo dei token videoListino delle tariffe—Quantità prevista—Unità di fatturazioneper 1K token videoCondizioni di fatturazioneopzione audio: without_audioCosto
Output · Prezzo dei token video · Stima solo a fini di confronto $0.007 per 1K token video

La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.

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 $0.1512 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

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

ConfigurazioneCondizioni di fatturazioneCosto
ConfigurazionePrezzo dei token videoCondizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva.Costo
Output · Prezzo dei token video $0.007 per 1K token video

La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.

ConfigurazionePrezzo dei token videoCondizioni di fatturazioneopzione audio: without_audioCosto
Output · Prezzo dei token video $0.007 per 1K token video

La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.

ConfigurazionePrezzo dei token videoCondizioni di fatturazioneingresso: with_video_inputCosto
reference · Prezzo dei token video $0.0042 per 1K token video

La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.

Esempi di richieste

Ailoot Ultra · Video

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"model":"bytedance/seedance-2.0-mini","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', 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\n

Ricevi e salva i risultati

Ailoot Ultra · Video

URL firmati di contenuti di tua proprietà

Verifica lo stato dell’attività
set -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\n
Altre letture di contenuto
set -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\n
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 bytedance/seedance-2.0-mini

Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

ID di chiamata correlati

bytedance/seedance-2.0-mini

", "method_identity": { "effective_request_model_id": "bytedance/seedance-2.0-mini", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|bytedance%2Fseedance-2.0-mini", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conserva ogni risultato effettivo di tua proprietà e i metadati misurati restituiti.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "L'accesso al video non è disponibile oppure questo ID video non è stato trovato.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Verifica l'accesso al video. Per un video esistente, usa l'ID pubblico originale e la stessa chiave API.", "type": "not_found_error" }, { "condition": "La chiave API non corrisponde all'account autenticato.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Verifica la chiave API e l'accesso all'account prima dell'invio.", "type": "authentication_error" }, { "condition": "Non è stato possibile leggere la richiesta oppure l'indice di download non è valido.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Correggi il corpo della richiesta. Per un download, scegli un indice di uscita restituito dall'attività originale.", "type": "invalid_request_error" }, { "condition": "Non è possibile determinare il prezzo della configurazione video selezionata.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Scegli una configurazione video supportata e completa le opzioni obbligatorie prima di inviare una richiesta corretta.", "type": "price_unavailable" }, { "condition": "Un input video o l'attività originale di continuazione non è valido.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Usa input HTTPS validi. Per la continuazione, usa l'ID video pubblico del tuo originale completato con la stessa chiave API.", "type": "invalid_request_error" }, { "condition": "Il saldo disponibile o i limiti non consentono di riservare l'importo.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Controlla il saldo disponibile e i limiti prima di inviare una nuova richiesta.", "type": "billing_error" }, { "condition": "La verifica video, l’archiviazione o l’accesso al servizio sono temporaneamente indisponibili.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Attendi che il servizio sia disponibile. Se hai già un ID video, verifica quell'attività originale invece di creare un'altra generazione.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Il risultato video originale e l'addebito devono essere verificati.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conserva l'ID video restituito e verifica quell'attività. Non inviare una richiesta di generazione sostitutiva mentre la verifica è in corso.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Il download del video esistente è temporaneamente indisponibile.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Verifica in seguito la stessa attività video e scarica il risultato esistente. Una nuova generazione crea un'operazione separata.", "type": "server_error" }, { "condition": "Il contenuto video non è stato pubblicato.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Verifica lo stato dell'attività originale. Scarica dopo che segnala completed; se segnala failed, segui l'avviso di verifica dell'addebito.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id originale + X-Should-Retry:false; non ripetere mai l'operazione originale" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Fornisci un prompt testuale e una durata supportata in secondi interi. Usa una dimensione esatta tra quelle elencate oppure una risoluzione e un rapporto d'aspetto che corrispondano a dimensioni elencate.", "required": [ "model", "prompt", "duration" ], "required_material": "Un prompt scritto." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images è un array di oggetti con type=image_url, image_url contenente url e frame_type. Usa un URL HTTPS pubblico dell'immagine; first_frame e last_frame possono comparire ciascuno una sola volta. Usa una dimensione di uscita elencata o dimensioni compatibili. Non aggiungere riferimenti video.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Un prompt scritto e l'immagine di un fotogramma." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references è un array. Ogni oggetto contiene type=image_url oppure type=audio_url e un oggetto URL corrispondente contenente url. Usa collegamenti HTTPS pubblici. Ometti frame_images per selezionare la modalità con riferimenti. Non è possibile determinare il prezzo dei riferimenti video.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Un prompt scritto e riferimenti a immagini o audio." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Posizione di questo video nell'elenco dei risultati, con indice a partire da zero.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL HTTPS firmato per il download di questo video completato.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Digest SHA-256 dei byte video originali; null se non disponibile.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Dimensione del file video originale in byte; null se non disponibile.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Durata misurata del video in millisecondi; null se non disponibile.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Larghezza del video in pixel; null se non disponibile.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Altezza del video in pixel; null se non disponibile.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identificatore del codec video; null se non registrato.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indica se il video contiene una traccia audio; null se non misurato.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identificatore del codec audio; null quando non è registrato alcun identificatore.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL firmati di contenuti di tua proprietà", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-mini" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Omettere generate_audio seleziona il prezzo con audio; false seleziona il prezzo senza audio. Controlla has_audio nel risultato per sapere se è stata restituita una traccia audio.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Queste chiavi si applicano a ogni oggetto fotogramma. Ometti frame_images per una richiesta di solo testo.", "content": "Array di oggetti fotogramma. Ciascuno contiene type=image_url, image_url con url e frame_type=first_frame o last_frame. Ogni ruolo compare al massimo una volta. Usa URL HTTPS pubblici.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Ometti frame_images per usare la modalità con riferimenti. Usa URL HTTPS pubblici.", "content": "Array di oggetti di riferimento a immagini o audio. Imposta type su image_url o audio_url e fornisci l'oggetto URL corrispondente contenente url. Il prezzo dei riferimenti video resta non determinabile.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-mini" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Prezzo dei token video", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.", "dimensions": { "conditions": "ingresso: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Prezzo dei token video", "units": [ { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo stimato della generazione", "units": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-mini\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', 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\n", "label": "curl · create video", "language": "bash" }, { "code": "set -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\n", "label": "GET original status", "language": "bash" }, { "code": "set -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\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "bytedance/seedance-2.0-mini", "nativeProvenance": { "input_facts_canonical_sha256": "0f3259f59b21ff52bdaf6e8b115f6d3dab8fc52ab4f386f57a4387017122a27e", "input_html_sha256": "c65695d12c50206c6f1168bdac3c6fb88981ff90060b369b251155a2961837f1", "private_audit_sha256": "7e5c77922dfe3a50ec5bbf7c1d2f34d851dec59222b7fda72f09b833e90f19d3", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/it/bytedance-seedance-2-0-mini/", "description": "Seedance 2.0 Mini crea brevi video con audio generato facoltativo a partire da testo e riferimenti di immagini, video e audio. Supporta la creazione di scene, modifiche video mirate e continuazioni, con un profilo di output documentato a 480p o 720p.", "locale": "it", "md_url": "https://ailoot.ai/models/it/bytedance-seedance-2-0-mini/index.md", "title": "ByteDance: Seedance 2.0 Mini — Ailoot", "url": "https://ailoot.ai/models/it/bytedance-seedance-2-0-mini/" }, "rawModel": { "about": "Seedance 2.0 Mini è un modello con un nome distinto all’interno della famiglia audiovisiva Seedance 2.0 di ByteDance. Il produttore documenta la generazione di video da testo, la generazione da immagini con primo fotogramma o primo e ultimo fotogramma, la generazione con riferimenti multimodali, la modifica e l’estensione di video. Il suono può essere generato insieme alle immagini. Scegli la modalità di creazione in base al materiale di cui disponi: un brief scritto, un’immagine iniziale fissa, due fotogrammi di confine o un clip da modificare o continuare.\n\nMini ha un proprio profilo di output. Il produttore elenca video a 480p e 720p con colore a 8 bit, 24 fotogrammi al secondo e output MP4. I rapporti d’aspetto supportati sono 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16; la durata di generazione documentata è di 4–15 secondi. Il controllo della durata consente anche la selezione automatica entro questo intervallo. Le opzioni 1080p e 4K del modello Seedance 2.0 completo sono separate; non sono impostazioni di Mini. La tabella delle capacità della famiglia elenca la restituzione dell’ultimo fotogramma generato, mentre la modalità Draft non è supportata.\n\nIl riferimento omni crea una nuova scena utilizzando informazioni selezionate dal materiale fornito. Un’immagine può definire l’aspetto di un soggetto, la composizione o il trattamento visivo. Un video può definire l’azione, il movimento di camera o un effetto; un riferimento audio può definire il timbro della voce, la melodia o il contenuto parlato. Indica al modello che cosa ricavare da ciascun riferimento, invece di chiedergli di copiarne ogni proprietà. Per esempio, usa una fotografia di prodotto per forma e colore, un breve clip di movimento di camera per l’avvicinamento e un riferimento sonoro per l’atmosfera.\n\nIl flusso di lavoro della famiglia consente fino a nove immagini di riferimento, tre clip video e tre clip audio. I riferimenti video durano 2–15 secondi ciascuno, per non più di 15 secondi complessivi; i riferimenti audio hanno gli stessi limiti di durata per clip e totali. L’audio da solo e il testo con audio senza un riferimento visivo non sono combinazioni di riferimenti supportate. La creazione con solo testo è una modalità supportata separata. Per una sequenza, fornisci le risorse nell’ordine previsto e richiamale coerentemente come Image 1, Video 1 o Audio 1, usando l’ordine all’interno di ciascun tipo di contenuto. Nel prompt scritto non sostituire un riferimento numerato con l’identificatore di una risorsa.\n\nUn’immagine di primo fotogramma definisce l’apertura di un’inquadratura guidata da un’immagine. La modalità primo e ultimo fotogramma definisce entrambi i confini. Se quelle esatte immagini iniziali e finali sono importanti, seleziona la modalità dedicata invece di descrivere i riferimenti come apertura e conclusione in un prompt omni-reference. Quest’ultima soluzione produce un effetto guidato dal prompt e non equivale alla scelta rigorosa dei fotogrammi di confine. Prepara le immagini per la composizione di uscita e specifica l’azione che collega la situazione iniziale a quella finale.\n\nLa modifica video cambia un clip esistente invece di usarlo soltanto come ispirazione. Identifica il video da modificare, l’oggetto o la regione da cambiare, il momento e la posizione in cui appare e i dettagli da preservare. Un brief utile è «In Video 1, replace the mug with the vessel shown in Image 1; preserve the hand movement, framing, lighting and table arrangement.» Per una rimozione, indica l’oggetto indesiderato e gli elementi circostanti che devono restare. Il produttore consiglia di riferirsi direttamente al video da modificare o estendere; presentarlo come riferimento può invece comunicare la richiesta di una scena nuova.\n\nL’estensione video aggiunge eventi prima o dopo un clip esistente. Descrivi la direzione della continuazione e ciò che accade dopo o prima. Il flusso documentato può anche collegare due o tre clip con transizioni generate; i tre video in ingresso devono comunque rientrare complessivamente nel limite di 15 secondi di riferimenti. Il tutorial distingue una continuazione che include principalmente il filmato ai confini del clip originale da una richiesta che ne conserva esplicitamente il contenuto. Specifica la composizione desiderata del risultato: soltanto la continuazione oppure una scena contenente il clip fornito e la nuova azione.\n\nPer impartire indicazioni chiare, separa la descrizione della scena stabile dalla sequenza degli eventi. Definisci ogni soggetto con due o tre caratteristiche visive distintive e un’etichetta coerente. Descrivi quindi azioni, ambientazione, illuminazione, movimento di camera, stile visivo e vincoli. In un dialogo, associa ogni battuta a chi la pronuncia e all’azione pertinente. Usa etichette ordinate per le inquadrature invece di considerare le indicazioni temporali esatte come controlli affidabili: il produttore segnala che la precisione dei tempi può essere instabile. Un brief di prodotto articolato in più momenti potrebbe essere: «Image 1 defines Product A. Shot 1: slowly approach Product A on the counter. Shot 2: a hand rotates it toward the light. Shot 3: settle on the front label. Soft room ambience; preserve the printed lettering.»\n\nPrepara i riferimenti secondo le regole di ingresso documentate per la famiglia. I formati immagine supportati comprendono JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF; ogni immagine deve essere inferiore a 30 MB. La guida specifica larghezza e altezza strettamente comprese tra 300 e 6.000 pixel e un rapporto d’aspetto strettamente compreso tra 0.4 e 2.5. I riferimenti video usano MP4 o MOV con video H.264 o H.265 e audio AAC o MP3, hanno un massimo di 200 MB ciascuno e 24–60 fotogrammi al secondo. Larghezza e altezza sono di 300–6.000 pixel, il rapporto d’aspetto è di 0.4–2.5 e il numero totale di pixel è di 407.696–8.295.044. I riferimenti audio usano WAV o MP3 e hanno un massimo di 15 MB ciascuno. Queste sono specifiche del produttore per la preparazione degli input, distinte dai controlli di caricamento di una particolare applicazione.\n\nIl flusso del produttore dedicato ai ritratti richiede una preparazione specifica per immagini o video contenenti volti di persone reali: i caricamenti diretti di riferimenti non sono il percorso standard supportato. Sono documentati come soluzioni separate gli output attendibili del modello, i personaggi digitali predefiniti e un flusso di risorse di persone reali autorizzate. Anche la corrispondenza della voce, la pronuncia e il suono al confine di un clip richiedono un controllo. La guida ai prompt consiglia di descrivere le caratteristiche vocali desiderate e mantenere lo stile del dialogo vicino al riferimento audio. Controlla il risultato finale per la coerenza del soggetto, le parole pronunciate esatte, i tempi dell’azione, le transizioni tra fotogrammi e l’audio finale; perfeziona l’elemento specifico che differisce dal brief.", "alias_of": null, "aliases": [], "author": "ByteDance", "available": null, "canonical_model": "bytedance/seedance-2.0-mini", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Tutte le tariffe della configurazione sono riportate nei dettagli." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "0b52dda4bb8d8eb2776e0f56", "label": "Riferimenti tariffari delle configurazioni video", "profiles": [ { "basis": "La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.", "dimensions": { "conditions": "In questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva." }, "label": "Prezzo dei token video", "units": [ { "amount": "0.007", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.", "dimensions": { "conditions": "opzione audio: without_audio" }, "label": "Prezzo dei token video", "units": [ { "amount": "0.007", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.", "dimensions": { "conditions": "ingresso: with_video_input" }, "label": "Prezzo dei token video", "units": [ { "amount": "0.0042", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "reference", "unit": "video_token" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "bytedance/seedance-2.0-mini", "input": [ "text", "image", "audio" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conserva ogni risultato effettivo di tua proprietà e i metadati misurati restituiti.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "L'accesso al video non è disponibile oppure questo ID video non è stato trovato.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Verifica l'accesso al video. Per un video esistente, usa l'ID pubblico originale e la stessa chiave API.", "type": "not_found_error" }, { "condition": "La chiave API non corrisponde all'account autenticato.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Verifica la chiave API e l'accesso all'account prima dell'invio.", "type": "authentication_error" }, { "condition": "Non è stato possibile leggere la richiesta oppure l'indice di download non è valido.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Correggi il corpo della richiesta. Per un download, scegli un indice di uscita restituito dall'attività originale.", "type": "invalid_request_error" }, { "condition": "Non è possibile determinare il prezzo della configurazione video selezionata.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Scegli una configurazione video supportata e completa le opzioni obbligatorie prima di inviare una richiesta corretta.", "type": "price_unavailable" }, { "condition": "Un input video o l'attività originale di continuazione non è valido.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Usa input HTTPS validi. Per la continuazione, usa l'ID video pubblico del tuo originale completato con la stessa chiave API.", "type": "invalid_request_error" }, { "condition": "Il saldo disponibile o i limiti non consentono di riservare l'importo.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Controlla il saldo disponibile e i limiti prima di inviare una nuova richiesta.", "type": "billing_error" }, { "condition": "La verifica video, l’archiviazione o l’accesso al servizio sono temporaneamente indisponibili.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Attendi che il servizio sia disponibile. Se hai già un ID video, verifica quell'attività originale invece di creare un'altra generazione.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Il risultato video originale e l'addebito devono essere verificati.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conserva l'ID video restituito e verifica quell'attività. Non inviare una richiesta di generazione sostitutiva mentre la verifica è in corso.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Il download del video esistente è temporaneamente indisponibile.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Verifica in seguito la stessa attività video e scarica il risultato esistente. Una nuova generazione crea un'operazione separata.", "type": "server_error" }, { "condition": "Il contenuto video non è stato pubblicato.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Verifica lo stato dell'attività originale. Scarica dopo che segnala completed; se segnala failed, segui l'avviso di verifica dell'addebito.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id originale + X-Should-Retry:false; non ripetere mai l'operazione originale" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Fornisci un prompt testuale e una durata supportata in secondi interi. Usa una dimensione esatta tra quelle elencate oppure una risoluzione e un rapporto d'aspetto che corrispondano a dimensioni elencate.", "required": [ "model", "prompt", "duration" ], "required_material": "Un prompt scritto." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images è un array di oggetti con type=image_url, image_url contenente url e frame_type. Usa un URL HTTPS pubblico dell'immagine; first_frame e last_frame possono comparire ciascuno una sola volta. Usa una dimensione di uscita elencata o dimensioni compatibili. Non aggiungere riferimenti video.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Un prompt scritto e l'immagine di un fotogramma." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references è un array. Ogni oggetto contiene type=image_url oppure type=audio_url e un oggetto URL corrispondente contenente url. Usa collegamenti HTTPS pubblici. Ometti frame_images per selezionare la modalità con riferimenti. Non è possibile determinare il prezzo dei riferimenti video.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Un prompt scritto e riferimenti a immagini o audio." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Posizione di questo video nell'elenco dei risultati, con indice a partire da zero.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL HTTPS firmato per il download di questo video completato.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Digest SHA-256 dei byte video originali; null se non disponibile.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Dimensione del file video originale in byte; null se non disponibile.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Durata misurata del video in millisecondi; null se non disponibile.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Larghezza del video in pixel; null se non disponibile.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Altezza del video in pixel; null se non disponibile.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identificatore del codec video; null se non registrato.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indica se il video contiene una traccia audio; null se non misurato.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identificatore del codec audio; null quando non è registrato alcun identificatore.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL firmati di contenuti di tua proprietà", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-mini" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Omettere generate_audio seleziona il prezzo con audio; false seleziona il prezzo senza audio. Controlla has_audio nel risultato per sapere se è stata restituita una traccia audio.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Queste chiavi si applicano a ogni oggetto fotogramma. Ometti frame_images per una richiesta di solo testo.", "content": "Array di oggetti fotogramma. Ciascuno contiene type=image_url, image_url con url e frame_type=first_frame o last_frame. Ogni ruolo compare al massimo una volta. Usa URL HTTPS pubblici.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Ometti frame_images per usare la modalità con riferimenti. Usa URL HTTPS pubblici.", "content": "Array di oggetti di riferimento a immagini o audio. Imposta type su image_url o audio_url e fornisci l'oggetto URL corrispondente contenente url. Il prezzo dei riferimenti video resta non determinabile.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-mini" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Prezzo dei token video", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "La tariffa per token video è il riferimento di prezzo principale. Le stime indicative al secondo sono riferimenti separati, non un addebito aggiuntivo.", "dimensions": { "conditions": "ingresso: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Prezzo dei token video", "units": [ { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo stimato della generazione", "units": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-mini\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', 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\n", "label": "curl · create video", "language": "bash" }, { "code": "set -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\n", "label": "GET original status", "language": "bash" }, { "code": "set -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\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.007000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000007", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.1512", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.1512", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "bytedance/seedance-2.0-mini", "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra" } ], "name": "ByteDance: Seedance 2.0 Mini", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.1512, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.1512, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-mini-260615", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000070", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-mini-260615", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-mini-260615", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000042", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-mini-260615", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.0070000", "amount_unit": "usd_per_thousand_tokens", "basis": "video token", "billing_original_currency": "USD", "billing_original_rate": "0.0000070", "key": "video_tokens", "label": "video token", "native_amount_usd_per_unit": "0.0000070", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0070000", "amount_unit": "usd_per_thousand_tokens", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.0000070", "key": "video_tokens_without_audio", "label": "video token", "native_amount_usd_per_unit": "0.0000070", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "basis": "video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.0000042", "key": "video_tokens_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" } ] } ], "public_id": "bytedance/seedance-2.0-mini", "short": "Seedance 2.0 Mini crea brevi video con audio generato facoltativo a partire da testo e riferimenti di immagini, video e audio. Supporta la creazione di scene, modifiche video mirate e continuazioni, con un profilo di output documentato a 480p o 720p." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Seedance 2.0 Mini crea brevi video con audio generato facoltativo a partire da testo e riferimenti di immagini, video e audio. Supporta la creazione di scene, modifiche video mirate e continuazioni, con un profilo di output documentato a 480p o 720p.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "f3998d75ff67265c3ad0b0cb6cb899916606879ac88af7b0a23dd5a946d5815b", "raw_model_js_projection_sha256": "ebce6d52b5730e186eaea10d1fc1d8fb0ddae1b5acb4eaec7495f62aad9199db", "raw_model_json_sha256": "f3998d75ff67265c3ad0b0cb6cb899916606879ac88af7b0a23dd5a946d5815b", "renderer_sha256": "3be1a96012c3c76b38a7b9bea6a57c0def38c56103737bee6a5e77aaa75e488a" }, "sourceRevision": "ef5d90aacb2e722756d13571dbaacf08ec82653c5c10d2e6c845b0fb237fc659" }