Zhipu AI: CogVideoX 3
CogVideoX 3 erzeugt im dokumentierten Herstellerablauf Video aus Text, einem Bild oder einem Paar aus erstem und letztem Einzelbild. Es unterstützt Sequenzen von fünf oder zehn Sekunden, mehrere Ausgabegrössen bis zu 4K, 30 oder 60 fps und optionale erzeugte Toneffekte.
Ü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.
CogVideoX 3 ist Zhipu AIs Videomodell mit dokumentierter Text-zu-Video-, Bild-zu-Video- und Erzeugung aus erstem und letztem Einzelbild. Der Hersteller betont Bildstabilität, Anweisungsbefolgung und realistische oder dreidimensionale Bildstile. Wählen Sie Text, wenn die Szene als schriftlicher Auftrag beginnt, ein Bild, wenn ihre visuelle Grundlage bereits besteht, oder zwei Endpunktbilder, wenn die Sequenz eine definierte Anfangs- und Schlussansicht benötigt.
Beschreiben Sie für einen Textauftrag das Motiv und eine klar erkennbare Handlung. Nennen Sie Umgebung, Blickwinkel und wichtige räumliche Beziehungen, damit die Szene anhand einer klaren Absicht beurteilt werden kann. Eine Figur, die ein Objekt aufhebt, benötigt eine andere Sequenz als eine Kamera, die dieses Objekt enthüllt. Beschreiben Sie beides nur, wenn ihre Beziehung für die Aufnahme wichtig ist.
Bereiten Sie bei einer bildgestützten Sequenz die Referenz so vor, dass die charakteristischen Merkmale des Motivs sichtbar sind. Der Hersteller akzeptiert PNG-, JPEG- und JPG-Bilder bis zu 5 MB, bereitgestellt über eine URL oder kodierte Bilddaten. Bewahren Sie die tatsächliche Referenz zusammen mit dem erzeugten Ergebnis auf, damit Aussehen und Bildausschnitt mit der Quelle statt mit einer erinnerten Version verglichen werden können.
Der Endpunktbildmodus des Herstellers akzeptiert zwei Bilder in dieser Reihenfolge: Das erste bestimmt das Anfangsbild, das zweite das Schlussbild. Bereiten Sie sie als die beiden gewünschten Zustände einer Aufnahme vor. Beschreiben Sie den verbindenden Übergang oder die Handlung und prüfen Sie anschliessend, ob das Motiv zwischen den Endpunkten konsistent bleibt. Ein Paar guter Standbilder zeigt für sich nicht, dass die Bewegung dazwischen zur gewünschten Geschichte passt.
Der Prompt kann bis zu 512 Zeichen enthalten. Verwenden Sie den verfügbaren Text für die Handlung, ihre Richtung und die visuellen Details, die ein erfolgreiches Ergebnis auszeichnen. Halten Sie den Auftrag auf das sichtbare Geschehen ausgerichtet. Wenn Eingabebilder bereits das Motivaussehen bestimmen, beschreiben Sie Bewegung und zeitlichen Ablauf, die sich zwischen diesen Bildern oder aus ihnen entwickeln sollen.
Der Hersteller dokumentiert Ausgaben von fünf oder zehn Sekunden mit fünf Sekunden als Standard sowie 30 oder 60 Bilder pro Sekunde. Unterstützte Grössen umfassen 1’280×720, 720×1’280, 1’024×1’024, 1’920×1’080, 1’080×1’920, 2’048×1’080 und 3’840×2’160. Wählen Sie Grösse und Zeitablauf für das Verwendungsziel und prüfen Sie dann den fertigen Clip auf Bildausschnitt und Tempo der tatsächlichen Handlung.
Modi für Qualität und Geschwindigkeit sind getrennt von der optionalen KI-Toneffekteinstellung dokumentiert. Bewahren Sie diese Auswahl zusammen mit Prompt, Bildern und Ergebnis auf. Die visuellen und Eingabefähigkeiten des Herstellers beschreiben das Modell; die verfügbaren Steuerungen einer bestimmten Generierungsmethode ergeben sich aus den Vorgaben dieser Methode. Erhalten Sie beim Vergleich möglicher Aufnahmen die tatsächlich verwendeten Einstellungen.
Erhalten Sie die ursprüngliche Aufgabenkennung, bis das Video fertig ist, und speichern Sie das zurückgegebene Material für die Bearbeitung. Prüfen Sie die gesamte Sequenz einschliesslich des Motivaussehens bei grösseren Bewegungen, der Interaktionen mit Szenenobjekten und der Schlusskomposition. Prüfen Sie bei Endpunktbildern beide Endpunkte und den Übergang dazwischen. Überarbeiten Sie die konkrete visuelle Abweichung bei Erhalt erfolgreicher Referenzen und des Aufnahmeplans und vergleichen Sie fertige Videos statt nur ihrer Vorschaubilder.
Ailoot Ultra · Videoerzeugung POST /v1/videos cogvideox-3
cogvideox-3Einstieg
CogVideoX 3 erzeugt im dokumentierten Herstellerablauf Video aus Text, einem Bild oder einem Paar aus erstem und letztem Einzelbild. Es unterstützt Sequenzen von fünf oder zehn Sekunden, mehrere Ausgabegrössen bis zu 4K, 30 oder 60 fps und optionale erzeugte Toneffekte.
- Zulässige Eingaben
- Text
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Videoerzeugung POST /v1/videos
- Eingabe
text- Ausgabe
video
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits cogvideox-3 Bedingungen: Verwenden Sie die exakte Modellauswahl von Ailoot. | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: Beschreiben Sie die Szene und die Bewegung. | Standard— |
Feldquality | Typboolean | AnforderungOptional | Werte und Limits Bedingungen: Optionale Qualitätsoption; dieses ausgewählte Schema enthält weder kompatible Enum-Werte noch einen Standardwert. | Standard— |
Feldwith_audio | Typboolean | AnforderungOptional | Werte und Limits Bedingungen: Erzeugt bei Aktivierung KI-Klangeffekte. | Standardfalse |
Feldsize | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Geben Sie bei der Auswahl expliziter Abmessungen die dokumentierte Grössenzeichenkette an. | Standard— |
Feldfps | Typstring | AnforderungOptional | Werte und Limits 30, 60 Bedingungen: Bei dieser ausgewählten nativen Methode wird die Bildrate als Zeichenkette dargestellt. | Standard30 |
Feldduration | Typstring | AnforderungOptional | Werte und Limits 5, 10 Bedingungen: Bei dieser ausgewählten nativen Methode wird die Dauer in Sekunden als Zeichenkette dargestellt. | Standard5 |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional | Vertragquality, with_audio, size, fps, duration |
Parametermaterial_types | Vertragtext |
Parameterconditions | VertragVerwenden Sie die exakte Modellauswahl von Ailoot., Beschreiben Sie die Szene und die Bewegung., Optionale Qualitätsoption; dieses ausgewählte Schema enthält weder kompatible Enum-Werte noch einen Standardwert., Erzeugt bei Aktivierung KI-Klangeffekte., Geben Sie bei der Auswahl expliziter Abmessungen die dokumentierte Grössenzeichenkette an., Bei dieser ausgewählten nativen Methode wird die Bildrate als Zeichenkette dargestellt., Bei dieser ausgewählten nativen Methode wird die Dauer in Sekunden als Zeichenkette dargestellt. |
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 | Abrechnungsmenge | Gebühr |
|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungsmenge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationPro Anfrage | Tarifstaffel— | Prognostizierte Menge— | Abrechnungsmengeeine Anfrage | Gebühr Eingabe · Schätzung nur zum Vergleich $0.3 pro Anfrage |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungsmenge— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.3 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 abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Videoerzeugung
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "cogvideox-3",
"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 · Videoerzeugung
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 samt Headern, ursprünglichen Kennungen, jeder tatsächlichen Ausgabe sowie sämtlichen Verbrauchs- und Abrechnungsfeldern auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und bewahren Sie jede Rolle auf, die darauf verweist.
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 ausschliesslich die ursprüngliche Aufgabe; unknown oder result_pending_check berechtigen nicht zu einer weiteren Erstellung.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldpolling_url | Typstring |
Feldprovider_task_id | Typstring |
Feldid | Typstring |
Feldtask_status | Typstring |
Feldvideo_result[].url | Typstring |
Aliasnamen
Modellaliasnamen
Ailoot Ultra cogvideox-3
Aliasnamen für Methodenpfade
/v1/videos/generations
Zugehörige Aufrufer-IDs
FAQ · Zhipu AI: CogVideoX 3
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·cogvideox-3:text→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·cogvideox-3:model,prompt,quality,with_audio,size,fps,duration