Higgsfield: DOP Preview

DOP Preview mění dodaný obrazový materiál ve video pomocí dokumentovaného postupu s pohybovými šablonami. Přesný identifikátor dop-preview podporuje jeden nebo dva efekty; parametry intenzity, prompt a seed zůstávají uchovány s dokončeným výsledkem.

Ailoot Ultra · Tvorba videa POST /v1/videos dop-preview

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

DOP Preview rozpohybuje dodaný obrazový materiál prostřednictvím dokumentovaného postupu Higgsfield pro tvorbu videa z obrazu. Přesný identifikátor je dop-preview. Použijte dop-preview jako hodnotu pole model na nejvyšší úrovni a jako hodnotu pole model v dokumentovaném objektu params. Obraz poskytuje vizuální podklad, zatímco pohybové šablony a písemné pokyny řídí požadovaný pohyb a efekt.

Připravte referenční obraz, na kterém jsou zamýšlený objekt, důležité detaily a okolní prostor dobře viditelné. Průvodce doporučuje obraz ve vysokém rozlišení pro zřetelnější detaily. U produktové scény zvolte pohled ukazující tvar předmětu a povrchy, které mají zůstat rozpoznatelné během pohybu. U osoby nebo prostředí určete vizuální prvek, který má pohyb zdůraznit. Skutečnou URL referenčního obrazu dodejte prostřednictvím obrazového vstupu použitého v příkladu metody.

Operace dokumentuje jednu nebo dvě pohybové šablony. Při dodání dvou průvodce popisuje spojení jejich efektů. Popisy předvoleb zahrnují pohyb kamery, otáčení objektu a vizuální proměny; například Dolly In popisuje přiblížení kamery, zatímco 3D Rotation otáčení osoby nebo produktu na místě. Vyberte dokumentované identifikátory šablon odpovídající zamýšlené sekvenci a uchovejte každý identifikátor s jeho hodnotou intenzity.

Intenzita pohybu je číslo od 0 do 1; dokumentovaná výchozí hodnota je 0.8. Průvodce popisuje 0.3 jako jemný efekt a 1 jako výrazný pohyb. Zvolte intenzitu podle detailu, který musí zůstat čitelný, a prohlédněte celý vygenerovaný pohyb. Popis pohybu a intenzita mají různé účely: šablona vybírá efekt a intenzita řídí jeho sílu.

Podle svého popisu musí být pole prompt přítomno, ale může obsahovat prázdný řetězec. Pro efekty řízené šablonami průvodce doporučuje ponechat pole prompt prázdné; při dodání textu doporučuje zahrnout popis šablony, protože prompt může výrazně změnit výsledek. Parametr enhance_prompt zapíná optimalizaci obsahu pole prompt a podle dokumentace má výchozí hodnotu true. Při porovnávání verzí uchovejte text a tento parametr s referenčním obrazem a zvolenými šablonami.

Parametr seed přijímá celé číslo od 1 do 1000000. Zvolenou hodnotu seed zaznamenejte s nastavením generování. Požadavek také poskytuje celočíselné pole seconds; použitou hodnotu uchovejte s výsledným klipem a prohlédněte jeho skutečné časování a rámování. Booleovský parametr check_nsfw zapíná dokumentovaný filtr obsahu a jeho výchozí hodnota je true. Tyto parametry patří k požadavku na tvorbu videa z obrazu a mají zůstat spojené s přesně zvoleným modelem.

Generování je asynchronní. Při sledování nakonfigurovaného dotazu na stav a výsledek uchovejte vrácenou identitu úlohy. Mapování dokončení čte dokončené položky úloh a URL jejich výsledků raw. Uložte každý dokončený výsledek videa a uchovejte identifikátor jeho úlohy s vrácenou URL; všechny dokončené položky držte pohromadě jako výsledek operace.

Prohlédněte celé video podle dodaného obrazu, zvoleného efektu a písemných pokynů: vzhled objektu, pohyb, rámování a závěrečný pohled. Při úpravě určete konkrétní vizuální detail ke změně a zachovejte úspěšné části požadavku. Původní odkaz na obraz, přesný identifikátor, prompt, identifikátory pohybu, intenzity, seed, požadovaná nastavení a dokončené soubory uchovejte společně, aby další porovnání vycházelo ze skutečného výsledku generování.

Ailoot Ultra · Tvorba videa POST /v1/videos dop-preview

dop-preview

Higgsfield /dop-preview

Úvod

Přijímané vstupy: Obrázky · Text
Výsledky: Video

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Tvorba videa POST /v1/videos

Vstup: image, text
Výstup: video

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity dop-preview Podmínky: Výběr modelu Ailoot.	Výchozí—
Pole`params`	Typ`object`	PožadavekPovinné	Hodnoty a limity Podmínky: Parametry převodu obrázku na video; zachovejte tuto obalovou strukturu.	Výchozí—
Pole`params.model`	Typ`string`	PožadavekPovinné	Hodnoty a limity dop-preview Podmínky: Použijte stejný identifikátor jako v poli model na nejvyšší úrovni.	Výchozí—
Pole`params.prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Podmínky: Toto pole ponechte přítomné; prázdný řetězec je dokumentován. Textové pokyny výrazně ovlivňují vybraný pohybový efekt.	Výchozí—
Pole`params.seconds`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Podmínky: Požadovaná délka; žádný dokumentovaný rozsah ani výchozí hodnota se neuvádějí.	Výchozí—
Pole`params.motions`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Podmínky: Vyberte jednu nebo dvě dokumentované šablony pohybu.	Výchozí—
Pole`params.motions[].id`	Typ`string`	PožadavekPovinné	Hodnoty a limity Podmínky: Identifikátor pohybu v dokumentovaném funkčním příkladu požadavku.	Výchozí—
Pole`params.motions[].strength`	Typ`number`	PožadavekPovinné	Hodnoty a limity Minimum: 0 Maximum: 1 Podmínky: Intenzita pohybu: 0.3 je popsána jako jemná a 1 jako silná.	Výchozí0,8
Pole`params.input_images`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Podmínky: Referenční obrázky s použitím pole objektů image_url uvedeného ve funkčním příkladu.	Výchozí—
Pole`params.input_images[].type`	Typ`string`	PožadavekPovinné	Hodnoty a limity image_url Podmínky: Způsob zadání reference.	Výchozí—
Pole`params.input_images[].image_url`	Typ`string`	PožadavekPovinné	Hodnoty a limity Podmínky: Skutečná dostupná URL vašeho referenčního obrázku.	Výchozí—
Pole`params.enhance_prompt`	Typ`boolean`	PožadavekVolitelné	Hodnoty a limity Podmínky: Vylepšení textového zadání.	Výchozítrue
Pole`params.check_nsfw`	Typ`boolean`	PožadavekVolitelné	Hodnoty a limity Podmínky: Filtrování obsahu.	Výchozítrue
Pole`params.seed`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 1 000 000 Podmínky: Počáteční hodnota generátoru náhodných čísel pro konzistentní výstup.	Výchozí—
Pole`webhook`	Typ`object`	PožadavekVolitelné	Hodnoty a limity Podmínky: Volitelná dokumentovaná nastavení webhooku; načítání výsledků spravovaných službou používá cesty úloh Ailoot.	Výchozí—
Pole`webhook.url`	Typ`string`	PožadavekVolitelné	Hodnoty a limity Podmínky: URL vašeho příjemce.	Výchozí—
Pole`webhook.secret`	Typ`string`	PožadavekVolitelné	Hodnoty a limity Podmínky: Tajný klíč vašeho příjemce.	Výchozí—
Pole`callback`	Typ`string`	PožadavekVolitelné	Hodnoty a limity Podmínky: Volitelný příjemce callbacku; dokumentovaný příjemce odpovídá HTTP 200.	Výchozí—

Kombinace vstupních materiálů

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, params
Parametr`optional`	Kontraktparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Parametr`material_types`	Kontraktimage, text
Parametr`additional_properties`	Kontrakttrue
Parametr`validation_scope`	KontraktModel určuje směrování požadavku; obalová struktura parameters odpovídá předvedenému požadavku na převod obrázku na video.

Aliasy metody: /v1/videos/generations

Životní cyklus: 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

Použijte stejný identifikátor modelu na nejvyšší úrovni i uvnitř params.

Vytvořte pouze jednou a poté pro původní operaci používejte vrácené veřejné id a polling_url.

Načtěte každé dokončené video spravované službou; ve výsledku zkontrolujte skutečnou délku a rozměry.

Nahraďte YOUR_ACCESSIBLE_IMAGE_URL v příkladu skutečnou URL svého referenčního obrázku.

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $1.24 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

Ailoot Ultra · Tvorba videa

JSON · vytvořte videocurl · načtěte původní úlohu

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

Přijímání a ukládání výsledků

Ailoot Ultra · Tvorba videa

Uchovejte vrácené úlohy a jejich stavy. Načtěte každý dokončený výsledek videa spravovaný službou.

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

Uchovejte všechny dokončené výsledky

Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.

Načtěte každý skutečný dokončený výstup; nepředpokládejte pevný počet.

Pokud je nutné ověřit původní odpověď

Uchovejte původní odpověď a vrácený identifikátor úlohy; nerozpoznaný stav ani nejednoznačné odeslání neopravňují k novému vytvoření.

Pole odpovědi

Pole	Typ	Význam
Pole`id`	Typstring	VýznamVeřejný identifikátor úlohy nebo operace Ailoot.
Pole`provider_task_id`	Typstring	VýznamPůvodní identifikátor úlohy, odlišný od veřejného id.
Pole`polling_url`	Typstring	VýznamVrácená cesta pro vyhledání v Ailoot.
Pole`jobs[].id`	Typstring	VýznamSkutečný vrácený identifikátor úlohy.
Pole`jobs[].status`	Typstring	VýznamStav každé vrácené úlohy.
Pole`jobs[].results.raw.url`	Typstring	VýznamKaždé dokončené video je dostupné prostřednictvím podepsané URL spravované službou Ailoot.

Chyby a další kroky

Odpověď	Podmínka	Další krok
Odpověď400 · `invalid_request_error`	PodmínkaNeplatný JSON/model nebo neplatný index obsahu.	Další krok
Odpověď401 · `authentication_error`	PodmínkaNeplatný klíč API Ailoot.	Další krok
Odpověď403 · `permission_error`	PodmínkaSkupina klíče API nemá přístup k této trase pro média.	Další krok
Odpověď404 · `not_found_error`	PodmínkaPůvodní úloha nebo požadovaný výstup chybí nebo nepatří stejnému uživateli, klíči API či skupině.	Další krok
Odpověď502 · `result_pending_check`	PodmínkaPůvodní odeslání nebo stav jsou neúplné nebo je nelze sesouhlasit; zachovejte původní ID a požadavek znovu neodesílejte.	Další krok
Odpověď503 · `result_pending_check`	PodmínkaPůvodní vazba, trasa nebo média spravovaná službou se stále kontrolují; pokračujte v kontrole původní operace.	Další krok
Odpověď503 · `server_error`	PodmínkaSlužba médií nebo úložiště původních úloh nejsou dostupné.	Další krok

Aliasy

Aliasy modelu

Ailoot Ultra dop-preview

Aliasy cest metod

/v1/videos/generations

Související ID modelů

dop-preview

FAQ · Higgsfield: DOP Preview

Jaké vstupy a výsledky jsou dostupné?: POST /v1/videos · dop-preview: image, text → video
Jaká pole požadavek používá?: POST /v1/videos · dop-preview: model, params, webhook, callback
Jaké limity platí?: 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