Kling 3.0 4K

Kling 3.0 4K API. Native 4K AI video from text or an image, 3-15 seconds, with native audio and first/last-frame control.

POST/v1/media/queue

from $0.714/second

Overview

Kling 3.0 4K — Kling 3.0 rendered at native 4K, with native audio, multi-shot prompts and first/last-frame control. Async operation — submit a job, poll for completion.

Property	Value
Model ID	`kwaivgi/kling-v3.0-4k`
Alias	`kling-4k`
Provider	Kling
Inputs	text-to-video, image-to-video
Resolution	4K (native)
Aspect Ratios	16:9, 9:16, 1:1
Duration	3–15 seconds
Audio Generation	Supported (on by default)
Billing	Per job — priced when queued, charged only on success
Pricing	from $0.714/second

Usage

All media models use the async job queue. Submit a job, then poll for the result.

Step 1: Submit Job

Text-to-Video

options.params passes this model's own parameters (see Model parameters).

const res = await fetch('https://api.yepapi.com/v1/media/queue', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'kwaivgi/kling-v3.0-4k',
    prompt: 'A cinematic drone shot over a rugged coastline at golden hour',
    options: {
      aspectRatio: '16:9',
      duration: '5',
      generateAudio: true,
      params: {
        cfg_scale: 0.6,
      },
    },
  }),
});
const { data } = await res.json();
// data.jobId — use this to poll for results

curl -X POST https://api.yepapi.com/v1/media/queue \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "kwaivgi/kling-v3.0-4k", "prompt": "A cinematic drone shot over a rugged coastline", "options": {"aspectRatio": "16:9", "duration": "5", "generateAudio": true, "params": {"cfg_scale": 0.6}}}'

Image-to-Video

Pass a reference image via imageData. By default it is the first frame; set options.imageRole to last_frame to make it the final frame instead.

const res = await fetch('https://api.yepapi.com/v1/media/queue', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'kwaivgi/kling-v3.0-4k',
    prompt: 'Animate this scene — clouds drifting, light changing',
    options: {
      duration: '5',
      generateAudio: true,
      imageRole: 'first_frame',
    },
    imageData: {
      mimeType: 'image/jpeg',
      base64: '...', // Base64-encoded image
    },
  }),
});

curl -X POST https://api.yepapi.com/v1/media/queue \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "kwaivgi/kling-v3.0-4k", "prompt": "Animate this scene — clouds drifting, light changing", "options": {"duration": "5", "generateAudio": true, "imageRole": "first_frame"}, "imageData": {"mimeType": "image/jpeg", "base64": "..."}}'

Step 2: Poll for Result

const status = await fetch(`https://api.yepapi.com/v1/media/status/${data.jobId}`, {
  headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const { data: job } = await status.json();
// job.status — "pending" | "processing" | "completed" | "failed"
// job.result.video — { mimeType, base64 } when completed

curl https://api.yepapi.com/v1/media/status/JOB_ID \
  -H "x-api-key: YOUR_API_KEY"

Request Body

Parameter	Type	Required	Description	Default
`model`	`string`	Yes	`kwaivgi/kling-v3.0-4k` or alias `kling-4k`	—
`prompt`	`string`	Yes	Text description of the video to generate	—
`options.aspectRatio`	`string`	No	One of: 16:9, 9:16, 1:1 (text-to-video only)	`16:9`
`options.duration`	`string` or `number`	No	`3` to `15` (seconds)	`5`
`options.generateAudio`	`boolean`	No	Generate an audio track for the video	`true`
`options.imageRole`	`string`	No	How to use the input image: `first_frame` or `last_frame`	`first_frame`
`options.params`	`object`	No	Model-specific parameters under their own names: `cfg_scale`, `elements`, `multi_prompt`, `multi_shots`. Unknown names return 400	—
`imageData.mimeType`	`string`	No	MIME type of input image (image/png, image/jpeg, image/webp)	—
`imageData.base64`	`string`	No	Base64-encoded input image for image-to-video generation	—

Options are validated when you submit: an unsupported duration, resolution or value returns 400 naming the allowed values.

Model parameters

Pass these inside options.params.

Parameter	Type	Allowed	Description	Default
`cfg_scale`	`number`	0–1	How closely to follow the prompt (higher = stricter)	`0.5`
`elements`	`array`	—	Kling element IDs to keep consistent across the clip	—
`multi_prompt`	`array`	up to 6 shots	Multi-shot script: list of `{ prompt, duration }` shots	—
`multi_shots`	`boolean`	—	Generate a multi-shot sequence	`false`

Features

Native 4K output
Text-to-video and image-to-video, 3–15 seconds
Native audio at no extra cost (on by default)
First or last frame from imageData
Multi-shot sequences via options.params.multi_shots / multi_prompt

Pricing

Tier	≈ Cost/sec	5-second video
All requests	$0.714	$3.57

Prices shown are for a 5-second clip at the default settings; longer clips cost proportionally more. Audio is included at no extra cost. Each job is priced when it's queued — the exact quote for your duration, resolution and options — and charged only if it succeeds. Failed or moderated jobs are free.

Info

Video jobs can take several minutes to complete. When capacity is busy, jobs wait in the queue (status stays pending or processing) — no action needed. Results retained for 1 hour.

Under the Hood

Kling 3.0 4K

On this page