DEVELOPER DOCS

KlipFast API

Integrate AI-powered video processing into your product. REST API with JSON responses.

Authentication

All API requests require a Bearer token. Get your API key from Dashboard → Settings → API Key.

API access is available on Starter plans and above. Keys are scoped to your account and should be kept secret.

HTTP Header
Authorization: Bearer kf_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Base URL
https://api.klipfast.com

Endpoints

POST/api/v1/process

Submit a video URL for processing. Returns a job ID you can poll for status.

Request Body
JSON
{
  "video_url": "https://example.com/video.mp4",
  "quality": "balanced",
  "caption_style": "white_bold",
  "language": "en"
}
Response
JSON
{
  "job_id": "job_abc123",
  "status": "queued",
  "created_at": "2026-04-15T10:00:00Z",
  "estimated_seconds": 300
}
Code Example
bash
curl -X POST https://api.klipfast.com/api/v1/process \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video_url":"https://example.com/video.mp4","quality":"balanced"}'
GET/api/v1/jobs/{job_id}

Get the status and results of a specific processing job.

Response
JSON
{
  "job_id": "job_abc123",
  "status": "completed",
  "clips": [
    {
      "clip_id": "clip_xyz",
      "title": "The best moment",
      "virality_score": 87,
      "duration_seconds": 62,
      "download_url": "https://cdn.klipfast.com/clips/clip_xyz.mp4"
    }
  ],
  "text_outputs": {
    "twitter_thread": "1/ This is the hook...",
    "linkedin_post": "Last week I learned...",
    "blog_post": "# Full blog article..."
  }
}
Code Example
bash
curl https://api.klipfast.com/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/api/v1/jobs

List all processing jobs for your account. Supports pagination via cursor.

Response
JSON
{
  "jobs": [
    { "job_id": "job_abc123", "status": "completed", "created_at": "2026-04-15T10:00:00Z" },
    { "job_id": "job_def456", "status": "processing", "created_at": "2026-04-15T09:30:00Z" }
  ],
  "next_cursor": "cursor_opaque_token",
  "has_more": true
}
Code Example
bash
curl "https://api.klipfast.com/api/v1/jobs?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/api/v1/clips/{clip_id}

Retrieve metadata and a signed download URL for a specific clip.

Response
JSON
{
  "clip_id": "clip_xyz",
  "job_id": "job_abc123",
  "title": "The best moment",
  "virality_score": 87,
  "duration_seconds": 62,
  "resolution": "1080x1920",
  "caption_style": "white_bold",
  "download_url": "https://cdn.klipfast.com/clips/clip_xyz.mp4",
  "expires_at": "2026-05-15T10:00:00Z"
}
Code Example
bash
curl https://api.klipfast.com/api/v1/clips/clip_xyz \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/api/v1/usage

Get current billing period usage, remaining credits, and plan limits.

Response
JSON
{
  "plan": "pro",
  "period_start": "2026-04-01",
  "period_end": "2026-04-30",
  "minutes_used": 47.5,
  "minutes_limit": 300,
  "storage_used_mb": 1240,
  "storage_limit_mb": 20480,
  "credits_remaining": 5
}
Code Example
bash
curl https://api.klipfast.com/api/v1/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limits

Starter
60 req/min
5 concurrent jobs
Pro
300 req/min
20 concurrent jobs
Agency
1000 req/min
Unlimited concurrent

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Error Codes

CodeErrorDescription
400bad_requestMissing or invalid request parameters.
401unauthorizedInvalid or missing API key.
403forbiddenYour plan does not have access to this endpoint.
404not_foundThe job or clip ID was not found.
409conflictJob is already being processed.
422unprocessableVideo format is unsupported or file is corrupted.
429rate_limitedToo many requests. See rate limits below.
500server_errorInternal server error. Retry after a moment.