Source: https://ailoot.ai/models/cs/dop-preview/
Canonical: https://ailoot.ai/models/cs/dop-preview/
Language: cs

# Higgsfield: DOP Preview

[Markdown](https://ailoot.ai/models/cs/dop-preview/index.md) · [JSON](https://ailoot.ai/models/cs/dop-preview/facts.json)

## [Higgsfield: DOP Preview](https://ailoot.ai/models/cs/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`](https://ailoot.ai/models/cs/dop-preview/#method-0)

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`](https://ailoot.ai/models/cs/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos)

Higgsfield /`dop-preview`

### Úvod

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.

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í →](https://ailoot.ai/docs/cs/billing/reserve/)

### Příklady požadavků

#### Ailoot Ultra · Tvorba videa

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

```json
{
  "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
  }
}
```

```bash
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`](https://ailoot.ai/models/cs/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos)

#### Aliasy cest metod

`/v1/videos/generations`

#### Související ID modelů

[`dop-preview`](https://ailoot.ai/models/cs/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos)

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`

Připojte Ailoot k Claude Code, OpenCode, Hermes nebo vlastní aplikaci.

## Společnost a její portfolio projektů

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

## Nakupujte tokeny se slevou.

Sleva předplatného pro pravidelnou práci. Promo kódy až 50% na nákup tokenů.

Předplatné

Pro pravidelné požadavky vyberte tarif se slevou.

Promo kód až 50%

Při nákupu zadejte kód. Cena se přepočítá podle probíhající akce.

Výdaje v historii

U každého požadavku se uloží model, tokeny a částka.

[Vybrat předplatné](https://ailoot.ai/docs/cs/billing/subscriptions/) · [Zobrazit ceny modelů](https://ailoot.ai/models/cs/)

## Připojte API k produktu, který prodáváte.

SaaS, aplikace a boti podle nabídky a licenční smlouvy Ailoot. Pro přeprodej požádejte o licenci přeprodejce.

Komerční aplikace

Začleňte generování textu, obrázků, videa a zvuku do placených funkcí své služby.

Licence pro přeprodejce

Pošlete popis projektu a způsob poskytování přístupu. Vyžádejte písemné podmínky použití a přeprodeje.

Dokumenty na webu

Nabídka, licenční smlouva a zásady zpracování dat jsou dostupné před připojením.

[Požádat o licenci přeprodejce](mailto:support@ailoot.ai) · [Nabídka a licenční smlouva](https://ailoot.ai/legal/offer?lang=cs)

## Ailoot · Společnost a její portfolio projektů





Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.





Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.





Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.
