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.
", "aboutText": "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.\n\nValitse 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.\n\nValmistajan 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.\n\nKuvaa 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.\n\nTekstikuvaus 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.\n\nAutomaattinen 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.\n\nValmistajan 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.\n\nTarkista 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "0ac62ca55a3cfed8b977ef5112eacf742f8ebd2a4d90aad830c3f29c07ae254b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "minimaxi-s2v-01S2V 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ä.
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.
POST /v1/videostext, imagevideo| 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— |
| 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}
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.
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 →
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncat > request.json <<'JSON'\n{\n "model": "minimaxi-s2v-01",\n "prompt": "A cat is walking on grass.",\n "image": "YOUR_ACCESSIBLE_IMAGE_URL"\n}\nJSON\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Create once; retain id, polling_url, original task identifiers and every header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.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)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n 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"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n 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"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}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.
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.
| 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 |
Ailoot Ultra minimaxi-s2v-01
/v1/videos/generations