Text to Video

kling-v3

Draft model pending operator verification

POST /v1/videos/generationsAsync generationFixed Credit pricing

Quick start

Submit a request with this public model ID. The API immediately returns a normalized job; poll GET /v1/jobs/{jobId} while its status is queued or running.

curl -X POST "https://api.artany.ai/v1/videos/generations" \
  -H "Authorization: Bearer $ARTANY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{"model":"kling-v3","prompt":"A paper kite flying above a quiet coast","mode":"std","duration":5,"aspect_ratio":"16:9","audio":false,"multi_shot":false}'

Request

Headers

Header	Required	Description
Authorization	Yes	Bearer token for an Artany API key.
Content-Type	Yes	Must be application/json.
Idempotency-Key	Recommended	8–128 characters. Reusing it with an identical request prevents duplicate jobs and charges.

Body

{
  "model": "kling-v3",
  "prompt": "A paper kite flying above a quiet coast",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9",
  "audio": false,
  "multi_shot": false
}

Request Parameters

Only fields in this model’s public request contract are shown. Defaults are applied before validation and quoting.

Note:Use prompt-only text-to-video or one/two-image image-to-video. Mode selects the output quality tier.

modelstringrequireddefault: "kling-v3"

Stable public model ID for this request.

promptstringrequired

Video content prompt. Describe scenes, actions, styles, and camera movement in detail.

English prompts are recommended for this model.

"a golden retriever running on the beach, sunset, cinematic"

negative_promptstring

Unwanted content or visual characteristics to exclude.

"blurry, low quality, distorted"

modestringdefault: "std"

Generation quality mode.

Allowed: std, pro, 4k

Field description

std: Standard mode (720P)
pro: Professional mode (1080P)
4k: 4K mode

stdpro4k

durationintegerdefault: 5

Video duration in seconds.

Range: 3–15

Note:Supported range is 3–15 seconds. Send a plain JSON number, not a quoted value.

aspect_ratiostringdefault: "16:9"

Output framing.

Allowed: 1:1, 9:16, 16:9

Field description

16:9: Landscape
9:16: Portrait
1:1: Square

1:19:1616:9

image_urlsarray<string>

Image array for image-to-video.

Items: 1–2

Field description

One image: Used as the first frame.
Two images: Used as the first and last frames.

Note:At most two images are supported. In image-to-video mode, image proportions may determine the effective framing.

audiobooleandefault: false

Whether to generate synchronized video audio.

Allowed: false, true

multi_shotbooleandefault: false

Whether to enable the supported multi-shot generation mode.

Allowed: false, true

shot_typestring

Camera treatment for the supported workflow.

Allowed: customize, intelligence

customizeintelligence

multi_promptarray<object>

Ordered prompt segments for multi-shot generation.

Items: 1–6

element_listarray

Supported named visual elements for the request.

Items: 1–3

Use Cases

Choose the request shape that matches the source media you provide. The examples use the public model ID and accepted public fields.

Text-to-video

Choose a quality mode and describe the scene.

{
  "model": "kling-v3",
  "prompt": "A paper kite flying above a quiet coast",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9",
  "audio": false
}

First/last-frame video

Use one image as the opening frame or two images as both endpoints.

{
  "model": "kling-v3",
  "prompt": "The kite rises into the clouds",
  "image_urls": [
    "https://example.com/first-frame.jpg",
    "https://example.com/last-frame.jpg"
  ],
  "mode": "pro",
  "duration": 5
}

Response and task status

A successful asynchronous submission returns HTTP 202 with a supplier-neutral job.

{
  "id": "job_…",
  "object": "generation.job",
  "model": "kling-v3",
  "status": "queued",
  "progress": 0,
  "output": null,
  "error": null,
  "billing": {
    "estimated_credits": "…",
    "frozen_credits": "…",
    "charged_credits": "0",
    "state": "frozen",
    "price_version": "2026-07-18.picverse-parity"
  },
  "created_at": "2026-07-21T00:00:00.000Z",
  "completed_at": null
}

queued / running: continue polling.
succeeded: retrieve media URLs from output; billing has settled.
failed / canceled: inspect error; frozen Credits are released.

Pricing

The price shown for a matching configuration is the fixed amount settled on successful completion. Price version: 2026-07-18.picverse-parity.

mode	audio	duration	Credits
std	false	3	41
pro	false	3	54
std	false	4	54
std	true	3	61
std	false	5	68
pro	false	4	72
pro	true	3	81
std	true	4	81
std	false	6	81
pro	false	5	90
std	false	7	95
std	true	5	101
pro	true	4	108
pro	false	6	108
std	false	8	108
std	true	6	121
std	false	9	121
pro	false	7	126
pro	true	5	135
std	false	10	135
std	true	7	142
pro	false	8	144
std	false	11	148
pro	true	6	162
std	true	8	162
pro	false	9	162
std	false	12	162
std	false	13	175
pro	false	10	180
std	true	9	182
pro	true	7	189
std	false	14	189
pro	false	11	198
std	true	10	202
std	false	15	202
pro	true	8	216
pro	false	12	216
std	true	11	222
pro	false	13	233
pro	true	9	242
std	true	12	242
pro	false	14	251
4k	true	3	258
4k	false	3	258
std	true	13	263
pro	true	10	269
pro	false	15	269
std	true	14	283
pro	true	11	296
std	true	15	303
pro	true	12	323
4k	true	4	343
4k	false	4	343
pro	true	13	350
pro	true	14	377
pro	true	15	404
4k	true	5	429
4k	false	5	429
4k	true	6	515
4k	false	6	515
4k	true	7	600
4k	false	7	600
4k	true	8	686
4k	false	8	686
4k	true	9	772
4k	false	9	772
4k	true	10	858
4k	false	10	858
4k	true	11	943
4k	false	11	943
4k	true	12	1029
4k	false	12	1029
4k	true	13	1115
4k	false	13	1115
4k	true	14	1200
4k	false	14	1200
4k	true	15	1286
4k	false	15	1286