Kling V3.0 4K API – Schnellstart

Kling V3.0 4K ist auf Novita AI als zwei dedizierte API-Endpunkte verfügbar: kling-v3.0-4k-t2v für Text-zu-Video und kling-v3.0-4k-i2v für Bild-zu-Video. Beide liefern native 3840×2160-Ausgabe, unterstützen Dauern von 3–15 Sekunden und folgen dem gleichen asynchronen Task-Muster, das bei allen Novita-Video-APIs verwendet wird. Wenn Sie bereits Kling V3.0 Standard oder Pro in Ihrer Pipeline haben, ist der Wechsel zur 4K-Stufe eine einzeilige Modell-ID-Änderung.

Diese Anleitung behandelt nur die 4K-spezifischen Endpunkte. Informationen zur nativen Audio-Generierung, Multi-Shot-Komposition oder zu Preisen pro Sekunde für Standard/Pro finden Sie in der Kling 3.0-Übersicht auf Novita AI.

Wann Sie Kling V3.0 4K statt Standard und Pro verwenden sollten

Die 4K-Stufe ist sinnvoll, wenn die Ausgabeauflösung die Einschränkung darstellt – druckreife Assets, große Bildschirme oder nachgelagerte Workflows, die hochauflösende Quellframes für Compositing oder Zuschnitt erfordern.

Sie ersetzt nicht für jeden Anwendungsfall Standard oder Pro. Iteration und Prompt-Tests sind bei niedrigeren Auflösungen günstiger, und die 4K-Generierung dauert pro Task länger. Ein praktischer Workflow ist, mit Standard zu iterieren und dann für den endgültigen akzeptierten Prompt auf kling-v3.0-4k-t2v oder kling-v3.0-4k-i2v zu wechseln.

Verwenden Sie kling-v3.0-4k-t2v, wenn:

• Die Szene vollständig in einem Prompt beschreibbar ist
• Kein Referenzbild existiert oder relevant ist

Verwenden Sie kling-v3.0-4k-i2v, wenn:

• Ein bestimmtes erstes Frame den generierten Clip verankern soll
• Sie eine konsistente Darstellung des Motivs aus einem Quellbild benötigen

Schritt 1: Holen Sie sich Ihren Novita-AI-API-Schlüssel

Registrieren Sie sich auf novita.ai und generieren Sie einen API-Schlüssel im Dashboard. Neue Konten enthalten kostenlose Guthaben. Speichern Sie den Schlüssel als Umgebungsvariable – hardcodieren Sie ihn nicht in Quelldateien.

export NOVITA_API_KEY="ihr_api_schluessel_hier"

Schritt 2: Modell-IDs und Endpunkte

Modus	Modell-ID	Endpunkt
Text-zu-Video	kling-v3.0-4k-t2v	POST https://api.novita.ai/v3/async/kling-v3.0-4k-t2v
Bild-zu-Video	kling-v3.0-4k-i2v	POST https://api.novita.ai/v3/async/kling-v3.0-4k-i2v
Ergebnisabruf	—	GET https://api.novita.ai/v3/async/task-result?task_id=<id>

Beide Endpunkte akzeptieren JSON, erfordern ein Bearer-Token im Authorization-Header und geben sofort eine task_id zurück. Das eigentliche Video wird separat über den Task-Ergebnis-Endpunkt abgerufen.

Offizielle API-Referenzen:

• Kling v3.0 4K T2V-Dokumentation
• Kling v3.0 4K I2V-Dokumentation

Schritt 3: Senden Sie Ihre erste Anfrage

curl -X POST https://api.novita.ai/v3/async/kling-v3.0-4k-t2v \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Ein einsamer Leuchtturm an einer felsigen Küste zur goldenen Stunde, filmische Totalen, brechende Wellen",
    "negative_prompt": "verschwommen, niedrige Qualität, verzerrt",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5
  }'

Die Antwort gibt eine task_id zurück:

{
  "task_id": "t2v-kling-4k-abc123"
}

Speichern Sie diese ID – Sie benötigen sie, um das Ergebnis abzurufen.

Schritt 4: Pollen Sie auf das Video-Ergebnis

curl "https://api.novita.ai/v3/async/task-result?task_id=t2v-kling-4k-abc123" \
  -H "Authorization: Bearer $NOVITA_API_KEY"

Ein abgeschlossener Task gibt ein task-Objekt mit status: "TASK_STATUS_SUCCEED" und ein videos-Array zurück:

{
  "task": {
    "task_id": "t2v-kling-4k-abc123",
    "status": "TASK_STATUS_SUCCEED"
  },
  "videos": [
    {
      "video_url": "https://...",
      "video_url_ttl": 3600,
      "video_type": "mp4"
    }
  ]
}

Typische Statuswerte: TASK_STATUS_QUEUED, TASK_STATUS_PROCESSING, TASK_STATUS_SUCCEED, TASK_STATUS_FAILED. Bauen Sie Ihre Polling-Schleife um diese herum – gehen Sie nicht von einer festen Wartezeit aus, da die 4K-Generierung länger dauert als 1080P.

Schritt 5: Bild-zu-Video-Anfrage

Der Bild-zu-Video-Endpunkt erfordert zusätzlich zum Prompt eine image_url. Das Bild definiert das erste Frame; das Modell generiert daraus Bewegung.

curl -X POST https://api.novita.ai/v3/async/kling-v3.0-4k-i2v \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Der Leuchtturmstrahl schwenkt durch den Nebel, langsame dramatische Bewegung",
    "negative_prompt": "schnelle Schnitte, Verwackeln, niedrige Qualität",
    "image_url": "https://your-storage.example.com/lighthouse-frame.jpg",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5
  }'

Bildanforderungen (aktuelle Grenzen in der Novita-API-Referenz prüfen):

• Formate: .jpg, .jpeg, .png
• Maximale Dateigröße: 10 MB
• Mindestmaße: 300×300 Pixel

Der Schritt zum Ergebnisabruf ist identisch mit T2V – Pollen Sie /v3/async/task-result mit der zurückgegebenen task_id.

Python-Beispiele

T2V – Text zu 4K-Video

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_t2v(prompt: str, duration: int = 5, aspect_ratio: str = "16:9") -> str:
    payload = {
        "prompt": prompt,
        "negative_prompt": "verschwommen, niedrige Qualität",
        "duration": duration,
        "aspect_ratio": aspect_ratio,
        "cfg_scale": 0.5,
    }
    resp = requests.post(
        f"{BASE_URL}/v3/async/kling-v3.0-4k-t2v",
        headers=HEADERS,
        json=payload,
        timeout=30,
    )
    resp.raise_for_status()
    return resp.json()["task_id"]

def poll_result(task_id: str, interval: int = 10, max_wait: int = 600) -> dict:
    deadline = time.time() + max_wait
    while time.time() < deadline:
        resp = requests.get(
            f"{BASE_URL}/v3/async/task-result",
            headers=HEADERS,
            params={"task_id": task_id},
            timeout=30,
        )
        resp.raise_for_status()
        data = resp.json()
        status = data.get("task", {}).get("status", "")
        if status == "TASK_STATUS_SUCCEED":
            return data
        if status == "TASK_STATUS_FAILED":
            raise RuntimeError(f"Task fehlgeschlagen: {data}")
        time.sleep(interval)
    raise TimeoutError(f"Task {task_id} wurde nicht innerhalb von {max_wait}s abgeschlossen")

if __name__ == "__main__":
    task_id = submit_t2v(
        prompt="Ein einsamer Leuchtturm an einer felsigen Küste zur goldenen Stunde, filmische Totalen",
        duration=5,
        aspect_ratio="16:9",
    )
    print(f"Task eingereicht: {task_id}")
    result = poll_result(task_id)
    video_url = result["videos"][0]["video_url"]
    print(f"Video bereit: {video_url}")

I2V – Bild zu 4K-Video

def submit_i2v(
    prompt: str,
    image_url: str,
    duration: int = 5,
    aspect_ratio: str = "16:9",
) -> str:
    payload = {
        "prompt": prompt,
        "negative_prompt": "verschwommen, niedrige Qualität",
        "image_url": image_url,
        "duration": duration,
        "aspect_ratio": aspect_ratio,
        "cfg_scale": 0.5,
    }
    resp = requests.post(
        f"{BASE_URL}/v3/async/kling-v3.0-4k-i2v",
        headers=HEADERS,
        json=payload,
        timeout=30,
    )
    resp.raise_for_status()
    return resp.json()["task_id"]

Verwenden Sie dieselbe poll_result-Funktion, um das generierte Video abzurufen.

Wichtige Parameter

Parameter	Typ	Erforderlich	Hinweise
prompt	string	Ja	Szenenbeschreibung. Halten Sie es spezifisch: Motiv, Bewegung, Kamerawinkel, Beleuchtung.
negative_prompt	string	Nein	Was unterdrückt werden soll: Unschärfe, Verwackeln, Artefakte, unerwünschte Stile.
duration	integer	Nein	Videosekunden. Bereich: 3–15. Standard variiert – in der Dokumentation prüfen.
aspect_ratio	string	Nein	"16:9", "9:16", "1:1". Standard: "16:9".
cfg_scale	float	Nein	Stärke der Prompt-Befolgung. 0.5 ist ein sicherer Startwert.
image_url	string	Nur I2V	Erstes Frame-Bild. Muss eine öffentlich zugängliche URL sein.

Auflösung und Dauer vs. Kosten

Die 4K-Generierung kostet pro Sekunde mehr als Standard oder Pro. Bevor Sie sich auf eine vollständige charge festlegen:

• Testen Sie Prompts mit kling-v3.0-std-t2v bei duration: 3
• Wechseln Sie nur für akzeptierte Prompts zu kling-v3.0-4k-t2v
• Verwenden Sie duration: 5 für die meisten Ausgaben; reservieren Sie 10–15 Sekunden für hero-Clips

Preise und Kostenabschätzung

Novita AI verwendet sekundengenaue Abrechnung für Kling V3.0 4K. Die Preise für die 4K-Stufe sind höher als für Standard oder Pro – prüfen Sie novita.ai/models/kling/kling-v3.0-4k-t2v und novita.ai/models/kling/kling-v3.0-4k-i2v für aktuelle Sekundenpreise, bevor Sie Produktions-Batches ausführen.

Informationen zu den Standard- und Pro-Stufen finden Sie in der Kling 3.0-Übersicht, die die Sekundenpreise für diese Stufen dokumentiert. Die 4K-Stufe wird separat bepreist.

Kostenschätzungsmuster für jedes sekundengenaue Modell:

• Bestimmen Sie die Dauer pro Clip (z. B. 5 Sekunden)
• Multiplizieren Sie mit dem Preis pro Sekunde
• Multiplizieren Sie mit der erwarteten Anzahl akzeptierter Clips
• Fügen Sie einen Wiederholungspuffer hinzu (10–20 % für Prompt-Fehlschläge)

Fehlerbehebung

task_id erhalten, aber das Ergebnis wird nie erfolgreich 4K-Tasks dauern länger als 1080P-Äquivalente. Verlängern Sie Ihr Polling-Timeout auf mindestens 10 Minuten (max_wait=600). Wenn der Task danach immer noch TASK_STATUS_PROCESSING ist, prüfen Sie die Novita-Statusseite oder wiederholen Sie die Anfrage.

TASK_STATUS_FAILED ohne Details Die häufigsten Ursachen sind: Prompt enthält nicht erlaubte Inhalte, eine ungültige oder nicht erreichbare image_url im I2V-Modus oder ein Dauerwert außerhalb des unterstützten Bereichs. Validieren Sie die Eingaben und wiederholen Sie den Vorgang mit einem einfacheren Prompt.

I2V-Bild abgelehnt Stellen Sie sicher, dass das Bild über eine direkte URL öffentlich zugänglich ist (keine Weiterleitung oder Authentifizierungswand), das Format .jpg/.jpeg/.png ist, die Datei unter 10 MB liegt und die Abmessungen mindestens 300×300 Pixel betragen.

Unerwartete Ausgabeauflösung Die 4K-Endpunkte zielen auf 3840×2160 ab. Wenn Ihr Player oder nachgelagertes Tool eine niedrigere Auflösung meldet, prüfen Sie, ob es die Datei korrekt dekodiert. Die codierte Ausgabe der API sollte natives 4K sein.

Rate-Limit-Fehler Novita AI wendet Ratenbegrenzungen pro API-Schlüssel an. Für Batch-Workloads mit hohem Durchsatz prüfen Sie die Dokumentation zu Ratenbegrenzungen und erwägen Sie, Tasks sequenziell oder mit einer kleinen Verzögerung zwischen Anfragen einzureichen.

FAQ

Welche Auflösung produziert kling-v3.0-4k-t2v?

Beide 4K-Endpunkte liefern native 3840×2160 (4K UHD)-Ausgabe. Dies ist ein Hardware-Render – kein Hochskalieren von einer niedrigeren Auflösung.

Wie unterscheidet sich Kling V3.0 4K von V3.0 Standard und Pro?

Standard und Pro generieren 1080P-Ausgabe. Die 4K-Endpunkte fügen native 3840×2160-Auflösung hinzu. Standard ist am schnellsten und günstigsten; Pro bietet höhere visuelle Qualität zu moderaten Kosten; 4K ist die höchstauflösende Option und entsprechend bepreist. Dauer (3–15 Sekunden) und die asynchrone API-Struktur sind bei allen drei Stufen gleich.

Kann ich die 4K-Endpunkte mit demselben API-Schlüssel wie Standard und Pro verwenden?

Ja. Alle Kling V3.0-Endpunkte auf Novita AI verwenden dieselbe Bearer-Token-Authentifizierung. Die einzige Änderung zwischen den Stufen ist die Modell-ID und der Endpunkt-Pfad.

Unterstützt Kling V3.0 4K native Audio-Generierung?

Das auf den Standard- und Pro-Endpunkten von V3.0 verfügbare Flag für Audio-Co-Generation wird möglicherweise auch auf der 4K-Stufe unterstützt. Prüfen Sie die T2V- und I2V-API-Referenzseiten für die aktuelle Parameterliste, einschließlich eines möglichen with_audio-Felds.

Wie lange dauert ein 4K-Generierungs-Task?

Die 4K-Generierung dauert länger als 1080P. Rechnen Sie mit mindestens 60–180 Sekunden für einen 5-Sekunden-Clip, abhängig von der Warteschlangenauslastung. Gestalten Sie Ihre Polling-Logik mit einem Timeout von mindestens 10 Minuten und behandeln Sie TASK_STATUS_PROCESSING als normalen Zwischenstatus.

Ist der I2V-Endpunkt für Produkt- oder Markenaufnahmen nützlich?

Ja, wenn das Eingabebild sauber und gut beleuchtet ist. Der I2V-Endpunkt bewahrt die Komposition des ersten Frames gut bei stationären Motiven. Für komplexe Kamerabewegungen oder Szenen mit mehreren Charakteren führen Sie vor einer vollständigen Produktion einen kleinen Test-Batch durch.

Empfohlene Artikel

• Kling 3.0 jetzt auf Novita AI: Filmische KI-Videogenerierung in großem Maßstab
• Kling O1 auf Novita AI: T2V, I2V, Ref2V und Videobearbeitungsmodi
• Kling V2.5 Turbo API auf Novita AI: Text-zu-Video und Bild-zu-Video