- Wann sollte man Hunyuan Video Fast gegenüber der Standardvariante 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 auf das Videoorgebnis
- 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 des quelloffenen Hunyuan-Video-Basismodells von Tencent – die Generierungszeit wird im Vergleich zur Standardversion verkürzt, allerdings zu Lasten der Bewegungsgenauigkeit. Das macht es praktisch für Hochdurchsatz-Pipelines, Prompt-Iterationen und Staging-Workflows, bei denen die Bearbeitungszeit wichtiger ist als die höchste filmische Qualität.
Wie bei allen asynchronen Video-APIs von Novita wird bei der Einreichung eine task_id zurückgegeben und die Video-URL nach Abschluss der Aufgabe bereitgestellt. Diese Anleitung behandelt den Endpunkt, das Anfrageformat, funktionierende Python- und cURL-Beispiele sowie den Einsatzzweck der schnellen Variante im Vergleich zum Standardmodell.
Wann sollte man Hunyuan Video Fast gegenüber der Standardvariante verwenden?
Die schnelle Variante ist die richtige Wahl, wenn die Generierungszeit und das Anfragevolumen wichtiger sind als die höchste visuelle Qualität. Das Standardmodell Hunyuan Video liefert hochwertigere Bewegungen und eine bessere Prompt-Treue pro Generierung. Die schnelle Variante verkürzt diese Zeit deutlich – nützlich für:
- Prompt-Iterationen – viele Variationen günstig testen, bevor man sich für eine vollwertige Ausgabe entscheidet
- Hochdurchsatz-Pipelines – Stapelgenerierung von Inhalten, bei denen die Latenz pro Clip den Gesamtdurchsatz beeinflusst
- Staging und interne Überprüfung – schnell teilbare Ausgaben erhalten, dann für die endgültige Auslieferung auf Standard wechseln
- Anwendungen mit geringer Latenz – Produktions-Workflows mit knappen Antwortzeitbudgets
Wenn die Ausgabequalität die primäre Einschränkung darstellt – Rundfunk, endgültige Auslieferung oder fotorealistische Bewegungen – verwenden Sie stattdessen den Standardendpunkt Hunyuan Video.
Schritt 1: Holen Sie sich 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 in Quelldateien codiert.
export NOVITA_API_KEY="your_api_key_here"
Schritt 2: Endpunkt und Modell-ID
| Feld | Wert |
|---|---|
| Einreichungs-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 enthalten – speichern Sie die task_id und verwenden Sie sie im nächsten Schritt.
Schritt 4: Pollen Sie auf das Videoorgebnis
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.
Aufgabenstatus-Werte
| Status | Bedeutung |
|---|---|
TASK_STATUS_QUEUED |
Anfrage angenommen, wartet auf Ausführung |
TASK_STATUS_PROCESSING |
Generierung läuft |
TASK_STATUS_SUCCEED |
Abgeschlossen – Video-URL in videos[0].video_url verfügbar |
TASK_STATUS_FAILED |
Generierung fehlgeschlagen – Antwort auf Fehlerursache prüfen |
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: Pollen bis zur Fertigstellung
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 Subjekts, der Bewegung und des Stils |
negative_prompt |
string | Nein | Zu vermeidende Elemente in der Ausgabe (z. B. “blurry, low quality”) |
width |
integer | Nein | Ausgabebreite in Pixeln – unterstützte Werte in der API-Dokumentation prüfen |
height |
integer | Nein | Ausgabehöhe in Pixeln – wird mit width zur Auflösung kombiniert |
seed |
integer | Nein | Feste Ganzzahl zur Reproduktion der gleichen Ausgabe; -1 für zufällig |
Die vollständige Parameterliste inklusive Dauereinstellungen, maximaler Auflösungsbeschränkungen und modellspezifischer Felder finden Sie in der Hunyuan Video Fast API-Referenz.
Preise und Limits
Aktuelle Preise pro Video finden Sie auf der Novita AI Modelle-Seite. Die Preisgestaltung für Videogenerierung erfolgt üblicherweise pro generiertem Clip und variiert je nach Auflösung und Dauer. Überprüfen Sie die Preisseite, bevor Sie ein Kostenmodell für Produktionsworkloads erstellen.
Bestätigen Sie folgende Limits in der offiziellen Dokumentation vor der Bereitstellung:
- Maximale Prompt-Zeichenlänge
- Unterstützte Auflösungswerte (Breite × Höhe-Kombinationen)
- Maximale Videodauer in Sekunden
- Ratenlimits und maximale gleichzeitige Aufgaben pro API-Schlüssel
Die schnelle Variante kostet typischerweise weniger pro Clip 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 Bereichs. Stellen Sie sicher, dass prompt nicht leer ist und dass width/height-Werte im unterstützten Bereich der API-Dokumentation liegen.
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 für große Ausgaben.
video_url gibt 403 oder 404 zurück – Die URL ist abgelaufen (video_url_ttl verstrichen). Laden Sie das Video unmittelbar 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 – Wechseln Sie zur Verfeinerung des prompt-Ansatzes: Beschreiben Sie Subjekt, 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 unzureichend ist, bewerten Sie den Standard-Hunyuan-Video-Endpunkt.
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, dann pollt GET https://api.novita.ai/v3/async/task-result?task_id=<id>, bis task_status TASK_STATUS_SUCCEED ist.
Wie unterscheidet sich Hunyuan Video Fast vom Standardmodell Hunyuan Video?
Die schnelle Variante ist auf Generierungsgeschwindigkeit optimiert – sie verkürzt die Zeit vom Absenden der Aufgabe bis zum fertigen Video. Der Kompromiss besteht darin, dass die Bewegungsgenauigkeit und die fein abgestimmte Prompt-Treue geringer sind als beim Standardmodell. Verwenden Sie die schnelle Variante für Prompt-Iterationen, Stapelverarbeitung mit hohem Durchsatz oder Staging; für endgültige Ausgabequalität verwenden Sie das Standardmodell.
Kann ich eine bestimmte Videodauer festlegen?
Überprüfen Sie die API-Referenz auf unterstützte Dauerparameter. Einige Novita-Video-APIs haben ein explizites duration-Feld, andere verwenden eine Standardeinstellung des Modells. Überprüfen Sie dies, bevor Sie eine Standard-Clip-Länge annehmen.
Wie kann ich ein bestimmtes Video reproduzieren?
Setzen Sie seed auf eine feste Ganzzahl. 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 Modelle-Seite.
Wie viel kostet Hunyuan Video Fast auf Novita AI?
Aktuelle Preise finden Sie unter novita.ai/models. Die Preisgestaltung pro Clip für Videomodelle kann sich ändern; überprüfen Sie immer die Preisseite, bevor Sie Produktionskostenschätzungen erstellen.
Ist Hunyuan Video Fast für Produktionsvideopipelines geeignet?
Ja, mit entsprechender Handhabung. Entwerfen Sie Ihre Pipeline um asynchrone Aufgabeneinreichung, speichern Sie die task_id zur Statusverfolgung, laden Sie das Video unmittelbar nach Abschluss herunter (bevor video_url_ttl abläuft) und behandeln Sie TASK_STATUS_FAILED mit einer Wiederholungs- oder Fallback-Strategie.
