Guide de démarrage rapide de l'API Kling V3.0 4K

Kling V3.0 4K est disponible sur Novita AI via deux endpoints API dédiés : kling-v3.0-4k-t2v pour le texte vers vidéo et kling-v3.0-4k-i2v pour l’image vers vidéo. Les deux produisent une sortie native 3840×2160, prennent en charge des durées de 3 à 15 secondes et suivent le même modèle de tâche asynchrone utilisé dans toutes les API vidéo de Novita. Si vous utilisez déjà Kling V3.0 Standard ou Pro dans votre pipeline, passer au niveau 4K est un simple changement d’ID de modèle sur une ligne.

Ce guide couvre uniquement les endpoints spécifiques à la 4K. Pour la génération audio native, la composition multi‑plans ou la tarification Standard/Pro par seconde, consultez la présentation de Kling 3.0 sur Novita AI.

Quand utiliser Kling V3.0 4K plutôt que Standard et Pro

Le niveau 4K est pertinent lorsque la résolution de sortie est le facteur limitant — assets de qualité d’impression, affichage grand écran ou workflows aval nécessitant des images source haute résolution pour le compositing ou le recadrage.

Il ne remplace pas le niveau Standard ou Pro dans tous les cas d’usage. L’itération et les tests de prompts sont moins coûteux en résolutions inférieures, et la génération 4K prend plus de temps par tâche. Un workflow pratique consiste à itérer avec le niveau Standard, puis à passer à kling-v3.0-4k-t2v ou kling-v3.0-4k-i2v pour le prompt final accepté.

Utilisez kling-v3.0-4k-t2v lorsque :

• La scène peut être entièrement décrite dans un prompt
• Aucune image de référence n’existe ou n’est importante

Utilisez kling-v3.0-4k-i2v lorsque :

• Une première image spécifique doit ancrer le clip généré
• Vous avez besoin d’une apparence cohérente du sujet à partir d’une image source

Étape 1 : Obtenez votre clé API Novita AI

Inscrivez-vous sur novita.ai et générez une clé API depuis le tableau de bord. Les nouveaux comptes incluent des crédits gratuits. Stockez la clé en tant que variable d’environnement — ne l’écrivez pas en dur dans les fichiers sources.

export NOVITA_API_KEY="your_api_key_here"

Étape 2 : IDs de modèle et endpoints

Mode	ID de modèle	Endpoint
Texte vers vidéo	kling-v3.0-4k-t2v	POST https://api.novita.ai/v3/async/kling-v3.0-4k-t2v
Image vers vidéo	kling-v3.0-4k-i2v	POST https://api.novita.ai/v3/async/kling-v3.0-4k-i2v
Récupération des résultats	—	GET https://api.novita.ai/v3/async/task-result?task_id=<id>

Les deux endpoints acceptent du JSON, nécessitent un jeton Bearer dans l’en‑tête Authorization et renvoient immédiatement un task_id. La vidéo elle‑même est récupérée séparément via l’endpoint de résultat de tâche.

Références API officielles :

• Documentation Kling v3.0 4K T2V
• Documentation Kling v3.0 4K I2V

Étape 3 : Envoyez votre première requête

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": "A lone lighthouse on a rocky coast at golden hour, cinematic wide shot, waves crashing",
    "negative_prompt": "blurry, low quality, distorted",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5
  }'

La réponse renvoie un task_id :

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

Conservez cet ID — vous en aurez besoin pour récupérer le résultat.

Étape 4 : Interrogez le résultat vidéo

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

Une tâche terminée renvoie un objet task avec status: "TASK_STATUS_SUCCEED" et un tableau videos :

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

Valeurs de statut typiques : TASK_STATUS_QUEUED, TASK_STATUS_PROCESSING, TASK_STATUS_SUCCEED, TASK_STATUS_FAILED. Construisez votre boucle d’interrogation autour de ces valeurs — ne supposez pas un temps d’attente fixe, car la génération 4K prend plus de temps que la 1080P.

Étape 5 : Requête image vers vidéo

L’endpoint image vers vidéo nécessite une image_url en plus du prompt. L’image définit la première image ; le modèle génère le mouvement à partir de celle‑ci.

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": "The lighthouse beam sweeps across the fog, slow dramatic movement",
    "negative_prompt": "fast cuts, shake, low quality",
    "image_url": "https://your-storage.example.com/lighthouse-frame.jpg",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5
  }'

Exigences pour l’image (vérifiez les limites actuelles dans la référence API Novita) :

• Formats : .jpg, .jpeg, .png
• Taille maximale du fichier : 10 Mo
• Dimensions minimales : 300×300 pixels

L’étape de récupération du résultat est identique à celle du T2V — interrogez /v3/async/task-result avec le task_id retourné.

Exemples Python

T2V — texte vers vidéo 4K

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": "blurry, low quality",
        "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 failed: {data}")
        time.sleep(interval)
    raise TimeoutError(f"Task {task_id} did not complete within {max_wait}s")

if __name__ == "__main__":
    task_id = submit_t2v(
        prompt="A lone lighthouse on a rocky coast at golden hour, cinematic wide shot",
        duration=5,
        aspect_ratio="16:9",
    )
    print(f"Task submitted: {task_id}")
    result = poll_result(task_id)
    video_url = result["videos"][0]["video_url"]
    print(f"Video ready: {video_url}")

I2V — image vers vidéo 4K

def submit_i2v(
    prompt: str,
    image_url: str,
    duration: int = 5,
    aspect_ratio: str = "16:9",
) -> str:
    payload = {
        "prompt": prompt,
        "negative_prompt": "blurry, low quality",
        "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"]

Utilisez la même fonction poll_result pour récupérer la vidéo générée.

Paramètres clés

Paramètre	Type	Requis	Notes
prompt	chaîne	Oui	Description de la scène. Soyez précis : sujet, mouvement, angle de caméra, éclairage.
negative_prompt	chaîne	Non	Ce qu’il faut supprimer : flou, secousses, artefacts, styles indésirables.
duration	entier	Non	Secondes de vidéo. Plage : 3–15. La valeur par défaut varie — consultez la doc.
aspect_ratio	chaîne	Non	"16:9", "9:16", "1:1". Valeur par défaut : "16:9".
cfg_scale	flottant	Non	Force d’adhérence au prompt. 0.5 est une valeur de départ sûre.
image_url	chaîne	I2V uniquement	Première image. Doit être une URL accessible publiquement.

Résolution et durée vs. coût

La génération 4K coûte plus cher par seconde que les niveaux Standard ou Pro. Avant de vous engager dans un lot complet :

• Testez les prompts avec kling-v3.0-std-t2v à duration: 3
• Passez à kling-v3.0-4k-t2v uniquement pour les prompts acceptés
• Utilisez duration: 5 pour la plupart des sorties ; réservez 10–15 secondes pour les clips phares

Tarification et estimation des coûts

Novita AI utilise une facturation à la seconde pour Kling V3.0 4K. La tarification du niveau 4K est plus élevée que celle des niveaux Standard ou Pro — consultez novita.ai/models/kling/kling-v3.0-4k-t2v et novita.ai/models/kling/kling-v3.0-4k-i2v pour connaître les tarifs par seconde actuels avant d’exécuter des lots de production.

Pour le contexte des niveaux Standard et Pro, la présentation de Kling 3.0 documente les tarifs par seconde pour ces niveaux. Le niveau 4K est tarifé séparément.

Schéma d’estimation des coûts pour tout modèle facturé à la seconde :

• Déterminez la durée par clip (par exemple 5 secondes)
• Multipliez par le tarif par seconde
• Multipliez par le nombre prévu de clips acceptés
• Ajoutez une marge de réessai (10–20 % pour les échecs de prompt)

Dépannage

task_id reçu mais le résultat n’aboutit jamais Les tâches 4K prennent plus de temps que leurs équivalents 1080P. Prolongez votre délai d’interrogation à au moins 10 minutes (max_wait=600). Si la tâche reste bloquée sur TASK_STATUS_PROCESSING au‑delà, consultez la page de statut de Novita ou relancez la requête.

TASK_STATUS_FAILED sans détails Les causes les plus fréquentes sont : un prompt contenant du contenu interdit, une image_url invalide ou inaccessible en mode I2V, ou une valeur de durée en dehors de la plage prise en charge. Validez les entrées et réessayez avec un prompt plus simple.

Image I2V rejetée Vérifiez que l’image est accessible publiquement via une URL directe (pas de redirection ni de mur d’authentification), que le format est .jpg/.jpeg/.png, que le fichier fait moins de 10 Mo et que les dimensions sont d’au moins 300×300 pixels.

Résolution de sortie inattendue Les endpoints 4K visent le 3840×2160. Si votre lecteur ou outil aval rapporte une résolution inférieure, vérifiez s’il décode correctement le fichier. La sortie encodée de l’API devrait être native 4K.

Erreurs de limite de débit Novita AI applique des limites de débit par clé API. Pour les charges de travail par lots à haut débit, consultez la documentation sur les limites de débit et envisagez de soumettre les tâches séquentiellement ou avec un petit délai entre les requêtes.

FAQ

Quelle résolution produit kling-v3.0-4k-t2v ?

Les deux endpoints 4K visent une sortie native 3840×2160 (4K UHD). Il s’agit d’un rendu matériel — pas d’une suréchantillonnage à partir d’une résolution inférieure.

En quoi Kling V3.0 4K diffère‑t‑il des V3.0 Standard et Pro ?

Les niveaux Standard et Pro génèrent une sortie 1080P. Les endpoints 4K ajoutent une résolution native 3840×2160. Standard est le plus rapide et le moins cher ; Pro ajoute une qualité visuelle supérieure à un coût modéré ; 4K est l’option de plus haute résolution et est tarifée en conséquence. La durée (3–15 secondes) et la forme asynchrone de l’API sont les mêmes pour les trois niveaux.

Puis‑je utiliser les endpoints 4K avec la même clé API que pour Standard et Pro ?

Oui. Tous les endpoints Kling V3.0 sur Novita AI utilisent la même authentification par jeton Bearer. La seule différence entre les niveaux est l’ID de modèle et le chemin de l’endpoint.

Kling V3.0 4K prend‑il en charge la génération audio native ?

L’indicateur de co‑génération audio standard disponible sur les endpoints V3.0 Standard et Pro peut également être pris en charge sur le niveau 4K. Consultez les pages de référence API T2V et I2V pour la liste actuelle des paramètres, y compris un éventuel champ with_audio.

Combien de temps prend une tâche de génération 4K ?

La génération 4K prend plus de temps que la 1080P. Attendez‑vous à au moins 60–180 secondes pour un clip de 5 secondes, selon la charge de la file d’attente. Concevez votre logique d’interrogation avec un délai d’au moins 10 minutes et traitez TASK_STATUS_PROCESSING comme un état intermédiaire normal.

L’endpoint I2V est‑il utile pour les séquences de produits ou de marque ?

Oui, lorsque l’image d’entrée est nette et bien éclairée. L’endpoint I2V préserve bien la composition de la première image pour les sujets statiques. Pour des mouvements de caméra complexes ou des scènes avec plusieurs personnages, exécutez un petit lot de test avant une production complète.

Articles recommandés

• Kling 3.0 Now on Novita AI: Cinematic AI Video Generation at Scale
• Kling O1 on Novita AI: T2V, I2V, Ref2V, and Video Edit Modes
• Kling V2.5 Turbo API on Novita AI: Text-to-Video and Image-to-Video