Kling 3.0

ID:kling/kling-3.0

API di generazione video Kling 3.0 di Kuaishou — 4K nativo a 60fps con storyboard multi-shot, audio in 5 lingue e 3 modalità di qualità.

Text to videoImage to video4KMulti-shot

Panoramica

API di generazione video Kling 3.0 di Kuaishou — 4K nativo a 60fps con storyboard multi-shot, audio in 5 lingue e 3 modalità di qualità.

Autenticazione

Tutte le richieste API richiedono una chiave API valida passata tramite l'header Authorization con lo schema Bearer.

Avvio rapido

Credenziali

Imposta la variabile d'ambiente RUNBASE_API_KEY.

Shell

export RUNBASE_API_KEY=your-api-key

Crea un'esecuzione

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling/kling-3.0",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Esecuzioni

Le esecuzioni vengono elaborate in modo asincrono. Invia una richiesta, poi interroga per il risultato.

Crea un'esecuzione

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling/kling-3.0",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Stato dell'esecuzione

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Ottieni risultato

Interroga l'endpoint di stato finche status non e "succeeded", poi leggi output.urls dalla risposta.

Schema input

Parametro	Tipo	Obbligatorio	Descrizione
prompt	string	Obbligatorio	Prompt
aspect_ratio	string	Facoltativo	Aspect ratioOpzioni: `16:99:161:1`
mode	string	Facoltativo	Quality modeOpzioni: `stdpro4K`
duration	number	Facoltativo	Duration (seconds)
image_urls	string[]	Facoltativo	Frame images

Schema output

Campo	Tipo	Descrizione
urls	string[]	URL degli output generati

Errori

L'API utilizza codici di stato HTTP standard per indicare successo o errore.

Codice di stato	Descrizione
400	Richiesta non valida - parametri mancanti o malformati
401	Autenticazione fallita - chiave API mancante o non valida
402	Crediti insufficienti
403	Accesso negato - IP non consentito o limite di spesa della chiave API superato
404	Esecuzione non trovata
429	Limite di frequenza superato
500	Errore interno del server