models

Higgsfield: DOP Lite

Markdown · JSON

Higgsfield: DOP Lite

A DOP Lite dokumentált mozgássablonokkal, állítható erősséggel és írásos utasításokkal animálja a megadott képet. Ez a pontos dop-lite modellválasztó a kép–videó kérést használja, és aszinkron feladaton keresztül adja vissza a videót.

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

A DOP Lite a Higgsfield dokumentált kép–videó munkafolyamatával animálja a megadott képi anyagot. A pontos modellválasztó azonosító dop-lite. A dop-lite értéket használja a legfelső szintű modellválasztásnál és a dokumentált params objektumon belüli model értékeként is. A kép adja a vizuális alapanyagot, míg a mozgássablonok és az írásos utasítások szabályozzák a kért mozgást és hatást.

Készítsen olyan referenciaképet, amelyen jól kivehető a kívánt téma, a fontos részletek és a környező tér. Az útmutató nagy felbontású képet javasol a részletek jobb láthatóságához. Termékjelenethez válasszon olyan nézetet, amely megmutatja a tárgy alakját és azokat a felületeket, amelyeknek mozgás közben is felismerhetőnek kell maradniuk. Személy vagy környezet esetén jelölje meg azt a vizuális jellemzőt, amelyet a mozgásnak ki kell emelnie. A referenciakép tényleges URL-jét a metódus példájában használt képbemeneten keresztül adja meg.

A művelet dokumentációja egy vagy két mozgássablont ír le. Két sablon megadásakor az útmutató a hatásaikat kombináltként jellemzi. Az előbeállítások leírásai kameramozgást, a téma forgatását és vizuális átalakításokat tartalmaznak; a Dolly In például a kamera közelítését, a 3D Rotation pedig a téma vagy termék helyben forgását írja le. Válassza ki a tervezett mozgássorhoz illő dokumentált sablonazonosítókat, és minden azonosítót őrizzen meg a hozzá tartozó erősségértékkel együtt.

A mozgás erőssége 0 és 1 közötti szám, dokumentált alapértéke 0.8. Az útmutató a 0.3 értéket finom hatásként, az 1 értéket erőteljes mozgásként írja le. Az intenzitást annak megfelelően válassza meg, hogy mely részletnek kell jól kivehetőnek maradnia, és ellenőrizze a teljes létrehozott mozgást. A mozgás leírása és erőssége eltérő célt szolgál: a sablon kiválasztja a hatást, az erősség pedig annak intenzitását szabályozza.

A leírás szerint a prompt mezőnek jelen kell lennie, de üres karakterlánc is megengedett. Sablonvezérelt hatásoknál az útmutató a prompt üresen hagyását javasolja; ha szöveget ad meg, a sablon leírásának feltüntetését ajánlja, mert a prompt jelentősen módosíthatja az eredményt. Az enhance_prompt vezérlő bekapcsolja a prompt optimalizálását, dokumentált alapértéke true. Verziók összehasonlításakor őrizze meg a szöveget és ezt a vezérlőt a referenciaképpel és a kiválasztott sablonokkal együtt.

A seed vezérlő 1 és 1000000 közötti egész számot fogad el, a határértékeket is beleértve. Jegyezze fel a választott seed értéket a generálási beállításokkal együtt. A kérés egy egész szám típusú seconds mezőt is tartalmaz; őrizze meg a felhasznált értéket az elkészült klippel együtt, és ellenőrizze a klip tényleges időzítését és képkivágását. A check_nsfw logikai vezérlő bekapcsolja a dokumentált tartalomszűrőt, alapértéke true. Ezek a vezérlők a kép–videó kéréshez tartoznak, és a pontosan kiválasztott modellhez kapcsolva kell megőrizni őket.

A generálás aszinkron. Őrizze meg a visszakapott feladatazonosítót a beállított állapot- és eredménylekérdezés követése közben. A befejezéshez tartozó leképezés a befejezett munkák bejegyzéseit és azok nyers eredmény-URL-jeit olvassa be. Mentsen el minden elkészült videóeredményt, és őrizze meg a munka azonosítóját a visszakapott URL-lel együtt, az összes befejezett bejegyzést a művelet eredményeként egyben tartva.

Ellenőrizze a teljes videót a megadott képhez, a választott hatáshoz és az írásos utasításokhoz viszonyítva: a téma megjelenését, a mozgást, a képkivágást és a záróképet. Módosításkor jelölje meg a változtatandó konkrét vizuális részletet, és tartsa meg a kérés bevált részeit. Őrizze meg együtt az eredeti képreferenciát, a pontos modellválasztó azonosítót, a prompt értékét, a mozgásazonosítókat, az erősségeket, a seed értékét, a kért beállításokat és az elkészült fájlokat, hogy a következő összehasonlítás a tényleges generálásra épüljön.

Ailoot Ultra · Videó POST /v1/videos dop-lite

dop-lite

Higgsfield /dop-lite

Kezdő lépések

A DOP Lite dokumentált mozgássablonokkal, állítható erősséggel és írásos utasításokkal animálja a megadott képet. Ez a pontos dop-lite modellválasztó a kép–videó kérést használja, és aszinkron feladaton keresztül adja vissza a videót.

Elfogadott bemenetek
Képek · Szöveg
Eredmények
Videó

Elérhető az Ailootban · bemenetek és metódusok

Ailoot Ultra · Videó POST /v1/videos
Bemenet
image, text
Kimenet
video
MezőTípusKövetelményÉrtékek és korlátokAlapértelmezett
MezőmodelTípusstringKövetelményKötelezőÉrtékek és korlátok
dop-lite
Feltételek: Ailoot modellválasztó.
Alapértelmezett—
MezőparamsTípusobjectKövetelményKötelezőÉrtékek és korlátok
Feltételek: Képből videó paraméterek; őrizze meg ezt a kérésburkolót.
Alapértelmezett—
Mezőparams.modelTípusstringKövetelményKötelezőÉrtékek és korlátok
dop-lite
Feltételek: Ugyanazt a választót használja, mint a legfelső szintű model mezőben.
Alapértelmezett—
Mezőparams.promptTípusstringKövetelményKötelezőÉrtékek és korlátok
Feltételek: Ez a mező maradjon jelen; az üres karakterlánc dokumentált. Az írott útmutatás erősen befolyásolja a kiválasztott mozgáshatást.
Alapértelmezett—
Mezőparams.secondsTípusintegerKövetelményOpcionálisÉrtékek és korlátok
Feltételek: Kért időtartam; nem állítunk dokumentált tartományt vagy alapértelmezést.
Alapértelmezett—
Mezőparams.motionsTípusarrayKövetelményOpcionálisÉrtékek és korlátok
Feltételek: Válasszon egy vagy két dokumentált mozgássablont.
Alapértelmezett—
Mezőparams.motions[].idTípusstringKövetelményKötelezőÉrtékek és korlátok
Feltételek: Mozgásazonosító a dokumentált működő kérési példában.
Alapértelmezett—
Mezőparams.motions[].strengthTípusnumberKövetelményKötelezőÉrtékek és korlátok
Minimum: 0
Maximum: 1
Feltételek: Mozgásintenzitás: a leírás szerint 0.3 visszafogott, 1 pedig erős.
Alapértelmezett0,8
Mezőparams.input_imagesTípusarrayKövetelményOpcionálisÉrtékek és korlátok
Feltételek: Referenciaképek a működő példában bemutatott image_url objektumtömbbel megadva.
Alapértelmezett—
Mezőparams.input_images[].typeTípusstringKövetelményKötelezőÉrtékek és korlátok
image_url
Feltételek: A referenciaanyag megadási formája.
Alapértelmezett—
Mezőparams.input_images[].image_urlTípusstringKövetelményKötelezőÉrtékek és korlátok
Feltételek: A tényleges, elérhető referenciakép URL-címe.
Alapértelmezett—
Mezőparams.enhance_promptTípusbooleanKövetelményOpcionálisÉrtékek és korlátok
Feltételek: A szöveges utasítás javítása.
Alapértelmezetttrue
Mezőparams.check_nsfwTípusbooleanKövetelményOpcionálisÉrtékek és korlátok
Feltételek: Tartalomszűrés.
Alapértelmezetttrue
Mezőparams.seedTípusintegerKövetelményOpcionálisÉrtékek és korlátok
Minimum: 1
Maximum: 1 000 000
Feltételek: Kezdőérték a következetes kimenethez.
Alapértelmezett—
MezőwebhookTípusobjectKövetelményOpcionálisÉrtékek és korlátok
Feltételek: Opcionális, dokumentált webhook-beállítások; a saját eredmények lekéréséhez az Ailoot feladatelérési útjai használatosak.
Alapértelmezett—
Mezőwebhook.urlTípusstringKövetelményOpcionálisÉrtékek és korlátok
Feltételek: Az Ön fogadó URL-címe.
Alapértelmezett—
Mezőwebhook.secretTípusstringKövetelményOpcionálisÉrtékek és korlátok
Feltételek: Az Ön fogadójának titkos kulcsa.
Alapértelmezett—
MezőcallbackTípusstringKövetelményOpcionálisÉrtékek és korlátok
Feltételek: Opcionális callback fogadó; a dokumentált fogadó HTTP 200 választ ad.
Alapértelmezett—
Bemeneti anyagok kombinációi

Metódus paraméterei és életciklusa
ParaméterSzerződés
Paramétercontent_typeSzerződésapplication/json
ParaméterrequiredSzerződésmodel, params
ParaméteroptionalSzerződésparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Paramétermaterial_typesSzerződésimage, text
Paraméteradditional_propertiesSzerződéstrue
Paramétervalidation_scopeSzerződésA model választja ki a kérés útvonalát; a paraméterburkoló a bemutatott képből videó kérést követi.

Metódus álnevei: /v1/videos/generations

Életciklus: 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

Ugyanazt a modellválasztót használja a legfelső szinten és a params mezőn belül.

Hozza létre egyszer, majd a visszaadott nyilvános id és polling_url értékekkel kérdezze le az eredeti műveletet.

Kérje le az összes elkészült, Önhöz tartozó videót; az eredményben ellenőrizze a tényleges időtartamot és méreteket.

A példában a YOUR_ACCESSIBLE_IMAGE_URL helyére írja a tényleges referenciakép URL-címét.

Díjcsomagok

A végső díj számítása

A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.

A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.

Gyors mód
Nincs megadva Ha a gyors mód van kiválasztva
Flex mód
Nincs megadva Ha a flex mód van kiválasztva
Maximális gondolkodási ráfordítás
Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik

Becsült díjak összehasonlításhoz

Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

BeállításDíjtáblázatElőre jelzett mennyiségDíj
BeállításTokenek alapdíjaiDíjtáblázatAlapdíjElőre jelzett mennyiség—Díj
Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token
Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token
Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token
Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token
Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token
BeállításA generálás becsült költségeDíjtáblázat—Előre jelzett mennyiségbecslés egy generálásraDíj
Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $1.24 becslés a generálás előtt

Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra.

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →

Példakérések

Ailoot Ultra · Videó

JSON · hozz létre videótcurl · olvasd be az eredeti feladatot
{
  "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

Eredmények fogadása és mentése

Ailoot Ultra · Videó

Őrizze meg a visszaadott feladatokat és állapotukat. Kérdezzen le minden elkészült, Önhöz tartozó videóeredményt.

  • GET /v1/videos/{request_id}
  • GET /v1/videos/generations/{request_id}
  • GET /v1/videos/{request_id}/content
  • GET /v1/videos/generations/{request_id}/content
Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.

Kérje le az összes ténylegesen elkészült kimenetet; ne feltételezzen rögzített darabszámot.

Ha az eredeti választ ellenőrizni kell

Őrizze meg az eredeti választ és a visszaadott feladat azonosítóadatait; egy fel nem ismert állapot vagy bizonytalan kimenetelű küldés nem jogosít fel új létrehozásra.

Válaszmezők
MezőTípusJelentés
MezőidTípusstringJelentésNyilvános Ailoot feladat- vagy műveletazonosító.
Mezőprovider_task_idTípusstringJelentésAz eredeti feladat azonosítója, a nyilvános id értéktől külön.
Mezőpolling_urlTípusstringJelentésA visszaadott Ailoot lekérdezési elérési út.
Mezőjobs[].idTípusstringJelentésA ténylegesen visszaadott feladatazonosító.
Mezőjobs[].statusTípusstringJelentésMinden visszaadott feladat állapota.
Mezőjobs[].results.raw.urlTípusstringJelentésMinden elkészült videó az Ailoot tulajdonában lévő aláírt URL-címen érhető el.
Hibák és következő lépések
VálaszFeltételKövetkező lépés
Válasz400 · invalid_request_errorFeltételÉrvénytelen JSON/modell vagy érvénytelen tartalomindex.Következő lépés
Válasz401 · authentication_errorFeltételÉrvénytelen Ailoot API-kulcs.Következő lépés
Válasz403 · permission_errorFeltételAz API-kulcs csoportja nem használhatja ezt a médiaútvonalat.Következő lépés
Válasz404 · not_found_errorFeltételAz eredeti feladat vagy a kért kimenet hiányzik, illetve nem ugyanahhoz a felhasználóhoz/API-kulcshoz/csoporthoz tartozik.Következő lépés
Válasz502 · result_pending_checkFeltételAz eredeti beküldés vagy állapot hiányos, illetve nem egyeztethető össze a nyilvántartással; őrizze meg az eredeti azonosítót, és ne küldje be újra.Következő lépés
Válasz503 · result_pending_checkFeltételAz eredeti hozzárendelés, útvonal vagy a saját média ellenőrzése még folyamatban van; folytassa az eredeti művelet ellenőrzését.Következő lépés
Válasz503 · server_errorFeltételA médiaszolgáltatás vagy az eredeti feladat tárolója nem érhető el.Következő lépés

Álnevek

Modell álnevei

Ailoot Ultra dop-lite

Metódusútvonalak álnevei

/v1/videos/generations

Kapcsolódó modellazonosítók

dop-lite

FAQ · Higgsfield: DOP Lite
Milyen bemenetek és eredmények érhetők el?

POST /v1/videos · dop-lite: image, text → video

Mely mezőket használja a kérés?

POST /v1/videos · dop-lite: model, params, webhook, callback

Milyen korlátok érvényesek?

POST /v1/videos · dop-lite: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

További részletek

Csatlakoztassa az Ailootot a Claude Code-hoz, OpenCode-hoz, Hermeshez vagy saját alkalmazásához.

A vállalat és projektportfóliója

A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.

Vásároljon tokeneket kedvezménnyel.

Előfizetési kedvezmény rendszeres munkához. Promókódok — akár 50% tokenvásárlási kedvezmény.

Előfizetés
Válasszon kedvezményes tarifát a rendszeres kéréseihez.
Promókód akár 50%-ig
Vásárláskor adja meg a kódot. Az ár az érvényes akció szerint újraszámolódik.
Költségek az előzményekben
Minden kéréshez megmarad a modell, a tokenek és az összeg.

Előfizetés kiválasztása · Modellárak megtekintése

Csatlakoztassa az API-t az értékesített termékéhez.

SaaS, alkalmazások és botok — az Ailoot ajánlati feltételei és licencszerződése alapján. Viszonteladáshoz kérjen viszonteladói licencet.

Kereskedelmi alkalmazás
Építsen szöveg-, kép-, videó- és hanggenerálást szolgáltatása fizetős funkcióiba.
Viszonteladói licenc
Küldje el a projekt leírását és a hozzáférés módját. Kérjen írásos használati és viszonteladási feltételeket.
Dokumentumok a weboldalon
Az ajánlati feltételek, licencszerződés és adatkezelési szabályzat már a csatlakoztatás előtt elérhető.

Viszonteladói licenc kérése · Ajánlati feltételek és licencszerződés