---
title: "Text to Video"
method: POST
path: "/kling/v1/videos/text2video"
---

# Text to Video

`POST /kling/v1/videos/text2video`

## Headers

- `Content-Type` string

## Request body

- object
  - `prompt` string, required — Text prompt describing the video to generate. Maximum 500 characters.
  - `negative_prompt` string — Elements to exclude from the video. Maximum 200 characters.
  - `aspect_ratio` '16:9' | '9:16' | '1:1' — Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field.
  - `callback_url` string — Webhook URL to receive task status updates when the task completes.
  - `model_name` 'kling-v1' | 'kling-v1-6' | 'kling-v2-master' | 'kling-v2-1-master' | 'kling-v2-5-turbo' | 'kling-v2-6' | 'kling-v3' — Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint.
  - `cfg_scale` number — Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.
  - `mode` 'std' | 'pro' — Generation mode. `std` for standard (faster), `pro` for professional (higher quality). The default is `std`.
  - `duration` string — Output video length in seconds. Use `5` or `10`; omit to use `5`.
  - `camera_control` object — Camera motion preset or manual configuration. Omit for automatic camera movement.
    - `type` 'simple' | 'down_back' | 'forward_up' | 'right_turn_forward' | 'left_turn_forward' — Preset camera motion type.
    - `config` object — Manual camera movement axes. Each value ranges from -10 to 10.
      - `horizontal` integer — Horizontal dolly (truck). Negative = left, positive = right. Range: -10 to 10.
      - `vertical` integer — Vertical dolly (pedestal). Negative = down, positive = up. Range: -10 to 10.
      - `pan` integer — Horizontal rotation (pan). Negative = left, positive = right. Range: -10 to 10.
      - `tilt` integer — Vertical rotation (tilt). Negative = down, positive = up. Range: -10 to 10.
      - `roll` integer — Axial rotation (roll). Negative = counter-clockwise, positive = clockwise. Range: -10 to 10.
      - `zoom` integer — Zoom. Negative = zoom out, positive = zoom in. Range: -10 to 10.
  - `external_task_id` string — Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.
  - `sound` 'on' | 'off' — Optional generated-audio switch for models that support video sound. Use `on` or `off`, or omit the field for the model default.

## Response `200`

Successful Response

- object
  - `code` integer — Error code; specifically define the error code
  - `message` string — error message
  - `request_id` string — Request ID, system-generated, for tracking requests, troubleshooting issues
  - `data` object
    - `task_id` string — Task ID, system generated
    - `task_status` string — Task status, enumerated values: submitted, processing, succeed, failed.
    - `created_at` integer — Task creation time, Unix timestamp, in ms.
    - `updated_at` integer — Task update time, Unix timestamp, in ms.

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)