Text to Video

kling-v3

Draft model pending operator verification

Commercial useAsync APIfrom 68 Credits

API reference

Submit this model to the capability endpoint, then poll the returned job until it is terminal. Only the parameters below are accepted.

POST /v1/videos/generations

Required headers

Authorization: Bearer $ARTANY_API_KEY
Content-Type: application/json
Idempotency-Key: unique-request-id

Use a new 8–128 character Idempotency-Key for each logical generation. Retrying the same request with the same key will not double-charge.

Request 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
}

Parameters

Field	Type	Required	Description	Default	Constraints
model	string	Yes	Stable Artany public model ID.	kling-v3	This exact public model ID.
mode	string	No	Model mode or quality tier. Available values determine the supported output configuration.	"std"	Allowed: std, pro, 4k
audio	boolean	No	Audio mode or audio-generation option supported by this video model.	false	Allowed: false, true
prompt	string	Yes	Natural-language instruction describing the desired image or video. Include subject, setting, composition, motion, lighting, and style as needed.	—	—
duration	integer	No	Target generated video length in seconds. Available durations are model-specific and can affect price.	5	Range: 3–15
shot_type	string	No	Camera or shot mode supported by the selected video model.	—	Allowed: customize, intelligence
image_urls	array (string items)	No	Public image URLs or supported image data used as source or reference images.	—	Items: 1–2
multi_shot	boolean	No	Whether the request uses the model's supported multi-shot video mode.	false	Allowed: false, true
aspect_ratio	string	No	Output canvas ratio. It controls the composition frame, not the pixel resolution tier.	"16:9"	Allowed: 1:1, 9:16, 16:9
element_list	array	No	Reference elements used by a model that supports structured subject consistency.	—	Items: 1–3
multi_prompt	array (object items)	No	Ordered prompts for a supported multi-shot generation workflow.	—	Items: 1–6
negative_prompt	string	No	Elements, styles, or visual characteristics to avoid in the generated result.	—	—

Accepted response

The submit endpoint returns HTTP 202 with a normalized job. Poll GET /v1/jobs/{jobId} until the status is terminal.

{
  "id": "job_…",
  "object": "generation.job",
  "model": "kling-v3",
  "status": "queued",
  "progress": 0,
  "output": null,
  "error": null,
  "billing": {
    "estimated_credits": "68",
    "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
}

Lifecycle and failures

queued / running — wait and poll again.
succeeded — read output URLs from output; the actual charge is settled.
failed / canceled — inspect error; frozen Credits are released.
For a schema error, the API returns an error object and identifies the invalid field in param when applicable.

Input

Modelprompt*negative_promptmodedurationaspect_ratioimage_urlsaudiomulti_shotshot_typemulti_promptelement_list

Runs are billed to your Credits at the listed price — same engine as the public API.

Output

Run the model to see results here

Pricing details

Fixed catalog pricing — the listed price is exactly what a run settles for. Version 2026-07-18.picverse-parity.

Model	mode	audio	duration	Price
kling-v3	std	false	3	41Credits · ~$0.4100
kling-v3	pro	false	3	54Credits · ~$0.5400
kling-v3	std	false	4	54Credits · ~$0.5400
kling-v3	std	true	3	61Credits · ~$0.6100
kling-v3	std	false	5	68Credits · ~$0.6800
kling-v3	pro	false	4	72Credits · ~$0.7200
kling-v3	pro	true	3	81Credits · ~$0.8100
kling-v3	std	true	4	81Credits · ~$0.8100

Integrate in minutes

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}'

# poll until terminal
curl "https://api.artany.ai/v1/jobs/{job_id}" \
  -H "Authorization: Bearer $ARTANY_API_KEY"