MiniMax: S2V 01
Az S2V 01 portréreferenciával irányítja egy karakter megjelenését az újonnan generált videóban. Adjon meg egy jól kivehető arcképet, és írja le a jelenetet és a cselekményt; a gyártó témareferenciára épülő munkafolyamata a képet karakterreferenciaként kezeli.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
Az S2V 01 a MiniMax témareferenciát használó videómodellje. A megadott kép a karakter megjelenését irányítja, a szöveg pedig a videó jelenetét és cselekményét írja le. Dokumentált referenciatípusa egy személy arca, ezért a portrét a generált képsorba helyezni kívánt karakter kilétét meghatározó útmutatóként készítse elő.
Olyan referenciát válasszon, amelyen a kívánt arc tisztán látszik és könnyen megkülönböztethető. Ne rejtse kéz, nagy kiegészítő vagy erős képkivágás mögé a meghatározó vonásokat, ha azok fontosak az eredményhez. Az összetartozó felvételeknél ugyanazt a portrét használja, hogy ismert maradjon a karaktert irányító forrás. A referencia a megjelenésről ad információt; a promptban azt a jelenetet magyarázza el, amelyben a karakternek szerepelnie kell.
A gyártó témareferencia-sémája egy képet fogad el a referenciaképek tömbjében. A támogatott formátumok JPG, JPEG, PNG és WebP, 20 MB alatti fájlmérettel. A rövidebb oldalnak 300 képpontnál hosszabbnak, a képaránynak pedig 2:5 és 5:2 közöttinek kell lennie. A pontos képfájlt tartsa a generálás adatai mellett, ahelyett hogy későbbi összehasonlításkor másik portréval helyettesítené.
Olyan jelenetet írjon le, amelyben a referencián szereplő személynek világos szerepe van. A karakter például beléphet egy csendes műhelybe, ránézhet egy asztalon álló tárgyra, és megállhat mellette. Adja meg az elkészült felvétel szempontjából fontos cselekményt, környezetet és nézőpontot. Ha az arcnak jól kivehetőnek kell maradnia, a képkivágást és a mozgást ehhez igazítsa.
A szöveges leírás legfeljebb 2000 karaktert támogat. Ezeket konkrét utasításokra használja: mit tesz a karakter, mi veszi körül, és mit mutasson a zárókép. Akkor írja le a ruházatot vagy a jelenet részleteit, ha azok fontosak a történethez, majd ellenőrizze, hogyan kapcsolja össze őket a generált videó a megadott arcreferenciával. A referencia szerepét különítse el attól a kéréstől, amely a portré teljes hátterét nyitóképkockaként kívánja reprodukálni.
Az automatikus promptoptimalizálás dokumentált, és alapértelmezés szerint be van kapcsolva. Kikapcsolható, ha az írott leírás feletti nagyobb kontrollra van szükség. Különböző jelenetek összehasonlításakor ezt a választást őrizze meg a szöveggel és a portréval együtt. Hasonlósági probléma vizsgálatakor tartsa változatlanul a jelenetleírást, miközben javított referenciát hasonlít össze; a cselekmény vizsgálatakor a referenciát tartsa változatlanul, és a mozgásleírást módosítsa.
A gyártó munkafolyamata feladatazonosítót ad vissza, mielőtt a videó elkészül. Az állapot- és eredménylekérés lépésein át ugyanazt az eredeti azonosítót őrizze meg, majd mentse el az elkészült klipet ellenőrzéshez és szerkesztéshez. A portrét, a promptot és az eredményül kapott videót egyetlen feljegyzésként tartsa meg, hogy egy későbbi felvétel összehasonlítható legyen a korábbi eredményt ténylegesen irányító anyaggal.
A karaktert a teljes képsor során ellenőrizze, a fordulásoknál, gesztusoknál és a képkivágás változásainál is. Vizsgálja meg az arc következetességét, a kívánt cselekmény érthetőségét, valamint a karakter és a jelenet tárgyai közötti kapcsolatot. Válassza ki a felvétel célját legjobban szolgáló klipet, és a bemenet módosítása előtt azonosítson minden konkrét eltérést. Visszatérő karakterrel végzett munkánál hasznos több elkészült felvételt egymás mellett ellenőrizni, ugyanazzal a portréreferenciával és az egyes jelenetleírások világos nyilvántartásával.
Ailoot Ultra · Videó POST /v1/videos minimaxi-s2v-01
minimaxi-s2v-01Kezdő lépések
Az S2V 01 portréreferenciával irányítja egy karakter megjelenését az újonnan generált videóban. Adjon meg egy jól kivehető arcképet, és írja le a jelenetet és a cselekményt; a gyártó témareferenciára épülő munkafolyamata a képet karakterreferenciaként kezeli.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Videó POST /v1/videos
- Bemenet
text,image- Kimenet
video
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok minimaxi-s2v-01 Feltételek: Használja a pontos Ailoot modellválasztót. | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Feltételek: Írja le a jelenetet és a mozgást. | Alapértelmezett— |
Mezőend_image | Típusstring | KövetelményOpcionális | Értékek és korlátok Feltételek: A záró képkocka kizárólag támogatott képbemeneti módban érvényes. | Alapértelmezett— |
Mezőimage | Típusstring or array<string> | KövetelményOpcionális | Értékek és korlátok Feltételek: Használjon tényleges, nyilvánosan elérhető kép-URL-címet vagy base64 képsztringet; itt nem állítunk maximális képdarabszámot. | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paraméteroptional | Szerződésend_image, image |
Paramétermaterial_types | Szerződéstext, image |
Paraméterconditions | SzerződésHasználja a pontos Ailoot modellválasztót., Írja le a jelenetet és a mozgást., A záró képkocka kizárólag támogatott képbemeneti módban érvényes., Használjon tényleges, nyilvánosan elérhető kép-URL-címet vagy base64 képsztringet; itt nem állítunk maximális képdarabszámot. |
Metódus álnevei: /v1/videos/generations
Életciklus: 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}
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Elszámolási mennyiség | Díj |
|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Elszámolási mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításKérésenként | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási mennyiségegy kérés | Díj Bemenet · Becslés, csak összehasonlításra $1.4 kérésenként |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Elszámolási mennyiség— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $1.4 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot Ultra · Videó
# 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
Eredmények fogadása és mentése
Ailoot Ultra · Videó
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}
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizze meg a teljes választ és fejléceit, az eredeti azonosítókat, az összes tényleges kimenetet és minden felhasználási, illetve elszámolási mezőt. Mentsen el minden egyedi saját médiaállományt, és őrizzen meg minden rá mutató szerepet.
Ha az eredeti választ ellenőrizni kell
Őrizze meg a visszaadott nyilvános feladat- vagy műveletazonosítót és az összes fejlécet. Csak az eredeti feladatot kérdezze le; az unknown vagy result_pending_check nem jogosít fel újabb létrehozásra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőpolling_url | Típusstring |
Mezőprovider_task_id | Típusstring |
Mezőtask_id | Típusstring |
Mezőstatus | Típusstring |
Mezővideo_url | Típusstring |
Álnevek
Modell álnevei
Ailoot Ultra minimaxi-s2v-01
Metódusútvonalak álnevei
/v1/videos/generations
Kapcsolódó modellazonosítók
FAQ · MiniMax: S2V 01
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·minimaxi-s2v-01:text,image→video- Mely mezőket használja a kérés?
POST /v1/videos·minimaxi-s2v-01:model,prompt,end_image,image