Artany API

Text to Video

kling-v3-omni

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-omni","prompt":"A paper kite flying above a quiet coast","mode":"std","duration":5,"aspect_ratio":"16:9","multi_shot":false,"audio":false}'

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-omni",
  "prompt": "A paper kite flying above a quiet coast",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9",
  "multi_shot": false,
  "audio": false
}

Request Parameters

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

Note:Unified workflow supporting text, image, video, character-reference, multi-shot, and audio-capable generation.

modelstringrequireddefault: "kling-v3-omni"

Stable public model ID for this request.

promptstringrequired

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

negative_promptstring

Unwanted content or visual characteristics to exclude.

Length: 0–2500

modestringdefault: "std"

Generation quality mode.

Allowed: std, pro, 4k

Field description

std
Standard mode
pro
Professional mode
4k
4K mode
stdpro4k
durationintegerdefault: 5

Target video duration in seconds.

Range: 3–15

aspect_ratiostringdefault: "16:9"

Output framing.

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

1:19:1616:9
image_urlsarray<string>

Image references for image-conditioned generation.

image_with_rolesarray

Role-labelled image references for character or frame consistency.

Field description

url
Image URL.
role
Supported image role for this workflow.
video_listarray

Video references for video-conditioned generation.

Items: 0–1

multi_shotbooleandefault: false

Whether to enable the supported multi-shot generation mode.

shot_typestring

Camera treatment for the supported workflow.

Allowed: customize, intelligence

customizeintelligence
multi_promptarray

Ordered prompt segments used when multi-shot generation is enabled.

Items: 1–6

element_listarray

Supported named visual elements for the request.

Items: 1–3

audiobooleandefault: false

Whether to generate synchronized video audio.

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 an Omni video directly from a prompt.

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

Reference video

Use video input to condition the result.

{
  "model": "kling-v3-omni",
  "prompt": "Keep the movement and change the setting",
  "video_list": [
    "https://example.com/reference.mp4"
  ],
  "mode": "pro",
  "duration": 5
}

Multi-shot video

Enable multi-shot mode and provide ordered prompt segments.

{
  "model": "kling-v3-omni",
  "prompt": "A short product story",
  "mode": "pro",
  "duration": 10,
  "multi_shot": true,
  "multi_prompt": [
    "Wide shot of the product",
    "Close-up as the product rotates"
  ]
}

Response and task status

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

{
  "id": "job_…",
  "object": "generation.job",
  "model": "kling-v3-omni",
  "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.

modeaudiodurationvideo_listCredits
stdfalse3any41
stdtrue3any54
profalse3any54
stdfalse4any54
stdany31 image61
protrue3any68
stdfalse5any68
stdtrue4any72
profalse4any72
proany31 image81
stdany41 image81
stdfalse6any81
stdtrue5any90
protrue4any90
profalse5any90
stdfalse7any95
stdany51 image101
proany41 image108
stdfalse8any108
stdtrue6any108
profalse6any108
protrue5any112
stdany61 image121
stdfalse9any121
stdtrue7any126
profalse7any126
proany51 image135
protrue6any135
stdfalse10any135
stdany71 image142
stdtrue8any144
profalse8any144
stdfalse11any148
protrue7any157
stdany81 image162
proany61 image162
stdtrue9any162
profalse9any162
stdfalse12any162
stdfalse13any175
protrue8any180
stdtrue10any180
profalse10any180
stdany91 image182
proany71 image189
stdfalse14any189
stdtrue11any198
profalse11any198
protrue9any202
stdany101 image202
stdfalse15any202
proany81 image216
stdtrue12any216
profalse12any216
stdany111 image222
protrue10any224
stdtrue13any233
profalse13any233
proany91 image242
stdany121 image242
protrue11any247
stdtrue14any251
profalse14any251
4ktrue3any258
4kfalse3any258
stdany131 image263
protrue12any269
proany101 image269
stdtrue15any269
profalse15any269
stdany141 image283
protrue13any292
proany111 image296
stdany151 image303
protrue14any314
proany121 image323
protrue15any336
4ktrue4any343
4kfalse4any343
proany131 image350
proany141 image377
proany151 image404
4ktrue5any429
4kfalse5any429
4ktrue6any515
4kfalse6any515
4ktrue7any600
4kfalse7any600
4ktrue8any686
4kfalse8any686
4ktrue9any772
4kfalse9any772
4ktrue10any858
4kfalse10any858
4ktrue11any943
4kfalse11any943
4ktrue12any1029
4kfalse12any1029
4ktrue13any1115
4kfalse13any1115
4ktrue14any1200
4kfalse14any1200
4ktrue15any1286
4kfalse15any1286