Image to Video

artany-video-pro-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-video-pro-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

Header	Required	Description
Authorization	Yes	Bearer token for an Artany API key.
Content-Type	Yes	Must be application/json.
Idempotency-Key	Recommended	8–128 characters. Reusing it with an identical request prevents duplicate jobs and charges.

Body

{
  "model": "artany-video-pro-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.

Field	Type	Required	Description	Default	Constraints
model	string	Yes	Stable Artany public model ID.	artany-video-pro-i2v	This exact public model ID.
prompt	string	Yes	Natural-language instruction describing the desired image or video. Include subject, setting, composition, motion, lighting, and style as needed.	—	Length: 1–12000
duration	integer	No	Target generated video length in seconds. Available durations are model-specific and can affect price.	5	Range: 4–15
resolution	string	No	Requested output quality tier. Available values are model-specific and can affect price.	"720p"	Allowed: 480p, 720p, 1080p, 4k
aspect_ratio	string	No	Output canvas ratio. It controls the composition frame, not the pixel resolution tier.	"16:9"	Allowed: 1:1, 3:4, 4:3, 9:16, 16:9, 21:9, auto
audio_enabled	boolean	No	Whether the model should generate synchronized audio when that capability is supported.	false	—
reference_images	array (string items)	Yes	Reference image URLs that guide the generated video. The first image is typically the primary visual reference.	—	Items: 1–9

Response and task status

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

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

duration	resolution	Credits
4	480p	32
5	480p	40
6	480p	48
7	480p	56
8	480p	64
4	720p	69
9	480p	72
10	480p	80
5	720p	86
11	480p	88
12	480p	96
6	720p	104
13	480p	104
14	480p	112
15	480p	120
7	720p	121
8	720p	138
9	720p	155
10	720p	172
4	1080p	173
11	720p	189
12	720p	207
5	1080p	216
13	720p	224
14	720p	241
15	720p	258
6	1080p	259
7	1080p	302
8	1080p	346
4	4k	356
9	1080p	389
10	1080p	432
5	4k	445
11	1080p	475
12	1080p	518
6	4k	534
13	1080p	561
14	1080p	604
7	4k	623
15	1080p	648
8	4k	711
9	4k	800
10	4k	889
11	4k	978
12	4k	1067
13	4k	1156
14	4k	1245
15	4k	1333