API quickstart

1. Create an API key

In the dashboard, open API key and create a key. It starts with ms_ and is shown once. Keep it on your server: anyone with the key can spend your workspace’s credits.

export MOSIO_API_KEY=ms_...

2. Create a video

curl https://app.mosio.me/v1/videos \
  -H "x-api-key: $MOSIO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "template": "promo-produk@1",
    "variables": {
      "judul": "Es Kopi Gula Aren",
      "harga": "Rp18.000",
      "harga_coret": "Rp22.000"
    },
    "idempotency_key": "kopi-senja-001"
  }'

The response comes back straight away, with status: "queued":

{
  "id": "vid_6f1c2b9e-0c1a-4b7e-9d0e-2f3a4b5c6d7e",
  "status": "queued",
  "template": "promo-produk@1",
  "created_at": "2026-10-20T10:15:01.105Z",
  "finished_at": null,
  "duration_seconds": null,
  "output_url": null,
  "error": null
}

Business name, colours, and contact come from your brand kit unless you send them. The variables each template takes are in the template reference.

Sending the same idempotency_key again returns the same video instead of rendering a second one. Reusing a key with a different body is refused with 409.

3. Wait for it

Poll every few seconds until status is done (or failed):

curl https://app.mosio.me/v1/videos/vid_6f1c2b9e-0c1a-4b7e-9d0e-2f3a4b5c6d7e \
  -H "x-api-key: $MOSIO_API_KEY"

A 15-second video usually finishes in under a minute.

4. Download

When status is done, output_url is a short-lived link to the MP4. Download it right away, or fetch the video again later for a fresh link.

curl -L -o video.mp4 "<output_url>"

Render your own HTML instead of a template: Design your own video.
Every endpoint, field, and error: REST API.