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

To list all videos in your workspace, make the following request:

curl -H "Authorization: Bearer tella_pk_your_api_key" \
  https://api.tella.com/v1/videos

const response = await fetch("https://api.tella.com/v1/videos", {
  headers: {
    Authorization: "Bearer tella_pk_your_api_key",
  },
});

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.tella.com/v1/videos',
    headers={'Authorization': 'Bearer tella_pk_your_api_key'}
)

print(response.json())

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

const response = await fetch("https://api.tella.com/v1/videos/abc123xyz", {
  headers: {
    Authorization: "Bearer tella_pk_your_api_key",
  },
});

const video = await response.json();
console.log(video.transcript);

Next steps

Authentication

Learn about API key management and security best practices.

Rate Limiting

Understand rate limits and how to handle them.

Webhooks

Set up webhooks to receive real-time event notifications.

Getting Started

Guides

API Reference

Webhooks

Quickstart

Quickstart

Step 1: Get your API key

Step 2: Make your first request

Step 3: Explore the response

Step 4: Get video details

Next steps

Authentication

Rate Limiting

Webhooks

​Quickstart

​Step 1: Get your API key

​Step 2: Make your first request

​Step 3: Explore the response

​Step 4: Get video details

​Next steps

Authentication

Rate Limiting

Webhooks

Quickstart

Step 1: Get your API key

Step 2: Make your first request

Step 3: Explore the response

Step 4: Get video details

Next steps