{
  "aboutHtml": "<p>DOP Preview anima le immagini fornite attraverso il flusso da immagine a video documentato da Higgsfield. Il selettore esatto è dop-preview. Usate dop-preview per la selezione del modello al livello superiore e come valore model nell’oggetto params documentato. L’immagine fornisce il materiale visivo, mentre i modelli di movimento e le indicazioni scritte controllano il movimento e l’effetto richiesti.</p><p>Preparate un’immagine di riferimento in cui il soggetto previsto, i dettagli importanti e lo spazio circostante siano leggibili. La guida raccomanda un’immagine ad alta risoluzione per dettagli più chiari. Per una scena di prodotto, scegliete una vista che mostri la forma dell’oggetto e le superfici che devono restare riconoscibili durante il movimento. Per una persona o un ambiente, identificate la caratteristica visiva da evidenziare con il movimento. Fornite l’URL dell’immagine di riferimento effettiva tramite l’input immagine usato nell’esempio del metodo.</p><p>L’operazione documenta uno o due modelli di movimento. Quando ne vengono forniti due, la guida descrive gli effetti come combinati. Le descrizioni delle impostazioni predefinite comprendono movimento della camera, rotazione del soggetto e trasformazioni visive; per esempio, Dolly In descrive un avvicinamento della camera, mentre 3D Rotation descrive un soggetto o prodotto che ruota sul posto. Selezionate gli identificatori documentati dei modelli che corrispondono alla sequenza prevista e conservate ogni identificatore insieme al suo valore di intensità.</p><p>L’intensità del movimento è un numero da 0 a 1, con 0,8 come valore predefinito documentato. La guida descrive 0,3 come effetto lieve e 1 come movimento forte. Scegliete l’intensità in base al dettaglio che deve restare leggibile e verificate l’intera azione generata. Una descrizione del movimento e la sua intensità hanno scopi diversi: il modello di movimento seleziona l’effetto, mentre l’intensità ne controlla la forza.</p><p>Il campo prompt deve essere presente secondo la sua descrizione, ma è ammessa una stringa vuota. Per gli effetti guidati dai modelli di movimento, la guida raccomanda di lasciare prompt vuoto; quando viene fornito testo, raccomanda di includere la descrizione del modello di movimento, perché il prompt può cambiare fortemente il risultato. Il controllo enhance_prompt abilita l’ottimizzazione del prompt ed è documentato con true come valore predefinito. Conservate il testo e questo controllo insieme all’immagine di riferimento e ai modelli selezionati quando confrontate le versioni.</p><p>Il controllo seed accetta un intero da 1 a 1 000 000. Registrate il valore seed scelto insieme alle impostazioni di generazione. La richiesta espone anche un campo intero seconds; conservate il valore usato insieme al video ottenuto ed esaminate i tempi e l’inquadratura effettivi del video. Il booleano check_nsfw abilita il filtro dei contenuti documentato e ha valore predefinito true. Questi controlli appartengono alla richiesta da immagine a video e devono restare associati all’esatto modello selezionato.</p><p>La generazione è asincrona. Conservate l’identificatore dell’attività restituito mentre seguite le interrogazioni configurate su stato e risultato. La mappatura del completamento legge le voci dei processi completati e gli URL grezzi dei risultati. Salvate ogni risultato video completato e conservate il suo identificatore di processo insieme all’URL restituito, mantenendo tutte le voci completate insieme come risultato dell’operazione.</p><p>Verificate l’intero video rispetto all’immagine fornita, all’effetto scelto e alle indicazioni scritte: aspetto del soggetto, movimento, inquadratura e vista finale. Per una revisione, identificate il dettaglio visivo concreto da cambiare e conservate le parti della richiesta riuscite. Mantenete insieme il riferimento all’immagine originale, il selettore esatto, prompt, identificatori dei movimenti, intensità, seed, impostazioni richieste e risorse completate, affinché il confronto successivo usi la generazione effettiva.</p>",
  "aboutText": "DOP Preview anima le immagini fornite attraverso il flusso da immagine a video documentato da Higgsfield. Il selettore esatto è dop-preview. Usate dop-preview per la selezione del modello al livello superiore e come valore model nell’oggetto params documentato. L’immagine fornisce il materiale visivo, mentre i modelli di movimento e le indicazioni scritte controllano il movimento e l’effetto richiesti.\n\nPreparate un’immagine di riferimento in cui il soggetto previsto, i dettagli importanti e lo spazio circostante siano leggibili. La guida raccomanda un’immagine ad alta risoluzione per dettagli più chiari. Per una scena di prodotto, scegliete una vista che mostri la forma dell’oggetto e le superfici che devono restare riconoscibili durante il movimento. Per una persona o un ambiente, identificate la caratteristica visiva da evidenziare con il movimento. Fornite l’URL dell’immagine di riferimento effettiva tramite l’input immagine usato nell’esempio del metodo.\n\nL’operazione documenta uno o due modelli di movimento. Quando ne vengono forniti due, la guida descrive gli effetti come combinati. Le descrizioni delle impostazioni predefinite comprendono movimento della camera, rotazione del soggetto e trasformazioni visive; per esempio, Dolly In descrive un avvicinamento della camera, mentre 3D Rotation descrive un soggetto o prodotto che ruota sul posto. Selezionate gli identificatori documentati dei modelli che corrispondono alla sequenza prevista e conservate ogni identificatore insieme al suo valore di intensità.\n\nL’intensità del movimento è un numero da 0 a 1, con 0,8 come valore predefinito documentato. La guida descrive 0,3 come effetto lieve e 1 come movimento forte. Scegliete l’intensità in base al dettaglio che deve restare leggibile e verificate l’intera azione generata. Una descrizione del movimento e la sua intensità hanno scopi diversi: il modello di movimento seleziona l’effetto, mentre l’intensità ne controlla la forza.\n\nIl campo prompt deve essere presente secondo la sua descrizione, ma è ammessa una stringa vuota. Per gli effetti guidati dai modelli di movimento, la guida raccomanda di lasciare prompt vuoto; quando viene fornito testo, raccomanda di includere la descrizione del modello di movimento, perché il prompt può cambiare fortemente il risultato. Il controllo enhance_prompt abilita l’ottimizzazione del prompt ed è documentato con true come valore predefinito. Conservate il testo e questo controllo insieme all’immagine di riferimento e ai modelli selezionati quando confrontate le versioni.\n\nIl controllo seed accetta un intero da 1 a 1 000 000. Registrate il valore seed scelto insieme alle impostazioni di generazione. La richiesta espone anche un campo intero seconds; conservate il valore usato insieme al video ottenuto ed esaminate i tempi e l’inquadratura effettivi del video. Il booleano check_nsfw abilita il filtro dei contenuti documentato e ha valore predefinito true. Questi controlli appartengono alla richiesta da immagine a video e devono restare associati all’esatto modello selezionato.\n\nLa generazione è asincrona. Conservate l’identificatore dell’attività restituito mentre seguite le interrogazioni configurate su stato e risultato. La mappatura del completamento legge le voci dei processi completati e gli URL grezzi dei risultati. Salvate ogni risultato video completato e conservate il suo identificatore di processo insieme all’URL restituito, mantenendo tutte le voci completate insieme come risultato dell’operazione.\n\nVerificate l’intero video rispetto all’immagine fornita, all’effetto scelto e alle indicazioni scritte: aspetto del soggetto, movimento, inquadratura e vista finale. Per una revisione, identificate il dettaglio visivo concreto da cambiare e conservate le parti della richiesta riuscite. Mantenete insieme il riferimento all’immagine originale, il selettore esatto, prompt, identificatori dei movimenti, intensità, seed, impostazioni richieste e risorse completate, affinché il confronto successivo usi la generazione effettiva.",
  "editorialOverlay": {
    "copy_fields": null,
    "copy_sha256": null,
    "copy_source": null,
    "html_sha256": "88668f73a4595c9ff65a7035067a9ab9a4bb07ae6d85b74f85c896bb0d9c1bee",
    "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06",
    "raw_model_unchanged": true,
    "schema": "ailoot-native-model-editorial-v1"
  },
  "locale": "it",
  "methods": [
    {
      "html": "<div class=\"sheet-head\"><span class=\"mav\" aria-hidden=\"true\">•</span><h2 id=\"sheet-title\">Higgsfield: DOP Preview</h2><button class=\"icon-btn\" type=\"button\" data-close-sheet aria-label=\"Chiudi\">×</button></div><div class=\"idline\"><span>Higgsfield /</span><code>dop-preview</code><button type=\"button\" id=\"copy-id\">Copia ID</button></div><nav class=\"card-jump-nav\" aria-label=\"Sezioni della scheda del modello\"><button type=\"button\" data-card-jump=\"overview\">Introduzione</button><button type=\"button\" data-card-jump=\"methods\">Input e metodi</button><button type=\"button\" data-card-jump=\"pricing\">Tariffe</button><button type=\"button\" data-card-jump=\"examples\">Esempi</button><button type=\"button\" data-card-jump=\"results\">Risultati</button><button type=\"button\" data-card-jump=\"aliases\">Alias</button></nav><div class=\"card-method-tabs\" role=\"tablist\" aria-label=\"Metodi API\"><button type=\"button\" role=\"tab\" tabindex=\"0\" aria-controls=\"card-method-content\" aria-selected=\"true\" id=\"card-method-tab-0\" data-card-method=\"Ultra|videos|/v1/videos|dop-preview\">Video</button></div><div id=\"card-method-content\" role=\"tabpanel\" aria-labelledby=\"card-method-tab-0\"><section class=\"card-section\" data-card-section=\"overview\"><h3 tabindex=\"-1\">Introduzione</h3><p class=\"mdesc-full\">DOP Preview trasforma le immagini fornite in video usando il flusso documentato con modelli di movimento. Il selettore esatto dop-preview supporta uno o due effetti, con i controlli strength, prompt e seed conservati insieme al risultato completato.</p><dl class=\"card-io\" data-card-io><div><dt>Input accettati</dt><dd>Immagini · Testo</dd></div><div><dt>Risultati</dt><dd>Video</dd></div></dl><details class=\"card-about\"><summary>Informazioni sul modello</summary><p class=\"note-s\" data-model-method-boundary>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.</p><div class=\"mabout\" id=\"m-about\"><p>DOP Preview anima le immagini fornite attraverso il flusso da immagine a video documentato da Higgsfield. Il selettore esatto è dop-preview. Usate dop-preview per la selezione del modello al livello superiore e come valore model nell’oggetto params documentato. L’immagine fornisce il materiale visivo, mentre i modelli di movimento e le indicazioni scritte controllano il movimento e l’effetto richiesti.</p><p>Preparate un’immagine di riferimento in cui il soggetto previsto, i dettagli importanti e lo spazio circostante siano leggibili. La guida raccomanda un’immagine ad alta risoluzione per dettagli più chiari. Per una scena di prodotto, scegliete una vista che mostri la forma dell’oggetto e le superfici che devono restare riconoscibili durante il movimento. Per una persona o un ambiente, identificate la caratteristica visiva da evidenziare con il movimento. Fornite l’URL dell’immagine di riferimento effettiva tramite l’input immagine usato nell’esempio del metodo.</p><p>L’operazione documenta uno o due modelli di movimento. Quando ne vengono forniti due, la guida descrive gli effetti come combinati. Le descrizioni delle impostazioni predefinite comprendono movimento della camera, rotazione del soggetto e trasformazioni visive; per esempio, Dolly In descrive un avvicinamento della camera, mentre 3D Rotation descrive un soggetto o prodotto che ruota sul posto. Selezionate gli identificatori documentati dei modelli che corrispondono alla sequenza prevista e conservate ogni identificatore insieme al suo valore di intensità.</p><p>L’intensità del movimento è un numero da 0 a 1, con 0,8 come valore predefinito documentato. La guida descrive 0,3 come effetto lieve e 1 come movimento forte. Scegliete l’intensità in base al dettaglio che deve restare leggibile e verificate l’intera azione generata. Una descrizione del movimento e la sua intensità hanno scopi diversi: il modello di movimento seleziona l’effetto, mentre l’intensità ne controlla la forza.</p><p>Il campo prompt deve essere presente secondo la sua descrizione, ma è ammessa una stringa vuota. Per gli effetti guidati dai modelli di movimento, la guida raccomanda di lasciare prompt vuoto; quando viene fornito testo, raccomanda di includere la descrizione del modello di movimento, perché il prompt può cambiare fortemente il risultato. Il controllo enhance_prompt abilita l’ottimizzazione del prompt ed è documentato con true come valore predefinito. Conservate il testo e questo controllo insieme all’immagine di riferimento e ai modelli selezionati quando confrontate le versioni.</p><p>Il controllo seed accetta un intero da 1 a 1 000 000. Registrate il valore seed scelto insieme alle impostazioni di generazione. La richiesta espone anche un campo intero seconds; conservate il valore usato insieme al video ottenuto ed esaminate i tempi e l’inquadratura effettivi del video. Il booleano check_nsfw abilita il filtro dei contenuti documentato e ha valore predefinito true. Questi controlli appartengono alla richiesta da immagine a video e devono restare associati all’esatto modello selezionato.</p><p>La generazione è asincrona. Conservate l’identificatore dell’attività restituito mentre seguite le interrogazioni configurate su stato e risultato. La mappatura del completamento legge le voci dei processi completati e gli URL grezzi dei risultati. Salvate ogni risultato video completato e conservate il suo identificatore di processo insieme all’URL restituito, mantenendo tutte le voci completate insieme come risultato dell’operazione.</p><p>Verificate l’intero video rispetto all’immagine fornita, all’effetto scelto e alle indicazioni scritte: aspetto del soggetto, movimento, inquadratura e vista finale. Per una revisione, identificate il dettaglio visivo concreto da cambiare e conservate le parti della richiesta riuscite. Mantenete insieme il riferimento all’immagine originale, il selettore esatto, prompt, identificatori dei movimenti, intensità, seed, impostazioni richieste e risorse completate, affinché il confronto successivo usi la generazione effettiva.</p></div></details></section><section class=\"card-section\" data-card-section=\"methods\"><h3 tabindex=\"-1\">Disponibile in Ailoot · input e metodi</h3><details class=\"card-method\" open><summary><b>Ailoot Ultra · Generazione video</b> <code>POST /v1/videos</code></summary><dl class=\"method-capabilities\"><div><dt>Tipi di input</dt><dd><code>image</code>, <code>text</code></dd></div><div><dt>Tipi di output</dt><dd><code>video</code></dd></div></dl><div class=\"tw\" data-card-parameters data-typed-parameters><table><thead><tr><th>Campo</th><th>Tipo</th><th>Requisito</th><th>Valori e limiti</th><th>Predefinito</th></tr></thead><tbody><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">model</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>string</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Obbligatorio</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>dop-preview</div><div>Condizioni: Selettore del modello Ailoot.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>object</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Obbligatorio</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Parametri per la generazione da immagine a video; conserva questa struttura.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.model</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>string</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Obbligatorio</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>dop-preview</div><div>Condizioni: Usa lo stesso selettore del modello al livello principale.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.prompt</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>string</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Obbligatorio</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Mantieni questo campo presente; è documentata una stringa vuota. Le indicazioni scritte influiscono fortemente sull&#39;effetto di movimento selezionato.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.seconds</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>integer</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Durata richiesta; non viene dichiarato alcun intervallo documentato o valore predefinito.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.motions</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>array</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Scegli uno o due modelli di movimento documentati.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.motions[].id</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>string</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Obbligatorio</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Identificatore del movimento nell&#39;esempio documentato di richiesta funzionante.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.motions[].strength</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>number</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Obbligatorio</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Minimo: 0</div><div>Massimo: 1</div><div>Condizioni: Intensità del movimento: 0.3 è descritto come lieve e 1 come forte.</div></td><td data-cell-label=\"Predefinito\" data-default=\"known\"><span class=\"card-cell-label\">Predefinito</span>0,8</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.input_images</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>array</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Immagini di riferimento, usando l&#39;array di oggetti image_url mostrato nell&#39;esempio funzionante.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.input_images[].type</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>string</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Obbligatorio</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>image_url</div><div>Condizioni: Rappresentazione del riferimento.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.input_images[].image_url</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>string</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Obbligatorio</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: L&#39;URL reale e accessibile della tua immagine di riferimento.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.enhance_prompt</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>boolean</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Miglioramento del prompt.</div></td><td data-cell-label=\"Predefinito\" data-default=\"known\"><span class=\"card-cell-label\">Predefinito</span>true</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.check_nsfw</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>boolean</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Filtro dei contenuti.</div></td><td data-cell-label=\"Predefinito\" data-default=\"known\"><span class=\"card-cell-label\">Predefinito</span>true</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">params.seed</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>integer</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Minimo: 1</div><div>Massimo: 1.000.000</div><div>Condizioni: Seed per risultati coerenti.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">webhook</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>object</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Impostazioni webhook documentate facoltative; il recupero dei risultati di tua proprietà usa i percorsi delle attività Ailoot.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">webhook.url</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>string</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: L&#39;URL del tuo destinatario.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">webhook.secret</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>string</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Il segreto del tuo endpoint di ricezione.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr><tr data-parameter-availability=\"source_interface\"><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">callback</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span><code>string</code></td><td data-cell-label=\"Requisito\"><span class=\"card-cell-label\">Requisito</span>Facoltativo</td><td data-cell-label=\"Valori e limiti\"><span class=\"card-cell-label\">Valori e limiti</span><div>Condizioni: Destinatario del callback facoltativo; il destinatario documentato risponde con HTTP 200.</div></td><td data-cell-label=\"Predefinito\" data-default=\"unspecified\"><span class=\"card-cell-label\">Predefinito</span>—</td></tr></tbody></table></div><details class=\"card-about\" data-material-combinations><summary>Combinazioni di materiali in input</summary><p class=\"note-s\"><b></b></p></details><details class=\"note-s\" data-method-contract><summary>Parametri e ciclo di vita del metodo</summary><div class=\"tw\" data-card-table=\"contract\"><table><thead><tr><th>Parametro</th><th>Contratto</th></tr></thead><tbody><tr><th data-cell-label=\"Parametro\" scope=\"row\"><span class=\"card-cell-label\">Parametro</span><code>content_type</code></th><td data-cell-label=\"Contratto\"><span class=\"card-cell-label\">Contratto</span>application/json</td></tr><tr><th data-cell-label=\"Parametro\" scope=\"row\"><span class=\"card-cell-label\">Parametro</span><code>required</code></th><td data-cell-label=\"Contratto\"><span class=\"card-cell-label\">Contratto</span>model, params</td></tr><tr><th data-cell-label=\"Parametro\" scope=\"row\"><span class=\"card-cell-label\">Parametro</span><code>optional</code></th><td data-cell-label=\"Contratto\"><span class=\"card-cell-label\">Contratto</span>params.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback</td></tr><tr><th data-cell-label=\"Parametro\" scope=\"row\"><span class=\"card-cell-label\">Parametro</span><code>material_types</code></th><td data-cell-label=\"Contratto\"><span class=\"card-cell-label\">Contratto</span>image, text</td></tr><tr><th data-cell-label=\"Parametro\" scope=\"row\"><span class=\"card-cell-label\">Parametro</span><code>additional_properties</code></th><td data-cell-label=\"Contratto\"><span class=\"card-cell-label\">Contratto</span>true</td></tr><tr><th data-cell-label=\"Parametro\" scope=\"row\"><span class=\"card-cell-label\">Parametro</span><code>validation_scope</code></th><td data-cell-label=\"Contratto\"><span class=\"card-cell-label\">Contratto</span>Il modello instrada la richiesta; la struttura contenitore dei parametri segue la richiesta dimostrata di generazione da immagine a video.</td></tr></tbody></table></div><p>Alias del metodo: <code>/v1/videos/generations</code></p><p>Ciclo di vita: <code>submit_once_poll_original</code></p><p class=\"note-s\"><code>GET /v1/videos/{request_id}</code></p><p class=\"note-s\"><code>GET /v1/videos/generations/{request_id}</code></p><p class=\"note-s\"><code>GET /v1/videos/{request_id}/content</code></p><p class=\"note-s\"><code>GET /v1/videos/generations/{request_id}/content</code></p><p class=\"note-s\">Usa lo stesso selettore del modello al livello principale e all&#39;interno di params.</p><p class=\"note-s\">Crea una sola volta, quindi usa l&#39;id pubblico e polling_url restituiti per l&#39;operazione originale.</p><p class=\"note-s\">Recupera ogni video completato di tua proprietà; verifica nel risultato la durata e le dimensioni effettive.</p><p class=\"note-s\">Sostituisci YOUR_ACCESSIBLE_IMAGE_URL nell&#39;esempio con l&#39;URL reale della tua immagine di riferimento.</p></details></details></section><section class=\"card-section\" data-card-section=\"pricing\"><h3 tabindex=\"-1\">Tariffe</h3><div class=\"card-result-process\" data-billing-basis><h5>Calcolo del costo finale</h5><p class=\"note-s\">Le tariffe visualizzate stimano il costo prima della generazione. L&#39;addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell&#39;output e le quantità previste non costituiscono la quantità finale fatturabile.</p></div><div data-native-semantic-method=\"v1\" data-tariff-reference-only><p class=\"note-s\" data-rate-support-note>Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.</p><dl data-price-conditions><dt>Modalità rapida</dt><dd>Non specificato <span class=\"note-s\">Quando è selezionata la modalità rapida</span></dd><dt>Modalità flex</dt><dd>Non specificato <span class=\"note-s\">Quando è selezionata la modalità flex</span></dd><dt>Sforzo massimo di ragionamento</dt><dd>Non specificato <span class=\"note-s\">Quando lo sforzo massimo di ragionamento usa l&#39;adeguamento predefinito (default)</span></dd></dl></div><div data-declared-tariff-pricing><h4>Tariffe stimate per il confronto</h4><h4>Prezzi per configurazione</h4><p class=\"note-s\">Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.</p><div class=\"tw\" data-pricing-profiles><table><thead><tr><th>Configurazione</th><th>Listino delle tariffe</th><th>Quantità prevista</th><th>Costo</th></tr></thead><tbody><tr><th data-cell-label=\"Configurazione\" scope=\"row\"><span class=\"card-cell-label\">Configurazione</span>Tariffe base dei token</th><td data-cell-label=\"Listino delle tariffe\"><span class=\"card-cell-label\">Listino delle tariffe</span>Tariffa base</td><td data-cell-label=\"Quantità prevista\"><span class=\"card-cell-label\">Quantità prevista</span>—</td><td data-cell-label=\"Costo\"><span class=\"card-cell-label\">Costo</span><div><span>Input · Token in input · Stima solo a fini di confronto</span> <b>—</b> <span class=\"price-unit\">/ 1K token</span></div><div><span>Output · Token in output · Stima solo a fini di confronto</span> <b>—</b> <span class=\"price-unit\">/ 1K token</span></div><div><span>Input · Lettura dalla cache · Stima solo a fini di confronto</span> <b>—</b> <span class=\"price-unit\">/ 1K token</span></div><div><span>Input · Scrittura nella cache · Stima solo a fini di confronto</span> <b>—</b> <span class=\"price-unit\">/ 1K token</span></div><div><span>Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto</span> <b>—</b> <span class=\"price-unit\">/ 1K token</span></div></td></tr><tr><th data-cell-label=\"Configurazione\" scope=\"row\"><span class=\"card-cell-label\">Configurazione</span>Costo stimato della generazione</th><td data-cell-label=\"Listino delle tariffe\"><span class=\"card-cell-label\">Listino delle tariffe</span>—</td><td data-cell-label=\"Quantità prevista\"><span class=\"card-cell-label\">Quantità prevista</span>stima per una generazione</td><td data-cell-label=\"Costo\"><span class=\"card-cell-label\">Costo</span><div><span>Output · Costo di generazione stimato · Stima solo a fini di confronto</span> <b>$1.24</b> <span class=\"price-unit\">stima prima della generazione</span></div><p class=\"note-s\">Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata.</p></td></tr></tbody></table></div></div><p class=\"note-s\">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. <a href=\"/docs/it/billing/reserve/\">Come funzionano la prenotazione e l’addebito finale →</a></p></section><section class=\"card-section\" data-card-section=\"examples\"><h3 tabindex=\"-1\">Esempi di richieste</h3><h4>Ailoot Ultra · Generazione video</h4><div class=\"code-group\"><div class=\"cg-bar\"><div class=\"cg-tabs\" role=\"tablist\" aria-label=\"Varianti di codice\"><button class=\"cg-tab\" id=\"model-code-2784-tab-0\" role=\"tab\" type=\"button\" aria-controls=\"model-code-2784-panel-0\" aria-selected=\"true\" tabindex=\"0\">JSON · crea un video</button><button class=\"cg-tab\" id=\"model-code-2784-tab-1\" role=\"tab\" type=\"button\" aria-controls=\"model-code-2784-panel-1\" aria-selected=\"false\" tabindex=\"-1\">curl · leggi il task originale</button></div><div class=\"cg-tools\"><button class=\"cg-btn cg-copy\" type=\"button\" aria-label=\"Copia il codice\"><svg class=\"cp\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\"><rect x=\"5.25\" y=\"5.25\" width=\"8.5\" height=\"8.5\" rx=\"1.75\"/><path d=\"M10.75 5.25V3.5a1.25 1.25 0 0 0-1.25-1.25H3.5A1.25 1.25 0 0 0 2.25 3.5v6a1.25 1.25 0 0 0 1.25 1.25h1.75\"/></svg><svg class=\"ok\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\"><path d=\"m3 8.5 3.25 3.25L13 5\"/></svg></button></div></div><div class=\"cg-body\"><div class=\"cg-pane\" id=\"model-code-2784-panel-0\" role=\"tabpanel\" aria-labelledby=\"model-code-2784-tab-0\"><pre data-lang=\"json\"><code>{\n  &quot;model&quot;: &quot;dop-preview&quot;,\n  &quot;params&quot;: {\n    &quot;model&quot;: &quot;dop-preview&quot;,\n    &quot;prompt&quot;: &quot;a cat&quot;,\n    &quot;seed&quot;: 500000,\n    &quot;motions&quot;: [\n      {\n        &quot;id&quot;: &quot;2bae49e6-ffe7-42a8-a73f-d44632c4acaa&quot;,\n        &quot;strength&quot;: 0.5\n      }\n    ],\n    &quot;input_images&quot;: [\n      {\n        &quot;type&quot;: &quot;image_url&quot;,\n        &quot;image_url&quot;: &quot;YOUR_ACCESSIBLE_IMAGE_URL&quot;\n      }\n    ],\n    &quot;enhance_prompt&quot;: true,\n    &quot;check_nsfw&quot;: true\n  }\n}</code></pre></div><div class=\"cg-pane\" id=\"model-code-2784-panel-1\" role=\"tabpanel\" aria-labelledby=\"model-code-2784-tab-1\" hidden><pre data-lang=\"bash\"><code>set -eu\n: &quot;${AILOOT_API_KEY:?Set your Ailoot API key}&quot;\npython3 - &lt;&lt;&#39;PY_POLL&#39;\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote,urljoin,urlsplit\nr=json.loads(Path(&quot;result.json&quot;).read_text())\ni=r.get(&quot;id&quot;)\nif not isinstance(i,str) or not i:raise SystemExit(&quot;Keep original response/headers/id; do not resubmit creation.&quot;)\nu=urljoin(&quot;https://api.ailoot.ai&quot;,r.get(&quot;polling_url&quot;) or &quot;/v1/videos/&quot;+quote(i,safe=&quot;&quot;))\np=urlsplit(u)\nif p.scheme!=&quot;https&quot; or p.netloc!=&quot;api.ailoot.ai&quot; or not p.path.startswith(&quot;/v1/videos/&quot;):raise SystemExit(&quot;Use the actual Ailoot lookup path.&quot;)\nPath(&quot;poll-url.txt&quot;).write_text(u)\nPY_POLL\ncurl --fail-with-body --silent --show-error &quot;$(cat poll-url.txt)&quot; -H &quot;Authorization: Bearer $AILOOT_API_KEY&quot; -D status-headers.txt -o status.json\n</code></pre></div></div></div></section><section class=\"card-section\" data-card-section=\"results\"><h3 tabindex=\"-1\">Ricevi e salva i risultati</h3><h4>Ailoot Ultra · Generazione video</h4><p class=\"note-s\">Conserva le attività restituite e i relativi stati. Consulta ogni risultato video completato di tua proprietà.</p><ul class=\"card-result-paths\"><li><code>GET /v1/videos/{request_id}</code></li><li><code>GET /v1/videos/generations/{request_id}</code></li><li><code>GET /v1/videos/{request_id}/content</code></li><li><code>GET /v1/videos/generations/{request_id}/content</code></li></ul><div class=\"card-result-process\" data-all-results><h5>Conserva tutti i risultati completati</h5><p class=\"note-s\">Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.</p><p class=\"note-s\">Recupera ogni risultato effettivo completato; non presumere un numero fisso.</p></div><div class=\"card-result-process\" data-unknown-recovery><h5>Se occorre verificare la risposta originale</h5><p class=\"note-s\">Conserva la risposta originale e l&#39;identità dell&#39;attività restituita; uno stato non riconosciuto o un invio dall&#39;esito ambiguo non autorizza una nuova creazione.</p></div><details class=\"card-about\" data-output-fields><summary>Campi della risposta</summary><div class=\"tw\" data-card-table=\"output\"><table><thead><tr><th>Campo</th><th>Tipo</th><th>Significato</th></tr></thead><tbody><tr><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">id</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span>string</td><td data-cell-label=\"Significato\"><span class=\"card-cell-label\">Significato</span>Identificatore pubblico dell&#39;attività o dell&#39;operazione Ailoot.</td></tr><tr><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">provider_task_id</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span>string</td><td data-cell-label=\"Significato\"><span class=\"card-cell-label\">Significato</span>Identificatore dell&#39;attività originale, distinto dall&#39;id pubblico.</td></tr><tr><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">polling_url</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span>string</td><td data-cell-label=\"Significato\"><span class=\"card-cell-label\">Significato</span>Percorso di consultazione Ailoot restituito.</td></tr><tr><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">jobs[].id</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span>string</td><td data-cell-label=\"Significato\"><span class=\"card-cell-label\">Significato</span>Identificatore dell&#39;attività effettivamente restituito.</td></tr><tr><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">jobs[].status</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span>string</td><td data-cell-label=\"Significato\"><span class=\"card-cell-label\">Significato</span>Stato di ogni attività restituita.</td></tr><tr><th data-cell-label=\"Campo\" scope=\"row\"><span class=\"card-cell-label\">Campo</span><code class=\"card-field-name\">jobs[].results.raw.url</code></th><td data-cell-label=\"Tipo\" data-field-type><span class=\"card-cell-label\">Tipo</span>string</td><td data-cell-label=\"Significato\"><span class=\"card-cell-label\">Significato</span>Ogni video completato è accessibile tramite un URL firmato di proprietà di Ailoot.</td></tr></tbody></table></div></details><details class=\"card-about\" data-method-errors><summary>Errori e passaggi successivi</summary><div class=\"tw\" data-card-table=\"errors\"><table><thead><tr><th>Risposta</th><th>Condizione</th><th>Passaggio successivo</th></tr></thead><tbody><tr><th data-cell-label=\"Risposta\" scope=\"row\"><span class=\"card-cell-label\">Risposta</span>400 · <code>invalid_request_error</code></th><td data-cell-label=\"Condizione\"><span class=\"card-cell-label\">Condizione</span>JSON o modello non valido oppure indice del contenuto non valido.</td><td data-cell-label=\"Passaggio successivo\"><span class=\"card-cell-label\">Passaggio successivo</span></td></tr><tr><th data-cell-label=\"Risposta\" scope=\"row\"><span class=\"card-cell-label\">Risposta</span>401 · <code>authentication_error</code></th><td data-cell-label=\"Condizione\"><span class=\"card-cell-label\">Condizione</span>Chiave API Ailoot non valida.</td><td data-cell-label=\"Passaggio successivo\"><span class=\"card-cell-label\">Passaggio successivo</span></td></tr><tr><th data-cell-label=\"Risposta\" scope=\"row\"><span class=\"card-cell-label\">Risposta</span>403 · <code>permission_error</code></th><td data-cell-label=\"Condizione\"><span class=\"card-cell-label\">Condizione</span>Il gruppo della chiave API non è autorizzato a utilizzare questa rotta multimediale.</td><td data-cell-label=\"Passaggio successivo\"><span class=\"card-cell-label\">Passaggio successivo</span></td></tr><tr><th data-cell-label=\"Risposta\" scope=\"row\"><span class=\"card-cell-label\">Risposta</span>404 · <code>not_found_error</code></th><td data-cell-label=\"Condizione\"><span class=\"card-cell-label\">Condizione</span>L&#39;attività originale o il risultato richiesto è assente oppure non appartiene allo stesso utente, alla stessa chiave API o allo stesso gruppo.</td><td data-cell-label=\"Passaggio successivo\"><span class=\"card-cell-label\">Passaggio successivo</span></td></tr><tr><th data-cell-label=\"Risposta\" scope=\"row\"><span class=\"card-cell-label\">Risposta</span>502 · <code>result_pending_check</code></th><td data-cell-label=\"Condizione\"><span class=\"card-cell-label\">Condizione</span>L&#39;invio o lo stato originale è incompleto oppure non può essere riconciliato; conserva l&#39;ID originale e non inviare nuovamente la richiesta.</td><td data-cell-label=\"Passaggio successivo\"><span class=\"card-cell-label\">Passaggio successivo</span></td></tr><tr><th data-cell-label=\"Risposta\" scope=\"row\"><span class=\"card-cell-label\">Risposta</span>503 · <code>result_pending_check</code></th><td data-cell-label=\"Condizione\"><span class=\"card-cell-label\">Condizione</span>Il collegamento originale, la rotta o il contenuto multimediale di tua proprietà è ancora in verifica; continua a verificare quell&#39;operazione originale.</td><td data-cell-label=\"Passaggio successivo\"><span class=\"card-cell-label\">Passaggio successivo</span></td></tr><tr><th data-cell-label=\"Risposta\" scope=\"row\"><span class=\"card-cell-label\">Risposta</span>503 · <code>server_error</code></th><td data-cell-label=\"Condizione\"><span class=\"card-cell-label\">Condizione</span>Il servizio multimediale o l&#39;archivio delle attività originali non è disponibile.</td><td data-cell-label=\"Passaggio successivo\"><span class=\"card-cell-label\">Passaggio successivo</span></td></tr></tbody></table></div></details></section><section class=\"card-section\" data-card-section=\"aliases\"><h3 tabindex=\"-1\">Alias</h3><h4>Alias del modello</h4><p class=\"note-s\"><span data-model-alias-route=\"Ultra\"><b>Ailoot Ultra</b> <a href=\"#m=dop-preview&amp;route=Ultra&amp;caller=dop-preview&amp;fmt=videos\"><code>dop-preview</code></a></span></p><h4>Alias dei percorsi dei metodi</h4><p class=\"note-s\"><code>/v1/videos/generations</code></p><h4>ID di chiamata correlati</h4><p class=\"note-s\"><a href=\"#m=dop-preview&amp;route=Ultra&amp;caller=dop-preview&amp;fmt=videos\"><code>dop-preview</code></a></p></section></div>",
      "method_identity": {
        "effective_request_model_id": "dop-preview",
        "fmt": "videos",
        "http": "POST",
        "path": "/v1/videos",
        "request_model_id": "dop-preview",
        "route_label": "Ultra"
      },
      "method_key": "Ultra|videos|/v1/videos|dop-preview",
      "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": {
            "errors": [
              {
                "condition": "JSON o modello non valido oppure indice del contenuto non valido.",
                "http_status": 400,
                "type": "invalid_request_error"
              },
              {
                "condition": "Chiave API Ailoot non valida.",
                "http_status": 401,
                "type": "authentication_error"
              },
              {
                "condition": "Il gruppo della chiave API non è autorizzato a utilizzare questa rotta multimediale.",
                "http_status": 403,
                "type": "permission_error"
              },
              {
                "condition": "L'attività originale o il risultato richiesto è assente oppure non appartiene allo stesso utente, alla stessa chiave API o allo stesso gruppo.",
                "http_status": 404,
                "type": "not_found_error"
              },
              {
                "condition": "L'invio o lo stato originale è incompleto oppure non può essere riconciliato; conserva l'ID originale e non inviare nuovamente la richiesta.",
                "http_status": 502,
                "type": "result_pending_check"
              },
              {
                "condition": "Il collegamento originale, la rotta o il contenuto multimediale di tua proprietà è ancora in verifica; continua a verificare quell'operazione originale.",
                "http_status": 503,
                "type": "result_pending_check"
              },
              {
                "condition": "Il servizio multimediale o l'archivio delle attività originali non è disponibile.",
                "http_status": 503,
                "type": "server_error"
              }
            ],
            "ignored_fields": [],
            "lifecycle": {
              "cancel_endpoint": null,
              "completed_states": [
                "completed"
              ],
              "content": [
                {
                  "http": "GET",
                  "path": "/v1/videos/{request_id}/content",
                  "query": {
                    "index": "actual output index; default 0"
                  }
                },
                {
                  "http": "GET",
                  "path": "/v1/videos/generations/{request_id}/content",
                  "query": {
                    "index": "actual output index; default 0"
                  }
                }
              ],
              "content_pending": "Original status JSON until publication.",
              "content_ready": {
                "http_status": 303,
                "location": "actual signed Ailoot-owned asset URL"
              },
              "create": {
                "http": "POST",
                "path": "/v1/videos"
              },
              "failed_states": [],
              "mode": "submit_once_poll_original",
              "owned_result": {
                "http": "GET",
                "path": "/v1/media/assets/{asset_id}"
              },
              "pending_states": [
                "queued"
              ],
              "signed_asset_lifetime_seconds": 86400,
              "state_field": "jobs[].status",
              "status": [
                {
                  "http": "GET",
                  "path": "/v1/videos/{request_id}"
                },
                {
                  "http": "GET",
                  "path": "/v1/videos/generations/{request_id}"
                }
              ],
              "submit_status": 200,
              "unknown": "Conserva la risposta originale e l'identità dell'attività restituita; uno stato non riconosciuto o un invio dall'esito ambiguo non autorizza una nuova creazione.",
              "unknown_no_replay": true
            },
            "material_combinations": [
              [
                "image",
                "text"
              ]
            ],
            "operation_modes": [
              "image_to_video"
            ],
            "outputs": {
              "all_results": "Recupera ogni risultato effettivo completato; non presumere un numero fisso.",
              "every_actual_output": true,
              "family": "video",
              "fields": [
                {
                  "description": "Identificatore pubblico dell'attività o dell'operazione Ailoot.",
                  "name": "id",
                  "type": "string"
                },
                {
                  "description": "Identificatore dell'attività originale, distinto dall'id pubblico.",
                  "name": "provider_task_id",
                  "type": "string"
                },
                {
                  "description": "Percorso di consultazione Ailoot restituito.",
                  "name": "polling_url",
                  "type": "string"
                },
                {
                  "description": "Identificatore dell'attività effettivamente restituito.",
                  "name": "jobs[].id",
                  "type": "string"
                },
                {
                  "description": "Stato di ogni attività restituita.",
                  "name": "jobs[].status",
                  "type": "string"
                },
                {
                  "description": "Ogni video completato è accessibile tramite un URL firmato di proprietà di Ailoot.",
                  "name": "jobs[].results.raw.url",
                  "type": "string"
                }
              ],
              "format": null,
              "maximum_outputs": null,
              "ownership": "Selected outputs are copied and verified before owned publication.",
              "result": "Conserva le attività restituite e i relativi stati. Consulta ogni risultato video completato di tua proprietà."
            },
            "parameters": [
              {
                "availability": "source_interface",
                "conditions": "Selettore del modello Ailoot.",
                "default": null,
                "default_known": false,
                "enum": [
                  "dop-preview"
                ],
                "enum_known": true,
                "name": "model",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Parametri per la generazione da immagine a video; conserva questa struttura.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params",
                "required": true,
                "type": "object"
              },
              {
                "availability": "source_interface",
                "conditions": "Usa lo stesso selettore del modello al livello principale.",
                "default": null,
                "default_known": false,
                "enum": [
                  "dop-preview"
                ],
                "enum_known": true,
                "name": "params.model",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Mantieni questo campo presente; è documentata una stringa vuota. Le indicazioni scritte influiscono fortemente sull'effetto di movimento selezionato.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.prompt",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Durata richiesta; non viene dichiarato alcun intervallo documentato o valore predefinito.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.seconds",
                "required": false,
                "type": "integer"
              },
              {
                "availability": "source_interface",
                "conditions": "Scegli uno o due modelli di movimento documentati.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "maxItems": 2,
                "minItems": 1,
                "name": "params.motions",
                "required": false,
                "type": "array"
              },
              {
                "availability": "source_interface",
                "conditions": "Identificatore del movimento nell'esempio documentato di richiesta funzionante.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.motions[].id",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Intensità del movimento: 0.3 è descritto come lieve e 1 come forte.",
                "default": 0.8,
                "default_known": true,
                "enum": null,
                "enum_known": false,
                "maximum": 1,
                "minimum": 0,
                "name": "params.motions[].strength",
                "required": true,
                "type": "number"
              },
              {
                "availability": "source_interface",
                "conditions": "Immagini di riferimento, usando l'array di oggetti image_url mostrato nell'esempio funzionante.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.input_images",
                "required": false,
                "type": "array"
              },
              {
                "availability": "source_interface",
                "conditions": "Rappresentazione del riferimento.",
                "default": null,
                "default_known": false,
                "enum": [
                  "image_url"
                ],
                "enum_known": true,
                "name": "params.input_images[].type",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "L'URL reale e accessibile della tua immagine di riferimento.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.input_images[].image_url",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Miglioramento del prompt.",
                "default": true,
                "default_known": true,
                "enum": null,
                "enum_known": false,
                "name": "params.enhance_prompt",
                "required": false,
                "type": "boolean"
              },
              {
                "availability": "source_interface",
                "conditions": "Filtro dei contenuti.",
                "default": true,
                "default_known": true,
                "enum": null,
                "enum_known": false,
                "name": "params.check_nsfw",
                "required": false,
                "type": "boolean"
              },
              {
                "availability": "source_interface",
                "conditions": "Seed per risultati coerenti.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "maximum": 1000000,
                "minimum": 1,
                "name": "params.seed",
                "required": false,
                "type": "integer"
              },
              {
                "availability": "source_interface",
                "conditions": "Impostazioni webhook documentate facoltative; il recupero dei risultati di tua proprietà usa i percorsi delle attività Ailoot.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "webhook",
                "required": false,
                "type": "object"
              },
              {
                "availability": "source_interface",
                "conditions": "L'URL del tuo destinatario.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "webhook.url",
                "required": false,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Il segreto del tuo endpoint di ricezione.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "webhook.secret",
                "required": false,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Destinatario del callback facoltativo; il destinatario documentato risponde con HTTP 200.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "callback",
                "required": false,
                "type": "string"
              }
            ],
            "request_schema": {
              "additionalProperties": true,
              "properties": {
                "callback": {
                  "type": "string"
                },
                "model": {
                  "const": "dop-preview",
                  "type": "string"
                },
                "params": {
                  "additionalProperties": true,
                  "properties": {
                    "check_nsfw": {
                      "default": true,
                      "type": "boolean"
                    },
                    "enhance_prompt": {
                      "default": true,
                      "type": "boolean"
                    },
                    "input_images": {
                      "items": {
                        "properties": {
                          "image_url": {
                            "type": "string"
                          },
                          "type": {
                            "const": "image_url",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "image_url"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "model": {
                      "const": "dop-preview",
                      "type": "string"
                    },
                    "motions": {
                      "items": {
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "strength": {
                            "default": 0.8,
                            "maximum": 1,
                            "minimum": 0,
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "strength"
                        ],
                        "type": "object"
                      },
                      "maxItems": 2,
                      "minItems": 1,
                      "type": "array"
                    },
                    "prompt": {
                      "type": "string"
                    },
                    "seconds": {
                      "type": "integer"
                    },
                    "seed": {
                      "maximum": 1000000,
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "required": [
                    "model",
                    "prompt"
                  ],
                  "type": "object"
                },
                "webhook": {
                  "properties": {
                    "secret": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              },
              "required": [
                "model",
                "params"
              ],
              "type": "object"
            },
            "source_ambiguities": [
              {
                "field": "params.motions[].id",
                "meaning": "The demonstrated request uses id; the generated schema names motion_id. This card follows the working example."
              },
              {
                "field": "params.input_images",
                "meaning": "The demonstrated request uses an array of image_url objects; the generated schema shows a different object shape. This card follows the working example."
              }
            ],
            "unsupported": []
          },
          "hints": [
            "Usa lo stesso selettore del modello al livello principale e all'interno di params.",
            "Crea una sola volta, quindi usa l'id pubblico e polling_url restituiti per l'operazione originale.",
            "Recupera ogni video completato di tua proprietà; verifica nel risultato la durata e le dimensioni effettive.",
            "Sostituisci YOUR_ACCESSIBLE_IMAGE_URL nell'esempio con l'URL reale della tua immagine di riferimento."
          ],
          "input": {
            "additional_properties": true,
            "content_type": "application/json",
            "material_types": [
              "image",
              "text"
            ],
            "optional": [
              "params.seconds",
              "params.motions",
              "params.input_images",
              "params.enhance_prompt",
              "params.check_nsfw",
              "params.seed",
              "webhook",
              "webhook.url",
              "webhook.secret",
              "callback"
            ],
            "required": [
              "model",
              "params"
            ],
            "validation_scope": "Il modello instrada la richiesta; la struttura contenitore dei parametri segue la richiesta dimostrata di generazione da immagine a video."
          },
          "lifecycle": {
            "cancel_endpoint": null,
            "completed_states": [
              "completed"
            ],
            "content": [
              {
                "http": "GET",
                "path": "/v1/videos/{request_id}/content",
                "query": {
                  "index": "actual output index; default 0"
                }
              },
              {
                "http": "GET",
                "path": "/v1/videos/generations/{request_id}/content",
                "query": {
                  "index": "actual output index; default 0"
                }
              }
            ],
            "content_pending": "Original status JSON until publication.",
            "content_ready": {
              "http_status": 303,
              "location": "actual signed Ailoot-owned asset URL"
            },
            "create": {
              "http": "POST",
              "path": "/v1/videos"
            },
            "failed_states": [],
            "mode": "submit_once_poll_original",
            "owned_result": {
              "http": "GET",
              "path": "/v1/media/assets/{asset_id}"
            },
            "pending_states": [
              "queued"
            ],
            "signed_asset_lifetime_seconds": 86400,
            "state_field": "jobs[].status",
            "status": [
              {
                "http": "GET",
                "path": "/v1/videos/{request_id}"
              },
              {
                "http": "GET",
                "path": "/v1/videos/generations/{request_id}"
              }
            ],
            "submit_status": 200,
            "unknown": "Keep the original response and returned task identity; an unrecognized state or ambiguous send does not authorize a new creation.",
            "unknown_no_replay": true
          },
          "manufacturer_capability": {
            "documented_material_types": [
              "image",
              "text"
            ]
          },
          "method": {
            "http": "POST",
            "path": "/v1/videos"
          },
          "method_aliases": [
            "/v1/videos/generations"
          ],
          "operation_modes": [
            "image_to_video"
          ],
          "output": {
            "all_results": "Fetch every actual completed output; do not assume a fixed count.",
            "every_actual_output": true,
            "family": "video",
            "fields": [
              {
                "description": "Public Ailoot task or operation identifier.",
                "name": "id",
                "type": "string"
              },
              {
                "description": "Original task identifier, separate from the public id.",
                "name": "provider_task_id",
                "type": "string"
              },
              {
                "description": "Returned Ailoot lookup path.",
                "name": "polling_url",
                "type": "string"
              },
              {
                "description": "Actual returned job identifier.",
                "name": "jobs[].id",
                "type": "string"
              },
              {
                "description": "State of each returned job.",
                "name": "jobs[].status",
                "type": "string"
              },
              {
                "description": "Each completed video is exposed through an Ailoot-owned signed URL.",
                "name": "jobs[].results.raw.url",
                "type": "string"
              }
            ],
            "format": null,
            "maximum_outputs": null,
            "ownership": "Selected outputs are copied and verified before owned publication.",
            "result": "Keep the returned jobs and their states. Read every completed owned video result."
          }
        },
        "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": "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": "1.24",
                "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": "1.24",
                "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": "{\n  \"model\": \"dop-preview\",\n  \"params\": {\n    \"model\": \"dop-preview\",\n    \"prompt\": \"a cat\",\n    \"seed\": 500000,\n    \"motions\": [\n      {\n        \"id\": \"2bae49e6-ffe7-42a8-a73f-d44632c4acaa\",\n        \"strength\": 0.5\n      }\n    ],\n    \"input_images\": [\n      {\n        \"type\": \"image_url\",\n        \"image_url\": \"YOUR_ACCESSIBLE_IMAGE_URL\"\n      }\n    ],\n    \"enhance_prompt\": true,\n    \"check_nsfw\": true\n  }\n}",
            "label": "JSON · create video",
            "language": "json"
          },
          {
            "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_POLL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote,urljoin,urlsplit\nr=json.loads(Path(\"result.json\").read_text())\ni=r.get(\"id\")\nif not isinstance(i,str) or not i:raise SystemExit(\"Keep original response/headers/id; do not resubmit creation.\")\nu=urljoin(\"https://api.ailoot.ai\",r.get(\"polling_url\") or \"/v1/videos/\"+quote(i,safe=\"\"))\np=urlsplit(u)\nif p.scheme!=\"https\" or p.netloc!=\"api.ailoot.ai\" or not p.path.startswith(\"/v1/videos/\"):raise SystemExit(\"Use the actual Ailoot lookup path.\")\nPath(\"poll-url.txt\").write_text(u)\nPY_POLL\ncurl --fail-with-body --silent --show-error \"$(cat poll-url.txt)\" -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\n",
            "label": "curl · read original task",
            "language": "bash"
          }
        ],
        "family": "openai",
        "fast_multiplier": null,
        "flex_multiplier": null,
        "fmt": "videos",
        "hints": [
          "Use the same model selector at the top level and inside params.",
          "Create once, then use the returned public id and polling_url for the original operation.",
          "Retrieve every completed owned video; inspect actual duration and dimensions in the result.",
          "Replace YOUR_ACCESSIBLE_IMAGE_URL in the example with your actual reference image URL."
        ],
        "http": "POST",
        "in": null,
        "input": [
          "image",
          "text"
        ],
        "label": "Generazione video",
        "max_out": null,
        "max_reasoning_effort_multiplier": null,
        "method_aliases": [
          "/v1/videos/generations"
        ],
        "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": "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": "1.24",
                "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": "1.24",
                "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": "dop-preview",
        "route_label": "Ultra",
        "status_reads": [
          "GET /v1/videos/{request_id}",
          "GET /v1/videos/generations/{request_id}",
          "GET /v1/videos/{request_id}/content",
          "GET /v1/videos/generations/{request_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": "1.24",
            "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": "1.24",
            "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": "dop-preview",
  "nativeProvenance": {
    "input_facts_canonical_sha256": "9fc4437449cda27a7f45f93d542ae499b288c4c6a84ea0aaf66bfc50841b088b",
    "input_html_sha256": "0f2746918c03b7cfeed3c205accc74cf919f165408c7f64bb7d9e1ee4899ac45",
    "private_audit_sha256": "eaed8e965f82ffe6a1f0a9bb50c4838a2517009de43213764ac1c999428fa14c",
    "role": "historical-normalized-input-audit-hashes",
    "schema": "ailoot-native-model-provenance-v2"
  },
  "page": {
    "canonical": "https://ailoot.ai/models/it/dop-preview/",
    "description": "DOP Preview trasforma le immagini fornite in video usando il flusso documentato con modelli di movimento. Il selettore esatto dop-preview supporta uno o due effetti, con i controlli strength, prompt e seed conservati insieme al risultato completato.",
    "locale": "it",
    "md_url": "https://ailoot.ai/models/it/dop-preview/index.md",
    "title": "Higgsfield: DOP Preview — Ailoot",
    "url": "https://ailoot.ai/models/it/dop-preview/"
  },
  "rawModel": {
    "about": "DOP Preview anima le immagini fornite attraverso il flusso da immagine a video documentato da Higgsfield. Il selettore esatto è dop-preview. Usate dop-preview per la selezione del modello al livello superiore e come valore model nell’oggetto params documentato. L’immagine fornisce il materiale visivo, mentre i modelli di movimento e le indicazioni scritte controllano il movimento e l’effetto richiesti.\n\nPreparate un’immagine di riferimento in cui il soggetto previsto, i dettagli importanti e lo spazio circostante siano leggibili. La guida raccomanda un’immagine ad alta risoluzione per dettagli più chiari. Per una scena di prodotto, scegliete una vista che mostri la forma dell’oggetto e le superfici che devono restare riconoscibili durante il movimento. Per una persona o un ambiente, identificate la caratteristica visiva da evidenziare con il movimento. Fornite l’URL dell’immagine di riferimento effettiva tramite l’input immagine usato nell’esempio del metodo.\n\nL’operazione documenta uno o due modelli di movimento. Quando ne vengono forniti due, la guida descrive gli effetti come combinati. Le descrizioni delle impostazioni predefinite comprendono movimento della camera, rotazione del soggetto e trasformazioni visive; per esempio, Dolly In descrive un avvicinamento della camera, mentre 3D Rotation descrive un soggetto o prodotto che ruota sul posto. Selezionate gli identificatori documentati dei modelli che corrispondono alla sequenza prevista e conservate ogni identificatore insieme al suo valore di intensità.\n\nL’intensità del movimento è un numero da 0 a 1, con 0,8 come valore predefinito documentato. La guida descrive 0,3 come effetto lieve e 1 come movimento forte. Scegliete l’intensità in base al dettaglio che deve restare leggibile e verificate l’intera azione generata. Una descrizione del movimento e la sua intensità hanno scopi diversi: il modello di movimento seleziona l’effetto, mentre l’intensità ne controlla la forza.\n\nIl campo prompt deve essere presente secondo la sua descrizione, ma è ammessa una stringa vuota. Per gli effetti guidati dai modelli di movimento, la guida raccomanda di lasciare prompt vuoto; quando viene fornito testo, raccomanda di includere la descrizione del modello di movimento, perché il prompt può cambiare fortemente il risultato. Il controllo enhance_prompt abilita l’ottimizzazione del prompt ed è documentato con true come valore predefinito. Conservate il testo e questo controllo insieme all’immagine di riferimento e ai modelli selezionati quando confrontate le versioni.\n\nIl controllo seed accetta un intero da 1 a 1 000 000. Registrate il valore seed scelto insieme alle impostazioni di generazione. La richiesta espone anche un campo intero seconds; conservate il valore usato insieme al video ottenuto ed esaminate i tempi e l’inquadratura effettivi del video. Il booleano check_nsfw abilita il filtro dei contenuti documentato e ha valore predefinito true. Questi controlli appartengono alla richiesta da immagine a video e devono restare associati all’esatto modello selezionato.\n\nLa generazione è asincrona. Conservate l’identificatore dell’attività restituito mentre seguite le interrogazioni configurate su stato e risultato. La mappatura del completamento legge le voci dei processi completati e gli URL grezzi dei risultati. Salvate ogni risultato video completato e conservate il suo identificatore di processo insieme all’URL restituito, mantenendo tutte le voci completate insieme come risultato dell’operazione.\n\nVerificate l’intero video rispetto all’immagine fornita, all’effetto scelto e alle indicazioni scritte: aspetto del soggetto, movimento, inquadratura e vista finale. Per una revisione, identificate il dettaglio visivo concreto da cambiare e conservate le parti della richiesta riuscite. Mantenete insieme il riferimento all’immagine originale, il selettore esatto, prompt, identificatori dei movimenti, intensità, seed, impostazioni richieste e risorse completate, affinché il confronto successivo usi la generazione effettiva.",
    "alias_of": null,
    "aliases": [],
    "author": "Higgsfield",
    "capabilities": {
      "context_length": 0,
      "manufacturer_input": [
        "image",
        "text"
      ],
      "manufacturer_output": [
        "video"
      ]
    },
    "card_routes": [
      {
        "label": "Ultra",
        "rates": [
          {
            "amount": "1.24",
            "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": "1.24",
            "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,
    "formats": [
      "videos"
    ],
    "id": "dop-preview",
    "input": [
      "image",
      "text"
    ],
    "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": {
            "errors": [
              {
                "condition": "JSON o modello non valido oppure indice del contenuto non valido.",
                "http_status": 400,
                "type": "invalid_request_error"
              },
              {
                "condition": "Chiave API Ailoot non valida.",
                "http_status": 401,
                "type": "authentication_error"
              },
              {
                "condition": "Il gruppo della chiave API non è autorizzato a utilizzare questa rotta multimediale.",
                "http_status": 403,
                "type": "permission_error"
              },
              {
                "condition": "L'attività originale o il risultato richiesto è assente oppure non appartiene allo stesso utente, alla stessa chiave API o allo stesso gruppo.",
                "http_status": 404,
                "type": "not_found_error"
              },
              {
                "condition": "L'invio o lo stato originale è incompleto oppure non può essere riconciliato; conserva l'ID originale e non inviare nuovamente la richiesta.",
                "http_status": 502,
                "type": "result_pending_check"
              },
              {
                "condition": "Il collegamento originale, la rotta o il contenuto multimediale di tua proprietà è ancora in verifica; continua a verificare quell'operazione originale.",
                "http_status": 503,
                "type": "result_pending_check"
              },
              {
                "condition": "Il servizio multimediale o l'archivio delle attività originali non è disponibile.",
                "http_status": 503,
                "type": "server_error"
              }
            ],
            "ignored_fields": [],
            "lifecycle": {
              "cancel_endpoint": null,
              "completed_states": [
                "completed"
              ],
              "content": [
                {
                  "http": "GET",
                  "path": "/v1/videos/{request_id}/content",
                  "query": {
                    "index": "actual output index; default 0"
                  }
                },
                {
                  "http": "GET",
                  "path": "/v1/videos/generations/{request_id}/content",
                  "query": {
                    "index": "actual output index; default 0"
                  }
                }
              ],
              "content_pending": "Original status JSON until publication.",
              "content_ready": {
                "http_status": 303,
                "location": "actual signed Ailoot-owned asset URL"
              },
              "create": {
                "http": "POST",
                "path": "/v1/videos"
              },
              "failed_states": [],
              "mode": "submit_once_poll_original",
              "owned_result": {
                "http": "GET",
                "path": "/v1/media/assets/{asset_id}"
              },
              "pending_states": [
                "queued"
              ],
              "signed_asset_lifetime_seconds": 86400,
              "state_field": "jobs[].status",
              "status": [
                {
                  "http": "GET",
                  "path": "/v1/videos/{request_id}"
                },
                {
                  "http": "GET",
                  "path": "/v1/videos/generations/{request_id}"
                }
              ],
              "submit_status": 200,
              "unknown": "Conserva la risposta originale e l'identità dell'attività restituita; uno stato non riconosciuto o un invio dall'esito ambiguo non autorizza una nuova creazione.",
              "unknown_no_replay": true
            },
            "material_combinations": [
              [
                "image",
                "text"
              ]
            ],
            "operation_modes": [
              "image_to_video"
            ],
            "outputs": {
              "all_results": "Recupera ogni risultato effettivo completato; non presumere un numero fisso.",
              "every_actual_output": true,
              "family": "video",
              "fields": [
                {
                  "description": "Identificatore pubblico dell'attività o dell'operazione Ailoot.",
                  "name": "id",
                  "type": "string"
                },
                {
                  "description": "Identificatore dell'attività originale, distinto dall'id pubblico.",
                  "name": "provider_task_id",
                  "type": "string"
                },
                {
                  "description": "Percorso di consultazione Ailoot restituito.",
                  "name": "polling_url",
                  "type": "string"
                },
                {
                  "description": "Identificatore dell'attività effettivamente restituito.",
                  "name": "jobs[].id",
                  "type": "string"
                },
                {
                  "description": "Stato di ogni attività restituita.",
                  "name": "jobs[].status",
                  "type": "string"
                },
                {
                  "description": "Ogni video completato è accessibile tramite un URL firmato di proprietà di Ailoot.",
                  "name": "jobs[].results.raw.url",
                  "type": "string"
                }
              ],
              "format": null,
              "maximum_outputs": null,
              "ownership": "Selected outputs are copied and verified before owned publication.",
              "result": "Conserva le attività restituite e i relativi stati. Consulta ogni risultato video completato di tua proprietà."
            },
            "parameters": [
              {
                "availability": "source_interface",
                "conditions": "Selettore del modello Ailoot.",
                "default": null,
                "default_known": false,
                "enum": [
                  "dop-preview"
                ],
                "enum_known": true,
                "name": "model",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Parametri per la generazione da immagine a video; conserva questa struttura.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params",
                "required": true,
                "type": "object"
              },
              {
                "availability": "source_interface",
                "conditions": "Usa lo stesso selettore del modello al livello principale.",
                "default": null,
                "default_known": false,
                "enum": [
                  "dop-preview"
                ],
                "enum_known": true,
                "name": "params.model",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Mantieni questo campo presente; è documentata una stringa vuota. Le indicazioni scritte influiscono fortemente sull'effetto di movimento selezionato.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.prompt",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Durata richiesta; non viene dichiarato alcun intervallo documentato o valore predefinito.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.seconds",
                "required": false,
                "type": "integer"
              },
              {
                "availability": "source_interface",
                "conditions": "Scegli uno o due modelli di movimento documentati.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "maxItems": 2,
                "minItems": 1,
                "name": "params.motions",
                "required": false,
                "type": "array"
              },
              {
                "availability": "source_interface",
                "conditions": "Identificatore del movimento nell'esempio documentato di richiesta funzionante.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.motions[].id",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Intensità del movimento: 0.3 è descritto come lieve e 1 come forte.",
                "default": 0.8,
                "default_known": true,
                "enum": null,
                "enum_known": false,
                "maximum": 1,
                "minimum": 0,
                "name": "params.motions[].strength",
                "required": true,
                "type": "number"
              },
              {
                "availability": "source_interface",
                "conditions": "Immagini di riferimento, usando l'array di oggetti image_url mostrato nell'esempio funzionante.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.input_images",
                "required": false,
                "type": "array"
              },
              {
                "availability": "source_interface",
                "conditions": "Rappresentazione del riferimento.",
                "default": null,
                "default_known": false,
                "enum": [
                  "image_url"
                ],
                "enum_known": true,
                "name": "params.input_images[].type",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "L'URL reale e accessibile della tua immagine di riferimento.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "params.input_images[].image_url",
                "required": true,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Miglioramento del prompt.",
                "default": true,
                "default_known": true,
                "enum": null,
                "enum_known": false,
                "name": "params.enhance_prompt",
                "required": false,
                "type": "boolean"
              },
              {
                "availability": "source_interface",
                "conditions": "Filtro dei contenuti.",
                "default": true,
                "default_known": true,
                "enum": null,
                "enum_known": false,
                "name": "params.check_nsfw",
                "required": false,
                "type": "boolean"
              },
              {
                "availability": "source_interface",
                "conditions": "Seed per risultati coerenti.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "maximum": 1000000,
                "minimum": 1,
                "name": "params.seed",
                "required": false,
                "type": "integer"
              },
              {
                "availability": "source_interface",
                "conditions": "Impostazioni webhook documentate facoltative; il recupero dei risultati di tua proprietà usa i percorsi delle attività Ailoot.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "webhook",
                "required": false,
                "type": "object"
              },
              {
                "availability": "source_interface",
                "conditions": "L'URL del tuo destinatario.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "webhook.url",
                "required": false,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Il segreto del tuo endpoint di ricezione.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "webhook.secret",
                "required": false,
                "type": "string"
              },
              {
                "availability": "source_interface",
                "conditions": "Destinatario del callback facoltativo; il destinatario documentato risponde con HTTP 200.",
                "default": null,
                "default_known": false,
                "enum": null,
                "enum_known": false,
                "name": "callback",
                "required": false,
                "type": "string"
              }
            ],
            "request_schema": {
              "additionalProperties": true,
              "properties": {
                "callback": {
                  "type": "string"
                },
                "model": {
                  "const": "dop-preview",
                  "type": "string"
                },
                "params": {
                  "additionalProperties": true,
                  "properties": {
                    "check_nsfw": {
                      "default": true,
                      "type": "boolean"
                    },
                    "enhance_prompt": {
                      "default": true,
                      "type": "boolean"
                    },
                    "input_images": {
                      "items": {
                        "properties": {
                          "image_url": {
                            "type": "string"
                          },
                          "type": {
                            "const": "image_url",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "image_url"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "model": {
                      "const": "dop-preview",
                      "type": "string"
                    },
                    "motions": {
                      "items": {
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "strength": {
                            "default": 0.8,
                            "maximum": 1,
                            "minimum": 0,
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "strength"
                        ],
                        "type": "object"
                      },
                      "maxItems": 2,
                      "minItems": 1,
                      "type": "array"
                    },
                    "prompt": {
                      "type": "string"
                    },
                    "seconds": {
                      "type": "integer"
                    },
                    "seed": {
                      "maximum": 1000000,
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "required": [
                    "model",
                    "prompt"
                  ],
                  "type": "object"
                },
                "webhook": {
                  "properties": {
                    "secret": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              },
              "required": [
                "model",
                "params"
              ],
              "type": "object"
            },
            "source_ambiguities": [
              {
                "field": "params.motions[].id",
                "meaning": "The demonstrated request uses id; the generated schema names motion_id. This card follows the working example."
              },
              {
                "field": "params.input_images",
                "meaning": "The demonstrated request uses an array of image_url objects; the generated schema shows a different object shape. This card follows the working example."
              }
            ],
            "unsupported": []
          },
          "hints": [
            "Usa lo stesso selettore del modello al livello principale e all'interno di params.",
            "Crea una sola volta, quindi usa l'id pubblico e polling_url restituiti per l'operazione originale.",
            "Recupera ogni video completato di tua proprietà; verifica nel risultato la durata e le dimensioni effettive.",
            "Sostituisci YOUR_ACCESSIBLE_IMAGE_URL nell'esempio con l'URL reale della tua immagine di riferimento."
          ],
          "input": {
            "additional_properties": true,
            "content_type": "application/json",
            "material_types": [
              "image",
              "text"
            ],
            "optional": [
              "params.seconds",
              "params.motions",
              "params.input_images",
              "params.enhance_prompt",
              "params.check_nsfw",
              "params.seed",
              "webhook",
              "webhook.url",
              "webhook.secret",
              "callback"
            ],
            "required": [
              "model",
              "params"
            ],
            "validation_scope": "Il modello instrada la richiesta; la struttura contenitore dei parametri segue la richiesta dimostrata di generazione da immagine a video."
          },
          "lifecycle": {
            "cancel_endpoint": null,
            "completed_states": [
              "completed"
            ],
            "content": [
              {
                "http": "GET",
                "path": "/v1/videos/{request_id}/content",
                "query": {
                  "index": "actual output index; default 0"
                }
              },
              {
                "http": "GET",
                "path": "/v1/videos/generations/{request_id}/content",
                "query": {
                  "index": "actual output index; default 0"
                }
              }
            ],
            "content_pending": "Original status JSON until publication.",
            "content_ready": {
              "http_status": 303,
              "location": "actual signed Ailoot-owned asset URL"
            },
            "create": {
              "http": "POST",
              "path": "/v1/videos"
            },
            "failed_states": [],
            "mode": "submit_once_poll_original",
            "owned_result": {
              "http": "GET",
              "path": "/v1/media/assets/{asset_id}"
            },
            "pending_states": [
              "queued"
            ],
            "signed_asset_lifetime_seconds": 86400,
            "state_field": "jobs[].status",
            "status": [
              {
                "http": "GET",
                "path": "/v1/videos/{request_id}"
              },
              {
                "http": "GET",
                "path": "/v1/videos/generations/{request_id}"
              }
            ],
            "submit_status": 200,
            "unknown": "Keep the original response and returned task identity; an unrecognized state or ambiguous send does not authorize a new creation.",
            "unknown_no_replay": true
          },
          "manufacturer_capability": {
            "documented_material_types": [
              "image",
              "text"
            ]
          },
          "method": {
            "http": "POST",
            "path": "/v1/videos"
          },
          "method_aliases": [
            "/v1/videos/generations"
          ],
          "operation_modes": [
            "image_to_video"
          ],
          "output": {
            "all_results": "Fetch every actual completed output; do not assume a fixed count.",
            "every_actual_output": true,
            "family": "video",
            "fields": [
              {
                "description": "Public Ailoot task or operation identifier.",
                "name": "id",
                "type": "string"
              },
              {
                "description": "Original task identifier, separate from the public id.",
                "name": "provider_task_id",
                "type": "string"
              },
              {
                "description": "Returned Ailoot lookup path.",
                "name": "polling_url",
                "type": "string"
              },
              {
                "description": "Actual returned job identifier.",
                "name": "jobs[].id",
                "type": "string"
              },
              {
                "description": "State of each returned job.",
                "name": "jobs[].status",
                "type": "string"
              },
              {
                "description": "Each completed video is exposed through an Ailoot-owned signed URL.",
                "name": "jobs[].results.raw.url",
                "type": "string"
              }
            ],
            "format": null,
            "maximum_outputs": null,
            "ownership": "Selected outputs are copied and verified before owned publication.",
            "result": "Keep the returned jobs and their states. Read every completed owned video result."
          }
        },
        "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": "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": "1.24",
                "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": "1.24",
                "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": "{\n  \"model\": \"dop-preview\",\n  \"params\": {\n    \"model\": \"dop-preview\",\n    \"prompt\": \"a cat\",\n    \"seed\": 500000,\n    \"motions\": [\n      {\n        \"id\": \"2bae49e6-ffe7-42a8-a73f-d44632c4acaa\",\n        \"strength\": 0.5\n      }\n    ],\n    \"input_images\": [\n      {\n        \"type\": \"image_url\",\n        \"image_url\": \"YOUR_ACCESSIBLE_IMAGE_URL\"\n      }\n    ],\n    \"enhance_prompt\": true,\n    \"check_nsfw\": true\n  }\n}",
            "label": "JSON · create video",
            "language": "json"
          },
          {
            "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_POLL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote,urljoin,urlsplit\nr=json.loads(Path(\"result.json\").read_text())\ni=r.get(\"id\")\nif not isinstance(i,str) or not i:raise SystemExit(\"Keep original response/headers/id; do not resubmit creation.\")\nu=urljoin(\"https://api.ailoot.ai\",r.get(\"polling_url\") or \"/v1/videos/\"+quote(i,safe=\"\"))\np=urlsplit(u)\nif p.scheme!=\"https\" or p.netloc!=\"api.ailoot.ai\" or not p.path.startswith(\"/v1/videos/\"):raise SystemExit(\"Use the actual Ailoot lookup path.\")\nPath(\"poll-url.txt\").write_text(u)\nPY_POLL\ncurl --fail-with-body --silent --show-error \"$(cat poll-url.txt)\" -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\n",
            "label": "curl · read original task",
            "language": "bash"
          }
        ],
        "family": "openai",
        "fast_multiplier": null,
        "flex_multiplier": null,
        "fmt": "videos",
        "hints": [
          "Use the same model selector at the top level and inside params.",
          "Create once, then use the returned public id and polling_url for the original operation.",
          "Retrieve every completed owned video; inspect actual duration and dimensions in the result.",
          "Replace YOUR_ACCESSIBLE_IMAGE_URL in the example with your actual reference image URL."
        ],
        "http": "POST",
        "in": null,
        "input": [
          "image",
          "text"
        ],
        "label": "Generazione video",
        "max_out": null,
        "max_reasoning_effort_multiplier": null,
        "method_aliases": [
          "/v1/videos/generations"
        ],
        "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": "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": "1.24",
                "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": "1.24",
                "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": "dop-preview",
        "route_label": "Ultra",
        "status_reads": [
          "GET /v1/videos/{request_id}",
          "GET /v1/videos/generations/{request_id}",
          "GET /v1/videos/{request_id}/content",
          "GET /v1/videos/generations/{request_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": "1.24",
            "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": "1.24",
            "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": "dop-preview",
        "request_model_id": "dop-preview",
        "route_label": "Ultra"
      }
    ],
    "name": "Higgsfield: DOP Preview",
    "price": {
      "estimate_only": true,
      "in": null,
      "in_label": null,
      "out": 1.24,
      "out_label": "estimate before generation",
      "scope_label": "Estimated generation cost",
      "sort_in": null,
      "sort_out": 1.24,
      "varies": false
    },
    "short": "DOP Preview trasforma le immagini fornite in video usando il flusso documentato con modelli di movimento. Il selettore esatto dop-preview supporta uno o due effetti, con i controlli strength, prompt e seed conservati insieme al risultato completato."
  },
  "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": "DOP Preview trasforma le immagini fornite in video usando il flusso documentato con modelli di movimento. Il selettore esatto dop-preview supporta uno o due effetti, con i controlli strength, prompt e seed conservati insieme al risultato completato.",
  "source": {
    "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1",
    "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036",
    "raw_model_json_sha256": "d8b8eadaaf73c1afb5c971c57b5a82a4117c520c14aad19c2202ba048c4053c6",
    "renderer_sha256": "3be1a96012c3c76b38a7b9bea6a57c0def38c56103737bee6a5e77aaa75e488a"
  },
  "sourceRevision": "36e2fd353a564dd64e49fe5a540079807cd40389e71bcca6ff9a972259fa3bc4"
}