CheaperGen

Documentazione API di Kling 4.0

Tutto ciò che ti serve per chiamare Kling 4.0 dal tuo codice. URL di base: https://cheapergen.com/api/v1. Provalo prima nel playground.

Usi un agente di programmazione?

Incolla questo testo in Claude Code, Cursor, Codex o qualsiasi agente di programmazione. Aggiunge l’API al tuo progetto, conserva la chiave in CHEAPERGEN_API_KEY ed esegue una prova con un preventivo gratuito prima di spendere.

Add Kling 4.0 (CheaperGen endpoint kuaishou/kling-4.0/text-to-video) to this project by following https://cheapergen.com/agents/integrate.md
Cosa legge il tuo agente

Autenticazione

Crea una chiave in Dashboard → Chiavi API, inviala come token bearer e conservala lato server.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

API Kling 4.0 Da testo a video

POST/api/v1/run/kuaishou/kling-4.0/text-to-video

Invia un job asincrono e restituisce 202 con l’ID della generazione. Interroga GET /api/v1/generations/{id} o specifica webhook_url. Consulta il ciclo di vita dei job.

Parametri di input

NomeTipoDescrizioneEffetto sul prezzo
promptobbligatoriostringDescrivi l’inquadratura: soggetto, azione, movimento della camera, illuminazione e stile.No
aspect_ratiostring (enum)Formato del fotogramma in output.
Valori: 16:9 · 9:16 · 1:1 · 21:9
Predefinito: 16:9
Sì
resolutionstring (enum)Risoluzione dell’output. Le risoluzioni più alte costano di più al secondo.
Valori: 720p · 1080p
Predefinito: 720p
Sì
durationintegerDurata della clip generata in secondi (3–30 s). Paghi al secondo.
Intervallo: 3–30s
Predefinito: 5
Sì
webhook_urlstringa (URL)Facoltativo. Inviamo con POST la generazione completata a questo indirizzo, firmandola con il segreto del webhook. WebhookNo

Richiesta

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-4.0/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Una barchetta di carta scivola di notte lungo un canale di scolo pieno di pioggia, riflessi al neon, il lieve picchiettio della pioggia",
    "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);

Risposta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "kuaishou/kling-4.0",
  "endpoint": "kuaishou/kling-4.0/text-to-video",
  "mode": "text-to-video",
  "status": "queued",
  "input": {
    "prompt": "Una barchetta di carta scivola di notte lungo un canale di scolo pieno di pioggia, riflessi al neon, il lieve picchiettio della pioggia",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

API Kling 4.0 Da immagine a video

POST/api/v1/run/kuaishou/kling-4.0/image-to-video

Invia un job asincrono e restituisce 202 con l’ID della generazione. Interroga GET /api/v1/generations/{id} o specifica webhook_url. Consulta il ciclo di vita dei job.

Parametri di input

NomeTipoDescrizioneEffetto sul prezzo
promptobbligatoriostringDescrivi l’inquadratura: soggetto, azione, movimento della camera, illuminazione e stile.No
image_urlobbligatoriostring (URL)Immagine usata come fotogramma iniziale. JPG/PNG/WebP, URL o caricamento.No
end_image_urlstring (URL)Fotogramma conclusivo facoltativo: il modello anima la transizione tra i due.No
resolutionstring (enum)Risoluzione dell’output. Le risoluzioni più alte costano di più al secondo.
Valori: 720p · 1080p
Predefinito: 720p
Sì
durationintegerDurata della clip generata in secondi (3–30 s). Paghi al secondo.
Intervallo: 3–30s
Predefinito: 5
Sì
webhook_urlstringa (URL)Facoltativo. Inviamo con POST la generazione completata a questo indirizzo, firmandola con il segreto del webhook. WebhookNo

Richiesta

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-4.0/image-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Lei si volta verso la finestra e sorride mentre le tende ondeggiano; lento avvicinamento della camera",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "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);

Risposta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "kuaishou/kling-4.0",
  "endpoint": "kuaishou/kling-4.0/image-to-video",
  "mode": "image-to-video",
  "status": "queued",
  "input": {
    "prompt": "Lei si volta verso la finestra e sorride mentre le tende ondeggiano; lento avvicinamento della camera",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

API Kling 4.0 Da riferimento a video

POST/api/v1/run/kuaishou/kling-4.0/reference-to-video

Invia un job asincrono e restituisce 202 con l’ID della generazione. Interroga GET /api/v1/generations/{id} o specifica webhook_url. Consulta il ciclo di vita dei job.

Parametri di input

NomeTipoDescrizioneEffetto sul prezzo
promptobbligatoriostringDescrivi l’inquadratura: soggetto, azione, movimento della camera, illuminazione e stile.No
reference_image_urlsstring[] (URLs)Fino a 10 immagini per definire personaggi, prodotti, stile o scena. Richiamale nel prompt con @Image1, @Image2…
Numero massimo di elementi: 10
No
reference_video_urlsstring[] (video URLs)Fino a 5 clip MP4/MOV per movimenti, movimenti di camera o effetti (3–30 s ciascuno, 30 s in totale, ≤ 200 MB ciascuno). Richiamali con @Video1, @Video2… Con un video di riferimento, i secondi di output più la durata maggiore tra output e video di riferimento vengono fatturati a una tariffa al secondo più bassa.
Numero massimo di elementi: 5
Sì
aspect_ratiostring (enum)Formato del fotogramma in output.
Valori: 16:9 · 9:16 · 1:1 · 21:9
Predefinito: 16:9
Sì
resolutionstring (enum)Risoluzione dell’output. Le risoluzioni più alte costano di più al secondo.
Valori: 720p · 1080p
Predefinito: 720p
Sì
durationintegerDurata della clip generata in secondi (3–30 s). Paghi al secondo.
Intervallo: 3–30s
Predefinito: 5
Sì
webhook_urlstringa (URL)Facoltativo. Inviamo con POST la generazione completata a questo indirizzo, firmandola con il segreto del webhook. WebhookNo

Richiesta

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-4.0/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "@Image1 cammina lungo la spiaggia al tramonto, seguendo il movimento della camera in @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "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);

Risposta

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "kuaishou/kling-4.0",
  "endpoint": "kuaishou/kling-4.0/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "@Image1 cammina lungo la spiaggia al tramonto, seguendo il movimento della camera in @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

Ottieni il risultato

Le generazioni sono asincrone. Continua a interrogare finché il campo status non vale succeeded, failed o canceled; oppure specifica webhook_url al momento dell’invio. Le generazioni non riuscite vengono rimborsate automaticamente.

curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"
200 — completata
{
  "status": "succeeded",
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4"
    }
  }
}

Altro: ciclo di vita dei job · i webhook · errori

prezzi di Kling 4.0

Paga al secondo di video man mano che le usi, senza abbonamento (piani mensili sono facoltativi). Le generazioni non riuscite vengono rimborsate automaticamente.

FasciaPrezzo ufficialeCheaperGen
720p
audio incluso
$0,157/s$0,1486/s
1080p
audio incluso
$0,235/s$0,2226/s
  • Prezzo ufficiale: Prezzo di listino dell’API per sviluppatori di Kling per Kling 4.0, kling.ai/dev/pricing (1 unità = 0,157 $/s a 720p, 1,5 unità = 0,235 $/s a 1080p; con video in input 0,094 $ / 0,141 $ per secondo di output più la durata maggiore tra output e video in input; audio sempre attivo). Prezzi verificati il 18 ottobre 2026.
  • L’audio viene sempre generato ed è incluso nel prezzo.
  • Con un video di riferimento, i secondi di output più la durata maggiore tra output e video di riferimento vengono fatturati a una tariffa al secondo più bassa.