Kling 3.0 API-Referenz
4K-Clips, Multi-Shot-Schnitte und Bewegungssteuerung
Mit einem einzigen PopNow-API-Schlüssel rufst du Kling 3.0 aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.
Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.
Auf einen Blick
- Hersteller
- Kuaishou
- Ergebnis
- Video
- Ab
- 10.08 Credits pro Sekunde Ergebnis ($0.1008)
- Typische Dauer
- etwa 400 s
1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.
Video erstellen
kling/3.0/text-to-video
Preis
| Option | Credits (pro Sekunde Ergebnis) | US-Dollar |
|---|---|---|
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 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 2.500 Zeichen | Describe the scene, the action and the camera. With sound on, add dialogue in quotes and the sounds you want. |
negative_promptOptional | string | — | bis zu 2.500 Zeichen | What to keep out of the clip: objects, looks or motion you do not want. |
aspect_ratioOptional | string | 16:9 | 16:9, 9:16, 1:1 | Output aspect ratio. |
resolutionOptional | string | 720p | 720p, 1080p, 4k | Output resolution. Higher tiers cost more per second. |
generate_audioOptional | boolean | false | — | Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second. |
duration_secondsOptional | integer | 5 | 3 bis 15 | Output length in whole seconds, from 3 to 15. Billed per second. |
shot_typeOptional | 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_promptOptional | array<object> | — | bis zu 6 Einträge | 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_scaleOptional | number | 0.5 | 0 bis 1 | How closely the clip follows the prompt, from 0 to 1. Higher sticks to the prompt more; lower gives the model more freedom. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
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"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Bild zu Video
kling/3.0/image-to-video
Preis
| Option | Credits (pro Sekunde Ergebnis) | US-Dollar |
|---|---|---|
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 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 2.500 Zeichen | Describe what happens after the opening frame: the action, the camera and, with sound on, the sounds. |
image_urlPflicht | string (uri) | — | — | Opening frame. The clip starts from this image. |
negative_promptOptional | string | — | bis zu 2.500 Zeichen | What to keep out of the clip: objects, looks or motion you do not want. |
last_image_urlOptional | string (uri) | — | — | Optional closing frame the clip should end on. |
resolutionOptional | string | 720p | 720p, 1080p, 4k | Output resolution. Higher tiers cost more per second. |
generate_audioOptional | boolean | false | — | Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second. |
duration_secondsOptional | integer | 5 | 3 bis 15 | Output length in whole seconds, from 3 to 15. Billed per second. |
shot_typeOptional | 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_promptOptional | array<object> | — | bis zu 6 Einträge | 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_scaleOptional | number | 0.5 | 0 bis 1 | How closely the clip follows the prompt, from 0 to 1. Higher sticks to the prompt more; lower gives the model more freedom. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
Das Beispiel nutzt in image_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.
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"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Bewegungssteuerung
kling/3.0/character-animation
Preis
| Option | Credits (pro Sekunde Ergebnis) | US-Dollar |
|---|---|---|
720p | 15.12 | $0.1512 |
1080p | 20.16 | $0.2016 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
image_urlPflicht | string (uri) | — | — | The character to animate: one clear, full or half-body picture of the person. |
video_urlPflicht | string (uri) | — | — | Driving clip, 3 to 30 seconds: the moves, expressions and gestures to copy. The result is as long as this clip. |
promptOptional | string | — | bis zu 2.500 Zeichen | Optional notes on the result: the setting, the look, anything the driving clip does not show. |
negative_promptOptional | string | — | bis zu 2.500 Zeichen | What to keep out of the result: objects, looks or motion you do not want. |
resolutionOptional | string | 720p | 720p, 1080p | Output resolution. Higher tiers cost more per second. |
keep_original_audioOptional | boolean | true | — | Keep the driving clip's own sound in the result. |
character_orientationOptional | 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_typeOptional | string | customize | customize, intelligent | How the shots are planned: customize keeps to your inputs, intelligent lets the model plan the shots itself. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
Das Beispiel nutzt in image_url, video_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.
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"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"