modelli

Higgsfield: DOP Preview

Markdown · JSON

Higgsfield: 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.

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

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
CampoTipoRequisitoValori e limitiPredefinito
CampomodelTipostringRequisitoObbligatorioValori e limiti
dop-preview
Condizioni: Selettore del modello Ailoot.
Predefinito—
CampoparamsTipoobjectRequisitoObbligatorioValori e limiti
Condizioni: Parametri per la generazione da immagine a video; conserva questa struttura.
Predefinito—
Campoparams.modelTipostringRequisitoObbligatorioValori e limiti
dop-preview
Condizioni: Usa lo stesso selettore del modello al livello principale.
Predefinito—
Campoparams.promptTipostringRequisitoObbligatorioValori e limiti
Condizioni: Mantieni questo campo presente; è documentata una stringa vuota. Le indicazioni scritte influiscono fortemente sull'effetto di movimento selezionato.
Predefinito—
Campoparams.secondsTipointegerRequisitoFacoltativoValori e limiti
Condizioni: Durata richiesta; non viene dichiarato alcun intervallo documentato o valore predefinito.
Predefinito—
Campoparams.motionsTipoarrayRequisitoFacoltativoValori e limiti
Condizioni: Scegli uno o due modelli di movimento documentati.
Predefinito—
Campoparams.motions[].idTipostringRequisitoObbligatorioValori e limiti
Condizioni: Identificatore del movimento nell'esempio documentato di richiesta funzionante.
Predefinito—
Campoparams.motions[].strengthTiponumberRequisitoObbligatorioValori e limiti
Minimo: 0
Massimo: 1
Condizioni: Intensità del movimento: 0.3 è descritto come lieve e 1 come forte.
Predefinito0,8
Campoparams.input_imagesTipoarrayRequisitoFacoltativoValori e limiti
Condizioni: Immagini di riferimento, usando l'array di oggetti image_url mostrato nell'esempio funzionante.
Predefinito—
Campoparams.input_images[].typeTipostringRequisitoObbligatorioValori e limiti
image_url
Condizioni: Rappresentazione del riferimento.
Predefinito—
Campoparams.input_images[].image_urlTipostringRequisitoObbligatorioValori e limiti
Condizioni: L'URL reale e accessibile della tua immagine di riferimento.
Predefinito—
Campoparams.enhance_promptTipobooleanRequisitoFacoltativoValori e limiti
Condizioni: Miglioramento del prompt.
Predefinitotrue
Campoparams.check_nsfwTipobooleanRequisitoFacoltativoValori e limiti
Condizioni: Filtro dei contenuti.
Predefinitotrue
Campoparams.seedTipointegerRequisitoFacoltativoValori e limiti
Minimo: 1
Massimo: 1.000.000
Condizioni: Seed per risultati coerenti.
Predefinito—
CampowebhookTipoobjectRequisitoFacoltativoValori e limiti
Condizioni: Impostazioni webhook documentate facoltative; il recupero dei risultati di tua proprietà usa i percorsi delle attività Ailoot.
Predefinito—
Campowebhook.urlTipostringRequisitoFacoltativoValori e limiti
Condizioni: L'URL del tuo destinatario.
Predefinito—
Campowebhook.secretTipostringRequisitoFacoltativoValori e limiti
Condizioni: Il segreto del tuo endpoint di ricezione.
Predefinito—
CampocallbackTipostringRequisitoFacoltativoValori 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
ParametroContratto
Parametrocontent_typeContrattoapplication/json
ParametrorequiredContrattomodel, params
ParametrooptionalContrattoparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Parametromaterial_typesContrattoimage, text
Parametroadditional_propertiesContrattotrue
Parametrovalidation_scopeContrattoIl 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.

ConfigurazioneListino delle tariffeQuantità previstaCosto
ConfigurazioneTariffe base dei tokenListino delle tariffeTariffa baseQuantità 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 generazioneListino delle tariffe—Quantità previstastima per una generazioneCosto
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 →

Esempi di richieste

Ailoot Ultra · Generazione video

JSON · crea un videocurl · leggi il task originale
{
  "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
  }
}
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
CampoTipoSignificato
CampoidTipostringSignificatoIdentificatore pubblico dell'attività o dell'operazione Ailoot.
Campoprovider_task_idTipostringSignificatoIdentificatore dell'attività originale, distinto dall'id pubblico.
Campopolling_urlTipostringSignificatoPercorso di consultazione Ailoot restituito.
Campojobs[].idTipostringSignificatoIdentificatore dell'attività effettivamente restituito.
Campojobs[].statusTipostringSignificatoStato di ogni attività restituita.
Campojobs[].results.raw.urlTipostringSignificatoOgni video completato è accessibile tramite un URL firmato di proprietà di Ailoot.
Errori e passaggi successivi
RispostaCondizionePassaggio successivo
Risposta400 · invalid_request_errorCondizioneJSON o modello non valido oppure indice del contenuto non valido.Passaggio successivo
Risposta401 · authentication_errorCondizioneChiave API Ailoot non valida.Passaggio successivo
Risposta403 · permission_errorCondizioneIl gruppo della chiave API non è autorizzato a utilizzare questa rotta multimediale.Passaggio successivo
Risposta404 · not_found_errorCondizioneL'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_checkCondizioneL'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_checkCondizioneIl collegamento originale, la rotta o il contenuto multimediale di tua proprietà è ancora in verifica; continua a verificare quell'operazione originale.Passaggio successivo
Risposta503 · server_errorCondizioneIl servizio multimediale o l'archivio delle attività originali non è disponibile.Passaggio successivo

Alias

Alias del modello

Ailoot Ultra dop-preview

Alias dei percorsi dei metodi

/v1/videos/generations

ID di chiamata correlati

dop-preview

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

Maggiori dettagli

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 · Consulta prezzi dei modelli

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 · Offerta e accordo di licenza