PixVerse v4
Text/bild-till-video med 5/8 sekunder, fem bildformat och kvalitetsval från 360p till 1080p.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
pixverse-v4 tar text och valfri referensbild för videogenerering. aspect_ratio kan vara 16:9, 4:3, 1:1, 3:4 och 9:16; quality accepterar 360p, 540p, 720p eller 1080p. Duration är 5 eller 8 sekunder. Ett konkret användningsfall är en stående produktscen från referensbild för kort socialt klipp.
Metoden /v1/videos listar också motion_mode som normal eller fast samt negative_prompt och valfri end_image. Läppsynksfält är separata namngivna kontroller som ska följa metoddefinitionerna snarare än antaget allmänt ljuduppladdningsflöde. Välj kombinationer som förfrågan stöder. Hämta ursprungligt jobb och varje faktisk utdata; fast är ett rörelselägesvärde, inte uppmätt genereringstidsgaranti.
Ailoot Ultra · Video POST /v1/videos pixverse-v4
pixverse-v4Start
Text/bild-till-video med 5/8 sekunder, fem bildformat och kvalitetsval från 360p till 1080p.
- Godkända indata
- Text · Bilder
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Video POST /v1/videos
- Indatatyper
text,image- Utdatatyper
video
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser pixverse-v4 Villkor: Använd exakt denna routningsväljare för Ailoot. | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Villkor: Beskriv scenen och dess rörelse. | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 16:9, 4:3, 1:1, 3:4, 9:16 Villkor: Använd ett av de angivna bildförhållandena för den valda modellen. | Standard— |
Fältquality | Typstring | KravValfritt | Värden & gränser 360p, 540p, 720p, 1080p Villkor: Använd det angivna kvalitetsvärdet för den valda modellen. | Standard— |
Fältmotion_mode | Typstring | KravValfritt | Värden & gränser normal, fast Villkor: Använd det angivna rörelseläget för den valda modellen. | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser 5, 8 Villkor: Använd en angiven längd; inget standardvärde förutsätts om det inte anges. | Standard— |
Fältend_image | Typstring | KravValfritt | Värden & gränser Villkor: En valfri slutbild väljer ett bildläge som stöds. | Standard— |
Fältlip_sync_tts_content | Typstring | KravValfritt | Värden & gränser Villkor: Valfritt talinnehåll för den valda modellen. | Standard— |
Fältlip_sync_tts_speaker_id | Typstring | KravValfritt | Värden & gränser Villkor: Använd ett verkligt röst-ID som leverantören stöder; röst-ID:n får inte hittas på. | Standard— |
Fältimage | Typstring or array<string> | KravValfritt | Värden & gränser Villkor: Använd bildens verkliga, offentligt tillgängliga URL eller en base64-bild; den valda modellen stöder bilder som indata. | Standard— |
Fältnegative_prompt | Typstring | KravValfritt | Värden & gränser Villkor: Beskriv innehåll som ska undvikas. | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parameteroptional | Avtalaspect_ratio, quality, motion_mode, duration, end_image, lip_sync_tts_content, lip_sync_tts_speaker_id, image, negative_prompt |
Parametermaterial_types | Avtaltext, image |
Parameterconditions | AvtalAnvänd exakt denna routningsväljare för Ailoot., Beskriv scenen och dess rörelse., Använd ett av de angivna bildförhållandena för den valda modellen., Använd det angivna kvalitetsvärdet för den valda modellen., Använd det angivna rörelseläget för den valda modellen., Använd en angiven längd; inget standardvärde förutsätts om det inte anges., En valfri slutbild väljer ett bildläge som stöds., Valfritt talinnehåll för den valda modellen., Använd ett verkligt röst-ID som leverantören stöder; röst-ID:n får inte hittas på., Använd bildens verkliga, offentligt tillgängliga URL eller en base64-bild; den valda modellen stöder bilder som indata., Beskriv innehåll som ska undvikas. |
Metodalias: /v1/videos/generations
Livscykel: 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å beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.2 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "pixverse-v4",
"prompt": "A cat is walking on grass."
}
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
Ta emot och spara resultat
Ailoot Ultra · Video
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}
Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Behåll hela svaret och svarshuvudena, ursprungliga identifierare, varje faktiskt resultat och alla förbruknings- och redovisningsfält. Spara varje unik tillgång som du äger och behåll varje roll som pekar på den.
Om det ursprungliga svaret behöver kontrolleras
Behåll det returnerade offentliga uppgifts- eller operations-id:t och samtliga svarshuvuden. Läs endast den ursprungliga uppgiften; unknown eller result_pending_check ger inte tillstånd att skapa på nytt.
Svarsfält
| Fält | Typ |
|---|---|
Fältid | Typstring |
Fältpolling_url | Typstring |
Fältprovider_task_id | Typstring |
Fälttask_id | Typstring |
Fältstatus | Typstring |
Fältvideo_url | Typstring |
Alias
Modellalias
Ailoot Ultra pixverse-v4
Alias för metodsökvägar
/v1/videos/generations
Relaterade anropar-ID:n
FAQ · PixVerse v4
- Vilka indata och resultat finns?
POST /v1/videos·pixverse-v4:text,image→video- Vilka fält använder begäran?
POST /v1/videos·pixverse-v4:model,prompt,aspect_ratio,quality,motion_mode,duration,end_image,lip_sync_tts_content,lip_sync_tts_speaker_id,image,negative_prompt