Higgsfield: DOP Turbo

DOP Turbo yra Higgsfield vaizdo iš paveikslėlio kūrimo darbo eigos dop-turbo identifikatorius. Pateikite atraminį paveikslėlį bei pasirinktus judesio šablonus ir išsaugokite stiprumą, prompt, seed bei baigtą vaizdo įrašą kaip vieną generavimo įrašą.

Ailoot Ultra · Vaizdo įrašai POST /v1/videos dop-turbo

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

DOP Turbo animuoja pateiktą vaizdinę medžiagą pagal dokumentuotą Higgsfield vaizdo iš paveikslėlio kūrimo darbo eigą. Tikslus modelio identifikatorius yra dop-turbo. Naudokite dop-turbo kaip aukščiausio lygio modelio pasirinkimą ir kaip lauko model reikšmę dokumentuotame params objekte. Paveikslėlis suteikia vaizdinę medžiagą, o judesio šablonai ir rašytinis nurodymas valdo prašomą judesį bei efektą.

Parenkite atraminį paveikslėlį, kuriame aiškiai matyti numatytas objektas, svarbios detalės ir aplinkinė erdvė. Vadove rekomenduojamas didelės raiškos paveikslėlis, kad detalės būtų aiškesnės. Produkto scenai pasirinkite vaizdą, rodantį objekto formą ir paviršius, kurie judant turi likti atpažįstami. Asmeniui ar aplinkai nurodykite vaizdinę ypatybę, kurią judesys turėtų pabrėžti. Tikrąjį atraminio paveikslėlio URL pateikite per paveikslėlio įvestį, naudojamą metodo pavyzdyje.

Operacijai dokumentuotas vienas arba du judesio šablonai. Kai pateikiami du, vadove jų efektai aprašomi kaip derinami. Paruoštų šablonų aprašymai apima kameros judėjimą, objekto sukimąsi ir vaizdines transformacijas; pavyzdžiui, Dolly In aprašo kameros artėjimą, o 3D Rotation — objekto ar produkto sukimąsi vietoje. Pasirinkite dokumentuotus šablonų identifikatorius, atitinkančius numatytą seką, ir kiekvieną identifikatorių laikykite kartu su jo stiprumo reikšme.

Judesio stiprumas yra skaičius nuo 0 iki 1, o dokumentuota numatytoji reikšmė — 0.8. Vadove 0.3 apibūdinama kaip subtilus efektas, o 1 — kaip stiprus judesys. Intensyvumą parinkite pagal detalę, kuri turi likti aiški, ir peržiūrėkite visą sugeneruotą veiksmą. Judesio aprašymas ir jo stiprumas atlieka skirtingus vaidmenis: šablonas parenka efektą, o stiprumas valdo jo intensyvumą.

Pagal lauko aprašymą prompt turi būti pateiktas, bet tuščia eilutė leidžiama. Šablonais valdomiems efektams vadove rekomenduojama prompt palikti tuščią; kai pateikiamas tekstas, rekomenduojama įtraukti šablono aprašymą, nes prompt gali stipriai pakeisti rezultatą. Valdiklis enhance_prompt įjungia užklausos optimizavimą, o dokumentuota jo numatytoji reikšmė yra true. Lygindami versijas išsaugokite tekstą ir šį valdiklį kartu su atraminiu paveikslėliu bei pasirinktais šablonais.

Valdiklis seed priima sveikąjį skaičių nuo 1 iki 1000000. Pasirinktą seed išsaugokite kartu su generavimo nustatymais. Užklausoje taip pat pateikiamas sveikaskaitis laukas seconds; panaudotą reikšmę laikykite kartu su gautu klipu ir patikrinkite jo tikrąją trukmę bei kadravimą. Loginis valdiklis check_nsfw įjungia dokumentuotą turinio filtrą, o numatytoji jo reikšmė — true. Šie valdikliai priklauso vaizdo iš paveikslėlio kūrimo užklausai ir turi likti susieti su tiksliai pasirinktu modeliu.

Generavimas asinchroninis. Sekdami sukonfigūruotą būsenos ir rezultato užklausą išsaugokite grąžintą užduoties tapatybę. Užbaigimo susiejimas skaito baigtų užduočių įrašus ir jų pirminių rezultatų URL. Išsaugokite kiekvieną baigtą vaizdo rezultatą ir jo užduoties identifikatorių kartu su grąžintu URL, visus baigtus įrašus laikydami vienu operacijos rezultatu.

Visą vaizdo įrašą peržiūrėkite pagal pateiktą paveikslėlį, pasirinktą efektą ir rašytinį nurodymą: objekto išvaizdą, judesį, kadravimą bei baigiamąjį vaizdą. Taisymui nurodykite konkrečią keistiną vaizdinę detalę ir išsaugokite sėkmingas užklausos dalis. Pradinį paveikslėlio šaltinį, tikslų modelio identifikatorių, prompt, judesio identifikatorius, stiprumus, seed, prašomus nustatymus bei baigtus išteklius išsaugokite kartu, kad kitas palyginimas remtųsi tikru generavimu.

Ailoot Ultra · Vaizdo įrašai POST /v1/videos dop-turbo

dop-turbo

Higgsfield /dop-turbo

Pradžia

Leidžiamos įvestys: Vaizdai · Tekstas
Rezultatai: Vaizdo įrašai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdo įrašai POST /v1/videos

Įvestis: image, text
Išvestis: video

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos dop-turbo Sąlygos: Ailoot modelio parinkiklis.	Numatyta—
Laukas`params`	Tipas`object`	ReikalavimasPrivaloma	Reikšmės ir ribos Sąlygos: Paveikslėlio pavertimo vaizdo įrašu parametrai; išsaugokite šią apgaubiančią struktūrą.	Numatyta—
Laukas`params.model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos dop-turbo Sąlygos: Naudokite tą patį parinkiklį kaip aukščiausio lygio model.	Numatyta—
Laukas`params.prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Sąlygos: Šį lauką būtinai pateikite; dokumentacijoje numatyta tuščia eilutė. Tekstinės instrukcijos labai veikia pasirinktą judesio efektą.	Numatyta—
Laukas`params.seconds`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Pageidaujama trukmė; dokumentacijoje nepateiktas intervalas ar numatytoji reikšmė netvirtinami.	Numatyta—
Laukas`params.motions`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Pasirinkite vieną arba du dokumentacijoje nurodytus judesio šablonus.	Numatyta—
Laukas`params.motions[].id`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Sąlygos: Judesio identifikatorius dokumentacijoje pateiktame veikiančios užklausos pavyzdyje.	Numatyta—
Laukas`params.motions[].strength`	Tipas`number`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausia reikšmė: 0 Didžiausia reikšmė: 1 Sąlygos: Judesio intensyvumas: 0.3 apibūdinamas kaip subtilus, o 1 – kaip stiprus.	Numatyta0,8
Laukas`params.input_images`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Pavyzdiniai paveikslėliai, pateikiami veikiančiame pavyzdyje parodytu image_url objektų masyvu.	Numatyta—
Laukas`params.input_images[].type`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos image_url Sąlygos: Pavyzdinės medžiagos pateikimo forma.	Numatyta—
Laukas`params.input_images[].image_url`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Sąlygos: Tikras pasiekiamo jūsų pavyzdinio paveikslėlio URL.	Numatyta—
Laukas`params.enhance_prompt`	Tipas`boolean`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Tekstinės užklausos patobulinimas.	Numatytatrue
Laukas`params.check_nsfw`	Tipas`boolean`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Turinio filtravimas.	Numatytatrue
Laukas`params.seed`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 1 000 000 Sąlygos: Pradinė reikšmė nuosekliems rezultatams gauti.	Numatyta—
Laukas`webhook`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Neprivalomi dokumentacijoje nurodyti webhook nustatymai; jums priklausantiems rezultatams gauti naudojami Ailoot užduočių keliai.	Numatyta—
Laukas`webhook.url`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Jūsų gavėjo URL.	Numatyta—
Laukas`webhook.secret`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Jūsų gavėjo paslaptis.	Numatyta—
Laukas`callback`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Neprivalomas callback gavėjas; dokumentacijoje nurodytas gavėjas atsako HTTP 200.	Numatyta—

Įvesties medžiagos deriniai

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, params
Parametras`optional`	Specifikacijaparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Parametras`material_types`	Specifikacijaimage, text
Parametras`additional_properties`	Specifikacijatrue
Parametras`validation_scope`	SpecifikacijaUžklausos maršrutas parenkamas pagal modelį; parametrų objekto struktūra atitinka parodytą paveikslėlio pavertimo vaizdo įrašu užklausą.

Metodo pseudonimai: /v1/videos/generations

Gyvavimo ciklas: 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

Naudokite tą patį modelio parinkiklį aukščiausiame lygyje ir params viduje.

Sukurkite vieną kartą, tada naudokite pradinės operacijos grąžintą viešą id ir polling_url.

Gaukite kiekvieną užbaigtą jums priklausantį vaizdo įrašą; rezultate patikrinkite tikrąją trukmę ir matmenis.

Pavyzdyje pakeiskite YOUR_ACCESSIBLE_IMAGE_URL tikru savo pavyzdinio paveikslėlio URL.

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $1.24 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdo įrašai

JSON · sukurkite vaizdo įrašącurl · peržiūrėkite pirminę užduotį

{
  "model": "dop-turbo",
  "params": {
    "model": "dop-turbo",
    "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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdo įrašai

Išsaugokite grąžintas užduotis ir jų būsenas. Perskaitykite kiekvieną užbaigtą jums priklausantį vaizdo įrašo rezultatą.

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

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.

Gaukite kiekvieną tikrą užbaigtą rezultatą; nedarykite prielaidos, kad jų skaičius fiksuotas.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite pradinį atsakymą ir grąžintos užduoties tapatybę; neatpažinta būsena ar siuntimas, kurio baigtis neaiški, nesuteikia leidimo kurti iš naujo.

Atsakymo laukai

Laukas	Tipas	Reikšmė
Laukas`id`	Tipasstring	ReikšmėViešas Ailoot užduoties arba operacijos identifikatorius.
Laukas`provider_task_id`	Tipasstring	ReikšmėPradinės užduoties identifikatorius, atskiras nuo viešo id.
Laukas`polling_url`	Tipasstring	ReikšmėGrąžintas Ailoot duomenų paieškos kelias.
Laukas`jobs[].id`	Tipasstring	ReikšmėTikras grąžintas užduoties identifikatorius.
Laukas`jobs[].status`	Tipasstring	ReikšmėKiekvienos grąžintos užduoties būsena.
Laukas`jobs[].results.raw.url`	Tipasstring	ReikšmėKiekvienas užbaigtas vaizdo įrašas pasiekiamas per Ailoot priklausantį pasirašytą URL.

Klaidos ir tolesni veiksmai

Atsakymas	Sąlyga	Kitas žingsnis
Atsakymas400 · `invalid_request_error`	SąlygaNetinkamas JSON/model arba netinkamas turinio indeksas.	Kitas žingsnis
Atsakymas401 · `authentication_error`	SąlygaNegaliojantis Ailoot API raktas.	Kitas žingsnis
Atsakymas403 · `permission_error`	SąlygaAPI rakto grupei nesuteikta prieiga prie šio medijos maršruto.	Kitas žingsnis
Atsakymas404 · `not_found_error`	SąlygaPradinės užduoties arba pageidaujamo rezultato nėra, arba jis nepriklauso tam pačiam naudotojui, API raktui ir grupei.	Kitas žingsnis
Atsakymas502 · `result_pending_check`	SąlygaPradinio pateikimo ar būsenos duomenys yra neišsamūs arba jų nepavyksta suderinti; išsaugokite pradinį ID ir neteikite užklausos pakartotinai.	Kitas žingsnis
Atsakymas503 · `result_pending_check`	SąlygaPradinis susiejimas, maršrutas arba jums priklausanti medija vis dar tikrinami; tęskite tos pradinės operacijos tikrinimą.	Kitas žingsnis
Atsakymas503 · `server_error`	SąlygaMedijos paslauga arba pradinių užduočių saugykla nepasiekiama.	Kitas žingsnis

Pseudonimai

Modelių pseudonimai

Ailoot Ultra dop-turbo

Metodų kelių pseudonimai

/v1/videos/generations

Susiję ID iškvietimui

dop-turbo

FAQ · Higgsfield: DOP Turbo

Kokios įvestys ir rezultatai prieinami?: POST /v1/videos · dop-turbo: image, text → video
Kokius laukus naudoja užklausa?: POST /v1/videos · dop-turbo: model, params, webhook, callback
Kokie apribojimai taikomi?: POST /v1/videos · dop-turbo: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Turbo