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.

Authorization: Bearer YOUR_SUBCLIP_API_KEY
x-api-key: YOUR_SUBCLIP_API_KEY

OpenAPI-style reference

API endpoints

Authentication, quota, status, download, and reusable voice discovery endpoints.

API v1 storage handling: files uploaded or generated through /api/v1 are auto-cleaned and do not count toward the user's storage quota.
GET/api/v1/quota

Check API credit availability

Returns AI credit availability and confirms that storage quota does not apply to API v1 jobs.

Bearer auth

Parameters

FieldTypeRequiredDetails
fileSizenumberNo
Optional file size in bytes for client-side planning
query
durationSecondsnumberNo
Optional duration used to estimate Enhance Audio API credits
query

Examples

Response

{
  "storage": {
    "applies": false,
    "usedBytes": 0,
    "remainingBytes": null,
    "limitBytes": null,
    "message": "Storage quota is not applied to /api/v1 jobs because API files are auto-cleaned."
  },
  "uploadCheck": {
    "fileSizeBytes": 52428800,
    "allowed": true,
    "remaining": "not_applicable"
  },
  "aiCredits": {
    "allowed": true,
    "balance": 250,
    "estimatedCredits": 9
  }
}

Responses

StatusDescription
200Request succeeded
400Invalid request body or unsupported parameter
401Missing, invalid, or revoked API key
429Rate limit exceeded
500Unexpected processing error
GET/api/v1/media-render/voices

List reusable voice IDs

Returns voice IDs used by Video Studio, AI Dubbing, and Text to Speech when voice cloning is not enabled.

Bearer auth

Parameters

FieldTypeRequiredDetails
languagestringNo
Optional BCP-47 style language code filter, for example en, es, hi
query

Examples

Response

{
  "voices": [
    {
      "voiceoverVoiceId": "svoice_...",
      "name": "English Narrator",
      "language": "en",
      "provider": "inworld"
    }
  ]
}

Responses

StatusDescription
200Request succeeded
400Invalid request body or unsupported parameter
401Missing, invalid, or revoked API key
429Rate limit exceeded
500Unexpected processing error

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 an Enhance Audio API job.

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

API costs

See all current API credit costs in one place, including Viral Captions, AI Dubbing, AI Clipping, Text to Speech, Social Media Transcript, Video Studio API, and Enhance Audio API examples.

Open API cost guide

Viral Captions API

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

Open Viral Captions docs

AI Dubbing API

Dub video or audio from public, signed, social, or Subclip-hosted media and return either chunk URLs or a merged final output.

Open AI Dubbing docs

AI Clipping API

Start from a video URL or YouTube URL, let AI choose viral clips or pass exact segments, then download the rendered MP4.

Open AI Clipping docs

AI Image Generation API

Generate or edit images from a text prompt, optionally upload visual references, poll the isolated API job, and download every output before automatic cleanup.

Open AI Image Generation docs

AI Video Generation API

Generate or edit video from a prompt and optional image, video, or audio references, with idempotent job starts and one-hour result retention.

Open AI Video Generation docs

Text to Speech API

Generate MP3 speech from text, SRT cue text, or structured transcript segments using shared Subclip voice IDs.

Open Text to Speech docs

Social Media Transcript API

Extract transcripts from YouTube, Instagram, Facebook, X, TikTok, or explicit public downloadable media URLs.

Open Social Media Transcript docs

Video Studio API

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

Open Video Studio API docs

Enhance Audio API

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

Open Enhance Audio API docs