Quickstart
Get up and running with the Tella API in just a few minutes.
Step 1: Get your API key
- Go to your Tella account settings
- Click Create key
- Copy your new API key (it starts with
tella_pk_)
Keep your API key secure. Never share it publicly or commit it to version
control.
Step 2: Make your first request
Let’s list all videos in your workspace:
curl -H "Authorization: Bearer tella_pk_your_api_key" \
https://api.tella.com/v1/videos
Step 3: Explore the response
A successful response looks like this:
{
"videos": [
{
"id": "abc123xyz",
"name": "Product Demo",
"description": "A walkthrough of our new feature",
"views": 1234,
"durationSeconds": 125.5,
"aspectRatio": "16:9",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z",
"links": {
"viewPage": "https://www.tella.tv/video/abc123xyz/view",
"embedPage": "https://www.tella.tv/video/abc123xyz/embed"
}
}
],
"pagination": {
"nextCursor": null,
"hasMore": false
}
}
Step 4: Get video details
To get full details including the transcript:
curl -H "Authorization: Bearer tella_pk_your_api_key" \
https://api.tella.com/v1/videos/abc123xyz
Next steps
