Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
character_orientation | No | Which way the character faces: video follows the person in the driving clip, image follows the person in the photo. With image the driving clip may be at most 10 seconds. video · image · Predefinito: video |
image_url | Sì | L'immagine di partenza. |
keep_original_audio | No | Keep the driving clip's own sound in the result. Predefinito: true |
negative_prompt | No | Ciò che non vuoi vedere. |
prompt | No | Optional notes on the result: the setting, the look, anything the driving clip does not show. |
resolution | No | Dimensione dell'output. Più grande è più nitido e costa di più. 720p · 1080p · Predefinito: 720p |
shot_type | No | How the shots are planned: customize keeps to your inputs, intelligent lets the model plan the shots itself. customize · intelligent · Predefinito: customize |
video_url | Sì | La clip su cui lavorare. |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti al secondo | ≈ USD |
|---|---|---|
| resolution 720p | 15,12 | 0,15 USD |
| resolution 1080p | 20,16 | 0,20 USD |
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di Kling 3.0 in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model kling/3.0/character-animation e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "kling/3.0/character-animation",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "720p",
"character_orientation": "video",
"shot_type": "customize"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di Kling 3.0
Quanto costa l’API di Kling 3.0?
Kling 3.0 costa da 15,12 crediti (0,15 USD) al secondo con Controllo del movimento, il suo task più economico. Prezzi per opzione: 720p 15,12 crediti al secondo, 1080p 20,16 crediti al secondo. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di Kling 3.0 nell’API?
Inserisci kling/3.0/text-to-video per Crea video; kling/3.0/image-to-video per Da immagine a video; kling/3.0/character-animation per Controllo del movimento nel campo model di POST /jobs/createTask.
shot_type single garantisce una sola ripresa continua?
Non da solo. Nei nostri test Kling 3.0 a volte tagliava a una seconda angolazione anche con single selezionato. Aggiungi una frase come "una sola ripresa continua, nessuno stacco" al prompt se la ripresa non deve tagliare: ha risolto nel nostro ritest della stessa scena.
Quanto tempo richiede la generazione di una clip?
Kling non è istantaneo: pianifica alcuni minuti per clip piuttosto che secondi, più a lungo per Motion Control e le risoluzioni più alte. Il playground mostra l'avanzamento mentre il lavoro è in corso.
Quali sono i limiti dell’API di Kling 3.0?
Risoluzioni: 720p · 1080p; Lunghezza del prompt (caratteri): 2,500; Caricamento massimo: 10 MB; Clip di input più lunga: 30 s. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare Kling 3.0 senza scrivere codice?
Sì. Il Playground esegue Kling 3.0 con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli Kling
Kling O3 è il fratello più flessibile: fino a sette foto di riferimento in un piano, stacchi multi-inquadratura automatici e modifica di clip che hai già. Kling 3.0 è la scelta per un singolo piano ben rifinito con primo e ultimo fotogramma o Motion Control.
- API di Kling 3.0Clip 4K, montaggio a più inquadrature e controllo del movimentoDa 51 crediti per una clip di 5 secondi
- API di Kling O3Kling tutto in uno: crea, anima, usa riferimenti e modifica fino al 4KDa 51 crediti per una clip di 5 secondi
- API di Kling 3.0 TurboKling 3.0 più veloce, con audio in ogni clipDa 84 crediti per una clip di 5 secondi
- API di Kling Avatar 2.0Un ritratto che parla o canta il tuo audio, fino a 5 minutiDa 7,68 crediti al secondo
- API di Kling 2.6Clip 1080p con audio e controllo del movimento opzionaliDa 52 crediti per una clip di 5 secondi
- API di Kling 2.5 TurboClip 1080p con colonna sonora in ogni ripresaDa 42 crediti per una clip di 5 secondi
- API di Kling 2.1 MasterClip 1080p mute con un controllo fine del promptDa 162 crediti per una clip di 5 secondi
- API di Kling 2.1Anima un fotogramma in 720p o 1080p, con fotogramma finale opzionaleDa 27 crediti per una clip di 5 secondi

