Riferimento API di Kling 3.0

Con una sola chiave API di PopNow chiami Kling 3.0 dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da: Kuaishou
Risultato: Video
Da: 10.08 crediti per secondo generato ($0.1008)
Tempo tipico: circa 400 s
ID del modello: kling/3.0/text-to-video
kling/3.0/image-to-video
kling/3.0/character-animation

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Crea video

kling/3.0/text-to-video

Prezzo

Opzione	Crediti (per secondo generato)	Dollari USA
`generate_audio = false, resolution = 720p`	10.08	$0.1008
`generate_audio = false, resolution = 1080p`	13.44	$0.1344
`generate_audio = true, resolution = 720p`	15.12	$0.1512
`generate_audio = true, resolution = 1080p`	20.16	$0.2016
`generate_audio = false, resolution = 4k`	50.4	$0.504
`generate_audio = true, resolution = 4k`	50.4	$0.504

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`prompt`Obbligatorio	`string`	—	fino a 2500 caratteri	Describe the scene, the action and the camera. With sound on, add dialogue in quotes and the sounds you want.
`negative_prompt`Facoltativo	`string`	—	fino a 2500 caratteri	What to keep out of the clip: objects, looks or motion you do not want.
`aspect_ratio`Facoltativo	`string`	`16:9`	16:9, 9:16, 1:1	Output aspect ratio.
`resolution`Facoltativo	`string`	`720p`	720p, 1080p, 4k	Output resolution. Higher tiers cost more per second.
`generate_audio`Facoltativo	`boolean`	`false`	—	Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second.
`duration_seconds`Facoltativo	`integer`	`5`	da 3 a 15	Output length in whole seconds, from 3 to 15. Billed per second.
`shot_type`Facoltativo	`string`	`single`	single, multi, customize	single keeps one continuous shot; multi lets the model cut the prompt into several shots on its own; customize follows the shot list you give in multi_prompt.
`multi_prompt`Facoltativo	`array<object>`	—	fino a 6 elementi	Shot list for shot_type customize: one entry per shot, in order, each with its own prompt and length in seconds. The lengths must add up to duration_seconds.
`guidance_scale`Facoltativo	`number`	`0.5`	da 0 a 1	How closely the clip follows the prompt, from 0 to 1. Higher sticks to the prompt more; lower gives the model more freedom.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "kling/3.0/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "duration_seconds": 5,
    "generate_audio": false,
    "resolution": "720p"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Da immagine a video

kling/3.0/image-to-video

Prezzo

Opzione	Crediti (per secondo generato)	Dollari USA
`generate_audio = false, resolution = 720p`	10.08	$0.1008
`generate_audio = false, resolution = 1080p`	13.44	$0.1344
`generate_audio = true, resolution = 720p`	15.12	$0.1512
`generate_audio = true, resolution = 1080p`	20.16	$0.2016
`generate_audio = false, resolution = 4k`	50.4	$0.504
`generate_audio = true, resolution = 4k`	50.4	$0.504

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`prompt`Obbligatorio	`string`	—	fino a 2500 caratteri	Describe what happens after the opening frame: the action, the camera and, with sound on, the sounds.
`image_url`Obbligatorio	`string (uri)`	—	—	Opening frame. The clip starts from this image.
`negative_prompt`Facoltativo	`string`	—	fino a 2500 caratteri	What to keep out of the clip: objects, looks or motion you do not want.
`last_image_url`Facoltativo	`string (uri)`	—	—	Optional closing frame the clip should end on.
`resolution`Facoltativo	`string`	`720p`	720p, 1080p, 4k	Output resolution. Higher tiers cost more per second.
`generate_audio`Facoltativo	`boolean`	`false`	—	Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second.
`duration_seconds`Facoltativo	`integer`	`5`	da 3 a 15	Output length in whole seconds, from 3 to 15. Billed per second.
`shot_type`Facoltativo	`string`	`single`	single, multi, customize	single keeps one continuous shot; multi lets the model cut the prompt into several shots on its own; customize follows the shot list you give in multi_prompt.
`multi_prompt`Facoltativo	`array<object>`	—	fino a 6 elementi	Shot list for shot_type customize: one entry per shot, in order, each with its own prompt and length in seconds. The lengths must add up to duration_seconds.
`guidance_scale`Facoltativo	`number`	`0.5`	da 0 a 1	How closely the clip follows the prompt, from 0 to 1. Higher sticks to the prompt more; lower gives the model more freedom.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in image_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "kling/3.0/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "generate_audio": false,
    "resolution": "720p"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Controllo del movimento

kling/3.0/character-animation

Prezzo

Opzione	Crediti (per secondo generato)	Dollari USA
`720p`	15.12	$0.1512
`1080p`	20.16	$0.2016

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`image_url`Obbligatorio	`string (uri)`	—	—	The character to animate: one clear, full or half-body picture of the person.
`video_url`Obbligatorio	`string (uri)`	—	—	Driving clip, 3 to 30 seconds: the moves, expressions and gestures to copy. The result is as long as this clip.
`prompt`Facoltativo	`string`	—	fino a 2500 caratteri	Optional notes on the result: the setting, the look, anything the driving clip does not show.
`negative_prompt`Facoltativo	`string`	—	fino a 2500 caratteri	What to keep out of the result: objects, looks or motion you do not want.
`resolution`Facoltativo	`string`	`720p`	720p, 1080p	Output resolution. Higher tiers cost more per second.
`keep_original_audio`Facoltativo	`boolean`	`true`	—	Keep the driving clip's own sound in the result.
`character_orientation`Facoltativo	`string`	`video`	video, image	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.
`shot_type`Facoltativo	`string`	`customize`	customize, intelligent	How the shots are planned: customize keeps to your inputs, intelligent lets the model plan the shots itself.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in image_url, video_url. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "kling/3.0/character-animation",
  "input": {
    "prompt": "The person dances with relaxed, natural movement",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "resolution": "720p"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Riferimento API di Kling 3.0

In sintesi

Crea video

Prezzo

Parametri

Richiesta di esempio

Da immagine a video

Prezzo

Parametri

Richiesta di esempio

Controllo del movimento

Prezzo

Parametri

Richiesta di esempio

Passi successivi

In questa pagina