Image to Video

artany-video-plus-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-plus-i2v","prompt":"Ocean waves at sunrise","duration":5,"resolution":"720p","aspect_ratio":"16:9","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-plus-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.

Field	Type	Required	Description	Default	Constraints
model	string	Yes	Stable Artany public model ID. Do not send provider model IDs.	artany-video-plus-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–12
resolution	string	No	Requested output quality tier. Available values are model-specific and can affect price.	"720p"	Allowed: 480p, 720p, 1080p
aspect_ratio	string	No	Output canvas ratio. It controls the composition frame, not the pixel resolution tier.	"16:9"	Allowed: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9
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–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-video-plus-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	720p	8
5	720p	9
6	720p	10
7	720p	11
8	720p	12
9	720p	13
10	720p	14
11	720p	15
12	720p	16