Source: https://ailoot.ai/models/fi/dop-preview/ Canonical: https://ailoot.ai/models/fi/dop-preview/ Language: fi # Higgsfield: DOP Preview [Markdown](https://ailoot.ai/models/fi/dop-preview/index.md) · [JSON](https://ailoot.ai/models/fi/dop-preview/facts.json) ## [Higgsfield: DOP Preview](https://ailoot.ai/models/fi/dop-preview/) DOP Preview muuttaa annetut kuvat videoksi dokumentoidulla liikepohjien työnkululla. Tarkka dop-preview-valintatunniste tukee yhtä tai kahta tehostetta; voimakkuus, kehote ja siemenluku säilytetään yhdessä valmistuneen tuloksen kanssa. - [**Ailoot Ultra · Videot** `POST /v1/videos` `dop-preview`](https://ailoot.ai/models/fi/dop-preview/#method-0) Tietoa mallista Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle. DOP Preview animoi annettuja kuvia Higgsfieldin dokumentoidulla kuvasta videoksi -työnkululla. Tarkka valintatunniste on dop-preview. Käytä dop-preview-tunnistetta ylimmän tason mallivalintana sekä dokumentoidun params-objektin model-arvona. Kuva antaa visuaalisen aineiston, ja liikepohjat sekä kirjalliset ohjeet ohjaavat pyydettyä liikettä ja tehostetta. Valmistele viitekuva, jossa tarkoitettu kohde, tärkeät yksityiskohdat ja ympäröivä tila erottuvat selvästi. Opas suosittelee suuritarkkuuksista kuvaa, jotta yksityiskohdat näkyvät paremmin. Valitse tuotekuvaukseen näkymä, josta esineen muoto ja liikkeen aikana tunnistettavina säilyvät pinnat näkyvät. Määritä henkilöä tai ympäristöä varten visuaalinen piirre, jota liikkeen tulee korostaa. Anna todellisen viitekuvan URL-osoite menetelmän esimerkissä käytetyn kuvasyötteen kautta. Operaation ohjeissa kuvataan yhden tai kahden liikepohjan käyttö. Kun pohjia annetaan kaksi, opas kuvaa niiden tehosteet yhdistettäviksi. Esiasetusten kuvaukset sisältävät kameran liikkeitä, kohteen pyörimistä ja visuaalisia muunnoksia; esimerkiksi Dolly In kuvaa kameran lähestymistä ja 3D Rotation kohteen tai tuotteen pyörimistä paikallaan. Valitse dokumentoidut pohjatunnisteet, jotka vastaavat haluttua tapahtumakulkua, ja säilytä jokainen tunniste yhdessä sen voimakkuusarvon kanssa. Liikkeen voimakkuus on luku väliltä 0–1, ja dokumentoitu oletusarvo on 0.8. Opas kuvaa arvon 0.3 hienovaraiseksi tehosteeksi ja arvon 1 voimakkaaksi liikkeeksi. Valitse voimakkuus sen mukaan, minkä yksityiskohdan tulee pysyä selvästi havaittavana, ja tarkista koko tuotettu toiminta. Liikkeen kuvaus ja voimakkuus palvelevat eri tarkoituksia: pohja valitsee tehosteen ja voimakkuus ohjaa sen intensiteettiä. prompt-kentän on kuvauksensa mukaan oltava mukana, mutta tyhjä merkkijono sallitaan. Pohjien ohjaamissa tehosteissa opas suosittelee jättämään kehotteen tyhjäksi; kun tekstiä annetaan, se suosittelee sisällyttämään pohjan kuvauksen, sillä kehote voi muuttaa tulosta huomattavasti. enhance\_prompt-asetus ottaa kehotteen optimoinnin käyttöön, ja sen dokumentoitu oletusarvo on true. Säilytä teksti ja tämä asetus yhdessä viitekuvan ja valittujen pohjien kanssa versioita vertaillessasi. seed-asetus hyväksyy kokonaisluvun väliltä 1–1000000. Tallenna valittu siemenluku yhdessä generointiasetusten kanssa. Pyyntö sisältää myös kokonaislukutyyppisen seconds-kentän; säilytä käytetty arvo yhdessä tulosvideon kanssa ja tarkasta videon todellinen ajoitus ja rajaus. Totuusarvotyyppinen check\_nsfw-asetus ottaa dokumentoidun sisältösuodattimen käyttöön, ja sen oletusarvo on true. Nämä asetukset kuuluvat kuvasta videoksi -pyyntöön, ja niiden tulee pysyä yhdistettyinä täsmälleen valittuun malliin. Generointi on asynkronista. Säilytä palautettu tehtävän tunniste seuratessasi määritettyä tila- ja tuloskyselyä. Valmistumisen käsittely lukee valmistuneiden töiden merkinnät ja niiden alkuperäiset tulosten URL-osoitteet. Tallenna jokainen valmistunut videotulos ja säilytä sen työn tunniste yhdessä palautetun URL-osoitteen kanssa. Pidä kaikki valmistuneet merkinnät yhdessä operaation tuloksena. Tarkista koko video suhteessa annettuun kuvaan, valittuun tehosteeseen ja kirjallisiin ohjeisiin: kohteen ulkonäkö, liike, rajaus ja loppunäkymä. Määritä korjausta varten konkreettinen visuaalinen yksityiskohta, jota pitää muuttaa, ja säilytä pyynnön onnistuneet osat. Pidä alkuperäinen kuvaviite, tarkka valintatunniste, kehote, liikkeiden tunnisteet, voimakkuudet, siemenluku, pyydetyt asetukset ja valmistuneet tuotokset yhdessä, jotta seuraava vertailu perustuu todelliseen generointiin. **Ailoot Ultra · Videot** `POST /v1/videos` `dop-preview` [`dop-preview`](https://ailoot.ai/models/fi/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos) Higgsfield /`dop-preview` ### Aloitus DOP Preview muuttaa annetut kuvat videoksi dokumentoidulla liikepohjien työnkululla. Tarkka dop-preview-valintatunniste tukee yhtä tai kahta tehostetta; voimakkuus, kehote ja siemenluku säilytetään yhdessä valmistuneen tuloksen kanssa. Hyväksytyt syötteet Kuvat · Teksti Tulokset Video ### Saatavilla Ailootissa · syötteet & menetelmät **Ailoot Ultra · Videot** `POST /v1/videos` Syötetyypit `image`, `text` Tulostyypit `video` | Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus | | --- | --- | --- | --- | --- | | Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat dop-preview Ehdot: Ailoot-mallin valitsin. | Oletus— | | Kenttä`params` | Tyyppi`object` | VaatimusPakollinen | Arvot & rajat Ehdot: Kuvasta videoksi -parametrit; säilytä tämä pyyntörakenne. | Oletus— | | Kenttä`params.model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat dop-preview Ehdot: Käytä samaa valitsinta kuin ylimmän tason model-kentässä. | Oletus— | | Kenttä`params.prompt` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Ehdot: Säilytä tämä kenttä mukana; tyhjä merkkijono on dokumentoitu. Kirjoitettu ohjaus vaikuttaa voimakkaasti valittuun liiketehosteeseen. | Oletus— | | Kenttä`params.seconds` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Ehdot: Pyydetty kesto; dokumentoitua vaihteluväliä tai oletusarvoa ei vahvisteta. | Oletus— | | Kenttä`params.motions` | Tyyppi`array` | VaatimusValinnainen | Arvot & rajat Ehdot: Valitse yksi tai kaksi dokumentoitua liikemallia. | Oletus— | | Kenttä`params.motions[].id` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Ehdot: Liikkeen tunniste dokumentoidussa toimivassa pyyntöesimerkissä. | Oletus— | | Kenttä`params.motions[].strength` | Tyyppi`number` | VaatimusPakollinen | Arvot & rajat Vähimmäismäärä: 0 Enimmäismäärä: 1 Ehdot: Liikkeen voimakkuus: 0.3 kuvataan hienovaraiseksi ja 1 voimakkaaksi. | Oletus0,8 | | Kenttä`params.input_images` | Tyyppi`array` | VaatimusValinnainen | Arvot & rajat Ehdot: Viitekuvat toimivassa esimerkissä näytetyn image\_url-oliotaulukon avulla. | Oletus— | | Kenttä`params.input_images[].type` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat image\_url Ehdot: Viitteen esitysmuoto. | Oletus— | | Kenttä`params.input_images[].image_url` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Ehdot: Todellinen saavutettavissa olevan viitekuvasi URL-osoite. | Oletus— | | Kenttä`params.enhance_prompt` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat Ehdot: Kehotteen parantaminen. | Oletustrue | | Kenttä`params.check_nsfw` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat Ehdot: Sisällön suodatus. | Oletustrue | | Kenttä`params.seed` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 1 000 000 Ehdot: Satunnaissiemen yhtenäisiä tuloksia varten. | Oletus— | | Kenttä`webhook` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat Ehdot: Valinnaiset dokumentoidut webhook-asetukset; käyttäjälle kuuluvien tulosten nouto käyttää Ailoot-tehtäväpolkuja. | Oletus— | | Kenttä`webhook.url` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Ehdot: Vastaanottajasi URL-osoite. | Oletus— | | Kenttä`webhook.secret` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Ehdot: Vastaanottajasi salaisuus. | Oletus— | | Kenttä`callback` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Ehdot: Valinnainen callback-vastaanottaja; dokumentoitu vastaanottaja vastaa koodilla HTTP 200. | Oletus— | Syöteaineistojen yhdistelmät Menetelmän parametrit ja elinkaari | Parametri | Sopimus | | --- | --- | | Parametri`content_type` | Sopimusapplication/json | | Parametri`required` | Sopimusmodel, params | | Parametri`optional` | Sopimusparams.seconds, params.motions, params.input\_images, params.enhance\_prompt, params.check\_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback | | Parametri`material_types` | Sopimusimage, text | | Parametri`additional_properties` | Sopimustrue | | Parametri`validation_scope` | SopimusMalli reitittää pyynnön; parametrien kääre noudattaa esitettyä kuvasta videoksi -pyyntöä. | Menetelmien aliakset: `/v1/videos/generations` Elinkaari: `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` Käytä samaa mallin valitsinta ylimmällä tasolla ja params-rakenteen sisällä. Luo kerran ja käytä sitten palautettua julkista id-tunnistetta ja polling\_url-osoitetta alkuperäisen operaation seuraamiseen. Nouda jokainen valmistunut käyttäjälle kuuluva video; tarkista tuloksesta todellinen kesto ja mitat. Korvaa esimerkin YOUR\_ACCESSIBLE\_IMAGE\_URL todellisella viitekuvasi URL-osoitteella. ### Hinnoittelu ##### Lopullisen veloituksen laskenta Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä. Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle. Nopea tila Ei määritetty Kun nopea tila on valittu Flex-tila Ei määritetty Kun flex-tila on valittu Päättelyn enimmäisteho Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä #### Arvioidut vertailuhinnat #### Hinnat asetusten mukaan Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden. | Asetukset | Hinnasto | Ennustettu määrä | Veloitus | | --- | --- | --- | --- | | AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten **—** / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten **—** / 1K tokenia | | AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten **$1.24** arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. | Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. [Varauksen ja lopullisen veloituksen toiminta →](https://ailoot.ai/docs/fi/billing/reserve/) ### Esimerkkipyynnöt #### Ailoot Ultra · Videot JSON · luo videocurl · lue alkuperäinen tehtävä ```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 ``` ### Vastaanota ja tallenna tulokset #### Ailoot Ultra · Videot Säilytä palautetut työt ja niiden tilat. Lue jokainen valmistunut käyttäjälle kuuluva videotulos. - `GET /v1/videos/{request_id}` - `GET /v1/videos/generations/{request_id}` - `GET /v1/videos/{request_id}/content` - `GET /v1/videos/generations/{request_id}/content` ##### Säilytä kaikki valmistuneet tulokset Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL. Nouda jokainen todellinen valmistunut tulos; älä oleta kiinteää lukumäärää. ##### Jos alkuperäinen vastaus on tarkistettava Säilytä alkuperäinen vastaus ja palautettu tehtävätunniste; tuntematon tila tai epäselvä lähetys ei oikeuta uuteen luontipyyntöön. Vastauksen kentät | Kenttä | Tyyppi | Merkitys | | --- | --- | --- | | Kenttä`id` | Tyyppistring | MerkitysJulkinen Ailoot-tehtävän tai -operaation tunniste. | | Kenttä`provider_task_id` | Tyyppistring | MerkitysAlkuperäinen tehtävätunniste, joka on erillinen julkisesta id-tunnisteesta. | | Kenttä`polling_url` | Tyyppistring | MerkitysPalautettu Ailoot-hakupolku. | | Kenttä`jobs[].id` | Tyyppistring | MerkitysTodellinen palautettu työn tunniste. | | Kenttä`jobs[].status` | Tyyppistring | MerkitysKunkin palautetun työn tila. | | Kenttä`jobs[].results.raw.url` | Tyyppistring | MerkitysJokainen valmistunut video on saatavilla Ailoot-palvelun hallinnoiman allekirjoitetun URL-osoitteen kautta. | Virheet ja seuraavat vaiheet | Vastaus | Ehto | Seuraava vaihe | | --- | --- | --- | | Vastaus400 · `invalid_request_error` | EhtoVirheellinen JSON/model tai virheellinen sisältöindeksi. | Seuraava vaihe | | Vastaus401 · `authentication_error` | EhtoVirheellinen Ailoot API -avain. | Seuraava vaihe | | Vastaus403 · `permission_error` | EhtoAPI-avaimen ryhmällä ei ole käyttöoikeutta tähän mediareittiin. | Seuraava vaihe | | Vastaus404 · `not_found_error` | EhtoAlkuperäinen tehtävä tai pyydetty tulos puuttuu tai ei kuulu samalle käyttäjälle/API-avaimelle/ryhmälle. | Seuraava vaihe | | Vastaus502 · `result_pending_check` | EhtoAlkuperäinen lähetys tai tilatieto on puutteellinen tai sitä ei voida täsmäyttää; säilytä alkuperäinen tunniste äläkä lähetä pyyntöä uudelleen. | Seuraava vaihe | | Vastaus503 · `result_pending_check` | EhtoAlkuperäistä sidontaa, reittiä tai käyttäjälle kuuluvaa mediaa tarkistetaan edelleen; jatka saman alkuperäisen operaation tarkistamista. | Seuraava vaihe | | Vastaus503 · `server_error` | EhtoMediapalvelu tai alkuperäisen tehtävän tallennustila ei ole saatavilla. | Seuraava vaihe | ### Aliakset #### Mallin aliakset **Ailoot Ultra** [`dop-preview`](https://ailoot.ai/models/fi/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos) #### Menetelmäpolkujen aliakset `/v1/videos/generations` #### Liittyvät kutsujan ID:t [`dop-preview`](https://ailoot.ai/models/fi/#m=dop-preview&route=Ultra&caller=dop-preview&fmt=videos) FAQ · Higgsfield: DOP Preview Mitä syötteitä ja tuloksia on saatavilla? `POST /v1/videos` · `dop-preview`: `image`, `text` → `video` Mitä kenttiä pyyntö käyttää? `POST /v1/videos` · `dop-preview`: `model`, `params`, `webhook`, `callback` Mitä rajoja sovelletaan? `POST /v1/videos` · `dop-preview`: `params.motions[].strength.minimum`: `0`; `params.motions[].strength.maximum`: `1`; `params.seed.minimum`: `1`; `params.seed.maximum`: `1000000` Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi. ## Yritys ja sen projektisalkku Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. ## Osta tokenit alennuksella. Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista. Tilaus Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten. Kampanjakoodi jopa 50% Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan. Kulut historiassa Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle. [Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/) ## Yhdistä API tuotteeseen, jonka myyt. SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi. Kaupallinen sovellus Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin. Jälleenmyyjälisenssi Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot. Asiakirjat verkkosivustolla Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä. [Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi) ## Ailoot · Yritys ja sen projektisalkku Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan. Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.