Skip to main content
POST
/
video-analyses
/
{id}
/
chat
cURL
curl -X POST https://app.mavera.io/api/v1/video-analyses/YOUR_ANALYSIS_ID/chat \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "What are the main strengths of this ad?" }
    ]
  }'
{
  "id": "resp_abc123def456abc123def456",
  "object": "response",
  "created_at": 1706345678,
  "status": "completed",
  "model": "mavera-1",
  "output": [
    {
      "id": "msg_abc123def456",
      "type": "message",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "Quantum computing uses qubits that can exist in multiple states simultaneously, enabling processing of many possibilities at once."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 42,
    "output_tokens": 68,
    "total_tokens": 110,
    "credits_used": 3
  }
}

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:
[
  {
    "role": "user",
    "content": "What are the main strengths of this ad?"
  }
]
​
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:
{
  "sentiment": "positive",
  "score": 8.5,
  "summary": "Great product"
}