Image to Video

artany-kling-3-i2v

Picverse phase-one video capability.

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":"artany-kling-3-i2v","prompt":"Ocean waves at sunrise","duration":5,"resolution":"720p","aspect_ratio":"16:9","reference_images":["https://example.com/frame.png"]}'

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": "artany-kling-3-i2v",
  "prompt": "Ocean waves at sunrise",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "reference_images": [
    "https://example.com/frame.png"
  ]
}

Parameters

Only these fields are accepted. Defaults are applied before validation and quoting.

FieldTypeRequiredDescriptionDefaultConstraints
modelstringYesStable Artany public model ID. Do not send provider model IDs.artany-kling-3-i2vThis exact public model ID.
promptstringYesNatural-language instruction describing the desired image or video. Include subject, setting, composition, motion, lighting, and style as needed.Length: 1–12000
durationintegerNoTarget generated video length in seconds. Available durations are model-specific and can affect price.5Range: 3–15
resolutionstringNoRequested output quality tier. Available values are model-specific and can affect price."720p"Allowed: 720p, 1080p, 4k
aspect_ratiostringNoOutput canvas ratio. It controls the composition frame, not the pixel resolution tier."16:9"Allowed: 16:9, 9:16, 1:1
audio_enabledbooleanNoWhether the model should generate synchronized audio when that capability is supported.false
reference_imagesarray (string items)YesReference image URLs that guide the generated video. The first image is typically the primary visual reference.Items: 1–2

Response and task status

A successful submission returns HTTP 202. The response shape is the same for every Artany model; provider-specific task formats are not exposed.

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

durationresolutionaudio_enabledCredits
3720pany12
4720pany14
5720pany15
3720ptrue15
31080pany17
6720pany17
4720ptrue17
5720ptrue18
7720pany19
41080pany20
31080ptrue20
6720ptrue20
8720pany21
51080pany22
7720ptrue22
9720pany23
41080ptrue23
10720pany24
8720ptrue24
61080pany25
51080ptrue25
34kany26
11720pany26
9720ptrue26
71080pany27
10720ptrue27
12720pany28
61080ptrue28
34ktrue29
11720ptrue29
44kany30
81080pany30
13720pany30
71080ptrue30
12720ptrue31
14720pany32
54kany33
91080pany33
15720pany33
44ktrue33
81080ptrue33
13720ptrue33
101080pany35
14720ptrue35
54ktrue36
91080ptrue36
15720ptrue36
64kany37
111080pany38
101080ptrue38
64ktrue40
74kany41
121080pany41
111080ptrue41
131080pany43
74ktrue44
121080ptrue44
84kany45
141080pany46
131080ptrue46
151080pany48
84ktrue48
94kany49
141080ptrue49
151080ptrue51
94ktrue52
104kany53
104ktrue56
114kany57
114ktrue60
124kany61
124ktrue64
134kany65
134ktrue68
144kany69
144ktrue72
154kany73
154ktrue76