Integrations

Altershot API

A simple REST API with API keys: the same tools, recipes and prices as the studio, JSON in and out. Videos render in the background; you poll or come back later.

Set up in 3 steps

  1. 1

    Create an API key

    Integrations → API keys. It's shown once: store it as a secret on your server.

    Create an API key
  2. 2

    Call the API

    Send the key as a bearer token.

    curl https://altershot.com/api/v1/me -H "Authorization: Bearer $ALTERSHOT_API_KEY"
  3. 3

    Make a video

    Then poll GET /v1/videos/{id} until status is succeeded.

    curl https://altershot.com/api/v1/videos -H "Authorization: Bearer $ALTERSHOT_API_KEY" -H "Content-Type: application/json" -d '{"tool":"freestyle","model":"flux_3_max","describe":"a paper boat sails across a puddle in the rain"}'

Endpoints

Base URL https://altershot.com/api. JSON in and out; every request needs Authorization: Bearer <your key>.

GET/v1/meYour coins and whether the first-upload confirmation was given.
GET/v1/modelsTools, qualities, Text to Video models, looks, Cast avatars and prices.
POST/v1/quoteThe coin price of a video before making it.
POST/v1/uploadsStart an upload: returns an upload_url to PUT the file to. First upload: "confirm_rights": true.
POST/v1/uploads/{id}/completeFinish the upload; returns the photo or video id.
GET/v1/uploads?kind=photo|videoYour recent photos or videos.
POST/v1/videosMake a video or a portrait. Same fields as the assistants: tool, photo_id, video_id, trend_id, cast_id, look, describe, script, extra_photo_ids, model, quality, seconds, aspect.
GET/v1/videos/{id}Status, progress, queued flag and, when done, result_url (valid for an hour).
GET/v1/videosYour recent videos.
DELETE/v1/videos/{id}Delete a video and its files.
POST/v1/stitchJoin 2-8 finished videos into one (free).
POST/v1/editAdd word-by-word captions and an outro to a finished video (free), plus animated cards (5 coins per edit).
GET/v1/recipesReady-made recipes; /v1/recipes/{id} adds the steps.
GET/v1/trendsTrend clips to use as trend_id with Body Double or Mimic.

A video

{
  "id": "7c1e…",
  "object": "video",
  "status": "processing",
  "queued": false,
  "tool": "freestyle",
  "quality": "light",
  "seconds": 5,
  "coins": 45,
  "progress": 0.4,
  "result_url": null,
  "created_at": "2026-11-16T10:02:11Z"
}

Errors

Errors come back as { "error": { "code", "message" } } with the HTTP status: 401 bad key, 402 not enough coins, 403 first upload needs confirm_rights, 404 not found, 429 slow down. A video that can't start right away waits in a queue ("queued": true) and starts on its own; if it can't start within about twenty minutes, the coins are refunded.

Good to know

Is there a free tier?
The API uses your coins, at the same prices as the studio. Failed videos are refunded automatically.
Rate limits?
Up to 120 requests a minute per key. Poll a video every 10-20 seconds.
Can I use it in my own app?
Yes, on your server. You're responsible for your users' content and consents (Terms, Section 17).

Other ways to use Altershot

Altershot generates videos with AI models from third-party providers. You are responsible for the content you upload and create and for how you use it; see the Terms and the Acceptable Use Policy. Terms · Acceptable use