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-liteKezdő 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ípus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok dop-lite Feltételek: Ailoot modellválasztó. | Alapértelmezett— |
Mezőparams | Típusobject | Kö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.model | Típusstring | Kö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.prompt | Típusstring | Kö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.seconds | Típusinteger | Kö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.motions | Típusarray | Kö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[].id | Típusstring | Kö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[].strength | Típusnumber | Kö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_images | Típusarray | Kö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[].type | Típusstring | Kö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_url | Típusstring | Kö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_prompt | Típusboolean | KövetelményOpcionális | Értékek és korlátok Feltételek: A szöveges utasítás javítása. | Alapértelmezetttrue |
Mezőparams.check_nsfw | Típusboolean | KövetelményOpcionális | Értékek és korlátok Feltételek: Tartalomszűrés. | Alapértelmezetttrue |
Mezőparams.seed | Típusinteger | Kö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őwebhook | Típusobject | Kö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.url | Típusstring | KövetelményOpcionális | Értékek és korlátok Feltételek: Az Ön fogadó URL-címe. | Alapértelmezett— |
Mezőwebhook.secret | Típusstring | KövetelményOpcionális | Értékek és korlátok Feltételek: Az Ön fogadójának titkos kulcsa. | Alapértelmezett— |
Mezőcallback | Típusstring | Kö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éter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, params |
Paraméteroptional | Szerződésparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Paramétermaterial_types | Szerződésimage, text |
Paraméteradditional_properties | Szerződéstrue |
Paramétervalidation_scope | Szerző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ás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Elő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ége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Dí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ó
{
"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}/contentGET /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ípus | Jelentés |
|---|---|---|
Mezőid | Típusstring | JelentésNyilvános Ailoot feladat- vagy műveletazonosító. |
Mezőprovider_task_id | Típusstring | JelentésAz eredeti feladat azonosítója, a nyilvános id értéktől külön. |
Mezőpolling_url | Típusstring | JelentésA visszaadott Ailoot lekérdezési elérési út. |
Mezőjobs[].id | Típusstring | JelentésA ténylegesen visszaadott feladatazonosító. |
Mezőjobs[].status | Típusstring | JelentésMinden visszaadott feladat állapota. |
Mezőjobs[].results.raw.url | Típusstring | Jelenté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álasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen JSON/modell vagy érvénytelen tartalomindex. | Következő lépés |
Válasz401 · authentication_error | FeltételÉrvénytelen Ailoot API-kulcs. | Következő lépés |
Válasz403 · permission_error | FeltételAz API-kulcs csoportja nem használhatja ezt a médiaútvonalat. | Következő lépés |
Válasz404 · not_found_error | Felté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_check | Felté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_check | Felté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_error | Felté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
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