Developers

Video API

One POST turns a sentence into a short film with native audio. It runs on our own GPU, not a reseller account: MiniMax H3, 20 steps, no distilled shortcut. Billed by the second of finished video — $0.08 a second, and nothing else.

Three steps

What it costs

Eight credits per second of finished video. No per-request fee, no resolution tiers, no charge for a failed render.

All three modes cost the same. A reference render is about 25 seconds of extra setup — a fixed cost, not a multiplier — which is 10% of a 4-second clip and 2% of a 15-second one, so charging a premium for it would be inventing a number. Credits are held when you submit and become the charge on success. A failed or cancelled job is refunded in full, same minute. Render times are measured on our current card and are estimates, not promises — the number that matters is deliver_by in the response.

Three ways to make a clip

Same model, same price, same endpoint — mode picks which one you get.

GET /v1/models tells you which modes are open right now. We turn them on one at a time; a mode that is not open returns mode_unavailable rather than pretending.

How long it takes, honestly

• · One GPU, strictly serial. Your job renders after everything submitted before it. Order is submission order — there is no priority tier to buy.
• · Cost in time grows faster than length: a 15-second clip is not four 4-second clips, it is about ten of them. This is the model, not our queue.
• · Every response carries deliver_by — a timestamp that already includes the queue ahead of you. Poll every 15–30 seconds; polling faster changes nothing.
• · If the queue is deeper than six hours we refuse the submission with capacity_deadline_infeasible rather than accept it and miss the date.

Submit a job

curl -X POST https://spaceskills.shop/v1/videos \
  -H "Authorization: Bearer $SPACESKILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-clip-0001" \
  -d '{
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft golden light, gentle ripples on the water, slow push-in, cinematic",
    "duration_sec": 5
  }'

HTTP/1.1 202 Accepted
{
  "job_id": "vid_8Qk2ZrX1c0Nn",
  "status": "queued",
  "model": "h3/768p",
  "duration_sec": 5,
  "credits_held": 40,
  "balance": 460,
  "queue_position": 2,
  "est_render_sec": 168,
  "deliver_by": "2026-09-09T14:31:07.000Z",
  "poll": "/v1/videos/vid_8Qk2ZrX1c0Nn"
}

Returns 202 with a job_id and the credits held. Send an Idempotency-Key and a retried POST returns the same job instead of charging twice.

curl https://spaceskills.shop/v1/videos/vid_8Qk2ZrX1c0Nn \
  -H "Authorization: Bearer $SPACESKILLS_API_KEY"

{
  "job_id": "vid_8Qk2ZrX1c0Nn",
  "status": "succeeded",
  "duration_sec": 5,
  "seed": 774512900183,
  "credits_held": 0,
  "credits_charged": 40,
  "output": {
    "url": "https://media.spaceskills.shop/relay/vid_8Qk2ZrX1c0Nn.mp4",
    "stored": true
  },
  "error": null,
  "created_at": "2026-09-09T14:21:44.910Z",
  "updated_at": "2026-09-09T14:25:12.338Z"
}

status is one of queued, running, succeeded, failed, cancelled. On succeeded, output.url is the finished MP4 with audio muxed in.

Sending images

Same shape as the Director API: each image is inline base64 or an https URL we fetch.

• · A file is { "name": "hero.jpg", "data_base64": "…" } or { "name": "hero.jpg", "url": "https://…" }. URLs must be https and must not resolve to a private address.
• · 8 MB per image, 16 MB of images per request, 24 MB request body. JPEG, PNG and WebP — we check the actual bytes, not the name or the declared type.
• · Your images are stored on our own server, never in the public bucket the finished clips live in, and the bytes are deleted the moment the job finishes or fails. The job keeps a manifest — slot, size and sha256 — so you can always check what we received.
• · In cast mode the prompt has to refer to the pictures. "A woman walks through rain" ignores your references; "The woman from <Picture 1> walks through rain" does not.

# cast: put a specific face, object or look in the shot
curl -X POST https://spaceskills.shop/v1/videos \
  -H "Authorization: Bearer $SPACESKILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "cast",
    "prompt": "The woman from <Picture 1> walks slowly through a rainy neon street at night, reflections on wet asphalt, rain and distant traffic, slow tracking shot",
    "duration_sec": 6,
    "ref_images": [
      { "name": "her.jpg", "url": "https://example.com/her.jpg" }
    ]
  }'

# animate: start from a photo
curl -X POST https://spaceskills.shop/v1/videos \
  -H "Authorization: Bearer $SPACESKILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "animate",
    "prompt": "The lake ripples as the sun sinks lower, drifting clouds, distant birdsong, slow push-in",
    "duration_sec": 5,
    "first_frame": { "name": "lake.jpg", "url": "https://example.com/lake.jpg" }
  }'

Endpoints

Request fields

Headers: Authorization: Bearer sk_live_… and, recommended, Idempotency-Key: <any string you generate>. A key is remembered per account, so a network retry can never buy the same clip twice.

What comes back

The same job object from submit, poll and list — only the fields that are known yet are filled in.

• · output.url is an MP4 at 1152×640 with native stereo audio already muxed in. There is no separate audio file to fetch.
• · output.stored: true means it sits on our own storage and the link is stable. On the rare false, the render machine is serving it directly and the link dies when that machine is recycled — download it promptly.
• · credits_held becomes credits_charged on success, and drops to zero on failure with a matching refund in your ledger.
• · The finished clip snaps to the model frame grid, so it can land up to 0.35 s short of the seconds you asked for. You are billed on the seconds you asked for.

Writing a prompt that works

The model reads plain prose, English or Chinese. It rewards specificity and punishes lists of adjectives.

• · Name the subject, then what it does, then where, then the light, then the camera. One clause each.
• · One camera move per clip. Two moves in four seconds looks like a mistake, not like style.
• · Say what should be heard. Native audio is generated from the prompt too — "wind and distant traffic" gets you wind and distant traffic.
• · Changing everything at once tells you nothing. Fix the seed and rewrite one clause at a time.

When things go wrong

Limits

• · 30 submissions per 10 minutes per IP; 120 catalogue reads in the same window. Polling a job is not rate limited.
• · One job renders at a time across the whole service — that is the honest constraint of a single card, and it is why deliver_by exists.
• · Five API keys per account. Revoking is immediate.
• · Finished clips stay on our storage; keep your own copy of anything you intend to ship.

Looking for the Director API — brief and material in, a shot-by-shot plan out? That is documented here

Questions, or something behaving oddly? Tell us