Higgsfield: DOP Lite
DOP Lite anima un’immagine fornita con modelli di movimento documentati, intensità regolabile e indicazioni scritte. Questo esatto selettore dop-lite usa la richiesta da immagine a video e restituisce il video tramite un’attività asincrona.
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 Lite anima le immagini fornite attraverso il flusso da immagine a video documentato da Higgsfield. Il selettore esatto è dop-lite. Usate dop-lite 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-lite
dop-liteIntroduzione
DOP Lite anima un’immagine fornita con modelli di movimento documentati, intensità regolabile e indicazioni scritte. Questo esatto selettore dop-lite usa la richiesta da immagine a video e restituisce il video tramite un’attività asincrona.
- 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 |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti dop-lite Condizioni: Selettore del modello Ailoot. | Predefinito— |
Campoparams | Tipoobject | RequisitoObbligatorio | Valori e limiti Condizioni: Parametri per la generazione da immagine a video; conserva questa struttura. | Predefinito— |
Campoparams.model | Tipostring | RequisitoObbligatorio | Valori e limiti dop-lite Condizioni: Usa lo stesso selettore del modello al livello principale. | Predefinito— |
Campoparams.prompt | Tipostring | RequisitoObbligatorio | Valori e limiti Condizioni: Mantieni questo campo presente; è documentata una stringa vuota. Le indicazioni scritte influiscono fortemente sull'effetto di movimento selezionato. | Predefinito— |
Campoparams.seconds | Tipointeger | RequisitoFacoltativo | Valori e limiti Condizioni: Durata richiesta; non viene dichiarato alcun intervallo documentato o valore predefinito. | Predefinito— |
Campoparams.motions | Tipoarray | RequisitoFacoltativo | Valori e limiti Condizioni: Scegli uno o due modelli di movimento documentati. | Predefinito— |
Campoparams.motions[].id | Tipostring | RequisitoObbligatorio | Valori e limiti Condizioni: Identificatore del movimento nell'esempio documentato di richiesta funzionante. | Predefinito— |
Campoparams.motions[].strength | Tiponumber | RequisitoObbligatorio | Valori e limiti Minimo: 0 Massimo: 1 Condizioni: Intensità del movimento: 0.3 è descritto come lieve e 1 come forte. | Predefinito0,8 |
Campoparams.input_images | Tipoarray | RequisitoFacoltativo | Valori e limiti Condizioni: Immagini di riferimento, usando l'array di oggetti image_url mostrato nell'esempio funzionante. | Predefinito— |
Campoparams.input_images[].type | Tipostring | RequisitoObbligatorio | Valori e limiti image_url Condizioni: Rappresentazione del riferimento. | Predefinito— |
Campoparams.input_images[].image_url | Tipostring | RequisitoObbligatorio | Valori e limiti Condizioni: L'URL reale e accessibile della tua immagine di riferimento. | Predefinito— |
Campoparams.enhance_prompt | Tipoboolean | RequisitoFacoltativo | Valori e limiti Condizioni: Miglioramento del prompt. | Predefinitotrue |
Campoparams.check_nsfw | Tipoboolean | RequisitoFacoltativo | Valori e limiti Condizioni: Filtro dei contenuti. | Predefinitotrue |
Campoparams.seed | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 1 Massimo: 1.000.000 Condizioni: Seed per risultati coerenti. | Predefinito— |
Campowebhook | Tipoobject | RequisitoFacoltativo | Valori e limiti Condizioni: Impostazioni webhook documentate facoltative; il recupero dei risultati di tua proprietà usa i percorsi delle attività Ailoot. | Predefinito— |
Campowebhook.url | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: L'URL del tuo destinatario. | Predefinito— |
Campowebhook.secret | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Il segreto del tuo endpoint di ricezione. | Predefinito— |
Campocallback | Tipostring | 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 |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, params |
Parametrooptional | Contrattoparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametromaterial_types | Contrattoimage, text |
Parametroadditional_properties | Contrattotrue |
Parametrovalidation_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 →
Esempi di richieste
Ailoot Ultra · Generazione video
{
"model": "dop-lite",
"params": {
"model": "dop-lite",
"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}/contentGET /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 |
|---|---|---|
Campoid | Tipostring | SignificatoIdentificatore pubblico dell'attività o dell'operazione Ailoot. |
Campoprovider_task_id | Tipostring | SignificatoIdentificatore dell'attività originale, distinto dall'id pubblico. |
Campopolling_url | Tipostring | SignificatoPercorso di consultazione Ailoot restituito. |
Campojobs[].id | Tipostring | SignificatoIdentificatore dell'attività effettivamente restituito. |
Campojobs[].status | Tipostring | SignificatoStato di ogni attività restituita. |
Campojobs[].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-lite
Alias dei percorsi dei metodi
/v1/videos/generations
ID di chiamata correlati
FAQ · Higgsfield: DOP Lite
- Quali input e risultati sono disponibili?
POST /v1/videos·dop-lite:image,text→video- Quali campi usa la richiesta?
POST /v1/videos·dop-lite:model,params,webhook,callback- Quali limiti si applicano?
POST /v1/videos·dop-lite:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000