PopNowDocs API
Contenuto principale

Riferimento API di Kling O3

Kling tutto in uno: crea, anima, usa riferimenti e modifica fino al 4K

Con una sola chiave API di PopNow chiami Kling O3 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)

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/o3/text-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
generate_audio = false, resolution = 720p10.08$0.1008
generate_audio = false, resolution = 1080p13.44$0.1344
generate_audio = true, resolution = 720p13.44$0.1344
generate_audio = true, resolution = 1080p16.8$0.168
generate_audio = false, resolution = 4k50.4$0.504
generate_audio = true, resolution = 4k50.4$0.504

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 2500 caratteriDescribe the scene, the action and the camera. With sound on, add dialogue in quotes and the sounds you want.
aspect_ratioFacoltativostring16:916:9, 9:16, 1:1Output aspect ratio.
resolutionFacoltativostring720p720p, 1080p, 4kOutput resolution. Higher tiers cost more per second.
generate_audioFacoltativobooleanfalse—Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second.
duration_secondsFacoltativointeger5da 3 a 15Output length in whole seconds, from 3 to 15. Billed per second.
shot_typeFacoltativostringsinglesingle, multi, customizesingle 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_promptFacoltativoarray<object>—fino a 6 elementiShot 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.

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/o3/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/o3/image-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
generate_audio = false, resolution = 720p10.08$0.1008
generate_audio = false, resolution = 1080p13.44$0.1344
generate_audio = true, resolution = 720p13.44$0.1344
generate_audio = true, resolution = 1080p16.8$0.168
generate_audio = false, resolution = 4k50.4$0.504
generate_audio = true, resolution = 4k50.4$0.504

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 2500 caratteriDescribe what happens after the opening frame: the action, the camera and, with sound on, the sounds.
image_urlObbligatoriostring (uri)——Opening frame. The clip starts from this image.
last_image_urlFacoltativostring (uri)——Optional closing frame the clip should end on.
resolutionFacoltativostring720p720p, 1080p, 4kOutput resolution. Higher tiers cost more per second.
generate_audioFacoltativobooleanfalse—Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second.
duration_secondsFacoltativointeger5da 3 a 15Output length in whole seconds, from 3 to 15. Billed per second.
shot_typeFacoltativostringsinglesingle, multi, customizesingle 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_promptFacoltativoarray<object>—fino a 6 elementiShot 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.

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/o3/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"

Da riferimenti a video

kling/o3/reference-to-video

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
generate_audio = false, resolution = 720p10.08$0.1008
generate_audio = false, resolution = 1080p13.44$0.1344
generate_audio = true, resolution = 720p13.44$0.1344
generate_audio = false, resolution = 720p, with_video = true15.12$0.1512
generate_audio = true, resolution = 1080p16.8$0.168
generate_audio = false, resolution = 1080p, with_video = true20.16$0.2016
generate_audio = false, resolution = 4k62.85$0.6285
generate_audio = true, resolution = 4k62.85$0.6285

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 2500 caratteriSay who and what each reference is (<<<image_1>>>, <<<image_2>>> and so on) and describe the shot they should produce.
reference_image_urlsObbligatorioarray<string (uri)>—fino a 7 elementiReference images for characters, objects, outfits or places, up to 7. Refer to them in the prompt as <<<image_1>>>, <<<image_2>>> and so on.
reference_video_urlsFacoltativoarray<string (uri)>—fino a 1 elementiOptional reference video (one clip) whose motion, camera or characters the new shot should draw on. Refer to it in the prompt as <<<video_1>>>. With a video, use up to 4 reference images. A run with a reference video is billed at a higher per-second rate.
elementsFacoltativoarray<object>—fino a 1 elementiOne named subject built from 2 to 4 images of the same character or object. Write @name in the prompt where it should appear. 4K only.
aspect_ratioFacoltativostring16:916:9, 9:16, 1:1Output aspect ratio.
resolutionFacoltativostring720p720p, 1080p, 4kOutput resolution. Higher tiers cost more per second.
generate_audioFacoltativobooleanfalse—Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second. Not available with a reference video.
keep_original_audioFacoltativobooleantrue—Keep the reference video's own sound in the result. Only matters when a reference video is given.
duration_secondsFacoltativointeger5da 3 a 15Output length in whole seconds, from 3 to 15. Billed per second.
shot_typeFacoltativostringsinglesingle, multi, customizesingle 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_promptFacoltativoarray<object>—fino a 6 elementiShot 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.

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 reference_image_urls. 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/o3/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.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"

Modifica video

kling/o3/video-edit

Prezzo

OpzioneCrediti (per secondo generato)Dollari USA
720p18.78$0.1878
1080p25.2$0.252

Parametri

CampoTipoPredefinitoValori ammessiA cosa serve
promptObbligatoriostring—fino a 2500 caratteriSay what to change in the clip: the subject, outfit, setting, style or weather. Anything you do not mention stays as it is.
video_urlObbligatoriostring (uri)——Source clip to edit, 3 to 10 seconds, at least 720 pixels on each side. The result is as long as this clip.
elementsFacoltativoarray<object>—fino a 1 elementiOne named subject to bring into the edited clip, built from 2 to 4 images of the same character or object. Write @name in the prompt where it should appear.
reference_image_urlsFacoltativoarray<string (uri)>—fino a 4 elementiOptional reference images, up to 4, for a new character, outfit, object or style. Refer to them as <<<image_1>>>, <<<image_2>>> and so on.
resolutionFacoltativostring720p720p, 1080pOutput resolution. Higher tiers cost more per second.
keep_original_audioFacoltativobooleantrue—Keep the source clip's own sound in the result.

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 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/o3/video-edit",
  "input": {
    "prompt": "Recolor the flowers in soft pastel blue; keep the face and the motion unchanged",
    "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"

Passi successivi

In questa pagina