Higgsfield: DOP Preview

DOP Preview mení dodané obrázky na video pomocou dokumentovaného postupu so šablónami pohybu. Presný identifikátor dop-preview podporuje jeden alebo dva efekty; intenzita, prompt a počiatočná hodnota sa uchovávajú spolu s dokončeným výsledkom.

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

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

DOP Preview animuje dodané obrázky prostredníctvom dokumentovaného postupu Higgsfield na tvorbu videa z obrázka. Presný identifikátor výberu je dop-preview. Použite dop-preview ako výber modelu na najvyššej úrovni aj ako hodnotu model v dokumentovanom objekte params. Obrázok poskytuje vizuálny materiál, zatiaľ čo šablóny pohybu a písomné usmernenie riadia požadovaný pohyb a efekt.

Pripravte referenčný obrázok, na ktorom sú dobre rozpoznateľné zamýšľaný objekt, dôležité detaily a okolitý priestor. Sprievodca odporúča obrázok s vysokým rozlíšením pre jasnejšie detaily. Pri produktovej scéne vyberte pohľad, ktorý ukazuje tvar predmetu a povrchy, ktoré majú zostať počas pohybu rozpoznateľné. Pri osobe alebo prostredí určte vizuálny prvok, ktorý má pohyb zdôrazniť. Skutočnú adresu URL referenčného obrázka dodajte cez obrázkový vstup použitý v príklade metódy.

Operácia dokumentuje jednu alebo dve šablóny pohybu. Pri použití dvoch sprievodca opisuje ich účinky ako kombinované. Opisy predvolieb zahŕňajú pohyb kamery, otáčanie objektu a vizuálne premeny; napríklad Dolly In opisuje priblíženie kamery, zatiaľ čo 3D Rotation opisuje otáčanie objektu alebo produktu na mieste. Vyberte dokumentované identifikátory šablón, ktoré zodpovedajú zamýšľanej sekvencii, a uchovajte každý identifikátor spolu s jeho hodnotou intenzity.

Intenzita pohybu je číslo od 0 do 1, pričom dokumentovaná predvolená hodnota je 0.8. Sprievodca opisuje 0.3 ako jemný efekt a 1 ako výrazný pohyb. Intenzitu zvoľte podľa detailu, ktorý má zostať dobre čitateľný, a skontrolujte celý vygenerovaný pohyb. Opis pohybu a jeho intenzita plnia odlišné úlohy: šablóna vyberá efekt a intenzita riadi jeho silu.

Pole prompt musí byť podľa jeho opisu prítomné, ale povoľuje sa prázdny reťazec. Pri efektoch riadených šablónou sprievodca odporúča ponechať prompt prázdny; keď sa dodá text, odporúča zahrnúť opis šablóny, pretože prompt môže výrazne zmeniť výsledok. Ovládací prvok enhance_prompt zapína optimalizáciu promptu a jeho dokumentovaná predvolená hodnota je true. Pri porovnávaní verzií uchovajte text aj tento ovládací prvok spolu s referenčným obrázkom a vybranými šablónami.

Ovládací prvok seed prijíma celé číslo od 1 do 1000000. Zvolenú počiatočnú hodnotu zaznamenajte spolu s nastaveniami generovania. Požiadavka sprístupňuje aj celočíselné pole seconds; použitú hodnotu uchovajte s výsledným klipom a skontrolujte jeho skutočné časovanie a kompozíciu záberu. Booleovský prvok check_nsfw zapína dokumentovaný filter obsahu a jeho predvolená hodnota je true. Tieto ovládacie prvky patria k požiadavke na tvorbu videa z obrázka a majú zostať spojené s presne vybraným modelom.

Generovanie je asynchrónne. Uchovajte vrátený identifikátor úlohy pri sledovaní nakonfigurovaného dopytu na stav a výsledok. Mapovanie dokončenia načítava dokončené položky úloh a ich pôvodné adresy URL výsledkov. Uložte každý dokončený výsledok videa a uchovajte identifikátor jeho úlohy spolu s vrátenou adresou URL; všetky dokončené položky zachovajte spolu ako výsledok operácie.

Skontrolujte celé video podľa dodaného obrázka, vybraného efektu a písomného usmernenia: vzhľad objektu, pohyb, kompozíciu záberu a záverečný pohľad. Pri úprave určte konkrétny vizuálny detail, ktorý sa má zmeniť, a zachovajte úspešné časti požiadavky. Pôvodný odkaz na obrázok, presný identifikátor výberu, prompt, identifikátory pohybov, intenzity, počiatočnú hodnotu, požadované nastavenia a dokončené výstupy uchovajte spolu, aby ďalšie porovnanie vychádzalo zo skutočného generovania.

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

dop-preview

Higgsfield /dop-preview

Úvod

Povolené vstupy: Obrázky · Text
Výsledky: Video

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Generovanie videa POST /v1/videos

Vstup: image, text
Výstup: video

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity dop-preview Podmienky: Volič modelu Ailoot.	Predvolené—
Pole`params`	Typ`object`	PožiadavkaPovinné	Hodnoty a limity Podmienky: Parametre videa z obrázka; zachovajte túto obálku.	Predvolené—
Pole`params.model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity dop-preview Podmienky: Použite rovnaký volič ako model na najvyššej úrovni.	Predvolené—
Pole`params.prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Podmienky: Toto pole ponechajte prítomné; prázdny reťazec je zdokumentovaný. Textové usmernenie výrazne ovplyvňuje vybraný pohybový efekt.	Predvolené—
Pole`params.seconds`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Požadovaná dĺžka; neuvádza sa žiadny zdokumentovaný rozsah ani predvolená hodnota.	Predvolené—
Pole`params.motions`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Vyberte jednu alebo dve zdokumentované šablóny pohybu.	Predvolené—
Pole`params.motions[].id`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Podmienky: Identifikátor pohybu v zdokumentovanom fungujúcom príklade požiadavky.	Predvolené—
Pole`params.motions[].strength`	Typ`number`	PožiadavkaPovinné	Hodnoty a limity Minimum: 0 Maximum: 1 Podmienky: Intenzita pohybu: 0.3 je opísaná ako jemná a 1 ako silná.	Predvolené0,8
Pole`params.input_images`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Referenčné obrázky s použitím poľa objektov image_url zobrazeného vo fungujúcom príklade.	Predvolené—
Pole`params.input_images[].type`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity image_url Podmienky: Reprezentácia referencie.	Predvolené—
Pole`params.input_images[].image_url`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Podmienky: Skutočná dostupná URL vášho referenčného obrázka.	Predvolené—
Pole`params.enhance_prompt`	Typ`boolean`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Vylepšenie zadania.	Predvolenétrue
Pole`params.check_nsfw`	Typ`boolean`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Filtrovanie obsahu.	Predvolenétrue
Pole`params.seed`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 1 000 000 Podmienky: Počiatočná hodnota na konzistentný výstup.	Predvolené—
Pole`webhook`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Voliteľné zdokumentované nastavenia pre webhook; načítanie výsledkov vo vašom vlastníctve používa cesty úloh Ailoot.	Predvolené—
Pole`webhook.url`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: URL vášho príjemcu.	Predvolené—
Pole`webhook.secret`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Tajný kľúč vášho príjemcu.	Predvolené—
Pole`callback`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Voliteľný prijímač pre callback; zdokumentovaný prijímač odpovedá HTTP 200.	Predvolené—

Kombinácie vstupných podkladov

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, params
Parameter`optional`	Špecifikáciaparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Parameter`material_types`	Špecifikáciaimage, text
Parameter`additional_properties`	Špecifikáciatrue
Parameter`validation_scope`	ŠpecifikáciaModel určuje trasu požiadavky; obálka parameters zodpovedá predvedenej požiadavke na video z obrázka.

Aliasy metódy: /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žite rovnaký volič modelu na najvyššej úrovni aj v params.

Vytvorte iba raz a potom pri pôvodnej operácii používajte vrátené verejné id a polling_url.

Získajte každé dokončené video vo vašom vlastníctve; vo výsledku overte skutočnú dĺžku a rozmery.

Nahraďte YOUR_ACCESSIBLE_IMAGE_URL v príklade skutočnou URL svojho referenčného obrázka.

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $1.24 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Generovanie videa

JSON · vytvoriť videocurl · prečítať 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

Prijať a uložiť výsledky

Ailoot Ultra · Generovanie videa

Zachovajte vrátené úlohy a ich stavy. Načítajte každý dokončený výsledok videa vo vašom vlastníctve.

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

Uchovať všetky dokončené výsledky

Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.

Načítajte každý skutočný dokončený výstup; nepredpokladajte pevný počet.

Ak treba overiť pôvodnú odpoveď

Zachovajte pôvodnú odpoveď a vrátenú identitu úlohy; nerozpoznaný stav ani nejednoznačné odoslanie neoprávňujú na nové vytvorenie.

Polia odpovede

Pole	Typ	Význam
Pole`id`	Typstring	VýznamVerejný identifikátor úlohy alebo operácie Ailoot.
Pole`provider_task_id`	Typstring	VýznamPôvodný identifikátor úlohy, oddelený od verejného id.
Pole`polling_url`	Typstring	VýznamVrátená cesta Ailoot na vyhľadanie.
Pole`jobs[].id`	Typstring	VýznamSkutočne vrátený identifikátor úlohy.
Pole`jobs[].status`	Typstring	VýznamStav každej vrátenej úlohy.
Pole`jobs[].results.raw.url`	Typstring	VýznamKaždé dokončené video je sprístupnené cez podpísanú URL vo vlastníctve Ailoot.

Chyby a ďalšie kroky

Odpoveď	Podmienka	Ďalší krok
Odpoveď400 · `invalid_request_error`	PodmienkaNeplatný JSON/model alebo neplatný index obsahu.	Ďalší krok
Odpoveď401 · `authentication_error`	PodmienkaNeplatný kľúč API služby Ailoot.	Ďalší krok
Odpoveď403 · `permission_error`	PodmienkaSkupina kľúča API nemá povolený prístup k tejto mediálnej trase.	Ďalší krok
Odpoveď404 · `not_found_error`	PodmienkaPôvodná úloha alebo požadovaný výstup chýbajú alebo nepatria rovnakému používateľovi, kľúču API či skupine.	Ďalší krok
Odpoveď502 · `result_pending_check`	PodmienkaPôvodné odoslanie alebo stav sú neúplné alebo ich nemožno zosúladiť; zachovajte pôvodné ID a požiadavku znova neodosielajte.	Ďalší krok
Odpoveď503 · `result_pending_check`	PodmienkaPôvodné priradenie, trasa alebo médium vo vašom vlastníctve sa stále kontrolujú; pokračujte v kontrole pôvodnej operácie.	Ďalší krok
Odpoveď503 · `server_error`	PodmienkaMediálna služba alebo úložisko pôvodnej úlohy nie sú dostupné.	Ďalší krok

Aliasy

Aliasy modelov

Ailoot Ultra dop-preview

Aliasy ciest metód

/v1/videos/generations

Súvisiace ID na volanie

dop-preview

FAQ · Higgsfield: DOP Preview

Aké vstupy a výsledky sú dostupné?: POST /v1/videos · dop-preview: image, text → video
Aké polia používa požiadavka?: POST /v1/videos · dop-preview: model, params, webhook, callback
Aké limity platia?: 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