Higgsfield: DOP Lite
DOP Lite animeert een aangeleverde afbeelding met gedocumenteerde bewegingssjablonen, instelbare sterkte en geschreven aanwijzingen. Deze exacte selector dop-lite gebruikt de aanvraag van afbeelding naar video en geeft de video via een asynchrone taak terug.
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 Lite animeert aangeleverde beelden via Higgsfields gedocumenteerde werkwijze van afbeelding naar video. De exacte selector is dop-lite. Gebruik dop-lite 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-lite
dop-liteAan de slag
DOP Lite animeert een aangeleverde afbeelding met gedocumenteerde bewegingssjablonen, instelbare sterkte en geschreven aanwijzingen. Deze exacte selector dop-lite gebruikt de aanvraag van afbeelding naar video en geeft de video via een asynchrone taak terug.
- 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 |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten dop-lite Voorwaarden: Modelselectie van Ailoot. | Standaard— |
Veldparams | Typeobject | VereisteVereist | Waarden en limieten Voorwaarden: Parameters voor afbeelding-naar-video; behoud deze omhullende structuur. | Standaard— |
Veldparams.model | Typestring | VereisteVereist | Waarden en limieten dop-lite Voorwaarden: Gebruik dezelfde selectie als voor model op het hoogste niveau. | Standaard— |
Veldparams.prompt | Typestring | 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— |
Veldparams.seconds | Typeinteger | VereisteOptioneel | Waarden en limieten Voorwaarden: Gevraagde duur; er wordt geen gedocumenteerd bereik of standaardwaarde aangenomen. | 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: Bewegingscode uit het gedocumenteerde werkende aanvraagvoorbeeld. | 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: Weergave van het referentiemateriaal. | Standaard— |
Veldparams.input_images[].image_url | Typestring | VereisteVereist | Waarden en limieten Voorwaarden: De werkelijke, toegankelijke URL van je referentieafbeelding. | 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: Startwaarde voor consistente uitvoer. | Standaard— |
Veldwebhook | Typeobject | VereisteOptioneel | Waarden en limieten Voorwaarden: Optionele gedocumenteerde webhook-instellingen; het ophalen van resultaten die je toebehoren gebeurt via de taakpaden van Ailoot. | Standaard— |
Veldwebhook.url | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: URL van je ontvanger. | Standaard— |
Veldwebhook.secret | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Je geheime waarde voor de ontvanger. | Standaard— |
Veldcallback | Typestring | 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 |
|---|---|
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 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
{
"model": "dop-lite",
"params": {
"model": "dop-lite",
"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}/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 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 |
|---|---|---|
Veldid | Typestring | BetekenisOpenbare taak- of operatiecode van Ailoot. |
Veldprovider_task_id | Typestring | BetekenisOorspronkelijke taakcode, afzonderlijk van de openbare id. |
Veldpolling_url | Typestring | BetekenisTeruggestuurd opzoekpad van Ailoot. |
Veldjobs[].id | Typestring | BetekenisWerkelijk teruggestuurde opdrachtcode. |
Veldjobs[].status | Typestring | BetekenisStatus van elke teruggestuurde opdracht. |
Veldjobs[].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-lite
Aliasnamen voor methodepaden
/v1/videos/generations
Gerelateerde aanroeper-ID’s
FAQ · Higgsfield: DOP Lite
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/videos·dop-lite:image,text→video- Welke velden gebruikt het verzoek?
POST /v1/videos·dop-lite:model,params,webhook,callback- Welke limieten gelden?
POST /v1/videos·dop-lite:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000