Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Path Parameters

id
string
required

The video analysis ID.

Body

application/json
messages
object[]
required

Conversation messages. Maximum 50 messages.

Required array length: 1 - 50 elements
Example:
stream
boolean
default:false

If true, stream the response via SSE.

Response

Chat completion response.

A completed response object.

id
string

Unique response ID with resp_ prefix.

Example:

"resp_abc123def456abc123def456"

object
enum<string>

Always response.

Available options:
response
Example:

"response"

created_at
integer

Unix timestamp (seconds) when the response was created.

Example:

1706345678

status
enum<string>

Response status.

Available options:
completed,
in_progress,
failed
Example:

"completed"

model
string

The model used.

Example:

"mavera-1"

output
object[]

Ordered list of output items. Typically a single message item with text, or one or more function_call items when the model wants to call tools.

A message output item.

usage
object

Token and credit usage.

server_tool_calls
object[]

Mavera's built-in server-side tools automatically executed during this request. Only present when server tools were used.

analysis
object

Structured analysis data. Present when analysis_mode is true.

parsed
object

Present when text.format.type is json_schema. Contains the parsed JSON object — a convenience field, same data is also in output[0].content[0].text.

Example: