MiniMax: S2V 01
S2V 01 bruger en portrætreference til at styre en figur i en nygenereret video. Giv ét tydeligt ansigtsbillede, og beskriv scenen og handlingen; producentens motivreferencearbejdsgang behandler billedet som en figurreference.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
S2V 01 er MiniMax’ videomodel med motivreference. Det leverede billede styrer en figurs udseende, mens teksten beskriver videoscenen og handlingen. Den dokumenterede referencetype er en persons ansigt, så forbered portrættet som en identitetsvejledning til den figur, du vil placere i den genererede sekvens.
Vælg en reference, hvor det tilsigtede ansigt er tydeligt og let at skelne. Undgå at skjule afgørende træk bag en hånd, et stort tilbehør eller en kraftig beskæring, når trækkene er vigtige for resultatet. Hold portrættet ensartet på tværs af relaterede optagelser, så den kilde, der bruges til at styre figuren, forbliver kendt. Referencen giver oplysninger om udseende; brug prompten til at forklare den scene, figuren skal udføre.
Producentens motivreferenceskema accepterer ét billede i referencebilledarrayet. Understøttede formater er JPG, JPEG, PNG og WebP med en filstørrelse under 20 MB. Den korte side skal overstige 300 pixels, og billedformatet skal være mellem 2:5 og 5:2. Gem den præcise billedfil sammen med genereringsregistreringen frem for at erstatte den med et andet portræt ved en senere sammenligning.
Beskriv en scene med en klar rolle for den refererede person. Figuren kan f.eks. gå ind i et stille værksted, kigge på et objekt på bordet og standse ved siden af det. Angiv den handling, de omgivelser og den synsvinkel, der er vigtige for den færdige optagelse. Planlæg billedudsnittet og bevægelsen omkring kravet, hvis ansigtet skal forblive tydeligt.
Tekstbeskrivelsen understøtter op til 2.000 tegn. Brug tegnene til konkrete instruktioner: hvad figuren gør, hvad der omgiver den, og hvad slutvisningen skal vise. Beskriv tøj eller scenedetaljer, når de er vigtige for fortællingen, og undersøg derefter, hvordan den genererede video kombinerer dem med den leverede identitetsreference. Hold referencens rolle adskilt fra en anmodning om at gengive hele portrættets baggrund som åbningsbillede.
Automatisk promptoptimering er dokumenteret og aktiveret som standard. Den kan deaktiveres, når tættere kontrol med den skriftlige beskrivelse kræves. Bevar det valg sammen med teksten og portrættet, når forskellige scener sammenlignes. Hold scenebeskrivelsen konstant, mens en forbedret reference sammenlignes, for at undersøge et lighedsproblem; hold referencen konstant, mens bevægelsesbeskrivelsen revideres, for at undersøge handlingen.
Producentens arbejdsgang returnerer en opgaveidentitet, før videoen er færdig. Bevar den oprindelige identitet gennem status- og resultattrinnene, og gem derefter det færdige klip til undersøgelse og redigering. Gem portrættet, prompten og den resulterende video som én registrering, så en senere optagelse kan sammenlignes med det faktiske materiale, der styrede det tidligere resultat.
Gennemgå figuren gennem hele sekvensen, herunder drejninger, gestus og ændringer i billedudsnit. Kontrollér ansigtskonsistens, tydeligheden af den tilsigtede handling og forholdet mellem figuren og sceneobjekterne. Vælg det klip, der bedst tjener optagelsens formål, og identificér enhver konkret afvigelse, før inputtet revideres. En arbejdsgang med en tilbagevendende figur har gavn af at gennemgå flere færdige optagelser side om side med samme portrætreference og en klar registrering af hver scenebeskrivelse.
Ailoot Ultra · Videoer POST /v1/videos minimaxi-s2v-01
minimaxi-s2v-01Start
S2V 01 bruger en portrætreference til at styre en figur i en nygenereret video. Giv ét tydeligt ansigtsbillede, og beskriv scenen og handlingen; producentens motivreferencearbejdsgang behandler billedet som en figurreference.
- Accepterede input
- Tekst · Billeder
- Resultater
- Video
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Videoer POST /v1/videos
- Inputtyper
text,image- Outputtyper
video
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser minimaxi-s2v-01 Betingelser: Brug den præcise Ailoot-modelvælger. | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Betingelser: Beskriv scenen og bevægelsen. | Standard— |
Feltend_image | Typestring | KravValgfrit | Værdier og grænser Betingelser: Et slutbillede gælder kun i en understøttet tilstand med billedinput. | Standard— |
Feltimage | Typestring or array<string> | KravValgfrit | Værdier og grænser Betingelser: Brug en faktisk offentligt tilgængelig URL til et billede eller en base64-billedstreng; der angives ikke noget maksimalt antal billeder her. | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parameteroptional | Kontraktend_image, image |
Parametermaterial_types | Kontrakttext, image |
Parameterconditions | KontraktBrug den præcise Ailoot-modelvælger., Beskriv scenen og bevægelsen., Et slutbillede gælder kun i en understøttet tilstand med billedinput., Brug en faktisk offentligt tilgængelig URL til et billede eller en base64-billedstreng; der angives ikke noget maksimalt antal billeder her. |
Metodealiaser: /v1/videos/generations
Livscyklus: 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
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregnet mængde | Beløb |
|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregnet mængde— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationPr. forespørgsel | Takstplan— | Forventet mængde— | Afregnet mængdeén forespørgsel | Beløb Input · Estimat kun til sammenligning $1.4 pr. anmodning |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregnet mængde— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $1.4 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Videoer
# 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
Hent og gem resultater
Ailoot Ultra · Videoer
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 færdige resultater
Gem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Behold hele svaret og alle headere, de oprindelige identifikatorer, hvert faktisk output og alle felter til forbrug og afregning. Gem hvert entydigt aktiv, du ejer, og behold alle roller, der henviser til det.
Hvis det oprindelige svar skal kontrolleres
Behold det returnerede offentlige opgave- eller operations-id og alle headere. Læs kun den oprindelige opgave; unknown eller result_pending_check giver ikke tilladelse til en ny oprettelse.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltpolling_url | Typestring |
Feltprovider_task_id | Typestring |
Felttask_id | Typestring |
Feltstatus | Typestring |
Feltvideo_url | Typestring |
Aliaser
Modelaliaser
Ailoot Ultra minimaxi-s2v-01
Aliaser for metodestier
/v1/videos/generations
Relaterede kalder-ID’er
FAQ · MiniMax: S2V 01
- Hvilke input og resultater er tilgængelige?
POST /v1/videos·minimaxi-s2v-01:text,image→video- Hvilke felter bruger anmodningen?
POST /v1/videos·minimaxi-s2v-01:model,prompt,end_image,image