API Reference

Base URL

https://stratakit.io/api/v1

All API requests should be made to this base URL. All endpoints return JSON.

Authentication

StrataKit uses Bearer token authentication. Include your API key in theAuthorization header of all requests.

Authorization: Bearer sk_live_YOUR_API_KEY

Python Authentication

1
import requests
2
import os
3
4
# Store your API key securely (never hardcode!)
5
API_KEY = os.environ.get('STRATAKIT_API_KEY')
6
BASE_URL = 'https://stratakit.io/api/v1'
7
8
# Create a session with authentication

API Key Format

sk_live_Ax7Kp2mN9qR4sT6vW8xY0zA
└─┘└──┘└────────────────────────┘
 │   │            │
 │   │            └─ Random (24 chars, base64url)
 │   └─ Environment (live/test)
 └─ Prefix (sk = StrataKit)

Request & Response Format

Request Headers

Response Headers

Productions

Productions are video rendering jobs. Create a production to render a video, then poll for status or use webhooks to get notified when complete.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "priority": "normal",
  "estimated_wait_seconds": 15,
  "next_submission_at": "2024-01-15T12:00:00Z",
  "created_at": "2024-01-15T12:00:00Z",
  "credits_used": 5,

1
import requests
2
import os
3
4
API_KEY = os.environ['STRATAKIT_API_KEY']
5
BASE_URL = 'https://stratakit.io/api/v1'
6
7
def create_production(canvas: dict, name: str = None, webhook_url: str = None):
8
    """Create a new video production."""

1
import requests
2
import os
3
4
API_KEY = os.environ['STRATAKIT_API_KEY']
5
BASE_URL = 'https://stratakit.io/api/v1'
6
7
def list_productions(limit: int = 20, offset: int = 0, status: str = None):
8
    """List productions with optional filtering."""

1
import requests
2
import os
3
import time
4
5
API_KEY = os.environ['STRATAKIT_API_KEY']
6
BASE_URL = 'https://stratakit.io/api/v1'
7
8
def get_production(production_id: str):

{
  "deleted": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "video_deleted": true
}

1
import requests
2
import os
3
4
API_KEY = os.environ['STRATAKIT_API_KEY']
5
BASE_URL = 'https://stratakit.io/api/v1'
6
7
def delete_production(production_id: str) -> dict:
8
    """Delete a production and its associated video files."""

Canvas Specification

The canvas object defines your video's dimensions and content. Use the segments format to define your content — base content (video, image, color) auto-sequences, overlays (text, shape) render on top, and audio/TTS each get their own track automatically.

Canvas Properties

Resolution Presets

Segments

Segments define what content appears and when. Base content (video, image, color) auto-sequences, overlays (text, shape) render on top, and audio/TTS each get their own track automatically.

Segment Properties

Asset Types

Each segment contains an asset that defines its content. Here are all supported asset types:

{
  "type": "video",
  "url": "https://assets.stratakit.io/samples/video/8366020-hd_1080_1920_25fps.mp4",
  "volume": 0.5,
  "trim": { "start": 5, "end": 15 },
  "fit": "cover",
  "speed": 1.5,
  "loop": true
}

{
  "type": "color",
  "color": "#1a1a2e"
}

{
  "type": "text",
  "text": "BREAKING NEWS",
  "fontSize": 64,
  "fontColor": "#ffffff",
  "fontWeight": "bold",
  "backgroundColor": "#FF0000",
  "padding": 20,
  "position": "top"
}

{
  "type": "audio",
  "url": "https://assets.stratakit.io/samples/audio/Waltz in B minor, Op. 69 no. 2.mp3",
  "volume": 0.3,
  "fadeIn": 1,
  "fadeOut": 2
}

{
  "type": "tts",
  "text": "Welcome to our video! Today we'll explore...",
  "provider": "elevenlabs",
  "voice": "Rachel"
}

Error Codes

All errors return a JSON response with an error field.

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Error message describing what went wrong"
  }
}

Rate Limits

Rate limits are enforced per API key. When you hit a limit, you'll receive a 429 response with a Retry-After header.

HTTP/1.1 429 Too Many Requests
Retry-After: 30
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1705320000

{
  "error": {

Complete Example

The segments format is the recommended way to build productions. Just list your content as flat segments with a type field — the API auto-organizes them, auto-calculates timing, and handles audio/TTS routing.

Segments Format (Recommended)

Two video clips with background music. Start times are auto-calculated for sequential video segments.

With Text Overlay

Text segments automatically render on top of base content. Add text alongside video and audio in the same flat segments array.

Python SDK Example

A complete Python client class with error handling, retry logic, and rate limit support.

1
"""
2
StrataKit Python Client
3
A complete client with error handling, retry logic, and rate limits.
4
5
Usage:
6
    client = StrataKitClient(api_key='sk_live_...')
7
    production = client.create_production(canvas={...})
8
    result = client.wait_for_completion(production['id'])

Error Handling Best Practices

1
from stratakit_client import StrataKitClient, StrataKitError, RateLimitError
2
3
client = StrataKitClient()
4
5
def create_video_safely(canvas: dict) -> dict:
6
    """Create a video with comprehensive error handling."""
7
    try:
8
        production = client.create_production(canvas)

Batch Processing

1
import concurrent.futures
2
from stratakit_client import StrataKitClient
3
4
client = StrataKitClient()
5
6
def process_batch(items: list, max_workers: int = 5):
7
    """
8
    Process multiple videos concurrently.

Next Steps

• Quickstart Guide - Get started in 5 minutes
• Webhook Documentation - Signature verification and delivery
• n8n Integration - Automate video workflows
• OpenAPI Specification - Machine-readable API spec