- Wann sollte man Hunyuan Video Fast statt Standard verwenden?
- Schritt 1: Holen Sie sich Ihren Novita-AI-API-Schlüssel
- Schritt 2: Endpunkt und Modell-ID
- Schritt 3: Senden Sie Ihre erste Anfrage
- Schritt 4: Pollen Sie das Videoergebnis
- 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 ist die geschwindigkeitsoptimierte Variante des Open-Source-Basismodells Hunyuan Video von Tencent – es verkürzt die Generierungszeit im Vergleich zur Standardversion, allerdings auf Kosten einer gewissen Bewegungsgenauigkeit. Dadurch eignet es sich für Pipelines mit hohem Durchsatz, Prompt-Iterationen und Staging-Workflows, bei denen die Bearbeitungszeit wichtiger ist als eine maximale filmische Qualität.
Wie alle asynchronen Video-APIs von Novita 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, wo die schnelle Variante im Vergleich zum Standardmodell eingesetzt wird.
Wann sollte man Hunyuan Video Fast statt Standard verwenden?
Die schnelle Variante ist die richtige Wahl, wenn die Generierungszeit und das Anfragevolumen wichtiger sind als die höchste visuelle Qualität. Das Standard-Hunyuan-Video erzeugt Bewegungen mit höherer Wiedergabetreue und eine bessere Prompt-Befolgung pro Generierung. Die schnelle Variante reduziert diese Zeit erheblich – nützlich für:
- Prompt-Iteration – testen Sie viele Variationen kostengünstig, bevor Sie sich für einen Render in voller Qualität entscheiden.
- Pipelines mit hohem Durchsatz – Batch-Inhaltsgenerierung, bei der die Latenz pro Clip den Durchsatz direkt beeinflusst.
- Staging und interne Überprüfung – schnell teilbares Ergebnis erhalten und für die endgültige Bereitstellung auf Standard umstellen.
- Anwendungen mit geringer Latenz – Produktionsworkflows mit engen Antwortzeit-Budgets.
Wenn die Ausgabequalität die oberste Priorität hat – Rundfunk, Endauslieferung oder fotorealistische Bewegungen – verwenden Sie stattdessen den Standard-Endpunkt Hunyuan Video.
Schritt 1: Holen Sie sich Ihren Novita-AI-API-Schlüssel
Registrieren Sie sich unter novita.ai und generieren Sie einen API-Schlüssel auf der Schlüsselverwaltungsseite. Neue Konten erhalten kostenloses Guthaben. Speichern Sie den Schlüssel als Umgebungsvariable – hardcoden Sie ihn niemals in Quelldateien.
export NOVITA_API_KEY="your_api_key_here"
Schritt 2: Endpunkt und Modell-ID
| Feld | Wert |
|---|---|
| Übermittlungsendpunkt | POST https://api.novita.ai/v3/async/hunyuan-video-fast |
| Ergebnisabruf | GET https://api.novita.ai/v3/async/task-result?task_id=<id> |
| Authorization-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 in dieser Antwort nicht enthalten – speichern Sie die task_id und verwenden Sie sie im nächsten Schritt.
Schritt 4: Pollen Sie das Videoergebnis
curl -s "https://api.novita.ai/v3/async/task-result?task_id=hunyuan-fast-abc123" \
-H "Authorization: Bearer $NOVITA_API_KEY"
Pollen Sie weiter, 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 läuft nach video_url_ttl Sekunden ab.
Statuswerte der Aufgabe
| Status | Bedeutung |
|---|---|
TASK_STATUS_QUEUED |
Anfrage angenommen, wartet auf Ausführung |
TASK_STATUS_PROCESSING |
Generierung läuft |
TASK_STATUS_SUCCEED |
Abgeschlossen – Video-URL unter videos[0].video_url verfügbar |
TASK_STATUS_FAILED |
Generierung fehlgeschlagen – prüfen Sie die Antwort auf den 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
# Step 1: Submit the generation request
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"
# Step 2: Poll until complete
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 | Zu vermeidende Elemente in der Ausgabe (z. B. „unscharf, geringe Qualität“) |
width |
integer | Nein | Ausgabebreite in Pixeln – prüfen Sie die unterstützten Werte in der API-Dokumentation |
height |
integer | Nein | Ausgabehöhe in Pixeln – wird mit width kombiniert, um die Auflösung festzulegen |
seed |
integer | Nein | Legen Sie eine feste Ganzzahl fest, um dieselbe Ausgabe zu reproduzieren; -1 für Zufall |
Die vollständige Parameterliste einschließlich Optionen für die Dauer, Einschränkungen bei der maximalen Auflösung und alle modellspezifischen Felder finden Sie in der Hunyuan Video Fast API-Referenz.
Preise und Limits
Prüfen Sie die aktuellen Preise pro Video auf der Novita-AI-Modellseite. Die Preisgestaltung für Videogenerierung erfolgt in der Regel pro generiertem Clip und variiert je nach Auflösung und Dauer. Prüfen Sie die Preisseite, bevor Sie ein Kostenmodell für Produktionsworkloads erstellen.
Bestätigen Sie vor der Bereitstellung die folgenden Limits in der offiziellen Dokumentation:
- Maximale Zeichenlänge des Prompts
- Unterstützte Auflösungswerte (Kombinationen aus Breite × Höhe)
- Maximale Videodauer in Sekunden
- Rate-Limits und Obergrenzen für gleichzeitige Aufgaben pro API-Schlüssel
Die schnelle Variante kostet in der Regel weniger pro Clip als das Standardmodell, da die Rechenzeit geringer ist – prü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 zulässigen Bereichs. Bestätigen Sie, dass prompt nicht leer ist und dass width/height Werte aus der unterstützten Menge der API-Dokumentation stammen.
Die Aufgabe bleibt in TASK_STATUS_PROCESSING – Die Generierung läuft noch. Die schnelle Variante ist schneller als die Standardversion, aber höhere Auflösungen und längere Dauern benötigen mehr Zeit. Erhöhen Sie Ihr Polling-Timeout bei großen Ausgaben.
video_url gibt 403 oder 404 zurück – Die URL ist abgelaufen (video_url_ttl überschritten). Laden Sie das Video in der Produktion sofort nach TASK_STATUS_SUCCEED herunter oder übertragen Sie es – verlassen Sie sich nicht auf die gehostete URL als dauerhaften Speicher.
Konsistente Qualitätsprobleme bei bestimmten Prompt-Typen – Verwenden Sie den Ansatz der prompt-Verfeinerung: Beschreiben Sie Motiv, Aktion, Kamerawinkel und Stil explizit. Fügen Sie negative_prompt-Einträge für häufige Artefakte hinzu. Wenn die Qualität für den Anwendungsfall immer noch nicht ausreicht, bewerten Sie den Standard-Endpunkt von Hunyuan Video.
FAQ
Wie lautet 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, und pollen Sie dann GET https://api.novita.ai/v3/async/task-result?task_id=<id>, bis task_status gleich TASK_STATUS_SUCCEED ist.
Wie unterscheidet sich Hunyuan Video Fast vom Standard-Hunyuan-Video?
Die schnelle Variante ist für die Generierungsgeschwindigkeit optimiert – sie reduziert die Zeit von der Aufgabeneinreichung bis zum fertigen Video. Der Kompromiss besteht darin, dass Bewegungsgenauigkeit und fein abgestimmte Prompt-Befolgung geringer sind als beim Standardmodell. Verwenden Sie die schnelle Variante für Prompt-Iterationen, Batch-Jobs mit hohem Durchsatz oder Staging; verwenden Sie die Standardversion für Ausgaben in Endqualität.
Kann ich eine bestimmte Videodauer festlegen?
Prüfen Sie die API-Referenz auf unterstützte Dauerparameter. Einige Novita-Video-APIs bieten ein explizites duration-Feld; andere verwenden eine Standardeinstellung des Modells. Vergewissern Sie sich, bevor Sie eine Standard-Cliplänge annehmen.
Wie reproduziere ich eine bestimmte Videoausgabe?
Setzen Sie seed auf eine feste Ganzzahl. Dieselbe 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 die Bild-zu-Video-Generierung auf Novita finden Sie verfügbare I2V-Modelle wie Kling, Vidu oder Wan auf der Novita-Modellseite.
Wie viel kostet Hunyuan Video Fast auf Novita AI?
Prüfen Sie die aktuellen Preise unter novita.ai/models. Die Preise pro Clip für Videomodelle können sich ändern; prüfen Sie immer die Preisseite, bevor Sie Produktionskostenschätzungen erstellen.
Ist Hunyuan Video Fast für Produktions-Videopipelines geeignet?
Ja, bei entsprechender Handhabung. Gestalten Sie Ihre Pipeline um die asynchrone Aufgabeneinreichung, speichern Sie die task_id zur 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.
