beatra
Capabilities

Video generation

Planned: generate and transform video clips.

Status: Planned. Not callable yet. The shape below is design direction, not contract.

Video generation will power ads, product demos, storyboards, localization variants, and motion assets.

Planned shape

POST /v1/videos
Authorization: Bearer <api_key>
Content-Type: application/json
Idempotency-Key: <uuid>
 
{
  "model": "auto",
  "prompt": "...",
  "duration_seconds": 6,
  "aspect_ratio": "16:9"
}
202 Accepted
{ "task_id": "tsk_..." }

Reference clips or images for video-to-video will arrive via the uploads mechanism.

How delivery will work

Video jobs use the async task model — these are long-running, expect minutes rather than seconds. Plan around polling cadence and customer callbacks.

Prepare now

  • Put long-running media work behind your own queue.
  • Cap per-customer concurrency in your product.
  • Design progress and failure states before accepting customer jobs.
  • Track Roadmap before wiring client calls.

On this page