Kling 3.0

Kling 3.0 è il modello di generazione video di Kuaishou. Una sola richiesta crea una clip di 3–15 secondi da un prompt, oppure da un primo fotogramma e un ultimo fotogramma facoltativo, in tre modalità di qualità (std, pro, 4K), con audio nativo quando lo richiedi. Una clip può anche essere una sequenza di fino a cinque inquadrature, ciascuna con il proprio prompt e la propria durata. Invia la richiesta, conserva l'ID attività restituito e leggi il video finito dall'attività. Le immagini vengono passate come URL.

ID modello

Consulta la pagina del modello per i prezzi attuali.

Esempio rapido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

La risposta è un'attività ({"id": "task_...", "status": "processing"}), non il video finito. Interroga GET /v1/tasks/{task_id} per ottenere il risultato. Conserva le chiavi API nel codice lato server.

Parametri

Lo schema è rigoroso: i campi sconosciuti vengono rifiutati invece che ignorati. callback_url non è disponibile; interroga invece l'attività.

Clip multi-inquadratura

Imposta multi_shots su true e descrivi ogni inquadratura in multi_prompt. Le durate delle inquadrature devono sommare 3–15 secondi; quella somma è la durata della clip e duration non viene usato. prompt si può omettere o usare per ciò che tutte le inquadrature hanno in comune.

{
  "model": "kling-3-0",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "A red paper boat on a calm pond at sunrise, wide shot", "duration": 3},
    {"prompt": "The boat drifts under a small wooden bridge, low angle", "duration": 3}
  ]
}

Elementi

Un elemento è un soggetto che il modello mantiene coerente per tutta la clip: una persona, un prodotto o un personaggio. Dagli un name, una breve description e 2–4 immagini, poi citalo per nome nel prompt (ad esempio @hero).

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

Input multimediali

Ogni immagine è un URL HTTP(S) pubblico. I data URI in base64 non sono accettati: carica il file nel tuo storage e passa il suo URL. Usa immagini JPG o PNG da 10 MB o meno.

Fattori di costo

Consulta la sezione prezzi del modello per le tariffe attuali. Kling 3.0 si paga per secondo di video, con una tariffa che dipende dalla modalità e dal fatto che sound sia attivo:

billed seconds = duration                      (single shot)
billed seconds = Σ multi_prompt[].duration     (multi_shots: true)
cost = billed seconds × rate per second

I secondi addebitati sono noti quando la richiesta è accettata, quindi l'importo riservato è l'importo addebitato. Consulta gli addebiti definitivi nella cronologia di utilizzo del tuo account. Le attività fallite non vengono addebitate.

Schema di output

L'invio restituisce l'attività:

{"id": "task_...", "model": "kling-3-0", "status": "processing", "created_at": 1789689600}

Recuperare l'attività

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interroga ogni 10–20 secondi finché status non diventa completed o failed. Un timeout di rete durante il polling non significa che la generazione sia fallita: conserva l'ID attività e riprendi il controllo. Non creare un'altra attività per verificare l'avanzamento.

Attività completata

{
  "id": "task_...",
  "model": "kling-3-0",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Nei nostri test una clip std di 3 secondi è tornata come MP4 (H.264) a 1280 × 720, e una clip pro di 5 secondi con sound a 1920 × 1080 con traccia audio, ciascuna in circa due-tre minuti.

Errori

Le richieste rifiutate prima della creazione di un'attività restituiscono un errore HTTP con un oggetto error e non vengono addebitate. Un'attività che fallisce dopo l'accettazione restituisce HTTP 200 quando viene interrogata, con status: "failed" e un oggetto error.

Vedi il catalogo errori comune per codici, stati HTTP e indicazioni sui tentativi.

{
  "id": "task_...",
  "model": "kling-3-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Se l'invio stesso va in timeout, controlla le tue attività prima di inviare di nuovo: la prima richiesta potrebbe essere stata accettata.

Suggerimenti

• Descrivi soggetto, luogo, movimento di camera e luce con una frase ciascuno; Kling segue il linguaggio di ripresa, come «lenta carrellata in avanti» e «inquadratura dal basso».
• Fai le bozze in std, poi renderizza l'inquadratura finale in pro o 4K con la stessa richiesta.
• Usa un primo e un ultimo fotogramma per controllare dove inizia e finisce un'inquadratura.
• Dividi una scena in inquadrature con multi_prompt invece di descrivere più stacchi in un solo prompt.
• Aggiungi no text, no logos per evitare marchi inventati.

Correlati

• Playground e prezzi di Kling 3.0
• Scarica l'OpenAPI
• Markdown copiabile