Shotstack

Shotstack is a cloud video-editing platform that turns a JSON timeline into a rendered video, image, or audio file. The Edit API renders programmatically from a JSON edit specification and templates, the Ingest API uploads and transforms source footage, the Serve API hosts and delivers generated assets, and the Create API generates AI assets such as text-to-speech, text-to-image, and image-to-video.

5 APIs 0 Features

VideoVideo EditingMediaRenderingGenerative AI

APIs

Shotstack Edit (Render) API

Queue a video, image, or audio render from a JSON edit specification (timeline, tracks, clips, output) and poll render status by ID. Supports AI generative assets (text-to-speec...

Shotstack Templates API

Save, list, retrieve, update, and delete reusable edit templates, then render them with merge-field variable substitution for data-driven, automated video generation at scale.

Shotstack Ingest API

Upload, store, and transform source footage, images, audio, and fonts from a URL or direct upload, with optional renditions and transcription, ready for use by the Edit API.

Shotstack Serve API

Inspect, manage, and delete the hosting of assets generated by the Edit and Ingest APIs, retrieve CDN URLs by asset or render ID, and transfer files to external destinations.

Shotstack Create (AI Assets) API

Generate AI assets - text-to-speech, text-to-image, image-to-video, and text generation - through built-in (Shotstack) and third-party (ElevenLabs, Stability AI) providers, retu...

Collections

Shotstack API

OPEN

Pricing Plans

Shotstack Plans Pricing

4 plans

PLANS

Rate Limits

Shotstack Rate Limits

4 limits

RATE LIMITS

FinOps

Shotstack Finops

FINOPS

Resources

👥

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Shotstack API
  version: '1.0'
request:
  auth:
    type: apikey
    apikey:
      key: x-api-key
      value: '{{apiKey}}'
      in: header
items:
- info:
    name: Edit
    type: folder
  items:
  - info:
      name: Queue a render
      type: http
    http:
      method: POST
      url: https://api.shotstack.io/edit/v1/render
      body:
        type: json
        data: '{"timeline":{"tracks":[]},"output":{"format":"mp4","resolution":"sd"}}'
    docs: Queue a video, image, or audio render from a JSON edit specification.
  - info:
      name: Get render status
      type: http
    http:
      method: GET
      url: https://api.shotstack.io/edit/v1/render/{id}
    docs: Retrieve the status, progress, and output URL of a render by ID.
  - info:
      name: Probe a media asset
      type: http
    http:
      method: GET
      url: https://api.shotstack.io/edit/v1/probe/{url}
    docs: Inspect media asset metadata using FFprobe (URL-encoded asset URL).
- info:
    name: Templates
    type: folder
  items:
  - info:
      name: Create a template
      type: http
    http:
      method: POST
      url: https://api.shotstack.io/edit/v1/templates
      body:
        type: json
        data: '{"name":"My Template","template":{}}'
    docs: Save an edit as a reusable template.
  - info:
      name: List templates
      type: http
    http:
      method: GET
      url: https://api.shotstack.io/edit/v1/templates
    docs: List all templates for the authenticated account.
  - info:
      name: Get a template
      type: http
    http:
      method: GET
      url: https://api.shotstack.io/edit/v1/templates/{id}
    docs: Retrieve a specific template by ID.
  - info:
      name: Update a template
      type: http
    http:
      method: PUT
      url: https://api.shotstack.io/edit/v1/templates/{id}
      body:
        type: json
        data: '{"name":"My Template","template":{}}'
    docs: Update an existing template's name and edit.
  - info:
      name: Delete a template
      type: http
    http:
      method: DELETE
      url: https://api.shotstack.io/edit/v1/templates/{id}
    docs: Delete a template by ID.
  - info:
      name: Render a template
      type: http
    http:
      method: POST
      url: https://api.shotstack.io/edit/v1/templates/render
      body:
        type: json
        data: '{"id":"","merge":[]}'
    docs: Render an asset from a template with optional merge fields.
- info:
    name: Ingest
    type: folder
  items:
  - info:
      name: Ingest a source from a URL
      type: http
    http:
      method: POST
      url: https://api.shotstack.io/ingest/v1/sources
      body:
        type: json
        data: '{"url":"https://example.com/video.mp4"}'
    docs: Queue a source file (video, image, audio, font) to be fetched, stored, and transformed.
  - info:
      name: List sources
      type: http
    http:
      method: GET
      url: https://api.shotstack.io/ingest/v1/sources
    docs: List ingested source files.
  - info:
      name: Get a source
      type: http
    http:
      method: GET
      url: https://api.shotstack.io/ingest/v1/sources/{id}
    docs: Retrieve a specific source file by ID.
  - info:
      name: Delete a source
      type: http
    http:
      method: DELETE
      url: https://api.shotstack.io/ingest/v1/sources/{id}
    docs: Delete an ingested source file by ID.
  - info:
      name: Request a direct upload
      type: http
    http:
      method: POST
      url: https://api.shotstack.io/ingest/v1/upload
    docs: Request a signed URL to upload a source file directly to Shotstack storage.
- info:
    name: Serve
    type: folder
  items:
  - info:
      name: Get an asset
      type: http
    http:
      method: GET
      url: https://api.shotstack.io/serve/v1/assets/{id}
    docs: Retrieve a hosted asset's details and CDN URL by asset ID.
  - info:
      name: Delete an asset
      type: http
    http:
      method: DELETE
      url: https://api.shotstack.io/serve/v1/assets/{id}
    docs: Delete a hosted asset by asset ID.
  - info:
      name: Get assets by render ID
      type: http
    http:
      method: GET
      url: https://api.shotstack.io/serve/v1/assets/render/{id}
    docs: Retrieve all assets (video, thumbnail, poster) for a render ID.
  - info:
      name: Transfer an asset
      type: http
    http:
      method: POST
      url: https://api.shotstack.io/serve/v1/assets
      body:
        type: json
        data: '{"url":"https://example.com/file.mp4","destinations":[{"provider":"s3"}]}'
    docs: Transfer a file from a URL to one or more hosting destinations.
- info:
    name: Create
    type: folder
  items:
  - info:
      name: Generate an AI asset
      type: http
    http:
      method: POST
      url: https://api.shotstack.io/create/v1/assets
      body:
        type: json
        data: '{"provider":"shotstack","options":{"type":"text-to-speech","text":"Hello from Shotstack"}}'
    docs: Generate an AI asset (text-to-speech, text-to-image, image-to-video, text generation).
  - info:
      name: Get a generated asset
      type: http
    http:
      method: GET
      url: https://api.shotstack.io/create/v1/assets/{id}
    docs: Retrieve the status and URL of a generated AI asset by ID.