MiniMax: S2V 01
S2V 01 používá portrétní referenci k vedení postavy v nově generovaném videu. Dodejte jeden jasný obrázek obličeje a popište scénu i akci; referenční postup výrobce pro hlavní objekt považuje obrázek za referenci postavy.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
S2V 01 je videomodel MiniMax využívající referenci hlavního objektu. Dodaný obrázek vede vzhled postavy, zatímco text popisuje videoscénu a akci. Dokumentovaným typem reference je lidský obličej, proto připravte portrét jako vodítko identity postavy, kterou chcete umístit do generované sekvence.
Vyberte referenci, na které je zamýšlený obličej jasný a snadno rozlišitelný. Pokud jsou určující rysy pro výsledek důležité, nezakrývejte je rukou, velkým doplňkem nebo výrazným ořezem. U souvisejících záběrů zachovejte portrét konzistentní, aby zdroj použitý k vedení postavy zůstal známý. Reference poskytuje informace o vzhledu; promptem vysvětlete scénu, kterou má postava předvést.
Referenční schéma výrobce pro hlavní objekt přijímá jeden obrázek v poli referenčních obrázků. Podporované formáty jsou JPG, JPEG, PNG a WebP s velikostí souboru pod 20 MB. Kratší strana musí přesáhnout 300 pixelů a poměr stran musí být mezi 2:5 a 5:2. Uchovejte přesný obrazový soubor se záznamem generování, místo nahrazení jiným portrétem při pozdějším porovnání.
Popište scénu s jasnou rolí referenční osoby. Postava například může vejít do tiché dílny, podívat se na předmět na stole a zastavit se vedle něj. Určete akci, prostředí a pohled důležité pro dokončený záběr. Pokud má obličej zůstat čitelný, plánujte zarámování a pohyb podle tohoto požadavku.
Textový popis podporuje až 2 000 znaků. Použijte je pro konkrétní pokyny: co postava dělá, co ji obklopuje a co má ukázat závěrečný pohled. Popište oblečení nebo detaily scény, pokud jsou pro příběh důležité, a poté zkontrolujte, jak je generované video propojuje s dodanou identitní referencí. Rozlišujte roli referenčního obrázku od požadavku reprodukovat celé pozadí portrétu jako úvodní snímek.
Automatická optimalizace promptu je dokumentovaná a ve výchozím stavu zapnutá. Lze ji vypnout, pokud je potřeba přesnější kontrola písemného popisu. Při porovnávání různých scén uchovejte tuto volbu s textem a portrétem. Pro prozkoumání problému podobnosti ponechte zadání scény stejné při porovnávání vylepšené reference; pro prozkoumání akce ponechte referenci stejnou při revizi popisu pohybu.
Postup výrobce vrací identitu úlohy před dokončením videa. Zachovejte tuto původní identitu v krocích stavu a výsledku a poté uložte dokončený klip pro kontrolu a střih. Ponechte portrét, prompt a výsledné video jako jeden záznam, aby bylo možné pozdější záběr porovnat se skutečným materiálem, který vedl dřívější výsledek.
Kontrolujte postavu během celé sekvence včetně otočení, gest a změn zarámování. Zkontrolujte konzistenci obličeje, čitelnost zamýšlené akce a vztah mezi postavou a předměty ve scéně. Vyberte klip nejlépe sloužící účelu záběru a před revizí vstupu určete každý konkrétní nesoulad. Postup s opakující se postavou těží z kontroly několika dokončených záběrů vedle sebe se stejnou portrétní referencí a jasným záznamem popisu každé scény.
Ailoot Ultra · Tvorba videa POST /v1/videos minimaxi-s2v-01
minimaxi-s2v-01Úvod
S2V 01 používá portrétní referenci k vedení postavy v nově generovaném videu. Dodejte jeden jasný obrázek obličeje a popište scénu i akci; referenční postup výrobce pro hlavní objekt považuje obrázek za referenci postavy.
- Přijímané vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Tvorba videa POST /v1/videos
- Vstup
text,image- Výstup
video
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity minimaxi-s2v-01 Podmínky: Použijte přesný identifikátor modelu Ailoot. | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Podmínky: Popište scénu a pohyb. | Výchozí— |
Poleend_image | Typstring | PožadavekVolitelné | Hodnoty a limity Podmínky: Koncový snímek se uplatní pouze v podporovaném režimu obrazového vstupu. | Výchozí— |
Poleimage | Typstring or array<string> | PožadavekVolitelné | Hodnoty a limity Podmínky: Použijte skutečnou veřejně dostupnou URL obrázku nebo řetězec obrázku v base64; žádný maximální počet obrázků se zde neuvádí. | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional | Kontraktend_image, image |
Parametrmaterial_types | Kontrakttext, image |
Parametrconditions | KontraktPoužijte přesný identifikátor modelu Ailoot., Popište scénu a pohyb., Koncový snímek se uplatní pouze v podporovaném režimu obrazového vstupu., Použijte skutečnou veřejně dostupnou URL obrázku nebo řetězec obrázku v base64; žádný maximální počet obrázků se zde neuvádí. |
Aliasy metody: /v1/videos/generations
Životní cyklus: 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}
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Množství pro účtování | Poplatek |
|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Množství pro účtování— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceZa požadavek | Tabulka sazeb— | Předpokládané množství— | Množství pro účtováníjeden požadavek | Poplatek Vstup · Odhad pouze pro srovnání $1.4 za požadavek |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Množství pro účtování— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $1.4 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
Ailoot Ultra · Tvorba videa
# 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
Přijímání a ukládání výsledků
Ailoot Ultra · Tvorba videa
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}
Uchovejte všechny dokončené výsledky
Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Uchovejte celou odpověď a hlavičky, původní identifikátory, každý skutečný výstup a všechna pole využití a účtování. Uložte každý jedinečný soubor spravovaný službou a zachovejte každou roli, která na něj odkazuje.
Pokud je nutné ověřit původní odpověď
Uchovejte vrácené veřejné id úlohy nebo operace a všechny hlavičky. Načítejte pouze původní úlohu; unknown ani result_pending_check neopravňují k dalšímu vytvoření.
Pole odpovědi
| Pole | Typ |
|---|---|
Poleid | Typstring |
Polepolling_url | Typstring |
Poleprovider_task_id | Typstring |
Poletask_id | Typstring |
Polestatus | Typstring |
Polevideo_url | Typstring |
Aliasy
Aliasy modelu
Ailoot Ultra minimaxi-s2v-01
Aliasy cest metod
/v1/videos/generations
Související ID modelů
FAQ · MiniMax: S2V 01
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·minimaxi-s2v-01:text,image→video- Jaká pole požadavek používá?
POST /v1/videos·minimaxi-s2v-01:model,prompt,end_image,image