API Overview

The Cliptext API provides programmatic access to transcription services. This RESTful API allows you to upload audio/video files and retrieve transcriptions.

Base URL

All API requests should be made to:

https://api.cliptext.ai/v1

Authentication

The Cliptext API uses Bearer token authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Tip

You can generate API keys in your account settings at app.cliptext.ai/settings/api.

Request Format

• All requests should use HTTPS
• Request bodies should be JSON (except file uploads which use multipart/form-data)
• Set Content-Type: application/json for JSON requests

Response Format

All responses are returned in JSON format:

{
  "id": "txn_abc123",
  "status": "completed",
  "text": "Hello, this is a transcription...",
  "duration": 45.2,
  "created_at": "2026-01-15T10:30:00Z"
}

Error Responses

Errors follow a consistent format:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid file format",
    "details": {
      "field": "file",
      "allowed": ["mp3", "wav", "mp4"]
    }
  }
}

Rate Limits

Plan	Requests/minute	Concurrent uploads
Free	10	1
Pro	60	5
Enterprise	Custom	Custom

Caution

Exceeding rate limits will result in a 429 Too Many Requests response.

Endpoints

Transcriptions

Method	Endpoint	Description
POST	/transcriptions	Create a new transcription
GET	/transcriptions	List all transcriptions
GET	/transcriptions/:id	Get a specific transcription
DELETE	/transcriptions/:id	Delete a transcription

Uploads

Method	Endpoint	Description
POST	/uploads/presigned	Get a presigned upload URL
POST	/uploads/complete	Mark upload as complete

Organizations

Method	Endpoint	Description
GET	/orgs	List your organizations
GET	/orgs/:id	Get organization details
POST	/orgs/:id/members	Add a team member

SDKs

Official SDKs are coming soon for:

• JavaScript/TypeScript
• Python
• Go

Need Help?

• Check our Quick Start Guide
• Contact support at [email protected]