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
- 1Create an API key
Create an API key
Integrations → API keys. It's shown once: store it as a secret on your server.
- 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
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/me | Your coins and whether the first-upload confirmation was given. |
| GET | /v1/models | Tools, qualities, Text to Video models, looks, Cast avatars and prices. |
| POST | /v1/quote | The coin price of a video before making it. |
| POST | /v1/uploads | Start an upload: returns an upload_url to PUT the file to. First upload: "confirm_rights": true. |
| POST | /v1/uploads/{id}/complete | Finish the upload; returns the photo or video id. |
| GET | /v1/uploads?kind=photo|video | Your recent photos or videos. |
| POST | /v1/videos | Make 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/videos | Your recent videos. |
| DELETE | /v1/videos/{id} | Delete a video and its files. |
| POST | /v1/stitch | Join 2-8 finished videos into one (free). |
| POST | /v1/edit | Add word-by-word captions and an outro to a finished video (free), plus animated cards (5 coins per edit). |
| GET | /v1/recipes | Ready-made recipes; /v1/recipes/{id} adds the steps. |
| GET | /v1/trends | Trend 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