Higgsfield: 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.
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-previewAloitus
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 | Tyyppistring | VaatimusPakollinen | Arvot & rajat dop-preview Ehdot: Ailoot-mallin valitsin. | Oletus— |
Kenttäparams | Tyyppiobject | VaatimusPakollinen | Arvot & rajat Ehdot: Kuvasta videoksi -parametrit; säilytä tämä pyyntörakenne. | Oletus— |
Kenttäparams.model | Tyyppistring | VaatimusPakollinen | Arvot & rajat dop-preview Ehdot: Käytä samaa valitsinta kuin ylimmän tason model-kentässä. | Oletus— |
Kenttäparams.prompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Ehdot: Säilytä tämä kenttä mukana; tyhjä merkkijono on dokumentoitu. Kirjoitettu ohjaus vaikuttaa voimakkaasti valittuun liiketehosteeseen. | Oletus— |
Kenttäparams.seconds | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Ehdot: Pyydetty kesto; dokumentoitua vaihteluväliä tai oletusarvoa ei vahvisteta. | Oletus— |
Kenttäparams.motions | Tyyppiarray | VaatimusValinnainen | Arvot & rajat Ehdot: Valitse yksi tai kaksi dokumentoitua liikemallia. | Oletus— |
Kenttäparams.motions[].id | Tyyppistring | VaatimusPakollinen | Arvot & rajat Ehdot: Liikkeen tunniste dokumentoidussa toimivassa pyyntöesimerkissä. | Oletus— |
Kenttäparams.motions[].strength | Tyyppinumber | 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 | Tyyppiarray | VaatimusValinnainen | Arvot & rajat Ehdot: Viitekuvat toimivassa esimerkissä näytetyn image_url-oliotaulukon avulla. | Oletus— |
Kenttäparams.input_images[].type | Tyyppistring | VaatimusPakollinen | Arvot & rajat image_url Ehdot: Viitteen esitysmuoto. | Oletus— |
Kenttäparams.input_images[].image_url | Tyyppistring | VaatimusPakollinen | Arvot & rajat Ehdot: Todellinen saavutettavissa olevan viitekuvasi URL-osoite. | Oletus— |
Kenttäparams.enhance_prompt | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Ehdot: Kehotteen parantaminen. | Oletustrue |
Kenttäparams.check_nsfw | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Ehdot: Sisällön suodatus. | Oletustrue |
Kenttäparams.seed | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 1 000 000 Ehdot: Satunnaissiemen yhtenäisiä tuloksia varten. | Oletus— |
Kenttäwebhook | Tyyppiobject | 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 | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: Vastaanottajasi URL-osoite. | Oletus— |
Kenttäwebhook.secret | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: Vastaanottajasi salaisuus. | Oletus— |
Kenttäcallback | Tyyppistring | 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 |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, params |
Parametrioptional | Sopimusparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametrimaterial_types | Sopimusimage, text |
Parametriadditional_properties | Sopimustrue |
Parametrivalidation_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 →
Esimerkkipyynnöt
Ailoot Ultra · Videot
{
"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
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}/contentGET /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
Menetelmäpolkujen aliakset
/v1/videos/generations
Liittyvät kutsujan ID:t
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