Mira Video

Mira Video generates short videos from a text prompt or from a first-frame image (image-to-video). Ideal for teasers, B-roll, animated avatars and social content.

Capabilities

Text-to-video — describe a scene, receive a video clip
Image-to-video — pass a starting frame in first_frame — the model animates it
Aspect ratios — 16:9, 9:16, 1:1
Duration — 5 or 10 seconds (choose duration_seconds)
Resolution — 720p / 1080p

Async flow (job + polling)

Video generation takes 30 seconds to a few minutes. The endpoint returns a job id; poll /v1/video/jobs/{id} until status="succeeded".

Request: text-to-video

cURL

curl https://api.vmira.ai/v1/video/generate \
  -H "Authorization: Bearer $MIRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A drone glides over snow-capped mountains at dawn",
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "resolution": "1080p"
  }'

Request: image-to-video

cURL

curl https://api.vmira.ai/v1/video/generate \
  -H "Authorization: Bearer $MIRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Camera slowly pulls back, leaves rustle in the wind",
    "first_frame": "https://example.com/frame.jpg",
    "aspect_ratio": "9:16",
    "duration_seconds": 10
  }'

Response: job

JSON

{
  "id": "video_job_x1y2z3",
  "status": "queued",
  "created_at": 1714000000
}

Poll status

cURL

curl https://api.vmira.ai/v1/video/jobs/video_job_x1y2z3 \
  -H "Authorization: Bearer $MIRA_API_KEY"

JSON

{
  "id": "video_job_x1y2z3",
  "status": "succeeded",
  "video_url": "https://cdn.vmira.ai/video/x1y2z3.mp4",
  "duration_seconds": 5,
  "aspect_ratio": "16:9"
}

Parameters

prompt — required description of motion and scene
first_frame — optional URL or data-URI for starting frame (enables image-to-video)
aspect_ratio — 16:9 | 9:16 | 1:1
duration_seconds — 5 | 10
resolution — 720p | 1080p

See /pricing for current per-second video cost and /docs/api/reference for the full endpoint specification.