# Kling Video O3 4K Reference to Video API

> Kling Video O3 4k by KwaiVGI - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.

- Model ID: `kwaivgi/kling-video/o3/4k/reference-to-video`
- Provider: Kling
- Tasks: Image to Video, 4K Video, Reference to Video
- Price: ≈ $2.10 per clip, reference price. Billed at the provider's actual cost; a typical clip is listed at $2.10. Your usage log shows the exact charge.
- Web page: https://scalingtensor.com/models/kwaivgi/kling-video/o3/4k/reference-to-video

## How to call it

Authenticate with the `apiKey` request header. Submit a job, then poll for the result:

1. `POST https://restapi.scalingtensor.com/api/media/generate` with JSON `{ "model": "<model ID>", "params": { ... } }`. The response `data.jobId` identifies the job.
2. `GET https://restapi.scalingtensor.com/api/media/result?jobId=<jobId>` until the status is `completed` or `failed`.
3. A response `code` of 0 means success; otherwise read `msg`.

```bash
curl --request POST 'https://restapi.scalingtensor.com/api/media/generate' \
  --header 'apiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "model": "kwaivgi/kling-video/o3/4k/reference-to-video",
  "params": {
    "image": "https://example.com/your-image.png",
    "prompt": "@Element1 and @Element2 enters the scene from two sides. Elephant starts to play with the ball",
    "duration": 8,
    "end_image": "https://example.com/your-image.png",
    "shot_type": "customize",
    "generate_audio": false
  }
}'
```

## Input parameters

Parameters go inside the `params` object.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `image` | string | Required | Image to use as the first frame of the video. |
| `prompt` | string | Required | Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both. · Max length: 2500 |
| `images` | string[] | Optional | Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 7 total (elements + reference images) is allowed. |
| `duration` | integer | Optional | Video duration in seconds (3-15s). · Options: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 · Default: 5 |
| `end_image` | string | Optional | Image to use as the last frame of the video. |
| `shot_type` | string | Optional | The type of multi‑shot video generation. 'intelligent' lets the model automatically determine shot structure. · Options: customize, intelligent · Default: "customize" |
| `aspect_ratio` | string | Optional | The aspect ratio of the generated image. · Options: 16:9, 9:16, 1:1 |
| `multi_prompt` | object[] | Optional | List of prompts for multi‑shot video generation. |
| `generate_audio` | boolean | Optional | Whether to generate native audio for the video. · Default: false |

## FAQ

### How much does the Kling Video O3 4K Reference to Video API cost?

Kling Video O3 4K Reference to Video is billed at the provider's actual cost for each job (per clip, reference price). The charge is deducted from your prepaid ScalingTensor wallet.

### How do I call the Kling Video O3 4K Reference to Video API?

Send POST /api/media/generate with "model": "kwaivgi/kling-video/o3/4k/reference-to-video" and the parameters in a params object, using your apiKey header. The call returns a jobId. Poll GET /api/media/result?jobId=... until the status is completed, then read the output URL from the result.

### Which parameters does Kling Video O3 4K Reference to Video accept?

Required: image and prompt. Optional: images, duration, end_image, shot_type, aspect_ratio, multi_prompt and generate_audio. The parameter table on this page describes each one.

### Do I need a Kling account to use Kling Video O3 4K Reference to Video?

No. You call Kling Video O3 4K Reference to Video with your ScalingTensor API key and pay from your ScalingTensor wallet. The same key works for every other model in the catalog.