Higgsfield: DOP Preview
DOP Preview pretvori priložene slike v video z dokumentiranim postopkom s predlogami gibanja. Točen identifikator dop-preview podpira enega ali dva učinka, pri čemer se jakost, poziv in začetna vrednost ohranijo skupaj z dokončanim rezultatom.
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 Preview animira priložene slike z dokumentiranim postopkom Higgsfield za ustvarjanje videa iz slike. Točen izbirni identifikator je dop-preview. Uporabite dop-preview 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-preview
dop-previewZačetek
DOP Preview pretvori priložene slike v video z dokumentiranim postopkom s predlogami gibanja. Točen identifikator dop-preview podpira enega ali dva učinka, pri čemer se jakost, poziv in začetna vrednost ohranijo skupaj z dokončanim rezultatom.
- 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 |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve dop-preview Pogoji: Izbirnik modela Ailoot. | Privzeto— |
Poljeparams | Vrstaobject | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Parametri za pretvorbo slike v video; ohranite ta ovoj. | Privzeto— |
Poljeparams.model | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve dop-preview Pogoji: Uporabite isti izbirnik kot pri vrhnjem modelu. | Privzeto— |
Poljeparams.prompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Ohranite to polje; prazen niz je dokumentiran. Pisna navodila močno vplivajo na izbrani učinek gibanja. | Privzeto— |
Poljeparams.seconds | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Zahtevano trajanje; dokumentiran razpon ali privzeta vrednost ni zagotovljena. | Privzeto— |
Poljeparams.motions | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Izberite eno ali dve dokumentirani predlogi gibanja. | Privzeto— |
Poljeparams.motions[].id | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Identifikator gibanja iz dokumentiranega delujočega primera zahteve. | Privzeto— |
Poljeparams.motions[].strength | Vrstanumber | ZahtevaObvezno | Vrednosti in omejitve Najmanj: 0 Največ: 1 Pogoji: Intenzivnost gibanja: 0.3 je opisana kot blaga, 1 pa kot močna. | Privzeto0,8 |
Poljeparams.input_images | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Referenčne slike s poljem objektov image_url, prikazanim v delujočem primeru. | Privzeto— |
Poljeparams.input_images[].type | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve image_url Pogoji: Referenčna predstavitev. | Privzeto— |
Poljeparams.input_images[].image_url | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Vaš dejanski dostopni URL referenčne slike. | Privzeto— |
Poljeparams.enhance_prompt | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Izboljšava poziva. | Privzetotrue |
Poljeparams.check_nsfw | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Filtriranje vsebine. | Privzetotrue |
Poljeparams.seed | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 1.000.000 Pogoji: Seme za ponovljive izhode. | Privzeto— |
Poljewebhook | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Neobvezne dokumentirane nastavitve webhook; pridobivanje rezultatov v vaši lasti uporablja poti opravil Ailoot. | Privzeto— |
Poljewebhook.url | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Vaš URL prejemnika. | Privzeto— |
Poljewebhook.secret | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Vaša skrivnost prejemnika. | Privzeto— |
Poljecallback | Vrstastring | 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 |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, params |
Parameteroptional | Specifikacijaparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parametermaterial_types | Specifikacijaimage, text |
Parameteradditional_properties | Specifikacijatrue |
Parametervalidation_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
{
"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
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}/contentGET /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 |
|---|---|---|
Poljeid | Vrstastring | PomenJavni identifikator opravila ali operacije Ailoot. |
Poljeprovider_task_id | Vrstastring | PomenPrvotni identifikator opravila, ločen od javnega id. |
Poljepolling_url | Vrstastring | PomenVrnjena pot Ailoot za poizvedbo. |
Poljejobs[].id | Vrstastring | PomenDejanski vrnjeni identifikator opravila. |
Poljejobs[].status | Vrstastring | PomenStanje vsakega vrnjenega opravila. |
Poljejobs[].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-preview
Druga imena poti metod
/v1/videos/generations
Povezani ID-ji za klic
FAQ · Higgsfield: DOP Preview
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·dop-preview:image,text→video- Katera polja uporablja zahteva?
POST /v1/videos·dop-preview:model,params,webhook,callback- Katere omejitve veljajo?
POST /v1/videos·dop-preview:params.motions[].strength.minimum:0;params.motions[].strength.maximum:1;params.seed.minimum:1;params.seed.maximum:1000000