Source: https://ailoot.ai/models/it/dop-preview/ Canonical: https://ailoot.ai/models/it/dop-preview/ Language: it # Higgsfield: DOP Preview [Markdown](https://ailoot.ai/models/it/dop-preview/index.md) · [JSON](https://ailoot.ai/models/it/dop-preview/facts.json) ## [Higgsfield: DOP Preview](https://ailoot.ai/models/it/dop-preview/) 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. - [**Ailoot Ultra · Generazione video** `POST /v1/videos` `dop-preview`](https://ailoot.ai/models/it/dop-preview/#method-0) Informazioni sul modello Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito. 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. 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. 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à. 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. 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. 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. 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. 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. **Ailoot Ultra · Generazione video** `POST /v1/videos` `dop-preview` [`dop-preview`](https://ailoot.ai/models/it/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos) Higgsfield /`dop-preview` ### Introduzione 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. Input accettati Immagini · Testo Risultati Video ### Disponibile in Ailoot · input e metodi **Ailoot Ultra · Generazione video** `POST /v1/videos` Tipi di input `image`, `text` Tipi di output `video` | Campo | Tipo | Requisito | Valori e limiti | Predefinito | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti dop-preview Condizioni: Selettore del modello Ailoot. | Predefinito— | | Campo`params` | Tipo`object` | RequisitoObbligatorio | Valori e limiti Condizioni: Parametri per la generazione da immagine a video; conserva questa struttura. | Predefinito— | | Campo`params.model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti dop-preview Condizioni: Usa lo stesso selettore del modello al livello principale. | Predefinito— | | Campo`params.prompt` | Tipo`string` | RequisitoObbligatorio | Valori e limiti Condizioni: Mantieni questo campo presente; è documentata una stringa vuota. Le indicazioni scritte influiscono fortemente sull'effetto di movimento selezionato. | Predefinito— | | Campo`params.seconds` | Tipo`integer` | RequisitoFacoltativo | Valori e limiti Condizioni: Durata richiesta; non viene dichiarato alcun intervallo documentato o valore predefinito. | Predefinito— | | Campo`params.motions` | Tipo`array` | RequisitoFacoltativo | Valori e limiti Condizioni: Scegli uno o due modelli di movimento documentati. | Predefinito— | | Campo`params.motions[].id` | Tipo`string` | RequisitoObbligatorio | Valori e limiti Condizioni: Identificatore del movimento nell'esempio documentato di richiesta funzionante. | Predefinito— | | Campo`params.motions[].strength` | Tipo`number` | RequisitoObbligatorio | Valori e limiti Minimo: 0 Massimo: 1 Condizioni: Intensità del movimento: 0.3 è descritto come lieve e 1 come forte. | Predefinito0,8 | | Campo`params.input_images` | Tipo`array` | RequisitoFacoltativo | Valori e limiti Condizioni: Immagini di riferimento, usando l'array di oggetti image\_url mostrato nell'esempio funzionante. | Predefinito— | | Campo`params.input_images[].type` | Tipo`string` | RequisitoObbligatorio | Valori e limiti image\_url Condizioni: Rappresentazione del riferimento. | Predefinito— | | Campo`params.input_images[].image_url` | Tipo`string` | RequisitoObbligatorio | Valori e limiti Condizioni: L'URL reale e accessibile della tua immagine di riferimento. | Predefinito— | | Campo`params.enhance_prompt` | Tipo`boolean` | RequisitoFacoltativo | Valori e limiti Condizioni: Miglioramento del prompt. | Predefinitotrue | | Campo`params.check_nsfw` | Tipo`boolean` | RequisitoFacoltativo | Valori e limiti Condizioni: Filtro dei contenuti. | Predefinitotrue | | Campo`params.seed` | Tipo`integer` | RequisitoFacoltativo | Valori e limiti Minimo: 1 Massimo: 1.000.000 Condizioni: Seed per risultati coerenti. | Predefinito— | | Campo`webhook` | Tipo`object` | RequisitoFacoltativo | Valori e limiti Condizioni: Impostazioni webhook documentate facoltative; il recupero dei risultati di tua proprietà usa i percorsi delle attività Ailoot. | Predefinito— | | Campo`webhook.url` | Tipo`string` | RequisitoFacoltativo | Valori e limiti Condizioni: L'URL del tuo destinatario. | Predefinito— | | Campo`webhook.secret` | Tipo`string` | RequisitoFacoltativo | Valori e limiti Condizioni: Il segreto del tuo endpoint di ricezione. | Predefinito— | | Campo`callback` | Tipo`string` | RequisitoFacoltativo | Valori e limiti Condizioni: Destinatario del callback facoltativo; il destinatario documentato risponde con HTTP 200. | Predefinito— | Combinazioni di materiali in input Parametri e ciclo di vita del metodo | Parametro | Contratto | | --- | --- | | Parametro`content_type` | Contrattoapplication/json | | Parametro`required` | Contrattomodel, params | | Parametro`optional` | Contrattoparams.seconds, params.motions, params.input\_images, params.enhance\_prompt, params.check\_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback | | Parametro`material_types` | Contrattoimage, text | | Parametro`additional_properties` | Contrattotrue | | Parametro`validation_scope` | ContrattoIl modello instrada la richiesta; la struttura contenitore dei parametri segue la richiesta dimostrata di generazione da immagine a video. | Alias del metodo: `/v1/videos/generations` Ciclo di vita: `submit_once_poll_original` `GET /v1/videos/{request_id}` `GET /v1/videos/generations/{request_id}` `GET /v1/videos/{request_id}/content` `GET /v1/videos/generations/{request_id}/content` 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. ### Tariffe ##### Calcolo del costo finale Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile. Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato. Modalità rapida Non specificato Quando è selezionata la modalità rapida Modalità flex Non specificato Quando è selezionata la modalità flex Sforzo massimo di ragionamento Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default) #### Tariffe stimate per il confronto #### Prezzi per configurazione Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative. | Configurazione | Listino delle tariffe | Quantità prevista | Costo | | --- | --- | --- | --- | | ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Costo Input · Token in input · Stima solo a fini di confronto **—** / 1K token Output · Token in output · Stima solo a fini di confronto **—** / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto **—** / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto **—** / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto **—** / 1K token | | ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto **$1.24** stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. | Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. [Come funzionano la prenotazione e l’addebito finale →](https://ailoot.ai/docs/it/billing/reserve/) ### Esempi di richieste #### Ailoot Ultra · Generazione video JSON · crea un videocurl · leggi il task originale ```json { "model": "dop-preview", "params": { "model": "dop-preview", "prompt": "a cat", "seed": 500000, "motions": [ { "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa", "strength": 0.5 } ], "input_images": [ { "type": "image_url", "image_url": "YOUR_ACCESSIBLE_IMAGE_URL" } ], "enhance_prompt": true, "check_nsfw": true } } ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_POLL' import json from pathlib import Path from urllib.parse import quote,urljoin,urlsplit r=json.loads(Path("result.json").read_text()) i=r.get("id") if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.") u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe="")) p=urlsplit(u) if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.") Path("poll-url.txt").write_text(u) PY_POLL curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json ``` ### Ricevi e salva i risultati #### Ailoot Ultra · Generazione video Conserva le attività restituite e i relativi stati. Consulta ogni risultato video completato di tua proprietà. - `GET /v1/videos/{request_id}` - `GET /v1/videos/generations/{request_id}` - `GET /v1/videos/{request_id}/content` - `GET /v1/videos/generations/{request_id}/content` ##### Conserva tutti i risultati completati Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito. Recupera ogni risultato effettivo completato; non presumere un numero fisso. ##### Se occorre verificare la risposta originale 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. Campi della risposta | Campo | Tipo | Significato | | --- | --- | --- | | Campo`id` | Tipostring | SignificatoIdentificatore pubblico dell'attività o dell'operazione Ailoot. | | Campo`provider_task_id` | Tipostring | SignificatoIdentificatore dell'attività originale, distinto dall'id pubblico. | | Campo`polling_url` | Tipostring | SignificatoPercorso di consultazione Ailoot restituito. | | Campo`jobs[].id` | Tipostring | SignificatoIdentificatore dell'attività effettivamente restituito. | | Campo`jobs[].status` | Tipostring | SignificatoStato di ogni attività restituita. | | Campo`jobs[].results.raw.url` | Tipostring | SignificatoOgni video completato è accessibile tramite un URL firmato di proprietà di Ailoot. | Errori e passaggi successivi | Risposta | Condizione | Passaggio successivo | | --- | --- | --- | | Risposta400 · `invalid_request_error` | CondizioneJSON o modello non valido oppure indice del contenuto non valido. | Passaggio successivo | | Risposta401 · `authentication_error` | CondizioneChiave API Ailoot non valida. | Passaggio successivo | | Risposta403 · `permission_error` | CondizioneIl gruppo della chiave API non è autorizzato a utilizzare questa rotta multimediale. | Passaggio successivo | | Risposta404 · `not_found_error` | CondizioneL'attività originale o il risultato richiesto è assente oppure non appartiene allo stesso utente, alla stessa chiave API o allo stesso gruppo. | Passaggio successivo | | Risposta502 · `result_pending_check` | CondizioneL'invio o lo stato originale è incompleto oppure non può essere riconciliato; conserva l'ID originale e non inviare nuovamente la richiesta. | Passaggio successivo | | Risposta503 · `result_pending_check` | CondizioneIl collegamento originale, la rotta o il contenuto multimediale di tua proprietà è ancora in verifica; continua a verificare quell'operazione originale. | Passaggio successivo | | Risposta503 · `server_error` | CondizioneIl servizio multimediale o l'archivio delle attività originali non è disponibile. | Passaggio successivo | ### Alias #### Alias del modello **Ailoot Ultra** [`dop-preview`](https://ailoot.ai/models/it/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos) #### Alias dei percorsi dei metodi `/v1/videos/generations` #### ID di chiamata correlati [`dop-preview`](https://ailoot.ai/models/it/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos) FAQ · Higgsfield: DOP Preview Quali input e risultati sono disponibili? `POST /v1/videos` · `dop-preview`: `image`, `text` → `video` Quali campi usa la richiesta? `POST /v1/videos` · `dop-preview`: `model`, `params`, `webhook`, `callback` Quali limiti si applicano? `POST /v1/videos` · `dop-preview`: `params.motions[].strength.minimum`: `0`; `params.motions[].strength.maximum`: `1`; `params.seed.minimum`: `1`; `params.seed.maximum`: `1000000` Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione. ## L’azienda e il suo portafoglio di progetti L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. ## Acquista token con uno sconto. Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token. Abbonamento Scegli un piano scontato per richieste regolari. Codice fino al 50% Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione. Spese nella cronologia Modello, token e importo sono salvati per ogni richiesta. [Scegli abbonamento](https://ailoot.ai/docs/it/billing/subscriptions/) · [Consulta prezzi dei modelli](https://ailoot.ai/models/it/) ## Collega l’API al prodotto che vendi. SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller. Applicazione commerciale Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento. Licenza reseller Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita. Documenti sul sito Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione. [Richiedi licenza reseller](mailto:support@ailoot.ai) · [Offerta e accordo di licenza](https://ailoot.ai/legal/offer?lang=it) ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.