Text to Video

veo3.1-lite

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

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

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

Request Parameters

Only fields in this model’s public request contract are shown. Defaults are applied before validation and quoting.

Note:Lightweight text-to-video and image-to-video workflow. The output duration is fixed at 8 seconds.

modelstringrequireddefault: "veo3.1-lite"

Stable public model ID for this request.

promptstringrequired

Text description for the generated video.

Length: 1–∞

durationintegerrequired

Video duration in seconds.

Allowed: 8

Note:This model supports only 8 seconds.

aspect_ratiostringdefault: "16:9"

Output framing.

Allowed: 16:9, 9:16

Field description

16:9: Landscape
9:16: Portrait

16:99:16

resolutionstringdefault: "720p"

Requested output resolution tier.

Allowed: 720p, 1080p, 4k

720p1080p4k

enable_gifboolean

Whether to request GIF output when that output path is enabled.

Use Cases

Choose the request shape that matches the source media you provide. The examples use the public model ID and accepted public fields.

Text-to-video

Create an 8-second video directly from text.

{
  "model": "veo3.1-lite",
  "prompt": "A paper kite above a quiet coast",
  "duration": 8,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

Image-to-video

Guide the motion with a supplied image.

{
  "model": "veo3.1-lite",
  "prompt": "The kite rises into the clouds",
  "duration": 8,
  "image_urls": [
    "https://example.com/kite.jpg"
  ]
}

Response and task status

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

{
  "id": "job_…",
  "object": "generation.job",
  "model": "veo3.1-lite",
  "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.

resolution	Credits
720p	14
1080p	14
4k	114