PixVerse v4
Video aus Text/Bild mit 5/8 Sekunden, fünf Seitenverhältnissen und Qualität von 360p bis 1080p.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
pixverse-v4 nimmt Text und optional ein Referenzbild zur Videogenerierung an. aspect_ratio erlaubt 16:9, 4:3, 1:1, 3:4 und 9:16. quality akzeptiert 360p, 540p, 720p oder 1080p. Die Dauer ist 5 oder 8 Sekunden. Ein konkreter Einsatz erstellt aus einem Referenzbild einen vertikalen Produktshot für einen kurzen Social-Clip.
/v1/videos bietet außerdem motion_mode mit normal oder fast, negative_prompt und optional end_image. Lip-Sync-Felder sind eigene benannte Parameter und folgen ihren Methodendefinitionen statt einem angenommenen allgemeinen Audioupload. Wähle unterstützte Kombinationen der Anfrage. Sammle den ursprünglichen Job und alle tatsächlichen Ausgaben. fast ist ein Bewegungsmodus, keine gemessene Generierungszeitgarantie.
Ailoot Ultra · Video POST /v1/videos pixverse-v4
pixverse-v4Start
Video aus Text/Bild mit 5/8 Sekunden, fünf Seitenverhältnissen und Qualität von 360p bis 1080p.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabetypen
text,image- Ausgabetypen
video
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits pixverse-v4 Bedingungen: Verwenden Sie genau diesen Ailoot-Routingselektor. | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: Beschreiben Sie die Szene und ihre Bewegung. | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 16:9, 4:3, 1:1, 3:4, 9:16 Bedingungen: Verwenden Sie ein für das ausgewählte Modell aufgeführtes Seitenverhältnis. | Standard— |
Feldquality | Typstring | AnforderungOptional | Werte und Limits 360p, 540p, 720p, 1080p Bedingungen: Verwenden Sie den für das ausgewählte Modell aufgeführten Qualitätswert. | Standard— |
Feldmotion_mode | Typstring | AnforderungOptional | Werte und Limits normal, fast Bedingungen: Verwenden Sie den für das ausgewählte Modell aufgeführten Bewegungsmodus. | Standard— |
Feldduration | Typinteger | AnforderungOptional | Werte und Limits 5, 8 Bedingungen: Verwenden Sie eine aufgeführte Dauer; es gibt keinen nicht genannten Standardwert. | Standard— |
Feldend_image | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Ein optionales Endbild wählt einen unterstützten Bildmodus aus. | Standard— |
Feldlip_sync_tts_content | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Optionaler Sprechtext für das ausgewählte Modell. | Standard— |
Feldlip_sync_tts_speaker_id | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Verwenden Sie eine tatsächlich vorhandene, vom Anbieter unterstützte Stimmen-ID; es wird keine Stimmen-ID erfunden. | Standard— |
Feldimage | Typstring or array<string> | AnforderungOptional | Werte und Limits Bedingungen: Verwenden Sie Ihre tatsächliche öffentlich erreichbare Bild-URL oder ein base64-Bild; das ausgewählte Modell unterstützt Bildeingaben. | Standard— |
Feldnegative_prompt | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Beschreiben Sie Inhalte, die vermieden werden sollen. | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional | Vertragaspect_ratio, quality, motion_mode, duration, end_image, lip_sync_tts_content, lip_sync_tts_speaker_id, image, negative_prompt |
Parametermaterial_types | Vertragtext, image |
Parameterconditions | VertragVerwenden Sie genau diesen Ailoot-Routingselektor., Beschreiben Sie die Szene und ihre Bewegung., Verwenden Sie ein für das ausgewählte Modell aufgeführtes Seitenverhältnis., Verwenden Sie den für das ausgewählte Modell aufgeführten Qualitätswert., Verwenden Sie den für das ausgewählte Modell aufgeführten Bewegungsmodus., Verwenden Sie eine aufgeführte Dauer; es gibt keinen nicht genannten Standardwert., Ein optionales Endbild wählt einen unterstützten Bildmodus aus., Optionaler Sprechtext für das ausgewählte Modell., Verwenden Sie eine tatsächlich vorhandene, vom Anbieter unterstützte Stimmen-ID; es wird keine Stimmen-ID erfunden., Verwenden Sie Ihre tatsächliche öffentlich erreichbare Bild-URL oder ein base64-Bild; das ausgewählte Modell unterstützt Bildeingaben., Beschreiben Sie Inhalte, die vermieden werden sollen. |
Methodenaliasnamen: /v1/videos/generations
Lebenszyklus: 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}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebühr |
|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.2 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
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
Ergebnisse abrufen und speichern
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 fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie die vollständige Antwort und die Header, ursprüngliche Kennungen, jede tatsächliche Ausgabe sowie alle Verbrauchs- und Abrechnungsfelder auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und bewahren Sie jede darauf verweisende Rolle auf.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie die zurückgegebene öffentliche Aufgaben- oder Vorgangs-ID und sämtliche Header auf. Lesen Sie ausschließlich die ursprüngliche Aufgabe aus; unknown oder result_pending_check berechtigt nicht zu einer weiteren Erstellung.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldpolling_url | Typstring |
Feldprovider_task_id | Typstring |
Feldtask_id | Typstring |
Feldstatus | Typstring |
Feldvideo_url | Typstring |
Aliasnamen
Modellaliasnamen
Ailoot Ultra pixverse-v4
Aliasnamen für Methodenpfade
/v1/videos/generations
Zugehörige Aufrufer-IDs
FAQ · PixVerse v4
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·pixverse-v4:text,image→video- Welche Felder verwendet die Anfrage?
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