REST API

Build With the
Klipstar API

Integrate AI-powered video clipping directly into your product. Submit videos, receive clips via webhook, and publish to social — all programmatically.

Get API KeyView Endpoints

Submit a Video

python
import requests

KLIPSTAR_API_KEY = "ks_live_..."

# Submit a video for AI clipping
response = requests.post(
    "https://api.klipstar.ai/v1/projects",
    headers={"Authorization": f"Bearer {KLIPSTAR_API_KEY}"},
    json={
        "video_url": "https://youtube.com/watch?v=...",
        "max_clips": 10,
        "caption_style": "karaoke",
        "platforms": ["youtube_shorts", "tiktok", "reels"]
    }
)

project = response.json()
print(f"Project ID: {project['id']}")
print(f"Status: {project['status']}")  # "processing"

Webhook Response

JSON
// Webhook payload when clips are ready
{
  "event": "project.completed",
  "project_id": "proj_abc123",
  "clips": [
    {
      "id": "clip_xyz",
      "title": "The Future of AI in Business",
      "virality_score": 92,
      "duration_seconds": 28.4,
      "download_url": "https://r2.klipstar.ai/clips/...",
      "platforms": {
        "youtube_shorts": { "width": 1080, "height": 1920 },
        "tiktok": { "width": 1080, "height": 1920 }
      }
    }
  ]
}

API Endpoints

Simple REST API with JSON request/response format. Supports polling and webhooks.

POST/v1/projects
GET/v1/projects/:id
POST/v1/projects/:id/prompt
GET/v1/clips/:id
POST/v1/clips/:id/publish
DELETE/v1/projects/:id

Rate Limits

Spark

1 req/min
per minute
10/hour
per hour
1
concurrent jobs

Creator

3 req/min
per minute
30/hour
per hour
3
concurrent jobs

Studio

15 req/min
per minute
100/hour
per hour
10
concurrent jobs

Built for Developers

RESTful JSON API

Standard HTTP methods with JSON payloads. No SDKs required — use any language.

Webhook Callbacks

Get notified instantly when clips are ready. No polling needed.

Presigned URLs

Secure, time-limited download URLs for clips with zero egress fees via R2.

Prompt Clipping

Send natural language prompts to find specific moments in processed videos.

Multi-Platform Output

Request clips formatted for specific platforms in a single API call.

Idempotent Requests

Safe to retry. Duplicate requests return the same result without double-processing.

Start Building Today

API access is included in all plans, even the free tier.

Get Your API KeyView Plans