Text to Video

kling-v3-turbo

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-turbo","prompt":"A paper kite flying above a quiet coast","aspect_ratio":"16:9","resolution":"1080p","duration":5}'

Request

Headers

HeaderRequiredDescription
AuthorizationYesBearer token for an Artany API key.
Content-TypeYesMust be application/json.
Idempotency-KeyRecommended8–128 characters. Reusing it with an identical request prevents duplicate jobs and charges.

Body

{
  "model": "kling-v3-turbo",
  "prompt": "A paper kite flying above a quiet coast",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

Request Parameters

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

Note:Text-to-video workflow that becomes first-frame image-to-video when first_frame_image is supplied.

modelstringrequireddefault: "kling-v3-turbo"

Stable public model ID for this request.

promptstringrequired

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

first_frame_imagestring

Optional opening image. Providing it selects first-frame image-to-video generation.

"https://example.com/first-frame.jpg"
aspect_ratiostringdefault: "16:9"

Output framing for text-to-video. The supplied first frame can determine framing for image-conditioned generation.

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

1:19:1616:9
resolutionstringdefault: "1080p"

Output resolution tier.

Allowed: 720p, 1080p

720p1080p
durationintegerdefault: 5

Target video duration in seconds.

Range: 3–15

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

Create a Turbo video directly from text.

{
  "model": "kling-v3-turbo",
  "prompt": "A paper kite flying above a quiet coast",
  "duration": 5,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

First-frame video

Use an opening image to condition the generation.

{
  "model": "kling-v3-turbo",
  "prompt": "The kite rises into the clouds",
  "first_frame_image": "https://example.com/first-frame.jpg",
  "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-turbo",
  "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.

durationresolutionCredits
3720p69
31080p86
4720p92
41080p115
5720p115
6720p138
51080p144
7720p161
61080p172
8720p184
71080p201
9720p206
10720p229
81080p230
11720p252
91080p258
12720p275
101080p287
13720p298
111080p316
14720p321
121080p344
15720p344
131080p373
141080p401
151080p430