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","audio_enabled":false,"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",
  "audio_enabled": false,
  "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.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: 1:1, 9:16, 16:9
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 asynchronous submission returns HTTP 202 with a supplier-neutral job.

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