- Wann verwendet man Hunyuan Video Fast und wann das Standard-Modell?
- Schritt 1: Holen Sie Ihren Novita AI API-Schlüssel
- Schritt 2: Endpunkt und Modell-ID
- Schritt 3: Senden Sie Ihre erste Anfrage
- Schritt 4: Fragen Sie das Video-Ergebnis ab
- Python-Beispiel
- cURL-Beispiel
- Wichtige Parameter
- Preise und Limits
- Fehlerbehebung
- FAQ
- Empfohlene Artikel
Hunyuan Video Fast ist auf Novita AI unter POST https://api.novita.ai/v3/async/hunyuan-video-fast verfügbar. Es handelt sich um die geschwindigkeitsoptimierte Variante von Tencent’s Open-Source-Basismodell Hunyuan Video – die Erzeugungszeit wird im Vergleich zur Standardversion reduziert, auf Kosten einer geringeren Bewegungsgenauigkeit. Damit eignet es sich für Hochdurchsatz-Pipelines, Prompt-Iteration und Staging-Workflows, bei denen die schnelle Fertigstellung wichtiger ist als höchste filmische Qualität.
Wie alle asynchronen Novita-Video-APIs gibt es bei der Einreichung eine task_id zurück und liefert die Video-URL, sobald die Aufgabe abgeschlossen ist. Dieser Leitfaden behandelt den Endpunkt, das Anfrageformat, funktionierende Python- und cURL-Beispiele sowie die Frage, wann die schnelle Variante im Vergleich zum Standardmodell verwendet wird.
Wann verwendet man Hunyuan Video Fast und wann das Standard-Modell?
Die schnelle Variante ist die richtige Wahl, wenn die Generierungszeit und das Anfragevolumen wichtiger sind als die beste visuelle Qualität. Das Standard-Hunyuan-Video liefert eine höhere Bewegungsgenauigkeit und eine bessere Prompt-Erfüllung pro Generierung. Die schnelle Variante verkürzt diese Zeit deutlich – nützlich für:
- Prompt-Iteration – viele Variationen günstig testen, bevor man sich für eine vollwertige Renderung entscheidet
- Hochdurchsatz-Pipelines – Batch-Inhaltserstellung, bei der die Latenz pro Clip direkt den Durchsatz beeinflusst
- Staging und interne Überprüfung – schnell teilbare Ergebnisse erhalten, dann für die endgültige Auslieferung auf Standard umschalten
- Niedriglatenz-Anwendungen – Produktions-Workflows mit knappen Antwortzeitbudgets
Wenn die Ausgabequalität die primäre Einschränkung ist – Rundfunk, Endauslieferung oder fotorealistische Bewegung – verwenden Sie stattdessen den Standard-Endpunkt Hunyuan Video.
Schritt 1: Holen Sie Ihren Novita AI API-Schlüssel
Melden Sie sich bei novita.ai an und generieren Sie einen API-Schlüssel auf der Schlüsselverwaltungsseite. Neue Konten erhalten kostenloses Guthaben. Speichern Sie den Schlüssel als Umgebungsvariable – niemals fest im Quellcode codieren.
export NOVITA_API_KEY="your_api_key_here"
Schritt 2: Endpunkt und Modell-ID
| Feld | Wert |
|---|---|
| Submit-Endpunkt | POST https://api.novita.ai/v3/async/hunyuan-video-fast |
| Ergebnisabruf | GET https://api.novita.ai/v3/async/task-result?task_id=<id> |
| Auth-Header | Authorization: Bearer $NOVITA_API_KEY |
| Content-Type | application/json |
Offizielle API-Referenz: novita.ai/docs/api-reference/model-apis-hunyuan-video-fast
Schritt 3: Senden Sie Ihre erste Anfrage
Senden Sie eine Generierungsanfrage mit Ihrem Prompt und den Ausgabeeinstellungen:
curl -s -X POST https://api.novita.ai/v3/async/hunyuan-video-fast \
-H "Authorization: Bearer $NOVITA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A red fox running through a snowy forest at dawn, slow motion, cinematic wide shot",
"negative_prompt": "blurry, low quality, distorted, watermark",
"width": 1280,
"height": 720,
"seed": -1
}'
Die API gibt sofort eine task_id zurück:
{
"task_id": "hunyuan-fast-abc123"
}
Das Video ist nicht in dieser Antwort – speichern Sie die task_id und verwenden Sie sie im nächsten Schritt.
Schritt 4: Fragen Sie das Video-Ergebnis ab
curl -s "https://api.novita.ai/v3/async/task-result?task_id=hunyuan-fast-abc123" \
-H "Authorization: Bearer $NOVITA_API_KEY"
Wiederholen Sie die Abfrage, bis task_status den Wert TASK_STATUS_SUCCEED hat:
{
"task_status": "TASK_STATUS_SUCCEED",
"videos": [
{
"video_url": "https://cdn.novitai.com/output/...",
"video_url_ttl": 3600,
"video_type": "mp4"
}
]
}
Laden Sie video_url umgehend herunter oder speichern Sie sie – sie verfällt nach video_url_ttl Sekunden.
Task-Status-Werte
| Status | Bedeutung |
|---|---|
TASK_STATUS_QUEUED |
Anfrage angenommen, wartet auf Ausführung |
TASK_STATUS_PROCESSING |
Generierung läuft |
TASK_STATUS_SUCCEED |
Abgeschlossen – Video-URL verfügbar in videos[0].video_url |
TASK_STATUS_FAILED |
Generierung fehlgeschlagen – überprüfen Sie die Antwort auf einen Fehlergrund |
Python-Beispiel
import os
import time
import requests
API_KEY = os.environ["NOVITA_API_KEY"]
BASE_URL = "https://api.novita.ai"
HEADERS = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
def submit_video(
prompt: str,
negative_prompt: str = "",
width: int = 1280,
height: int = 720,
seed: int = -1,
) -> str:
payload = {
"prompt": prompt,
"negative_prompt": negative_prompt,
"width": width,
"height": height,
"seed": seed,
}
resp = requests.post(
f"{BASE_URL}/v3/async/hunyuan-video-fast",
headers=HEADERS,
json=payload,
)
resp.raise_for_status()
return resp.json()["task_id"]
def poll_result(task_id: str, interval: int = 5, timeout: int = 300) -> dict:
deadline = time.time() + timeout
while time.time() < deadline:
resp = requests.get(
f"{BASE_URL}/v3/async/task-result",
headers=HEADERS,
params={"task_id": task_id},
)
resp.raise_for_status()
data = resp.json()
status = data.get("task_status", "")
if status == "TASK_STATUS_SUCCEED":
return data
if status == "TASK_STATUS_FAILED":
raise RuntimeError(f"Task failed: {data}")
time.sleep(interval)
raise TimeoutError(f"Task {task_id} did not complete within {timeout}s")
if __name__ == "__main__":
task_id = submit_video(
prompt="A red fox running through a snowy forest at dawn, slow motion, cinematic wide shot",
negative_prompt="blurry, low quality, distorted, watermark",
width=1280,
height=720,
)
print(f"Task submitted: {task_id}")
result = poll_result(task_id)
for video in result.get("videos", []):
print(f"Video URL (expires in {video['video_url_ttl']}s): {video['video_url']}")
cURL-Beispiel
# Schritt 1: Senden Sie die Generierungsanfrage
TASK_ID=$(curl -s -X POST https://api.novita.ai/v3/async/hunyuan-video-fast \
-H "Authorization: Bearer $NOVITA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A timelapse of a city skyline transitioning from dusk to night, cinematic",
"negative_prompt": "blurry, low quality, distorted",
"width": 1280,
"height": 720,
"seed": 42
}' | jq -r '.task_id')
echo "Task ID: $TASK_ID"
# Schritt 2: Abfragen, bis abgeschlossen
while true; do
RESULT=$(curl -s "https://api.novita.ai/v3/async/task-result?task_id=$TASK_ID" \
-H "Authorization: Bearer $NOVITA_API_KEY")
STATUS=$(echo "$RESULT" | jq -r '.task_status')
if [ "$STATUS" = "TASK_STATUS_SUCCEED" ]; then
echo "$RESULT" | jq -r '.videos[0].video_url'
break
elif [ "$STATUS" = "TASK_STATUS_FAILED" ]; then
echo "Failed: $RESULT"
break
fi
echo "Status: $STATUS — waiting..."
sleep 5
done
Wichtige Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
prompt |
string | Ja | Textbeschreibung der Videoszene, des Motivs, der Bewegung und des Stils |
negative_prompt |
string | Nein | Elemente, die in der Ausgabe vermieden werden sollen (z. B. „blurry, low quality“) |
width |
integer | Nein | Ausgabebreite in Pixeln – prüfen Sie die API-Dokumentation für unterstützte Werte |
height |
integer | Nein | Ausgabehöhe in Pixeln – zusammen mit width zur Auflösungsfestlegung |
seed |
integer | Nein | Fester ganzzahliger Wert zur Reproduktion derselben Ausgabe; -1 für Zufall |
Eine vollständige Parameterliste mit Optionen zur Dauer, maximalen Auflösungseinschränkungen und modellspezifischen Feldern finden Sie in der Hunyuan Video Fast API-Referenz.
Preise und Limits
Überprüfen Sie die aktuellen Preise pro Video auf der Novita AI Modellseite. Die Videogenerierungspreise werden in der Regel pro generiertem Clip berechnet und variieren je nach Auflösung und Dauer. Überprüfen Sie die Preisseite, bevor Sie ein Kostenmodell für Produktions-Workloads erstellen.
Bestätigen Sie vor der Bereitstellung die folgenden Limits in der offiziellen Dokumentation:
- Maximale Prompt-Zeichenlänge
- Unterstützte Auflösungswerte (Kombinationen aus Breite × Höhe)
- Maximale Videodauer in Sekunden
- Ratenlimits und gleichzeitige Aufgabenlimits pro API-Schlüssel
Die schnelle Variante kostet pro Clip in der Regel weniger als das Standardmodell aufgrund der reduzierten Rechenzeit – überprüfen Sie die aktuelle Differenz auf der Novita-Preisseite.
Fehlerbehebung
401 Unauthorized – Der API-Schlüssel fehlt, ist ungültig oder abgelaufen. Stellen Sie sicher, dass NOVITA_API_KEY gesetzt und der Schlüssel in Ihrem Novita AI Dashboard aktiv ist.
422 Unprocessable Entity – Ein erforderlicher Parameter fehlt oder ein Wert liegt außerhalb des gültigen Bereichs. Stellen Sie sicher, dass prompt nicht leer ist und dass die Werte für width/height im unterstützten Satz der API-Dokumentation liegen.
Aufgabe bleibt in TASK_STATUS_PROCESSING – Die Generierung läuft noch. Die schnelle Variante wird schneller abgeschlossen als die Standardversion, aber höhere Auflösungen und längere Dauern benötigen mehr Zeit. Erhöhen Sie Ihr Abfrage-Timeout für große Ausgaben.
video_url gibt 403 oder 404 zurück – Die URL ist abgelaufen (video_url_ttl abgelaufen). Laden Sie in der Produktion das Video sofort nach TASK_STATUS_SUCCEED herunter oder übertragen Sie es – verlassen Sie sich nicht auf die gehostete URL als dauerhaften Speicher.
Durchgängige Qualitätsprobleme bei bestimmten Prompt-Typen – Wechseln Sie zur Verfeinerung des prompt: Beschreiben Sie das Subjekt, die Aktion, den Kamerawinkel und den Stil explizit. Fügen Sie negative_prompt-Einträge für häufige Artefakte hinzu. Reicht die Qualität für den Anwendungsfall immer noch nicht aus, evaluieren Sie den Standard-Hunyuan-Video-Endpunkt.
FAQ
Was ist der Novita AI-Endpunkt für Hunyuan Video Fast?
POST https://api.novita.ai/v3/async/hunyuan-video-fast. Die API ist asynchron: Senden Sie eine Anfrage, erhalten Sie eine task_id, fragen Sie dann GET https://api.novita.ai/v3/async/task-result?task_id=<id> ab, bis task_status TASK_STATUS_SUCCEED ist.
Wie unterscheidet sich Hunyuan Video Fast vom Standard-Hunyuan-Video?
Die schnelle Variante ist auf Generierungsgeschwindigkeit optimiert – sie reduziert die Zeit von der Aufgabeneinreichung bis zum fertigen Video. Der Nachteil ist, dass die Bewegungsgenauigkeit und die feinkörnige Prompt-Erfüllung geringer sind als beim Standardmodell. Verwenden Sie die schnelle Variante für Prompt-Iteration, Hochdurchsatz-Batch-Jobs oder Staging; verwenden Sie die Standardvariante für qualitativ hochwertige Ausgabe.
Kann ich eine bestimmte Videodauer festlegen?
Überprüfen Sie die API-Referenz auf unterstützte Dauerparameter. Einige Novita-Video-APIs bieten ein explizites duration-Feld; andere verwenden einen modellspezifischen Standardwert. Vergewissern Sie sich vor der Annahme einer Standard-Clip-Länge.
Wie reproduziere ich eine bestimmte Videoausgabe?
Setzen Sie seed auf einen festen ganzzahligen Wert. Die gleiche Kombination aus seed, prompt, width und height sollte über mehrere Läufe hinweg konsistente Ausgaben erzeugen.
Unterstützt Hunyuan Video Fast Bild-zu-Video?
Hunyuan Video Fast auf Novita AI ist ein Text-zu-Video-Modell. Für Bild-zu-Video-Generierung auf Novita prüfen Sie die verfügbaren I2V-Modelle wie Kling, Vidu oder Wan auf der Novita-Modellseite.
Wie viel kostet Hunyuan Video Fast auf Novita AI?
Überprüfen Sie die aktuellen Preise auf novita.ai/models. Die Preise pro Clip für Videomodelle können sich ändern; überprüfen Sie immer die Preisseite, bevor Sie Produktionskostenschätzungen erstellen.
Ist Hunyuan Video Fast für Produktions-Video-Pipelines geeignet?
Ja, mit entsprechender Handhabung. Gestalten Sie Ihre Pipeline rund um asynchrone Aufgabeneinreichung, speichern Sie die task_id für die Statusverfolgung, laden Sie das Video sofort nach Abschluss herunter (bevor video_url_ttl abläuft) und behandeln Sie TASK_STATUS_FAILED mit einer Wiederholungs- oder Fallback-Strategie.
