KuaishouTutoriel

Comment utiliser l’API Kling 3.0 Omni

Tutoriel pas à pas sur l’API Kling 3.0 Omni avec Node.js, Python et cURL : envoyer une tâche texte en vidéo, l’interroger ou recevoir un webhook, puis télécharger le video. L’exemple ci-dessous coûte $0,39.

Points de terminaison: 3; Texte en vidéo · Image en vidéo · Référence → vidéo
Exemple de requête: $0,39; Texte en vidéo
Langages: 3; Node.js · Python · cURL
Générations échouées: $0; remboursées automatiquement

Obtenir une clé API Créer avec Kling 3.0 Omni Documentation API

Obtenir une clé API

Créez un compte, ajoutez des crédits, puis créez une clé dans Tableau de bord → Clés API. Enregistrez-la sous CHEAPERGEN_API_KEY sur votre serveur. Chaque requête la transmet comme jeton Bearer.

Comment obtenir une clé API Kling 3.0 Omni

Choisissez un point de terminaison Kling 3.0 Omni

Chaque tâche a son propre point de terminaison. Tous acceptent un corps JSON et renvoient une génération que vous pouvez interroger.

Kling 3.0 Omni points de terminaison API, entrées obligatoires et tarifs
Tâche	Point de terminaison	Obligatoire	À partir de
Texte en vidéo	kuaishou/kling-3.0-omni/text-to-video	prompt	$0,0773 par seconde
Image en vidéo	kuaishou/kling-3.0-omni/image-to-video	prompt, image_url	$0,0773 par seconde
Référence → vidéo	kuaishou/kling-3.0-omni/reference-to-video	prompt, reference_image_urls	$0,0773 par seconde

Envoyer une tâche texte en vidéo

Ce programme envoie la tâche, interroge son état toutes les 3 secondes jusqu’à sa fin et affiche l’URL video. Remplacez le prompt et les paramètres par les vôtres.

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/kuaishou/kling-3.0-omni/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Un samouraï solitaire traverse des pétales de cerisier qui tombent au crépuscule, travelling lent, lumière cinématographique",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/kuaishou/kling-3.0-omni/text-to-video", headers=headers, json={
    "prompt": "Un samouraï solitaire traverse des pétales de cerisier qui tombent au crépuscule, travelling lent, lumière cinématographique",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/kuaishou/kling-3.0-omni/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Un samouraï solitaire traverse des pétales de cerisier qui tombent au crépuscule, travelling lent, lumière cinématographique",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Définissez les paramètres importants

Les paramètres de kuaishou/kling-3.0-omni/text-to-video, avec l’incidence de chacun sur le prix.

Paramètres Texte en vidéo de Kling 3.0 Omni et effet sur le prix
Paramètre	Type · valeur par défaut	Description	Effet sur le prix
aspect_ratio	string (enum) · 16:9	Format de l’image de sortie. 16:9 · 9:16 · 1:1	Oui
resolution	string (enum) · 720p	Résolution de sortie. Les résolutions supérieures coûtent plus cher par seconde. 720p · 1080p · 4k	720p: $0,0773 par seconde 1080p: $0,1031 par seconde 4K: $0,3853 par seconde
duration	integer · 5	Durée du clip généré en secondes (3–15 s). La facturation se fait à la seconde.	Facturé à la seconde
generate_audio	boolean · false	Générez un son synchronisé, une ambiance et des dialogues. Les clips avec audio sont facturés à un tarif par seconde plus élevé.	Oui
negative_prompt	string	Éléments à éviter dans le résultat.	Aucun

Les autres points de terminaison Kling 3.0 Omni suivent la même structure, avec leurs propres entrées :

POST /api/v1/run/kuaishou/kling-3.0-omni/image-to-video

{
  "prompt": "Elle se tourne vers la fenêtre et sourit tandis que les rideaux ondulent ; lent travelling avant",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "resolution": "720p",
  "duration": 5
}

POST /api/v1/run/kuaishou/kling-3.0-omni/reference-to-video

{
  "prompt": "@Image1 entre dans le café de @Image2 et s’assied près de la fenêtre, caméra à l’épaule",
  "reference_image_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.jpg",
    "https://cdn.cheapergen.com/samples/reference-2.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}

Récupérer le résultat

Une tâche passe de queued à running, puis à succeeded, failed ou canceled. Interrogez GET /api/v1/generations/{id}, ou indiquez webhook_url pour que nous vous envoyions le résultat par POST. Téléchargez le résultat et stockez-le vous-même.

200 — terminée

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "kuaishou/kling-3.0-omni",
  "endpoint": "kuaishou/kling-3.0-omni/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "Un samouraï solitaire traverse des pétales de cerisier qui tombent au crépuscule, travelling lent, lumière cinématographique",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Vérifier les signatures des webhooks

Calculer le prix avant le lancement

Le point de terminaison de devis est gratuit et ne nécessite pas de clé. Il renvoie le prix, le prix officiel et votre remise pour exactement les paramètres que vous envoyez.

curl -X POST https://cheapergen.com/api/v1/quote/kuaishou/kling-3.0-omni/text-to-video \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Un samouraï solitaire traverse des pétales de cerisier qui tombent au crépuscule, travelling lent, lumière cinématographique","aspect_ratio":"16:9","resolution":"720p","duration":5}'

Erreurs de l’API et marche à suivre
État	Code	Signification
400	invalid_request	Un paramètre manque ou dépasse les limites autorisées ; le message indique lequel.
401	unauthorized	Clé API manquante, mal formée ou révoquée.
402	insufficient_balance	Crédits insuffisants pour le prix indiqué ; rechargez votre solde ou activez la recharge automatique.
429	rate_limited	Trop de requêtes ou de générations en cours ; attendez un peu avant de réessayer.
502	upstream_error	Une erreur s’est produite pendant la génération ; le montant réservé est remboursé et vous pouvez réessayer.
503	model_unavailable	Aucune capacité n’est disponible pour le moment ; réessayez plus tard ou choisissez un autre modèle.

Documentation complète de l’API Kling 3.0 Omni

FAQ

Questions sur l’API Kling 3.0 Omni

Non. L’API utilise HTTPS et JSON. Les exemples Node.js (fetch) et Python (requests) de cette page sont des programmes complets. Toute langue capable d’envoyer une requête HTTP convient.

Oui. Ajoutez "webhook_url" au corps de la requête ; nous envoyons la génération terminée par POST à cette URL, avec une signature dans l’en-tête CheaperGen-Signature (HMAC-SHA256 de l’horodatage et du corps brut). Vous pouvez aussi interroger GET /api/v1/generations/{id}.

Transmettez des URL publiques dans "image_url", "end_image_url", "reference_image_urls". Les fichiers sans URL publique peuvent d’abord être téléversés avec POST /api/v1/uploads ; l’API renvoie une URL à utiliser dans la requête.

Texte en vidéo est proposé à partir de $0,0773 par seconde ; la requête d’exemple sur cette page coûte $0,39, 8 % sous le prix officiel. Les générations échouées sont automatiquement remboursées.

Comment utiliser l’API Kling 3.0 Omni

Obtenir une clé API

Choisissez un point de terminaison Kling 3.0 Omni

Envoyer une tâche texte en vidéo

Définissez les paramètres importants

Récupérer le résultat

Calculer le prix avant le lancement

Questions sur l’API Kling 3.0 Omni

Ai-je besoin d’un SDK pour utiliser l’API Kling 3.0 Omni ?

Puis-je utiliser un webhook au lieu d’interroger l’état ?

Comment envoyer des images à l’API Kling 3.0 Omni ?

Combien coûte un appel à l’API Kling 3.0 Omni ?