Skip to main content
POST
Start an agent chat

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Body

application/json
prompt
string
required

What the agent should do, in full: it is all the agent knows. Sent as if the user had typed it in the video's agent chat.

Required string length: 1 - 20000
Example:

"Import https://www.youtube.com/watch?v=dQw4w9WgXcQ, cut it to the best 60 seconds and add captions."

effort
enum<string>

How hard the model thinks, lowest first: more effort takes longer and spends more AI Credits. Left out, the model's usual effort (medium for most). Not every model has every level: gpt-6.1-terra stops at high.

Available options:
low,
medium,
high,
xhigh,
max
Example:

"high"

model
enum<string>

The model the agent runs on, as in the editor's model picker. Left out, claude-sonnet-5-5.

Available options:
claude-fable-5-2,
claude-opus-5-5,
claude-sonnet-5-5,
claude-haiku-5-5,
gpt-6-astra,
gpt-6.1-sol,
gpt-6.1-terra,
gpt-6-luna
Example:

"claude-sonnet-5-5"

name
string

The new video's name. Only used without videoId; left out, the prompt's start names it.

Maximum string length: 120
Example:

"Launch recap"

videoId
string

A video you can edit. Leave it out to start the chat in a new, empty video.

Example:

"vid_abc123def456"

Response

Created

chatId
string
required
Example:

"achat_abc123def456"

url
string
required

Opens the chat in the video's editor

Example:

"https://www.tella.tv/video/vid_abc123def456/edit?agentChat=achat_abc123def456"

videoId
string
required
Example:

"vid_abc123def456"