PixVerse v4
Tekst/beeld-naar-video met 5/8 seconden, vijf beeldverhoudingen en 360p–1080p-kwaliteit.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
pixverse-v4 accepteert tekst en een optioneel referentiebeeld voor video. aspect_ratio biedt 16:9, 4:3, 1:1, 3:4 en 9:16; quality accepteert 360p, 540p, 720p of 1080p. Duration is 5 of 8 seconden. Maak bijvoorbeeld een verticaal productshot uit een referentiebeeld voor een korte socialmontage.
/v1/videos noemt ook motion_mode normal of fast, negative_prompt en optioneel end_image. Lipsyncvelden zijn apart benoemde instellingen en moeten hun methodedefinities volgen, geen aangenomen algemene audio-uploadworkflow. Kies combinaties die het verzoek ondersteunt. Haal de oorspronkelijke taak en elke echte uitvoer op; fast is een bewegingsmodus, geen gemeten garantie voor generatietijd.
Ailoot Ultra · Video POST /v1/videos pixverse-v4
pixverse-v4Aan de slag
Tekst/beeld-naar-video met 5/8 seconden, vijf beeldverhoudingen en 360p–1080p-kwaliteit.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Video
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Video POST /v1/videos
- Invoertypen
text,image- Uitvoertypen
video
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten pixverse-v4 Voorwaarden: Gebruik exact deze Ailoot-routeringsselector. | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Voorwaarden: Beschrijf de scène en de beweging daarin. | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 16:9, 4:3, 1:1, 3:4, 9:16 Voorwaarden: Gebruik een van de vermelde beeldverhoudingen van het geselecteerde model. | Standaard— |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten 360p, 540p, 720p, 1080p Voorwaarden: Gebruik de vermelde kwaliteitswaarde van het geselecteerde model. | Standaard— |
Veldmotion_mode | Typestring | VereisteOptioneel | Waarden en limieten normal, fast Voorwaarden: Gebruik de vermelde bewegingsmodus van het geselecteerde model. | Standaard— |
Veldduration | Typeinteger | VereisteOptioneel | Waarden en limieten 5, 8 Voorwaarden: Gebruik een vermelde duur; er is geen ongedocumenteerde standaardwaarde. | Standaard— |
Veldend_image | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Met een optioneel eindframe kiest u een ondersteunde afbeeldingsmodus. | Standaard— |
Veldlip_sync_tts_content | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Optionele spraakinhoud voor het geselecteerde model. | Standaard— |
Veldlip_sync_tts_speaker_id | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Gebruik een bestaande stem-ID die door de provider wordt ondersteund; verzin geen stem-ID. | Standaard— |
Veldimage | Typestring or array<string> | VereisteOptioneel | Waarden en limieten Voorwaarden: Gebruik uw werkelijk openbaar bereikbare afbeeldings-URL of een base64-afbeelding; het geselecteerde model ondersteunt afbeeldingsinvoer. | Standaard— |
Veldnegative_prompt | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Beschrijf de inhoud die moet worden vermeden. | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parameteroptional | Contractaspect_ratio, quality, motion_mode, duration, end_image, lip_sync_tts_content, lip_sync_tts_speaker_id, image, negative_prompt |
Parametermaterial_types | Contracttext, image |
Parameterconditions | ContractGebruik exact deze Ailoot-routeringsselector., Beschrijf de scène en de beweging daarin., Gebruik een van de vermelde beeldverhoudingen van het geselecteerde model., Gebruik de vermelde kwaliteitswaarde van het geselecteerde model., Gebruik de vermelde bewegingsmodus van het geselecteerde model., Gebruik een vermelde duur; er is geen ongedocumenteerde standaardwaarde., Met een optioneel eindframe kiest u een ondersteunde afbeeldingsmodus., Optionele spraakinhoud voor het geselecteerde model., Gebruik een bestaande stem-ID die door de provider wordt ondersteund; verzin geen stem-ID., Gebruik uw werkelijk openbaar bereikbare afbeeldings-URL of een base64-afbeelding; het geselecteerde model ondersteunt afbeeldingsinvoer., Beschrijf de inhoud die moet worden vermeden. |
Methodealiasnamen: /v1/videos/generations
Levenscyclus: 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}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.2 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
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
Resultaten ophalen en opslaan
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}
Alle voltooide resultaten bewaren
Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Bewaar het volledige antwoord en de headers, de oorspronkelijke identificaties, alle daadwerkelijke uitvoer en alle gebruiks-/afrekenvelden. Sla elke unieke asset op die u bezit en behoud elke rol die ernaar verwijst.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde openbare taak- of operatie-id en alle headers. Lees uitsluitend de oorspronkelijke taak; unknown of result_pending_check geeft geen toestemming voor een nieuwe aanmaak.
Antwoordvelden
| Veld | Type |
|---|---|
Veldid | Typestring |
Veldpolling_url | Typestring |
Veldprovider_task_id | Typestring |
Veldtask_id | Typestring |
Veldstatus | Typestring |
Veldvideo_url | Typestring |
Aliasnamen
Modelaliasnamen
Ailoot Ultra pixverse-v4
Aliasnamen voor methodepaden
/v1/videos/generations
Gerelateerde aanroeper-ID’s
FAQ · PixVerse v4
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/videos·pixverse-v4:text,image→video- Welke velden gebruikt het verzoek?
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