Media Community listing

Shotstack

Shotstack is a video, image and audio editing service that allows for the automated generation of videos, images and audio using JSON and a RESTful API.

https://api.shotstack.io/v15 endpointsapiKey authno ratings yet100.0% uptime

Bring your own key. This API needs your own Shotstack key - get one from the provider, add it once below, and the proxy injects it on every call. Your OmniStream plan covers the unified SDK, key storage, and proxy - the provider's own rate limits still apply to your key.

This is a community listing. If you own this API, you can request ownership.

Install the SDK

npm install omnistream-sdk

import { OmniClient } from "omnistream-sdk";

const omni = new OmniClient({ token: process.env.OMNI_KEY! });

// One key reaches every API on the marketplace.
const data = await omni.call("shotstack/getAssetByRenderId");

One install, one key - the same client calls every API on the marketplace.

Try it

Try itone Omni key, every API

Your Omni key

GET/assets/render/{id}

id*

The render id associated with the asset in UUID format

5 endpoints

GET/assets/render/{id}

Get Asset by Render ID

id*

GET/assets/{id}

Get Asset

id*

DELETE/assets/{id}

Delete Asset

id*

POST/render

Render Asset

GET/render/{id}

Get Render Status

id*

Typed client (copy, no install)

shotstack.ts

/**
 * Shotstack - generated by OmniStream from Shotstack's OpenAPI spec.
 * One typed method per endpoint. A single Omni key reaches the API.
 */
const DEFAULT_BASE = "https://grid.skinvaults.online/v1/proxy/shotstack";

export class ShotstackError extends Error {
  status: number;
  code?: string;
  constructor(status: number, code: string | undefined, message?: string) {
    super(message || `Shotstack error ${status}`);
    this.name = "ShotstackError";
    this.status = status;
    this.code = code;
  }
}

export interface ShotstackOptions {
  baseUrl?: string;
  fetch?: typeof fetch;
  timeoutMs?: number;
}

export class Shotstack {
  /** @param token Your OmniStream key (one key for every API). */
  constructor(private token: string, private opts: ShotstackOptions = {}) {
    if (!token) throw new Error("Shotstack: token is required");
  }
  rateLimit: { remainingMinute?: number; remainingDay?: number } | null = null;

  private async _request(method: string, path: string, { params, body }: { params?: Record<string, unknown>; body?: unknown } = {}): Promise<any> {
    const f = this.opts.fetch ?? globalThis.fetch;
    const url = new URL((this.opts.baseUrl ?? DEFAULT_BASE).replace(/\/+$/, "") + path);
    if (params) for (const [k, v] of Object.entries(params)) if (v != null) url.searchParams.set(k, String(v));
    const headers: Record<string, string> = { "x-omni-key": this.token };
    if (body !== undefined) headers["content-type"] = "application/json";
    const res = await f(url, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined });
    this.rateLimit = {
      remainingMinute: Number(res.headers.get("x-ratelimit-remaining-minute")) || undefined,
      remainingDay: Number(res.headers.get("x-ratelimit-remaining-day")) || undefined,
    };
    const data = await res.json().catch(() => ({}));
    if (!res.ok) throw new ShotstackError(res.status, data?.error?.code, data?.error?.message);
    return data.data ?? data;
  }

  /** Get Asset by Render ID */
  getAssetByRenderId(params: { "id": string }): Promise<any> {
    return this._request("GET", "/assets/render/{id}", { params });
  }

  /** Get Asset */
  getAsset(params: { "id": string }): Promise<any> {
    return this._request("GET", "/assets/{id}", { params });
  }

  /** Delete Asset */
  deleteAsset(params: { "id": string }): Promise<any> {
    return this._request("DELETE", "/assets/{id}", { params });
  }

  /** Render Asset */
  postRender(body: unknown): Promise<any> {
    return this._request("POST", "/render", { body });
  }

  /** Get Render Status */
  getRender(params: { "id": string }): Promise<any> {
    return this._request("GET", "/render/{id}", { params });
  }
}

export default Shotstack;

Reviews

No reviews yet. Be the first to rate this API.

Frequently asked questions

Do I need an API key to use Shotstack?

Yes. Shotstack uses apiKey authentication, so you bring your own key from the provider. You store it once on OmniStream and the proxy injects it into every call, so your code only ever sends your Omni key.

What can you do with the Shotstack API?

Shotstack is a video, image and audio editing service that allows for the automated generation of videos, images and audio using JSON and a RESTful API. It exposes 5 endpoints over GET, DELETE, POST, including GET /assets/render/{id}, GET /assets/{id}, DELETE /assets/{id}.

How do I call Shotstack from Python, TypeScript, Rust or Go?

Install the OmniStream SDK for your language and call Shotstack through it. The client is generated from this API's OpenAPI spec, so parameters and responses are fully typed, and the same client also calls every other API in the marketplace.

Is Shotstack free to use on OmniStream?

You can start on the free plan. OmniStream charges for the unified SDK, key storage and proxy rather than for Shotstack itself, and Shotstack's own rate limits still apply to your provider key.