MiniMax: S2V 01
S2V 01 ohjaa hahmoa uudessa generoidussa videossa muotokuvareferenssin avulla. Toimita yksi selkeä kasvokuva ja kuvaa kohtaus sekä toiminta; valmistajan kohdereferenssityönkulku käsittelee kuvaa hahmon referenssinä.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
S2V 01 on MiniMaxin kohdereferenssiin perustuva videomalli. Annettu kuva ohjaa hahmon ulkoasua, kun taas teksti kuvaa videokohtauksen ja toiminnan. Sen dokumentoitu referenssityyppi on henkilön kasvot, joten valmistele muotokuva hahmon ulkoasua ohjaavaksi referenssiksi, kun haluat sijoittaa hahmon generoituun jaksoon.
Valitse referenssi, jossa tarkoitetut kasvot ovat selkeät ja helposti erotettavat. Vältä tunnusomaisten piirteiden peittämistä käden, suuren asusteen tai voimakkaan rajauksen taakse, kun ne ovat tulokselle tärkeitä. Käytä yhtenäistä muotokuvaa toisiinsa liittyvissä otoksissa, jotta hahmoa ohjaava lähde pysyy tiedossa. Referenssi antaa ulkoasutietoa; selitä kehotteessa kohtaus, jossa hahmon tulee toimia.
Valmistajan kohdereferenssin määritys hyväksyy yhden kuvan referenssikuvataulukossa. Tuetut muodot ovat JPG, JPEG, PNG ja WebP, ja tiedostokoon tulee olla alle 20 MB. Lyhyemmän sivun tulee ylittää 300 pikseliä, ja kuvasuhteen tulee olla välillä 2:5 ja 5:2. Säilytä täsmällinen kuvatiedosto generointitietueen yhteydessä sen sijaan, että vaihtaisit sen toiseen muotokuvaan myöhemmässä vertailussa.
Kuvaa kohtaus, jossa referenssin henkilöllä on selkeä rooli. Hahmo voi esimerkiksi kävellä hiljaiseen työpajaan, katsoa pöydällä olevaa esinettä ja pysähtyä sen viereen. Määritä valmiille otokselle tärkeä toiminta, ympäristö ja näkökulma. Jos kasvojen tulee pysyä luettavina, suunnittele rajaus ja liike tämän vaatimuksen ympärille.
Tekstikuvaus tukee enintään 2000 merkkiä. Käytä merkit konkreettisiin ohjeisiin: mitä hahmo tekee, mitä hänen ympärillään on ja mitä loppunäkymän tulee näyttää. Kuvaa vaatteet tai kohtauksen yksityiskohdat, kun ne ovat tarinalle tärkeitä, ja tarkista sitten, miten generoitu video yhdistää ne annettuun identiteettireferenssiin. Erota referenssin rooli pyynnöstä toistaa muotokuvan koko tausta aloitusruutuna.
Automaattinen kehotteen optimointi on dokumentoitu ja oletuksena käytössä. Sen voi poistaa käytöstä, kun kirjallista kuvausta on tarpeen hallita tarkemmin. Säilytä valinta tekstin ja muotokuvan kanssa eri kohtauksia vertaillessasi. Tutki yhdennäköisyysongelmaa pitämällä kohtauskuvaus samana parannettua referenssiä vertaillessasi; tutki toimintaa pitämällä referenssi samana liikekuvausta muokatessasi.
Valmistajan työnkulku palauttaa tehtävän tunnisteen ennen videon valmistumista. Säilytä alkuperäinen tunniste tila- ja tulosvaiheiden ajan ja tallenna sitten valmis leike tarkistukseen ja editointiin. Säilytä muotokuva, kehote ja tulosvideo yhtenä tietueena, jotta myöhempää otosta voidaan verrata aiempaa tulosta ohjanneeseen varsinaiseen aineistoon.
Tarkista hahmo koko jakson ajan, mukaan lukien käännökset, eleet ja rajauksen muutokset. Tarkista kasvojen yhtenäisyys, aiotun toiminnan ymmärrettävyys sekä hahmon ja kohtauksen esineiden välinen suhde. Valitse otoksen tarkoitusta parhaiten palveleva leike ja yksilöi konkreettinen poikkeama ennen syötteen muuttamista. Toistuvaan hahmoon perustuva työnkulku hyötyy useiden valmiiden otosten rinnakkaisesta tarkastelusta samalla muotokuvareferenssillä ja kunkin kohtauskuvauksen selkeällä tietueella.
Ailoot Ultra · Videot POST /v1/videos minimaxi-s2v-01
minimaxi-s2v-01Aloitus
S2V 01 ohjaa hahmoa uudessa generoidussa videossa muotokuvareferenssin avulla. Toimita yksi selkeä kasvokuva ja kuvaa kohtaus sekä toiminta; valmistajan kohdereferenssityönkulku käsittelee kuvaa hahmon referenssinä.
- Hyväksytyt syötteet
- Teksti · Kuvat
- Tulokset
- Video
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · Videot POST /v1/videos
- Syötetyypit
text,image- Tulostyypit
video
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat minimaxi-s2v-01 Ehdot: Käytä täsmällistä Ailoot-mallin valitsinta. | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Ehdot: Kuvaile kohtaus ja liike. | Oletus— |
Kenttäend_image | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: Loppuruutua käytetään vain tuetussa kuvasyötetilassa. | Oletus— |
Kenttäimage | Tyyppistring or array<string> | VaatimusValinnainen | Arvot & rajat Ehdot: Käytä todellista julkisesti saavutettavaa kuvan URL-osoitetta tai base64-kuvamerkkijonoa; kuvien enimmäismäärää ei vahvisteta tässä. | Oletus— |
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt |
Parametrioptional | Sopimusend_image, image |
Parametrimaterial_types | Sopimustext, image |
Parametriconditions | SopimusKäytä täsmällistä Ailoot-mallin valitsinta., Kuvaile kohtaus ja liike., Loppuruutua käytetään vain tuetussa kuvasyötetilassa., Käytä todellista julkisesti saavutettavaa kuvan URL-osoitetta tai base64-kuvamerkkijonoa; kuvien enimmäismäärää ei vahvisteta tässä. |
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/media/assets
GET /v1/media/assets/{asset_id}
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ä | Laskutusmäärä | Veloitus |
|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Laskutusmää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 |
| AsetuksetPyyntöä kohden | Hinnasto— | Ennustettu määrä— | Laskutusmääräyksi pyyntö | Veloitus Syöte · Arvio vain vertailua varten $1.4 pyyntöä kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusmäärä— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $1.4 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
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-s2v-01",
"prompt": "A cat is walking on grass.",
"image": "YOUR_ACCESSIBLE_IMAGE_URL"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Vastaanota ja tallenna tulokset
Ailoot Ultra · Videot
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Säilytä kaikki valmistuneet tulokset
Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.
Säilytä koko vastaus ja otsakkeet, alkuperäiset tunnisteet, jokainen todellinen tulos sekä kaikki käyttö- ja veloitustietokentät. Tallenna jokainen yksilöllinen käyttäjälle kuuluva aineisto ja säilytä kaikki siihen viittaavat roolit.
Jos alkuperäinen vastaus on tarkistettava
Säilytä palautettu julkinen tehtävän tai operaation id ja kaikki otsakkeet. Lue vain alkuperäisen tehtävän tietoja; unknown tai result_pending_check ei oikeuta uuteen luontipyyntöön.
Vastauksen kentät
| Kenttä | Tyyppi |
|---|---|
Kenttäid | Tyyppistring |
Kenttäpolling_url | Tyyppistring |
Kenttäprovider_task_id | Tyyppistring |
Kenttätask_id | Tyyppistring |
Kenttästatus | Tyyppistring |
Kenttävideo_url | Tyyppistring |
Aliakset
Mallin aliakset
Ailoot Ultra minimaxi-s2v-01
Menetelmäpolkujen aliakset
/v1/videos/generations
Liittyvät kutsujan ID:t
FAQ · MiniMax: S2V 01
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/videos·minimaxi-s2v-01:text,image→video- Mitä kenttiä pyyntö käyttää?
POST /v1/videos·minimaxi-s2v-01:model,prompt,end_image,image