Higgsfield: DOP Preview
DOP Preview gjør innsendte bilder om til video med den dokumenterte arbeidsflyten for bevegelsesmaler. Den nøyaktige dop-preview-velgeren støtter én eller to effekter; styrke, instruksjon og frøverdi beholdes sammen med det fullførte resultatet.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
DOP Preview animerer innsendte bilder gjennom Higgsfields dokumenterte arbeidsflyt for video fra bilde. Den nøyaktige velgeren er dop-preview. Bruk dop-preview både som modellvalg på øverste nivå og som verdien for model i det dokumenterte params-objektet. Bildet gir det visuelle materialet, mens bevegelsesmaler og skriftlige instruksjoner styrer ønsket bevegelse og effekt.
Forbered et referansebilde der det tiltenkte motivet, viktige detaljer og plassen rundt er tydelige. Veiledningen anbefaler et bilde med høy oppløsning for tydeligere detaljer. For en produktscene velger du en vinkel som viser gjenstandens form og flatene som skal være gjenkjennelige under bevegelsen. For en person eller et miljø angir du det visuelle trekket som bevegelsen skal fremheve. Oppgi den faktiske URL-en til referansebildet gjennom bildeinndataene som brukes i metodens eksempel.
Veiledningen for operasjonen beskriver bruk av én eller to bevegelsesmaler. Når to oppgis, beskriver veiledningen effektene som kombinerte. Beskrivelsene av forhåndsinnstillingene omfatter kamerabevegelse, rotasjon av motivet og visuelle forvandlinger; Dolly In beskriver for eksempel at kameraet nærmer seg, mens 3D Rotation beskriver at et motiv eller produkt roterer på stedet. Velg dokumenterte malidentifikatorer som passer til ønsket sekvens, og behold hver identifikator sammen med styrkeverdien.
Bevegelsesstyrken er et tall fra 0 til 1, med 0.8 som dokumentert standardverdi. Veiledningen beskriver 0.3 som en subtil effekt og 1 som kraftig bevegelse. Velg intensiteten ut fra detaljen som må forbli tydelig, og gjennomgå hele den genererte handlingen. En bevegelsesbeskrivelse og styrken har ulike formål: malen velger effekten, mens styrken bestemmer intensiteten.
Feltet prompt må ifølge beskrivelsen være med, men en tom streng er tillatt. For malstyrte effekter anbefaler veiledningen å la instruksjonen være tom; når tekst oppgis, anbefaler den å ta med malens beskrivelse fordi instruksjonen kan endre resultatet kraftig. Innstillingen enhance_prompt aktiverer optimalisering av instruksjonen og har true som dokumentert standardverdi. Behold teksten og denne innstillingen sammen med referansebildet og de valgte malene når du sammenligner versjoner.
Innstillingen seed godtar et heltall fra 1 til 1000000. Registrer den valgte frøverdien sammen med genereringsinnstillingene. Forespørselen har også et heltallsfelt seconds; behold verdien som ble brukt sammen med det ferdige klippet, og undersøk klippets faktiske tidsforløp og bildeutsnitt. Den boolske innstillingen check_nsfw aktiverer det dokumenterte innholdsfilteret og har true som standardverdi. Disse innstillingene tilhører forespørselen om video fra bilde og skal forbli knyttet til akkurat den valgte modellen.
Genereringen er asynkron. Behold den returnerte oppgaveidentiteten mens du følger den konfigurerte status- og resultatspørringen. Tilordningen ved fullføring leser oppføringer for fullførte jobber og de opprinnelige resultat-URL-ene. Lagre hvert fullførte videoresultat og behold jobbidentifikatoren sammen med den returnerte URL-en. Hold alle fullførte oppføringer samlet som operasjonens resultat.
Gjennomgå hele videoen opp mot det innsendte bildet, den valgte effekten og de skriftlige instruksjonene: motivets utseende, bevegelse, bildeutsnitt og avslutningsbildet. Ved en endring angir du den konkrete visuelle detaljen som skal justeres, og beholder de delene av forespørselen som fungerte. Hold den opprinnelige bildereferansen, den nøyaktige velgeren, instruksjonen, bevegelsesidentifikatorene, styrkene, frøverdien, de forespurte innstillingene og de fullførte filene samlet, slik at neste sammenligning bygger på den faktiske genereringen.
Ailoot Ultra · Videogenerering POST /v1/videos dop-preview
dop-previewStart
DOP Preview gjør innsendte bilder om til video med den dokumenterte arbeidsflyten for bevegelsesmaler. Den nøyaktige dop-preview-velgeren støtter én eller to effekter; styrke, instruksjon og frøverdi beholdes sammen med det fullførte resultatet.
- Godkjente inndata
- Bilder · Tekst
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Videogenerering POST /v1/videos
- Inndatatyper
image,text- Utdatatyper
video
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser dop-preview Vilkår: Modellvelger for Ailoot. | Standard— |
Feltparams | Typeobject | KravPåkrevd | Verdier & grenser Vilkår: Parametere for bilde til video; behold denne innpakningsstrukturen. | Standard— |
Feltparams.model | Typestring | KravPåkrevd | Verdier & grenser dop-preview Vilkår: Bruk samme modellvelger som model på øverste nivå. | Standard— |
Feltparams.prompt | Typestring | KravPåkrevd | Verdier & grenser Vilkår: Behold dette feltet; en tom streng er dokumentert. Skriftlig veiledning påvirker den valgte bevegelseseffekten sterkt. | Standard— |
Feltparams.seconds | Typeinteger | KravValgfritt | Verdier & grenser Vilkår: Ønsket varighet; intet dokumentert intervall eller noen standardverdi forutsettes. | Standard— |
Feltparams.motions | Typearray | KravValgfritt | Verdier & grenser Vilkår: Velg én eller to dokumenterte bevegelsesmaler. | Standard— |
Feltparams.motions[].id | Typestring | KravPåkrevd | Verdier & grenser Vilkår: Bevegelsesidentifikator i det dokumenterte fungerende forespørselseksemplet. | Standard— |
Feltparams.motions[].strength | Typenumber | KravPåkrevd | Verdier & grenser Minimum: 0 Maksimum: 1 Vilkår: Bevegelsesintensitet: 0.3 beskrives som diskret og 1 som kraftig. | Standard0,8 |
Feltparams.input_images | Typearray | KravValgfritt | Verdier & grenser Vilkår: Referansebilder, med matrisen av image_url-objekter som vises i det fungerende eksemplet. | Standard— |
Feltparams.input_images[].type | Typestring | KravPåkrevd | Verdier & grenser image_url Vilkår: Representasjon av referanser. | Standard— |
Feltparams.input_images[].image_url | Typestring | KravPåkrevd | Verdier & grenser Vilkår: Den faktiske tilgjengelige URL-en til referansebildet ditt. | Standard— |
Feltparams.enhance_prompt | Typeboolean | KravValgfritt | Verdier & grenser Vilkår: Forbedring av ledetekst. | Standardtrue |
Feltparams.check_nsfw | Typeboolean | KravValgfritt | Verdier & grenser Vilkår: Innholdsfiltrering. | Standardtrue |
Feltparams.seed | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 1 000 000 Vilkår: Startverdi for konsistente utdata. | Standard— |
Feltwebhook | Typeobject | KravValgfritt | Verdier & grenser Vilkår: Valgfrie dokumenterte webhook-innstillinger; henting av resultater du eier, bruker oppgavestiene i Ailoot. | Standard— |
Feltwebhook.url | Typestring | KravValgfritt | Verdier & grenser Vilkår: URL til mottakeren din. | Standard— |
Feltwebhook.secret | Typestring | KravValgfritt | Verdier & grenser Vilkår: Mottakerhemmeligheten din. | Standard— |
Feltcallback | Typestring | KravValgfritt | Verdier & grenser Vilkår: Valgfri callback-mottaker; den dokumenterte mottakeren svarer med HTTP 200. | Standard— |
Kombinasjoner av inngående materialer
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, params |
Parameteroptional | Avtaleparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametermaterial_types | Avtaleimage, text |
Parameteradditional_properties | Avtaletrue |
Parametervalidation_scope | AvtaleModellen ruter forespørselen; parameterinnpakningen følger den demonstrerte forespørselen for bilde til video. |
Metodealiaser: /v1/videos/generations
Livssyklus: 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
Bruk samme modellvelger på øverste nivå og inne i params.
Opprett én gang, og bruk deretter returnert offentlig id og polling_url for den opprinnelige operasjonen.
Hent hver ferdigstilte video du eier; undersøk faktisk varighet og mål i resultatet.
Erstatt YOUR_ACCESSIBLE_IMAGE_URL i eksemplet med den faktiske URL-en til referansebildet ditt.
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Kostnad |
|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $1.24 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Videogenerering
{
"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
Motta og lagre resultater
Ailoot Ultra · Videogenerering
Behold de returnerte jobbene og tilstandene deres. Les hvert ferdigstilte videoresultat du eier.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Behold alle ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Hent alle faktiske ferdigstilte utdata; ikke forutsett et fast antall.
Hvis det opprinnelige svaret må kontrolleres
Behold det opprinnelige svaret og den returnerte oppgaveidentiteten; en ukjent tilstand eller tvetydig sending gir ikke tillatelse til en ny opprettelse.
Svarfelter
| Felt | Type | Betydning |
|---|---|---|
Feltid | Typestring | BetydningOffentlig identifikator for en oppgave eller operasjon i Ailoot. |
Feltprovider_task_id | Typestring | BetydningOpprinnelig oppgaveidentifikator, atskilt fra offentlig id. |
Feltpolling_url | Typestring | BetydningReturnert oppslagssti i Ailoot. |
Feltjobs[].id | Typestring | BetydningFaktisk returnert jobbidentifikator. |
Feltjobs[].status | Typestring | BetydningTilstanden til hver returnert jobb. |
Feltjobs[].results.raw.url | Typestring | BetydningHver ferdigstilte video gjøres tilgjengelig via en signert URL som tilhører Ailoot. |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldig JSON/modell eller ugyldig innholdsindeks. | Neste trinn |
Svar401 · authentication_error | VilkårUgyldig Ailoot API-nøkkel. | Neste trinn |
Svar403 · permission_error | VilkårAPI-nøkkelgruppen har ikke tilgang til denne medieruten. | Neste trinn |
Svar404 · not_found_error | VilkårDen opprinnelige oppgaven eller de forespurte utdataene mangler eller tilhører ikke samme bruker/API-nøkkel/gruppe. | Neste trinn |
Svar502 · result_pending_check | VilkårDen opprinnelige innsendingen eller statusen er ufullstendig eller kan ikke avstemmes; behold den opprinnelige ID-en og ikke send inn på nytt. | Neste trinn |
Svar503 · result_pending_check | VilkårDen opprinnelige bindingen, ruten eller mediene du eier, kontrolleres fortsatt; fortsett å kontrollere den opprinnelige operasjonen. | Neste trinn |
Svar503 · server_error | VilkårMedietjenesten eller lagringen for den opprinnelige oppgaven er utilgjengelig. | Neste trinn |
Aliaser
Modellaliaser
Ailoot Ultra dop-preview
Aliaser for metodestier
/v1/videos/generations
Tilknyttede anroper-ID-er
FAQ · Higgsfield: DOP Preview
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·dop-preview:image,text→video- Hvilke felt bruker forespørselen?
POST /v1/videos·dop-preview:model,params,webhook,callback- Hvilke grenser gjelder?
POST /v1/videos·dop-preview:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000