Higgsfield: DOP Preview

DOP Preview zet aangeleverde beelden om in video via de gedocumenteerde werkwijze met bewegingssjablonen. De exacte selector dop-preview ondersteunt één of twee effecten; sterkte, prompt en seed blijven bij het voltooide resultaat bewaard.

Ailoot Ultra · Videogeneratie POST /v1/videos dop-preview

Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

DOP Preview animeert aangeleverde beelden via Higgsfields gedocumenteerde werkwijze van afbeelding naar video. De exacte selector is dop-preview. Gebruik dop-preview als waarde van model op het hoogste niveau en als model-waarde binnen het gedocumenteerde params-object. De afbeelding levert het visuele materiaal, terwijl bewegingssjablonen en de geschreven aanwijzingen de gevraagde beweging en het effect sturen.

Bereid een referentieafbeelding voor waarin het beoogde onderwerp, belangrijke details en de omringende ruimte goed zichtbaar zijn. De handleiding beveelt een afbeelding met hoge resolutie aan voor duidelijkere details. Kies voor een productscène een aanzicht dat de vorm van het object en de oppervlakken toont die tijdens de beweging herkenbaar moeten blijven. Benoem voor een persoon of omgeving het visuele kenmerk dat de beweging moet benadrukken. Lever de werkelijke URL van de referentieafbeelding via de afbeeldingsinvoer uit het methodevoorbeeld aan.

De bewerking documenteert één of twee bewegingssjablonen. Wanneer twee worden aangeleverd, beschrijft de handleiding hun effecten als gecombineerd. De beschrijvingen van de voorinstellingen omvatten camerabeweging, rotatie van het onderwerp en visuele transformaties; Dolly In beschrijft bijvoorbeeld een camerabeweging naar het onderwerp toe, terwijl 3D Rotation een onderwerp of product beschrijft dat ter plaatse draait. Kies de gedocumenteerde sjabloonidentificatoren die bij de beoogde reeks passen en bewaar elke identificator met de bijbehorende strength-waarde.

De instelling strength voor de bewegingssterkte is een getal van 0 tot 1, met 0.8 als gedocumenteerde standaard. De handleiding beschrijft 0.3 als een subtiel effect en 1 als sterke beweging. Kies de intensiteit op basis van het detail dat leesbaar moet blijven en controleer de volledige gegenereerde handeling. Een bewegingsbeschrijving en de bijbehorende strength-waarde hebben verschillende doelen: het sjabloon kiest het effect, terwijl strength de intensiteit regelt.

Het veld prompt moet volgens zijn beschrijving aanwezig zijn, maar een lege tekenreeks is toegestaan. Voor effecten die door sjablonen worden gestuurd beveelt de handleiding aan prompt leeg te laten; wanneer tekst wordt aangeleverd, beveelt zij aan de beschrijving van het sjabloon op te nemen, omdat de prompt het resultaat sterk kan veranderen. De instelling enhance_prompt schakelt promptoptimalisatie in en staat volgens de documentatie standaard op true. Bewaar de tekst en deze instelling bij de referentieafbeelding en gekozen sjablonen wanneer u versies vergelijkt.

De instelling seed accepteert een geheel getal van 1 tot en met 1.000.000. Bewaar de gekozen seed bij de generatie-instellingen. De aanvraag bevat ook een veld seconds met een gehele waarde; bewaar de gebruikte waarde bij de resulterende clip en inspecteer de werkelijke timing en kadrering van de clip. De booleaanse instelling check_nsfw schakelt het gedocumenteerde inhoudsfilter in en staat standaard op true. Deze instellingen behoren bij de aanvraag van afbeelding naar video en moeten met het exact gekozen model verbonden blijven.

Generatie verloopt asynchroon. Bewaar de teruggegeven taakidentiteit tijdens het volgen van de ingestelde status- en resultaatopvraag. De resultaatkoppeling leest voltooide taakvermeldingen en hun ruwe resultaat-URL’s. Sla elk voltooid videoresultaat op en bewaar de taakidentificator bij de teruggegeven URL, zodat alle voltooide vermeldingen samen het resultaat van de bewerking vormen.

Controleer de volledige video aan de hand van de aangeleverde afbeelding, het gekozen effect en de geschreven aanwijzingen: het uiterlijk van het onderwerp, de beweging, de kadrering en het eindbeeld. Benoem voor een herziening het concrete visuele detail dat moet veranderen en behoud de geslaagde delen van de aanvraag. Bewaar de oorspronkelijke afbeeldingsreferentie, exacte selector, prompt, bewegingsidentificatoren, strength-waarden, seed, gevraagde instellingen en voltooide resultaten bij elkaar, zodat de volgende vergelijking de werkelijke generatie gebruikt.

Ailoot Ultra · Videogeneratie POST /v1/videos dop-preview

dop-preview

Higgsfield /dop-preview

Aan de slag

Toegestane invoer: Afbeeldingen · Tekst
Resultaten: Video

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Videogeneratie POST /v1/videos

Invoer: image, text
Uitvoer: video

Veld	Type	Vereiste	Waarden en limieten	Standaard
Veld`model`	Type`string`	VereisteVereist	Waarden en limieten dop-preview Voorwaarden: Modelselectie van Ailoot.	Standaard—
Veld`params`	Type`object`	VereisteVereist	Waarden en limieten Voorwaarden: Parameters voor afbeelding-naar-video; behoud deze omhullende structuur.	Standaard—
Veld`params.model`	Type`string`	VereisteVereist	Waarden en limieten dop-preview Voorwaarden: Gebruik dezelfde selectie als voor model op het hoogste niveau.	Standaard—
Veld`params.prompt`	Type`string`	VereisteVereist	Waarden en limieten Voorwaarden: Laat dit veld aanwezig; een lege tekenreeks is gedocumenteerd. Geschreven instructies hebben een sterke invloed op het geselecteerde bewegingseffect.	Standaard—
Veld`params.seconds`	Type`integer`	VereisteOptioneel	Waarden en limieten Voorwaarden: Gevraagde duur; er wordt geen gedocumenteerd bereik of standaardwaarde aangenomen.	Standaard—
Veld`params.motions`	Type`array`	VereisteOptioneel	Waarden en limieten Voorwaarden: Kies één of twee gedocumenteerde bewegingssjablonen.	Standaard—
Veld`params.motions[].id`	Type`string`	VereisteVereist	Waarden en limieten Voorwaarden: Bewegingscode uit het gedocumenteerde werkende aanvraagvoorbeeld.	Standaard—
Veld`params.motions[].strength`	Type`number`	VereisteVereist	Waarden en limieten Minimum: 0 Maximum: 1 Voorwaarden: Bewegingsintensiteit: 0.3 wordt beschreven als subtiel en 1 als sterk.	Standaard0,8
Veld`params.input_images`	Type`array`	VereisteOptioneel	Waarden en limieten Voorwaarden: Referentieafbeeldingen, met de array van image_url-objecten uit het werkende voorbeeld.	Standaard—
Veld`params.input_images[].type`	Type`string`	VereisteVereist	Waarden en limieten image_url Voorwaarden: Weergave van het referentiemateriaal.	Standaard—
Veld`params.input_images[].image_url`	Type`string`	VereisteVereist	Waarden en limieten Voorwaarden: De werkelijke, toegankelijke URL van je referentieafbeelding.	Standaard—
Veld`params.enhance_prompt`	Type`boolean`	VereisteOptioneel	Waarden en limieten Voorwaarden: Promptverbetering.	Standaardtrue
Veld`params.check_nsfw`	Type`boolean`	VereisteOptioneel	Waarden en limieten Voorwaarden: Inhoudsfiltering.	Standaardtrue
Veld`params.seed`	Type`integer`	VereisteOptioneel	Waarden en limieten Minimum: 1 Maximum: 1.000.000 Voorwaarden: Startwaarde voor consistente uitvoer.	Standaard—
Veld`webhook`	Type`object`	VereisteOptioneel	Waarden en limieten Voorwaarden: Optionele gedocumenteerde webhook-instellingen; het ophalen van resultaten die je toebehoren gebeurt via de taakpaden van Ailoot.	Standaard—
Veld`webhook.url`	Type`string`	VereisteOptioneel	Waarden en limieten Voorwaarden: URL van je ontvanger.	Standaard—
Veld`webhook.secret`	Type`string`	VereisteOptioneel	Waarden en limieten Voorwaarden: Je geheime waarde voor de ontvanger.	Standaard—
Veld`callback`	Type`string`	VereisteOptioneel	Waarden en limieten Voorwaarden: Optionele ontvanger voor een callback; de gedocumenteerde ontvanger antwoordt met HTTP 200.	Standaard—

Combinaties van invoermaterialen

Methodeparameters en levenscyclus

Parameter	Contract
Parameter`content_type`	Contractapplication/json
Parameter`required`	Contractmodel, params
Parameter`optional`	Contractparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Parameter`material_types`	Contractimage, text
Parameter`additional_properties`	Contracttrue
Parameter`validation_scope`	ContractHet model bepaalt de routering van de aanvraag; de omhullende parameterstructuur volgt de getoonde aanvraag voor afbeelding-naar-video.

Methodealiasnamen: /v1/videos/generations

Levenscyclus: 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

Gebruik dezelfde modelselectie op het hoogste niveau en binnen params.

Maak eenmaal aan en gebruik vervolgens de teruggestuurde openbare id en polling_url voor de oorspronkelijke operatie.

Haal elke voltooide video op die je toebehoort; controleer de werkelijke duur en afmetingen in het resultaat.

Vervang YOUR_ACCESSIBLE_IMAGE_URL in het voorbeeld door de werkelijke URL van je referentieafbeelding.

Tarieven

Zo worden de uiteindelijke kosten berekend

De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.

Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.

Snelle modus: Niet opgegeven Wanneer de snelle modus geselecteerd is
Flex-modus: Niet opgegeven Wanneer de flex-modus geselecteerd is
Maximale redeneerinspanning: Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt

Geschatte tarieven ter vergelijking

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

Configuratie	Tariefstaffel	Verwachte hoeveelheid	Kosten
ConfiguratieBasistarieven voor tokens	TariefstaffelBasistarief	Verwachte hoeveelheid—	Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens
ConfiguratieGeschatte generatiekosten	Tariefstaffel—	Verwachte hoeveelheidschatting voor één generatie	Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $1.24 schatting vóór generatie Deze raming is geen extra kost of vast tarief voor de voltooide generatie.

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →

Voorbeeldverzoeken

Ailoot Ultra · Videogeneratie

JSON · video makencurl · lees de oorspronkelijke taak

{
  "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

Resultaten ophalen en opslaan

Ailoot Ultra · Videogeneratie

Bewaar de teruggestuurde opdrachten en hun status. Lees elk voltooid videoresultaat dat je toebehoort.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Alle voltooide resultaten bewaren

Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.

Haal elk werkelijk voltooid uitvoerbestand op; ga niet uit van een vast aantal.

Als het oorspronkelijke antwoord moet worden gecontroleerd

Bewaar het oorspronkelijke antwoord en de teruggestuurde taakidentiteit; een onbekende status of een verzending met onduidelijke uitkomst geeft geen toestemming om opnieuw een taak aan te maken.

Antwoordvelden

Veld	Type	Betekenis
Veld`id`	Typestring	BetekenisOpenbare taak- of operatiecode van Ailoot.
Veld`provider_task_id`	Typestring	BetekenisOorspronkelijke taakcode, afzonderlijk van de openbare id.
Veld`polling_url`	Typestring	BetekenisTeruggestuurd opzoekpad van Ailoot.
Veld`jobs[].id`	Typestring	BetekenisWerkelijk teruggestuurde opdrachtcode.
Veld`jobs[].status`	Typestring	BetekenisStatus van elke teruggestuurde opdracht.
Veld`jobs[].results.raw.url`	Typestring	BetekenisElke voltooide video wordt beschikbaar gesteld via een ondertekende URL van Ailoot.

Fouten en vervolgstappen

Antwoord	Voorwaarde	Volgende stap
Antwoord400 · `invalid_request_error`	VoorwaardeOngeldige JSON of ongeldig model, of een ongeldige inhoudsindex.	Volgende stap
Antwoord401 · `authentication_error`	VoorwaardeOngeldige Ailoot API-sleutel.	Volgende stap
Antwoord403 · `permission_error`	VoorwaardeDe groep van de API-sleutel heeft geen toegang tot deze mediaroute.	Volgende stap
Antwoord404 · `not_found_error`	VoorwaardeDe oorspronkelijke taak of gevraagde uitvoer ontbreekt of behoort niet toe aan dezelfde gebruiker/API-sleutel/groep.	Volgende stap
Antwoord502 · `result_pending_check`	VoorwaardeDe oorspronkelijke indiening of status is onvolledig of kan niet met de gegevens worden afgestemd; bewaar de oorspronkelijke ID en dien de aanvraag niet opnieuw in.	Volgende stap
Antwoord503 · `result_pending_check`	VoorwaardeDe oorspronkelijke koppeling, route of media die je toebehoren worden nog gecontroleerd; blijf die oorspronkelijke operatie controleren.	Volgende stap
Antwoord503 · `server_error`	VoorwaardeDe mediadienst of de opslag van de oorspronkelijke taak is niet beschikbaar.	Volgende stap

Aliasnamen

Modelaliasnamen

Ailoot Ultra dop-preview

Aliasnamen voor methodepaden

/v1/videos/generations

Gerelateerde aanroeper-ID’s

dop-preview

FAQ · Higgsfield: DOP Preview

Welke invoer en resultaten zijn beschikbaar?: POST /v1/videos · dop-preview: image, text → video
Welke velden gebruikt het verzoek?: POST /v1/videos · dop-preview: model, params, webhook, callback
Welke limieten gelden?: POST /v1/videos · dop-preview: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Preview