Higgsfield: DOP Preview
DOP Preview omvandlar tillhandahållet bildmaterial till video med det dokumenterade arbetsflödet för rörelsemallar. Det exakta modellvalet dop-preview stöder en eller två effekter, med inställningarna för styrka, prompt och seed bevarade tillsammans med det färdiga resultatet.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
DOP Preview animerar tillhandahållet bildmaterial genom det dokumenterade arbetsflödet från Higgsfield för bild till video. Det exakta modellvalet är dop-preview. Använd dop-preview som modellval på översta nivån och som värdet för model inuti det dokumenterade params-objektet. Bilden tillför det visuella materialet, medan rörelsemallar och den skriftliga anvisningen styr den begärda rörelsen och effekten.
Förbered en referensbild där det avsedda motivet, viktiga detaljer och omgivande utrymme går att urskilja. Guiden rekommenderar en högupplöst bild för tydligare detaljer. För en produktscen ska du välja en vy som visar objektets form och de ytor som ska förbli igenkännbara under rörelsen. För en person eller miljö ska du identifiera den visuella egenskap som rörelsen ska framhäva. Ange den faktiska referensbildens URL genom den bildindata som används i metodexemplet.
Operationen dokumenterar en eller två rörelsemallar. När två lämnas beskriver guiden deras effekter som kombinerade. Förinställningarnas beskrivningar omfattar kamerarörelse, motivrotation och visuella omvandlingar; till exempel beskriver Dolly In att kameran närmar sig, medan 3D Rotation beskriver ett motiv eller en produkt som roterar på plats. Välj de dokumenterade mallidentifierare som matchar den avsedda sekvensen och håll varje identifierare tillsammans med dess styrkevärde.
Rörelsestyrka är ett tal från 0 till 1, med 0.8 som dokumenterat standardvärde. Guiden beskriver 0.3 som en subtil effekt och 1 som kraftig rörelse. Välj intensiteten utifrån den detalj som behöver förbli tydlig och granska hela den genererade handlingen. En rörelsebeskrivning och dess styrka har olika syften: mallen väljer effekten, medan styrkan styr dess intensitet.
Fältet prompt måste finnas enligt dess beskrivning, men en tom sträng är tillåten. För mallstyrda effekter rekommenderar guiden att prompt lämnas tom; när text lämnas rekommenderar den att mallens beskrivning tas med eftersom prompt kan förändra resultatet kraftigt. Inställningen enhance_prompt aktiverar promptoptimering och dokumenteras med true som standard. Håll texten och denna inställning tillsammans med referensbilden och de valda mallarna när versioner jämförs.
Inställningen seed tar emot ett heltal från 1 till 1000000. Spara det valda seed-värdet tillsammans med genereringsinställningarna. Begäran har också heltalsfältet seconds; behåll det använda värdet tillsammans med det resulterande klippet och granska klippets faktiska tidsförlopp och bildutsnitt. Den booleska inställningen check_nsfw aktiverar det dokumenterade innehållsfiltret och har true som standard. Dessa inställningar hör till begäran för bild till video och ska förbli kopplade till den exakt valda modellen.
Genereringen är asynkron. Bevara den returnerade uppgiftsidentiteten medan du följer den konfigurerade status- och resultatfrågan. Kopplingen för slutförande läser slutförda jobbposter och deras råa resultat-URL:er. Spara varje slutfört videoresultat och bevara dess jobbidentifierare tillsammans med den returnerade URL:en, och håll alla slutförda poster tillsammans som operationens resultat.
Granska hela videon mot den tillhandahållna bilden, den valda effekten och den skriftliga anvisningen: motivets utseende, rörelse, bildutsnitt och avslutande vy. Vid en ändring ska du identifiera den konkreta visuella detalj som ska ändras och behålla de lyckade delarna av begäran. Håll den ursprungliga bildreferensen, det exakta modellvalet, prompt, rörelseidentifierare, styrkor, seed, begärda inställningar och färdiga mediefiler tillsammans så att nästa jämförelse använder den faktiska genereringen.
Ailoot Ultra · Videor POST /v1/videos dop-preview
dop-previewStart
DOP Preview omvandlar tillhandahållet bildmaterial till video med det dokumenterade arbetsflödet för rörelsemallar. Det exakta modellvalet dop-preview stöder en eller två effekter, med inställningarna för styrka, prompt och seed bevarade tillsammans med det färdiga resultatet.
- Godkända indata
- Bilder · Text
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Videor POST /v1/videos
- Indatatyper
image,text- Utdatatyper
video
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser dop-preview Villkor: Modellväljare för Ailoot. | Standard— |
Fältparams | Typobject | KravObligatoriskt | Värden & gränser Villkor: Parametrar för bild till video; bevara detta parameterhölje. | Standard— |
Fältparams.model | Typstring | KravObligatoriskt | Värden & gränser dop-preview Villkor: Använd samma väljare som för model på toppnivån. | Standard— |
Fältparams.prompt | Typstring | KravObligatoriskt | Värden & gränser Villkor: Behåll detta fält; en tom sträng är dokumenterad. Skriftliga instruktioner påverkar den valda rörelseeffekten starkt. | Standard— |
Fältparams.seconds | Typinteger | KravValfritt | Värden & gränser Villkor: Begärd längd; inget dokumenterat intervall eller standardvärde fastställs. | Standard— |
Fältparams.motions | Typarray | KravValfritt | Värden & gränser Villkor: Välj en eller två dokumenterade rörelsemallar. | Standard— |
Fältparams.motions[].id | Typstring | KravObligatoriskt | Värden & gränser Villkor: Rörelseidentifierare i det dokumenterade fungerande begäransexemplet. | Standard— |
Fältparams.motions[].strength | Typnumber | KravObligatoriskt | Värden & gränser Minimum: 0 Maximum: 1 Villkor: Rörelseintensitet: 0.3 beskrivs som subtil och 1 som stark. | Standard0,8 |
Fältparams.input_images | Typarray | KravValfritt | Värden & gränser Villkor: Referensbilder, med arrayen av image_url-objekt som visas i det fungerande exemplet. | Standard— |
Fältparams.input_images[].type | Typstring | KravObligatoriskt | Värden & gränser image_url Villkor: Referensrepresentation. | Standard— |
Fältparams.input_images[].image_url | Typstring | KravObligatoriskt | Värden & gränser Villkor: Din faktiska, åtkomliga URL till referensbilden. | Standard— |
Fältparams.enhance_prompt | Typboolean | KravValfritt | Värden & gränser Villkor: Promptförbättring. | Standardtrue |
Fältparams.check_nsfw | Typboolean | KravValfritt | Värden & gränser Villkor: Innehållsfiltrering. | Standardtrue |
Fältparams.seed | Typinteger | KravValfritt | Värden & gränser Minimum: 1 Maximum: 1 000 000 Villkor: Slumpfrö för konsekventa resultat. | Standard— |
Fältwebhook | Typobject | KravValfritt | Värden & gränser Villkor: Valfria dokumenterade webhook-inställningar; hämtning av resultat som du äger använder uppgiftssökvägarna i Ailoot. | Standard— |
Fältwebhook.url | Typstring | KravValfritt | Värden & gränser Villkor: Din mottagares URL. | Standard— |
Fältwebhook.secret | Typstring | KravValfritt | Värden & gränser Villkor: Det hemliga värdet för din mottagare. | Standard— |
Fältcallback | Typstring | KravValfritt | Värden & gränser Villkor: Valfri callback-mottagare; den dokumenterade mottagaren svarar med HTTP 200. | Standard— |
Kombinationer av indatamaterial
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, params |
Parameteroptional | Avtalparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametermaterial_types | Avtalimage, text |
Parameteradditional_properties | Avtaltrue |
Parametervalidation_scope | AvtalModellen styr begärans routning; parameterhöljet följer den demonstrerade begäran för bild till video. |
Metodalias: /v1/videos/generations
Livscykel: 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
Använd samma modellväljare på toppnivån och inuti params.
Skapa en gång och använd sedan returnerat offentligt id och polling_url för den ursprungliga operationen.
Hämta varje färdig video som du äger; granska den faktiska längden och dimensionerna i resultatet.
Ersätt YOUR_ACCESSIBLE_IMAGE_URL i exemplet med din faktiska URL till referensbilden.
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $1.24 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Videor
{
"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
Ta emot och spara resultat
Ailoot Ultra · Videor
Behåll de returnerade jobben och deras tillstånd. Läs varje färdigt videoresultat som du äger.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Hämta varje faktiskt färdigt resultat; förutsätt inte ett fast antal.
Om det ursprungliga svaret behöver kontrolleras
Behåll det ursprungliga svaret och den returnerade uppgiftsidentiteten; ett okänt tillstånd eller en tvetydig sändning ger inte tillstånd att skapa på nytt.
Svarsfält
| Fält | Typ | Betydelse |
|---|---|---|
Fältid | Typstring | BetydelseOffentlig identifierare för uppgiften eller operationen i Ailoot. |
Fältprovider_task_id | Typstring | BetydelseUrsprunglig uppgiftsidentifierare, skild från offentligt id. |
Fältpolling_url | Typstring | BetydelseReturnerad sökväg för uppslagning i Ailoot. |
Fältjobs[].id | Typstring | BetydelseFaktisk returnerad jobbidentifierare. |
Fältjobs[].status | Typstring | BetydelseTillstånd för varje returnerat jobb. |
Fältjobs[].results.raw.url | Typstring | BetydelseVarje färdig video görs tillgänglig via en signerad URL som ägs av Ailoot. |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltig JSON/modell eller ogiltigt innehållsindex. | Nästa steg |
Svar401 · authentication_error | VillkorOgiltig API-nyckel för Ailoot. | Nästa steg |
Svar403 · permission_error | VillkorAPI-nyckelns grupp har inte tillträde till denna medierutt. | Nästa steg |
Svar404 · not_found_error | VillkorDen ursprungliga uppgiften eller begärda utdatan saknas eller ägs inte av samma användare, API-nyckel och grupp. | Nästa steg |
Svar502 · result_pending_check | VillkorDen ursprungliga inskickningen eller statusen är ofullständig eller kan inte stämmas av; bevara det ursprungliga ID:t och skicka inte in igen. | Nästa steg |
Svar503 · result_pending_check | VillkorDen ursprungliga kopplingen, rutten eller mediefilen som du äger kontrolleras fortfarande; fortsätt att kontrollera den ursprungliga operationen. | Nästa steg |
Svar503 · server_error | VillkorMedietjänsten eller lagringen för den ursprungliga uppgiften är inte tillgänglig. | Nästa steg |
Alias
Modellalias
Ailoot Ultra dop-preview
Alias för metodsökvägar
/v1/videos/generations
Relaterade anropar-ID:n
FAQ · Higgsfield: DOP Preview
- Vilka indata och resultat finns?
POST /v1/videos·dop-preview:image,text→video- Vilka fält använder begäran?
POST /v1/videos·dop-preview:model,params,webhook,callback- Vilka gränser gäller?
POST /v1/videos·dop-preview:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000