Text to Video

veo3.1-quality

VEO 3 video generation; Fast and Quality also support continuation from a successful Artany job.

Commercial useAsync APIfrom 200 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": "veo3.1-quality",
  "operation": "generate",
  "prompt": "A paper kite above a quiet coast",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}

Parameters

Field	Type	Required	Description	Default	Constraints
model	string	Yes	Stable Artany public model ID.	veo3.1-quality	This exact public model ID.
raw	boolean	No	Whether to request the provider's raw or minimally processed output when supported.	—	—
prompt	string	Yes	Natural-language instruction describing the desired image or video. Include subject, setting, composition, motion, lighting, and style as needed.	—	Length: 1–∞
duration	integer	No	Target generated video length in seconds. Available durations are model-specific and can affect price.	—	Allowed: 8
operation	string	Yes	generate creates a new video; remix continues a successful Artany video job.	—	Allowed: generate, remix
enable_gif	boolean	No	Whether to return a GIF-compatible result for a supported video workflow.	—	—
image_urls	array (string items)	No	Public image URLs or supported image data used as source or reference images.	—	Items: 0–3
resolution	string	No	Requested output quality tier. Available values are model-specific and can affect price.	"720p"	Allowed: 720p, 1080p, 4k
aspect_ratio	string	No	Output canvas ratio. It controls the composition frame, not the pixel resolution tier.	"16:9"	Allowed: 16:9, 9:16
source_job_id	string	No	Identifier of a prior Artany job used as the source for a supported remix workflow.	—	—
generation_type	string	No	Provider-supported generation variant for the selected operation.	—	Allowed: frame, reference
official_fallback	boolean	No	Whether to use a supported fallback channel when the primary route is unavailable.	—	—

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": "veo3.1-quality",
  "status": "queued",
  "progress": 0,
  "output": null,
  "error": null,
  "billing": {
    "estimated_credits": "200",
    "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

Modeloperation*prompt*source_job_iddurationaspect_ratioresolutionimage_urlsgeneration_typeenable_gifofficial_fallbackraw

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	resolution	Price
veo3.1-quality	720p	200Credits · ~$2.0000
veo3.1-quality	1080p	200Credits · ~$2.0000
veo3.1-quality	4k	300Credits · ~$3.0000

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":"veo3.1-quality","operation":"generate","prompt":"A paper kite above a quiet coast","duration":8,"aspect_ratio":"16:9","resolution":"720p"}'

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