Higgsfield: DOP Lite

DOP Lite animira priloženo sliko z dokumentiranimi predlogami gibanja, nastavljivo jakostjo in pisno usmeritvijo. Ta točni identifikator dop-lite uporablja zahtevo za ustvarjanje videa iz slike in vrne video prek asinhrone naloge.

Ailoot Ultra · Videoposnetki POST /v1/videos dop-lite

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

DOP Lite animira priložene slike z dokumentiranim postopkom Higgsfield za ustvarjanje videa iz slike. Točen izbirni identifikator je dop-lite. Uporabite dop-lite kot izbiro modela na najvišji ravni in kot vrednost model v dokumentiranem objektu params. Slika zagotovi vizualno gradivo, predloge gibanja in pisna usmeritev pa nadzorujejo zahtevano gibanje in učinek.

Pripravite referenčno sliko, na kateri so predvideni glavni motiv, pomembne podrobnosti in okoliški prostor jasno razvidni. Vodnik za jasnejše podrobnosti priporoča sliko visoke ločljivosti. Pri prizoru z izdelkom izberite pogled, ki pokaže obliko predmeta in površine, ki morajo med gibanjem ostati prepoznavne. Pri osebi ali okolju določite vizualno značilnost, ki naj jo gibanje poudari. Dejanski URL referenčne slike podajte prek slikovnega vhoda, uporabljenega v primeru metode.

Operacija dokumentira eno ali dve predlogi gibanja. Pri dveh vodnik opisuje njuna učinka kot združena. Opisi prednastavitev vključujejo premikanje kamere, vrtenje glavnega motiva in vizualne preobrazbe; Dolly In na primer opisuje približevanje kamere, 3D Rotation pa vrtenje glavnega motiva ali izdelka na mestu. Izberite dokumentirane identifikatorje predlog, ki ustrezajo predvidenemu zaporedju, in vsak identifikator ohranite z njegovo vrednostjo jakosti.

Jakost gibanja je število od 0 do 1, dokumentirana privzeta vrednost pa je 0.8. Vodnik opisuje 0.3 kot blag učinek in 1 kot izrazito gibanje. Jakost izberite glede na podrobnost, ki mora ostati jasno razvidna, in preglejte celotno ustvarjeno dogajanje. Opis gibanja in njegova jakost imata različni vlogi: predloga izbere učinek, jakost pa nadzoruje njegovo intenzivnost.

Polje prompt mora biti po svojem opisu prisotno, dovoljen pa je prazen niz. Pri učinkih, ki jih vodijo predloge, vodnik priporoča prazen poziv; kadar je besedilo podano, priporoča vključitev opisa predloge, saj lahko poziv močno spremeni rezultat. Nadzorni element enhance_prompt omogoči optimizacijo poziva, njegova dokumentirana privzeta vrednost pa je true. Pri primerjavi različic ohranite besedilo in ta nadzorni element skupaj z referenčno sliko in izbranimi predlogami.

Nadzorni element seed sprejema celo število od 1 do 1000000. Izbrano začetno vrednost zabeležite z nastavitvami ustvarjanja. Zahteva vsebuje tudi celoštevilsko polje seconds; uporabljeno vrednost ohranite z nastalim posnetkom ter preverite njegovo dejansko časovno razporeditev in kadriranje. Logični element check_nsfw omogoči dokumentirani filter vsebine, privzeta vrednost pa je true. Ti nadzorni elementi pripadajo zahtevi za ustvarjanje videa iz slike in morajo ostati povezani s točno izbranim modelom.

Ustvarjanje je asinhrono. Ohranite vrnjeni identifikator naloge, ko sledite nastavljenemu preverjanju stanja in poizvedbi za rezultat. Preslikava dokončanja bere dokončane vnose opravil in njihove izvorne URL-je rezultatov. Shranite vsak dokončani videorezultat in njegov identifikator opravila ohranite z vrnjenim URL-jem; vse dokončane vnose hranite skupaj kot rezultat operacije.

Celoten video preverite glede na priloženo sliko, izbrani učinek in pisno usmeritev: videz glavnega motiva, gibanje, kadriranje in zaključni pogled. Pri popravku določite konkretno vizualno podrobnost, ki jo želite spremeniti, ter ohranite uspešne dele zahteve. Prvotno referenco slike, točen izbirni identifikator, poziv, identifikatorje gibanj, jakosti, začetno vrednost, zahtevane nastavitve in dokončane rezultate hranite skupaj, da bo naslednja primerjava uporabljala dejansko ustvarjanje.

Ailoot Ultra · Videoposnetki POST /v1/videos dop-lite

dop-lite

Higgsfield /dop-lite

Začetek

Dovoljeni vhodi: Slike · Besedilo
Rezultati: Video

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Videoposnetki POST /v1/videos

Vhod: image, text
Izhod: video

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve dop-lite Pogoji: Izbirnik modela Ailoot.	Privzeto—
Polje`params`	Vrsta`object`	ZahtevaObvezno	Vrednosti in omejitve Pogoji: Parametri za pretvorbo slike v video; ohranite ta ovoj.	Privzeto—
Polje`params.model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve dop-lite Pogoji: Uporabite isti izbirnik kot pri vrhnjem modelu.	Privzeto—
Polje`params.prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Pogoji: Ohranite to polje; prazen niz je dokumentiran. Pisna navodila močno vplivajo na izbrani učinek gibanja.	Privzeto—
Polje`params.seconds`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Zahtevano trajanje; dokumentiran razpon ali privzeta vrednost ni zagotovljena.	Privzeto—
Polje`params.motions`	Vrsta`array`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Izberite eno ali dve dokumentirani predlogi gibanja.	Privzeto—
Polje`params.motions[].id`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Pogoji: Identifikator gibanja iz dokumentiranega delujočega primera zahteve.	Privzeto—
Polje`params.motions[].strength`	Vrsta`number`	ZahtevaObvezno	Vrednosti in omejitve Najmanj: 0 Največ: 1 Pogoji: Intenzivnost gibanja: 0.3 je opisana kot blaga, 1 pa kot močna.	Privzeto0,8
Polje`params.input_images`	Vrsta`array`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Referenčne slike s poljem objektov image_url, prikazanim v delujočem primeru.	Privzeto—
Polje`params.input_images[].type`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve image_url Pogoji: Referenčna predstavitev.	Privzeto—
Polje`params.input_images[].image_url`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Pogoji: Vaš dejanski dostopni URL referenčne slike.	Privzeto—
Polje`params.enhance_prompt`	Vrsta`boolean`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Izboljšava poziva.	Privzetotrue
Polje`params.check_nsfw`	Vrsta`boolean`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Filtriranje vsebine.	Privzetotrue
Polje`params.seed`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 1.000.000 Pogoji: Seme za ponovljive izhode.	Privzeto—
Polje`webhook`	Vrsta`object`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Neobvezne dokumentirane nastavitve webhook; pridobivanje rezultatov v vaši lasti uporablja poti opravil Ailoot.	Privzeto—
Polje`webhook.url`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Vaš URL prejemnika.	Privzeto—
Polje`webhook.secret`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Vaša skrivnost prejemnika.	Privzeto—
Polje`callback`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Neobvezni prejemnik callback; dokumentirani prejemnik odgovori s HTTP 200.	Privzeto—

Kombinacije vhodnih gradiv

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`content_type`	Specifikacijaapplication/json
Parameter`required`	Specifikacijamodel, params
Parameter`optional`	Specifikacijaparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Parameter`material_types`	Specifikacijaimage, text
Parameter`additional_properties`	Specifikacijatrue
Parameter`validation_scope`	SpecifikacijaModel usmeri zahtevo; ovoj parameters sledi prikazani zahtevi za pretvorbo slike v video.

Druga imena metode: /v1/videos/generations

Življenjski cikel: 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

Uporabite isti izbirnik modela na vrhnji ravni in znotraj params.

Ustvarite enkrat, nato za prvotno operacijo uporabite vrnjena javna id in polling_url.

Pridobite vsak dokončan video v vaši lasti; v rezultatu preverite dejansko trajanje in mere.

V primeru nadomestite YOUR_ACCESSIBLE_IMAGE_URL z dejanskim URL-jem svoje referenčne slike.

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $1.24 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Videoposnetki

JSON · ustvarite videoposnetekcurl · preberite izvirno opravilo

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

Prejmi in shrani rezultate

Ailoot Ultra · Videoposnetki

Ohranite vrnjena opravila in njihova stanja. Preberite vsak dokončan video rezultat v vaši lasti.

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

Ohrani vse dokončane rezultate

Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.

Pridobite vsak dejanski dokončani izhod; ne predpostavljajte stalnega števila.

Če je treba preveriti izvirni odgovor

Ohranite prvotni odgovor in vrnjeno identiteto opravila; neprepoznano stanje ali dvoumna oddaja ne dovoljujeta novega ustvarjanja.

Polja odgovora

Polje	Vrsta	Pomen
Polje`id`	Vrstastring	PomenJavni identifikator opravila ali operacije Ailoot.
Polje`provider_task_id`	Vrstastring	PomenPrvotni identifikator opravila, ločen od javnega id.
Polje`polling_url`	Vrstastring	PomenVrnjena pot Ailoot za poizvedbo.
Polje`jobs[].id`	Vrstastring	PomenDejanski vrnjeni identifikator opravila.
Polje`jobs[].status`	Vrstastring	PomenStanje vsakega vrnjenega opravila.
Polje`jobs[].results.raw.url`	Vrstastring	PomenVsak dokončan video je dostopen prek podpisanega URL-ja v lasti Ailoot.

Napake in naslednji koraki

Odgovor	Pogoj	Naslednji korak
Odgovor400 · `invalid_request_error`	PogojNeveljaven JSON/model ali neveljaven indeks vsebine.	Naslednji korak
Odgovor401 · `authentication_error`	PogojNeveljaven ključ Ailoot API.	Naslednji korak
Odgovor403 · `permission_error`	PogojSkupina ključa API nima dovoljenja za to medijsko pot.	Naslednji korak
Odgovor404 · `not_found_error`	PogojPrvotno opravilo ali zahtevani izhod manjka ali ni v lasti istega uporabnika/ključa API/skupine.	Naslednji korak
Odgovor502 · `result_pending_check`	PogojPrvotna oddaja ali stanje sta nepopolna ali ju ni mogoče uskladiti; ohranite prvotni ID in zahteve ne oddajte znova.	Naslednji korak
Odgovor503 · `result_pending_check`	PogojPrvotna povezava, pot ali medij v vaši lasti se še preverja; nadaljujte preverjanje te prvotne operacije.	Naslednji korak
Odgovor503 · `server_error`	PogojMedijska storitev ali shramba prvotnega opravila ni na voljo.	Naslednji korak

Druga imena

Druga imena modelov

Ailoot Ultra dop-lite

Druga imena poti metod

/v1/videos/generations

Povezani ID-ji za klic

dop-lite

FAQ · Higgsfield: DOP Lite

Kateri vhodi in rezultati so na voljo?: POST /v1/videos · dop-lite: image, text → video
Katera polja uporablja zahteva?: POST /v1/videos · dop-lite: model, params, webhook, callback
Katere omejitve veljajo?: POST /v1/videos · dop-lite: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Higgsfield: DOP Lite