Subclip Logo

Developer API

Subclip API

Generate API keys, check storage quota, check AI credit status, and run media jobs.

Get an API key

Sign in to Subclip and open Developer Portal.

Generate a key and copy it immediately. API keys are only shown once.

Generated keys include read and write access for Enhance Voice, Media Render, and Dynamic Captions. Read access is used for quota, status, and download URL requests. Write access is used to create upload URLs and start jobs.

If an older key works for quota or Media Render but fails on Dynamic Captions with 401 invalid_api_key, generate a new key so it includes the dynamic_captions permission.

Authorization: Bearer YOUR_SUBCLIP_API_KEY
x-api-key: YOUR_SUBCLIP_API_KEY

Check storage and credits

Use /api/v1/quota with no query parameters to see storage availability and current AI credit balance.

curl https://www.subclip.app/api/v1/quota \
  -H "Authorization: Bearer $SUBCLIP_API_KEY"
{
  "storage": {
    "usedBytes": 104857600,
    "remainingBytes": 5261334937,
    "limitBytes": 5368709120,
    "used": "100 MB",
    "remaining": "4.9 GB",
    "limit": "5 GB"
  },
  "uploadCheck": null,
  "aiCredits": {
    "balance": 250,
    "allowed": true
  }
}

Add fileSize to check whether an upload fits. Add durationSeconds to check estimated AI credits for Enhance Voice.

curl "https://www.subclip.app/api/v1/quota?fileSize=52428800&durationSeconds=180&backgroundMusicSeparationEnabled=false" \
  -H "Authorization: Bearer $SUBCLIP_API_KEY"

Dynamic Captions API

Upload a video, optionally provide SRT captions, choose a dynamic caption template and face tracking, then download the rendered MP4.

Open Dynamic Captions docs

Media Render API

Upload multiple images, videos, and audio files, optionally provide editing instructions, render the result on Lambda, and download the final MP4.

Open Media Render docs

Enhance Voice API

Follow the full workflow for creating an upload URL, uploading media, starting enhancement, polling status, and downloading the enhanced output.

Open Enhance Voice docs