DOP Preview animerer leveret billedmateriale gennem Higgsfields dokumenterede arbejdsgang fra billede til video. Den præcise modelidentifikator er dop-preview. Brug dop-preview som værdi for model på øverste niveau og som model-værdi i det dokumenterede params-objekt. Billedet leverer det visuelle materiale, mens bevægelsesskabeloner og den skriftlige instruktion styrer den ønskede bevægelse og effekt.
Forbered et referencebillede, hvor det ønskede motiv, væsentlige detaljer og den omgivende plads er tydelige. Vejledningen anbefaler et billede i høj opløsning for tydeligere detaljer. Ved en produktscene skal et perspektiv vælges, som viser objektets form og de overflader, der skal forblive genkendelige under bevægelsen. Ved en person eller et miljø skal det visuelle træk, bevægelsen skal fremhæve, angives. Lever den faktiske URL til referencebilledet gennem det billedinput, der bruges i metodeeksemplet.
Operationen dokumenterer én eller to bevægelsesskabeloner. Når to leveres, beskriver vejledningen deres effekter som kombinerede. Beskrivelserne af forudindstillingerne omfatter kamerabevægelse, rotation af motivet og visuelle transformationer; Dolly In beskriver for eksempel en kamerabevægelse ind mod motivet, mens 3D Rotation beskriver et motiv eller produkt, der drejer på stedet. Vælg de dokumenterede skabelonidentifikatorer, der passer til den ønskede sekvens, og bevar hver identifikator sammen med dens strength-værdi.
Indstillingen strength for bevægelsesstyrke er et tal fra 0 til 1 med 0.8 som dokumenteret standard. Vejledningen beskriver 0.3 som en diskret effekt og 1 som kraftig bevægelse. Vælg intensiteten efter den detalje, der skal forblive tydelig, og gennemgå hele den genererede handling. En bevægelsesbeskrivelse og dens strength-værdi har forskellige formål: skabelonen vælger effekten, mens strength styrer intensiteten.
Feltet prompt skal ifølge beskrivelsen være til stede, men en tom streng er tilladt. Ved skabelonstyrede effekter anbefaler vejledningen at lade prompt være tom; når tekst leveres, anbefaler den at medtage skabelonens beskrivelse, fordi prompten kan ændre resultatet markant. Indstillingen enhance_prompt aktiverer promptoptimering og er dokumenteret med true som standard. Bevar teksten og denne indstilling sammen med referencebilledet og de valgte skabeloner, når versioner sammenlignes.
Indstillingen seed accepterer et heltal fra 1 til og med 1.000.000. Registrér den valgte seed sammen med genereringsindstillingerne. Anmodningen indeholder også et heltalsfelt seconds; bevar den anvendte værdi sammen med det resulterende klip, og undersøg klippets faktiske timing og billedudsnit. Den booleske indstilling check_nsfw aktiverer det dokumenterede indholdsfilter og har true som standard. Disse indstillinger tilhører anmodningen fra billede til video og skal forblive knyttet til den præcise model, der er valgt.
Genereringen er asynkron. Bevar den returnerede opgaveidentitet, mens den konfigurerede status- og resultatforespørgsel følges. Resultatkoblingen læser afsluttede jobposter og deres rå resultat-URL’er. Gem hvert afsluttet videoresultat, og bevar dets jobidentifikator sammen med den returnerede URL, så alle afsluttede poster holdes samlet som operationens resultat.
Gennemgå hele videoen ud fra det leverede billede, den valgte effekt og den skriftlige instruktion: motivets udseende, bevægelse, billedudsnit og det afsluttende billede. Ved en revision skal den konkrete visuelle detalje, der skal ændres, angives, og de vellykkede dele af anmodningen bevares. Hold den oprindelige billedreference, præcise modelidentifikator, prompt, bevægelsesidentifikatorer, strength-værdier, seed, ønskede indstillinger og færdige resultater samlet, så næste sammenligning bruger den faktiske generering.
", "aboutText": "DOP Preview animerer leveret billedmateriale gennem Higgsfields dokumenterede arbejdsgang fra billede til video. Den præcise modelidentifikator er dop-preview. Brug dop-preview som værdi for model på øverste niveau og som model-værdi i det dokumenterede params-objekt. Billedet leverer det visuelle materiale, mens bevægelsesskabeloner og den skriftlige instruktion styrer den ønskede bevægelse og effekt.\n\nForbered et referencebillede, hvor det ønskede motiv, væsentlige detaljer og den omgivende plads er tydelige. Vejledningen anbefaler et billede i høj opløsning for tydeligere detaljer. Ved en produktscene skal et perspektiv vælges, som viser objektets form og de overflader, der skal forblive genkendelige under bevægelsen. Ved en person eller et miljø skal det visuelle træk, bevægelsen skal fremhæve, angives. Lever den faktiske URL til referencebilledet gennem det billedinput, der bruges i metodeeksemplet.\n\nOperationen dokumenterer én eller to bevægelsesskabeloner. Når to leveres, beskriver vejledningen deres effekter som kombinerede. Beskrivelserne af forudindstillingerne omfatter kamerabevægelse, rotation af motivet og visuelle transformationer; Dolly In beskriver for eksempel en kamerabevægelse ind mod motivet, mens 3D Rotation beskriver et motiv eller produkt, der drejer på stedet. Vælg de dokumenterede skabelonidentifikatorer, der passer til den ønskede sekvens, og bevar hver identifikator sammen med dens strength-værdi.\n\nIndstillingen strength for bevægelsesstyrke er et tal fra 0 til 1 med 0.8 som dokumenteret standard. Vejledningen beskriver 0.3 som en diskret effekt og 1 som kraftig bevægelse. Vælg intensiteten efter den detalje, der skal forblive tydelig, og gennemgå hele den genererede handling. En bevægelsesbeskrivelse og dens strength-værdi har forskellige formål: skabelonen vælger effekten, mens strength styrer intensiteten.\n\nFeltet prompt skal ifølge beskrivelsen være til stede, men en tom streng er tilladt. Ved skabelonstyrede effekter anbefaler vejledningen at lade prompt være tom; når tekst leveres, anbefaler den at medtage skabelonens beskrivelse, fordi prompten kan ændre resultatet markant. Indstillingen enhance_prompt aktiverer promptoptimering og er dokumenteret med true som standard. Bevar teksten og denne indstilling sammen med referencebilledet og de valgte skabeloner, når versioner sammenlignes.\n\nIndstillingen seed accepterer et heltal fra 1 til og med 1.000.000. Registrér den valgte seed sammen med genereringsindstillingerne. Anmodningen indeholder også et heltalsfelt seconds; bevar den anvendte værdi sammen med det resulterende klip, og undersøg klippets faktiske timing og billedudsnit. Den booleske indstilling check_nsfw aktiverer det dokumenterede indholdsfilter og har true som standard. Disse indstillinger tilhører anmodningen fra billede til video og skal forblive knyttet til den præcise model, der er valgt.\n\nGenereringen er asynkron. Bevar den returnerede opgaveidentitet, mens den konfigurerede status- og resultatforespørgsel følges. Resultatkoblingen læser afsluttede jobposter og deres rå resultat-URL’er. Gem hvert afsluttet videoresultat, og bevar dets jobidentifikator sammen med den returnerede URL, så alle afsluttede poster holdes samlet som operationens resultat.\n\nGennemgå hele videoen ud fra det leverede billede, den valgte effekt og den skriftlige instruktion: motivets udseende, bevægelse, billedudsnit og det afsluttende billede. Ved en revision skal den konkrete visuelle detalje, der skal ændres, angives, og de vellykkede dele af anmodningen bevares. Hold den oprindelige billedreference, præcise modelidentifikator, prompt, bevægelsesidentifikatorer, strength-værdier, seed, ønskede indstillinger og færdige resultater samlet, så næste sammenligning bruger den faktiske generering.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "397a07b871309759e392e7e3b6596559872c640560691e328c1bcdccb9e229b7", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "da", "methods": [ { "html": "dop-previewDOP Preview omsætter leveret billedmateriale til video med den dokumenterede arbejdsgang med bevægelsesskabeloner. Den præcise modelidentifikator dop-preview understøtter én eller to effekter, mens styrke, prompt og seed bevares sammen med det færdige resultat.
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
DOP Preview animerer leveret billedmateriale gennem Higgsfields dokumenterede arbejdsgang fra billede til video. Den præcise modelidentifikator er dop-preview. Brug dop-preview som værdi for model på øverste niveau og som model-værdi i det dokumenterede params-objekt. Billedet leverer det visuelle materiale, mens bevægelsesskabeloner og den skriftlige instruktion styrer den ønskede bevægelse og effekt.
Forbered et referencebillede, hvor det ønskede motiv, væsentlige detaljer og den omgivende plads er tydelige. Vejledningen anbefaler et billede i høj opløsning for tydeligere detaljer. Ved en produktscene skal et perspektiv vælges, som viser objektets form og de overflader, der skal forblive genkendelige under bevægelsen. Ved en person eller et miljø skal det visuelle træk, bevægelsen skal fremhæve, angives. Lever den faktiske URL til referencebilledet gennem det billedinput, der bruges i metodeeksemplet.
Operationen dokumenterer én eller to bevægelsesskabeloner. Når to leveres, beskriver vejledningen deres effekter som kombinerede. Beskrivelserne af forudindstillingerne omfatter kamerabevægelse, rotation af motivet og visuelle transformationer; Dolly In beskriver for eksempel en kamerabevægelse ind mod motivet, mens 3D Rotation beskriver et motiv eller produkt, der drejer på stedet. Vælg de dokumenterede skabelonidentifikatorer, der passer til den ønskede sekvens, og bevar hver identifikator sammen med dens strength-værdi.
Indstillingen strength for bevægelsesstyrke er et tal fra 0 til 1 med 0.8 som dokumenteret standard. Vejledningen beskriver 0.3 som en diskret effekt og 1 som kraftig bevægelse. Vælg intensiteten efter den detalje, der skal forblive tydelig, og gennemgå hele den genererede handling. En bevægelsesbeskrivelse og dens strength-værdi har forskellige formål: skabelonen vælger effekten, mens strength styrer intensiteten.
Feltet prompt skal ifølge beskrivelsen være til stede, men en tom streng er tilladt. Ved skabelonstyrede effekter anbefaler vejledningen at lade prompt være tom; når tekst leveres, anbefaler den at medtage skabelonens beskrivelse, fordi prompten kan ændre resultatet markant. Indstillingen enhance_prompt aktiverer promptoptimering og er dokumenteret med true som standard. Bevar teksten og denne indstilling sammen med referencebilledet og de valgte skabeloner, når versioner sammenlignes.
Indstillingen seed accepterer et heltal fra 1 til og med 1.000.000. Registrér den valgte seed sammen med genereringsindstillingerne. Anmodningen indeholder også et heltalsfelt seconds; bevar den anvendte værdi sammen med det resulterende klip, og undersøg klippets faktiske timing og billedudsnit. Den booleske indstilling check_nsfw aktiverer det dokumenterede indholdsfilter og har true som standard. Disse indstillinger tilhører anmodningen fra billede til video og skal forblive knyttet til den præcise model, der er valgt.
Genereringen er asynkron. Bevar den returnerede opgaveidentitet, mens den konfigurerede status- og resultatforespørgsel følges. Resultatkoblingen læser afsluttede jobposter og deres rå resultat-URL’er. Gem hvert afsluttet videoresultat, og bevar dets jobidentifikator sammen med den returnerede URL, så alle afsluttede poster holdes samlet som operationens resultat.
Gennemgå hele videoen ud fra det leverede billede, den valgte effekt og den skriftlige instruktion: motivets udseende, bevægelse, billedudsnit og det afsluttende billede. Ved en revision skal den konkrete visuelle detalje, der skal ændres, angives, og de vellykkede dele af anmodningen bevares. Hold den oprindelige billedreference, præcise modelidentifikator, prompt, bevægelsesidentifikatorer, strength-værdier, seed, ønskede indstillinger og færdige resultater samlet, så næste sammenligning bruger den faktiske generering.
POST /v1/videosimage, textvideo| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser dop-preview Betingelser: Ailoot-modelvælger. | Standard— |
Feltparams | Typeobject | KravPåkrævet | Værdier og grænser Betingelser: Parametre for billede til video; bevar denne indpakning. | Standard— |
Feltparams.model | Typestring | KravPåkrævet | Værdier og grænser dop-preview Betingelser: Brug samme vælger som for model på øverste niveau. | Standard— |
Feltparams.prompt | Typestring | KravPåkrævet | Værdier og grænser Betingelser: Behold dette felt i forespørgslen; en tom streng er dokumenteret. Skriftlig vejledning påvirker den valgte bevægelseseffekt kraftigt. | Standard— |
Feltparams.seconds | Typeinteger | KravValgfrit | Værdier og grænser Betingelser: Ønsket varighed; der angives intet dokumenteret interval og ingen dokumenteret standardværdi. | Standard— |
Feltparams.motions | Typearray | KravValgfrit | Værdier og grænser Betingelser: Vælg én eller to dokumenterede bevægelsesskabeloner. | Standard— |
Feltparams.motions[].id | Typestring | KravPåkrævet | Værdier og grænser Betingelser: Bevægelsesidentifikator i det dokumenterede fungerende forespørgselseksempel. | Standard— |
Feltparams.motions[].strength | Typenumber | KravPåkrævet | Værdier og grænser Minimum: 0 Maksimum: 1 Betingelser: Bevægelsesintensitet: 0.3 beskrives som diskret og 1 som kraftig. | Standard0,8 |
Feltparams.input_images | Typearray | KravValgfrit | Værdier og grænser Betingelser: Referencebilleder med det array af image_url-objekter, der vises i det fungerende eksempel. | Standard— |
Feltparams.input_images[].type | Typestring | KravPåkrævet | Værdier og grænser image_url Betingelser: Repræsentation af referencemateriale. | Standard— |
Feltparams.input_images[].image_url | Typestring | KravPåkrævet | Værdier og grænser Betingelser: URL til dit faktiske, tilgængelige referencebillede. | Standard— |
Feltparams.enhance_prompt | Typeboolean | KravValgfrit | Værdier og grænser Betingelser: Forbedring af prompten. | Standardtrue |
Feltparams.check_nsfw | Typeboolean | KravValgfrit | Værdier og grænser Betingelser: Indholdsfiltrering. | Standardtrue |
Feltparams.seed | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 1.000.000 Betingelser: Seed-værdi til ensartede resultater. | Standard— |
Feltwebhook | Typeobject | KravValgfrit | Værdier og grænser Betingelser: Valgfrie dokumenterede webhook-indstillinger; hentning af ejede resultater bruger Ailoot-opgavestierne. | Standard— |
Feltwebhook.url | Typestring | KravValgfrit | Værdier og grænser Betingelser: Din modtagers URL. | Standard— |
Feltwebhook.secret | Typestring | KravValgfrit | Værdier og grænser Betingelser: Din modtagers hemmelige nøgle. | Standard— |
Feltcallback | Typestring | KravValgfrit | Værdier og grænser Betingelser: Valgfri modtager af callbacks; den dokumenterede modtager svarer med HTTP 200. | Standard— |
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, params |
Parameteroptional | Kontraktparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametermaterial_types | Kontraktimage, text |
Parameteradditional_properties | Kontrakttrue |
Parametervalidation_scope | KontraktModellen router forespørgslen; parameterindpakningen følger den demonstrerede forespørgsel for billede til video. |
Metodealiaser: /v1/videos/generations
Livscyklus: 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
Brug samme modelvælger på øverste niveau og inde i params.
Opret én gang, og brug derefter det returnerede offentlige id og polling_url til den oprindelige operation.
Hent hver færdig video, du ejer; kontrollér den faktiske varighed og de faktiske dimensioner i resultatet.
Erstat YOUR_ACCESSIBLE_IMAGE_URL i eksemplet med URL til dit faktiske referencebillede.
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Beløb |
|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $1.24 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
{\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}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\nBehold de returnerede job og deres tilstande. Læs hvert færdigt videoresultat, du ejer.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentGem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Hent hvert faktisk færdigt output; antag ikke et fast antal.
Behold det oprindelige svar og den returnerede opgaveidentitet; en ukendt tilstand eller en afsendelse med uklart udfald giver ikke tilladelse til en ny oprettelse.
| Felt | Type | Betydning |
|---|---|---|
Feltid | Typestring | BetydningOffentlig Ailoot-opgave- eller operationsidentifikator. |
Feltprovider_task_id | Typestring | BetydningOprindelig opgaveidentifikator, adskilt fra det offentlige id. |
Feltpolling_url | Typestring | BetydningReturneret Ailoot-opslagssti. |
Feltjobs[].id | Typestring | BetydningFaktisk returneret jobidentifikator. |
Feltjobs[].status | Typestring | BetydningTilstanden for hvert returneret job. |
Feltjobs[].results.raw.url | Typestring | BetydningHver færdig video stilles til rådighed via en signeret URL, der ejes af Ailoot. |
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseUgyldig JSON/model eller et ugyldigt indholdsindeks. | Næste trin |
Svar401 · authentication_error | BetingelseUgyldig Ailoot API-nøgle. | Næste trin |
Svar403 · permission_error | BetingelseAPI-nøglens gruppe har ikke adgang til denne medierute. | Næste trin |
Svar404 · not_found_error | BetingelseDen oprindelige opgave eller det ønskede output mangler eller tilhører ikke samme bruger/API-nøgle/gruppe. | Næste trin |
Svar502 · result_pending_check | BetingelseDen oprindelige indsendelse eller status er ufuldstændig eller kan ikke afstemmes; behold det oprindelige ID, og indsend ikke igen. | Næste trin |
Svar503 · result_pending_check | BetingelseDen oprindelige tilknytning, rute eller de ejede medier kontrolleres stadig; fortsæt kontrollen af denne oprindelige operation. | Næste trin |
Svar503 · server_error | BetingelseMedietjenesten eller lageret for den oprindelige opgave er utilgængeligt. | Næste trin |
Ailoot Ultra dop-preview
/v1/videos/generations