MiniMax: S2V 01
S2V 01 bruker en portrettreferanse til å styre en figur i en nygenerert video. Oppgi ett tydelig ansiktsbilde og beskriv scene og handling; produsentens motivreferanseprosess behandler bildet som en figurreferanse.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
S2V 01 er MiniMax' motivreferansebaserte videomodell. Det oppgitte bildet styrer figurens utseende, mens teksten beskriver videoscenen og handlingen. Den dokumenterte referansetypen er et menneskeansikt, så klargjør portrettet som en identitetsveiledning for figuren du vil plassere i den genererte sekvensen.
Velg en referanse der det tiltenkte ansiktet er tydelig og lett å skille ut. Unngå å skjule kjennetegn bak en hånd, et stort tilbehør eller en kraftig beskjæring når trekkene er viktige for resultatet. Hold portrettet konsistent på tvers av relaterte opptak, slik at kilden som brukes til å styre figuren, forblir kjent. Referansen gir utseendeinformasjon; bruk prompten til å forklare scenen figuren skal opptre i.
Produsentens motivreferanseskjema godtar ett bilde i referansebildelisten. Støttede formater er JPG, JPEG, PNG og WebP, med filstørrelse under 20 MB. Kortsiden må overstige 300 piksler, og sideforholdet må være mellom 2:5 og 5:2. Behold den nøyaktige bildefilen sammen med genereringsposten fremfor å bytte til et annet portrett under en senere sammenligning.
Beskriv en scene med en tydelig rolle for personen i referansen. Figuren kan for eksempel gå inn i et stille verksted, se på et objekt på bordet og stoppe ved siden av det. Angi handlingen, miljøet og synsvinkelen som er viktig for det ferdige opptaket. Hvis ansiktet må forbli tydelig, planlegg utsnitt og bevegelse rundt dette kravet.
Tekstbeskrivelsen støtter opptil 2000 tegn. Bruk tegnene til konkrete instruksjoner: hva figuren gjør, hva som omgir den, og hva sluttvisningen skal vise. Beskriv klær eller scenedetaljer når de er viktige for historien, og undersøk deretter hvordan den genererte videoen kombinerer dem med den oppgitte identitetsreferansen. Hold referanserollen adskilt fra en forespørsel om å gjenskape hele portrettbakgrunnen som åpningsbilde.
Automatisk promptoptimalisering er dokumentert og aktivert som standard. Den kan deaktiveres når nærmere kontroll over den skriftlige beskrivelsen er nødvendig. Behold valget sammen med tekst og portrett når forskjellige scener sammenlignes. For å undersøke et likhetsproblem holdes scenebeskrivelsen uendret mens en forbedret referanse sammenlignes; for å undersøke handlingen holdes referansen uendret mens bevegelsesbeskrivelsen revideres.
Produsentens prosess returnerer en oppgaveidentitet før videoen er ferdig. Behold denne opprinnelige identiteten gjennom status- og resultattrinnene, og lagre deretter det ferdige klippet for gjennomgang og redigering. Behold portrett, prompt og resulterende video som én post, slik at et senere opptak kan sammenlignes med det faktiske materialet som styrte det tidligere resultatet.
Vurder figuren gjennom hele sekvensen, inkludert vendinger, gester og endringer i utsnitt. Kontroller ansiktskonsistens, tydeligheten i ønsket handling og forholdet mellom figuren og sceneobjektene. Velg klippet som best tjener opptakets formål, og identifiser et konkret avvik før inndataene revideres. En prosess med en tilbakevendende figur har nytte av å vurdere flere ferdige opptak side om side, med samme portrettreferanse og en tydelig registrering av hver scenebeskrivelse.
Ailoot Ultra · Videogenerering POST /v1/videos minimaxi-s2v-01
minimaxi-s2v-01Start
S2V 01 bruker en portrettreferanse til å styre en figur i en nygenerert video. Oppgi ett tydelig ansiktsbilde og beskriv scene og handling; produsentens motivreferanseprosess behandler bildet som en figurreferanse.
- Godkjente inndata
- Tekst · Bilder
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Videogenerering POST /v1/videos
- Inndatatyper
text,image- Utdatatyper
video
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser minimaxi-s2v-01 Vilkår: Bruk den eksakte modellvelgeren for Ailoot. | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Vilkår: Beskriv scenen og bevegelsen. | Standard— |
Feltend_image | Typestring | KravValgfritt | Verdier & grenser Vilkår: Et sluttbilde gjelder bare i en støttet modus for bildeinndata. | Standard— |
Feltimage | Typestring or array<string> | KravValgfritt | Verdier & grenser Vilkår: Bruk en faktisk offentlig tilgjengelig URL til bildet eller en bildestreng i base64; det forutsettes ikke noe maksimalt antall bilder her. | Standard— |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parameteroptional | Avtaleend_image, image |
Parametermaterial_types | Avtaletext, image |
Parameterconditions | AvtaleBruk den eksakte modellvelgeren for Ailoot., Beskriv scenen og bevegelsen., Et sluttbilde gjelder bare i en støttet modus for bildeinndata., Bruk en faktisk offentlig tilgjengelig URL til bildet eller en bildestreng i base64; det forutsettes ikke noe maksimalt antall bilder her. |
Metodealiaser: /v1/videos/generations
Livssyklus: 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}
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsmengde | Kostnad |
|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsmengde— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonPer forespørsel | Prisplan— | Forventet mengde— | Faktureringsmengdeén forespørsel | Kostnad Inndata · Estimat kun for sammenligning $1.4 per forespørsel |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsmengde— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $1.4 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Videogenerering
# 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
Motta og lagre resultater
Ailoot Ultra · Videogenerering
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}
Behold alle ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Behold hele svaret og alle svarhoder, opprinnelige identifikatorer, alle faktiske utdata og alle felt for forbruk og avregning. Lagre hver unike ressurs du eier, og behold alle roller som viser til den.
Hvis det opprinnelige svaret må kontrolleres
Behold den returnerte offentlige oppgave- eller operasjons-ID-en og alle svarhoder. Les bare den opprinnelige oppgaven; unknown eller result_pending_check gir ikke tillatelse til en ny opprettelse.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltpolling_url | Typestring |
Feltprovider_task_id | Typestring |
Felttask_id | Typestring |
Feltstatus | Typestring |
Feltvideo_url | Typestring |
Aliaser
Modellaliaser
Ailoot Ultra minimaxi-s2v-01
Aliaser for metodestier
/v1/videos/generations
Tilknyttede anroper-ID-er
FAQ · MiniMax: S2V 01
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·minimaxi-s2v-01:text,image→video- Hvilke felt bruker forespørselen?
POST /v1/videos·minimaxi-s2v-01:model,prompt,end_image,image