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.
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 · Videomateriaal POST /v1/videos dop-preview
dop-previewAan de slag
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.
- Toegestane invoer
- Afbeeldingen · Tekst
- Resultaten
- Video
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Videomateriaal POST /v1/videos
- Invoertypen
image,text- Uitvoertypen
video
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten dop-preview Voorwaarden: Ailoot-modelidentificatie. | Standaard— |
Veldparams | Typeobject | VereisteVereist | Waarden en limieten Voorwaarden: Parameters voor afbeelding-naar-video; behoud deze envelop. | Standaard— |
Veldparams.model | Typestring | VereisteVereist | Waarden en limieten dop-preview Voorwaarden: Gebruik dezelfde modelidentificatie als model op het hoogste niveau. | Standaard— |
Veldparams.prompt | Typestring | VereisteVereist | Waarden en limieten Voorwaarden: Behoud dit veld; een lege tekenreeks is gedocumenteerd. Geschreven aanwijzingen hebben grote invloed op het geselecteerde bewegingseffect. | Standaard— |
Veldparams.seconds | Typeinteger | VereisteOptioneel | Waarden en limieten Voorwaarden: Gevraagde duur; er wordt geen gedocumenteerd bereik of standaardwaarde verondersteld. | Standaard— |
Veldparams.motions | Typearray | VereisteOptioneel | Waarden en limieten Voorwaarden: Kies één of twee gedocumenteerde bewegingssjablonen. | Standaard— |
Veldparams.motions[].id | Typestring | VereisteVereist | Waarden en limieten Voorwaarden: Bewegingsidentificatie in het gedocumenteerde werkende verzoekvoorbeeld. | Standaard— |
Veldparams.motions[].strength | Typenumber | VereisteVereist | Waarden en limieten Minimum: 0 Maximum: 1 Voorwaarden: Bewegingsintensiteit: 0.3 wordt beschreven als subtiel en 1 als sterk. | Standaard0,8 |
Veldparams.input_images | Typearray | VereisteOptioneel | Waarden en limieten Voorwaarden: Referentieafbeeldingen, met de array van image_url-objecten uit het werkende voorbeeld. | Standaard— |
Veldparams.input_images[].type | Typestring | VereisteVereist | Waarden en limieten image_url Voorwaarden: Referentieweergave. | Standaard— |
Veldparams.input_images[].image_url | Typestring | VereisteVereist | Waarden en limieten Voorwaarden: Uw eigen toegankelijke referentieafbeeldings-URL. | Standaard— |
Veldparams.enhance_prompt | Typeboolean | VereisteOptioneel | Waarden en limieten Voorwaarden: Promptverbetering. | Standaardtrue |
Veldparams.check_nsfw | Typeboolean | VereisteOptioneel | Waarden en limieten Voorwaarden: Inhoudsfiltering. | Standaardtrue |
Veldparams.seed | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1.000.000 Voorwaarden: Seed voor consistente uitvoer. | Standaard— |
Veldwebhook | Typeobject | VereisteOptioneel | Waarden en limieten Voorwaarden: Optionele gedocumenteerde webhookinstellingen; ophalen van resultaten die u bezit gebruikt de Ailoot-taakpaden. | Standaard— |
Veldwebhook.url | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Uw ontvanger-URL. | Standaard— |
Veldwebhook.secret | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Uw ontvangergeheim. | Standaard— |
Veldcallback | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Optionele callbackontvanger; de gedocumenteerde ontvanger antwoordt met HTTP 200. | Standaard— |
Combinaties van invoermaterialen
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, params |
Parameteroptional | Contractparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametermaterial_types | Contractimage, text |
Parameteradditional_properties | Contracttrue |
Parametervalidation_scope | ContractHet model routeert het verzoek; de parameters-envelop volgt het gedemonstreerde verzoek 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 modelidentificatie op het hoogste niveau en binnen params.
Maak eenmaal aan en gebruik daarna de geretourneerde openbare id en polling_url voor de oorspronkelijke operatie.
Haal elke voltooide video op die u bezit; controleer de werkelijke duur en afmetingen in het resultaat.
Vervang YOUR_ACCESSIBLE_IMAGE_URL in het voorbeeld door uw eigen referentieafbeeldings-URL.
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn 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 is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij 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 schatting is geen extra bedrag 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 · Videomateriaal
{
"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 · Videomateriaal
Bewaar de geretourneerde taken en hun statussen. Lees elk voltooid videoresultaat dat u bezit.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /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 alle daadwerkelijke voltooide uitvoer op; veronderstel geen vast aantal.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar het oorspronkelijke antwoord en de geretourneerde taakidentiteit; een onbekende status of onduidelijke verzending geeft geen toestemming voor een nieuwe aanmaak.
Antwoordvelden
| Veld | Type | Betekenis |
|---|---|---|
Veldid | Typestring | BetekenisOpenbare Ailoot-taak- of operatie-identificatie. |
Veldprovider_task_id | Typestring | BetekenisOorspronkelijke taakidentificatie, afzonderlijk van de openbare id. |
Veldpolling_url | Typestring | BetekenisGeretourneerd Ailoot-opzoekpad. |
Veldjobs[].id | Typestring | BetekenisDaadwerkelijk geretourneerde taakidentificatie. |
Veldjobs[].status | Typestring | BetekenisStatus van elke geretourneerde taak. |
Veldjobs[].results.raw.url | Typestring | BetekenisElke voltooide video is beschikbaar via een ondertekende URL in eigendom van Ailoot. |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeOngeldige JSON/model of een ongeldige inhoudsindex. | Volgende stap |
Antwoord401 · authentication_error | VoorwaardeOngeldige Ailoot API-sleutel. | Volgende stap |
Antwoord403 · permission_error | VoorwaardeDe API-sleutelgroep is niet toegelaten tot deze mediaroute. | Volgende stap |
Antwoord404 · not_found_error | VoorwaardeDe oorspronkelijke taak of gevraagde uitvoer ontbreekt of is niet in eigendom van dezelfde gebruiker/API-sleutel/groep. | Volgende stap |
Antwoord502 · result_pending_check | VoorwaardeDe oorspronkelijke indiening of status is onvolledig of kan niet worden afgestemd; bewaar de oorspronkelijke ID en dien niet opnieuw in. | Volgende stap |
Antwoord503 · result_pending_check | VoorwaardeDe oorspronkelijke koppeling, route of media die u bezit worden nog gecontroleerd; blijf die oorspronkelijke operatie controleren. | Volgende stap |
Antwoord503 · server_error | VoorwaardeDe mediaservice of opslag voor oorspronkelijke taken is niet beschikbaar. | Volgende stap |
Aliasnamen
Modelaliasnamen
Ailoot Ultra dop-preview
Aliasnamen voor methodepaden
/v1/videos/generations
Gerelateerde aanroeper-ID’s
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