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": "chatcmpl_abc123def456",
  "object": "chat.completion",
  "created": 1706345678,
  "model": "mavera-1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing uses quantum bits (qubits) that can exist in multiple states simultaneously, unlike classical bits that are either 0 or 1. This allows quantum computers to process many possibilities at once, making them powerful for specific tasks like cryptography and molecular simulation."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "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.

id
string

A unique identifier for this completion.

Example:

"chatcmpl_abc123def456"

object
enum<string>

The object type, always chat.completion.

Available options:
chat.completion
Example:

"chat.completion"

created
integer

Unix timestamp (in seconds) of when the completion was created.

Example:

1706345678

model
string

The model used for this completion.

Example:

"mavera-1"

choices
object[]

A list of completion choices. Currently always contains a single choice.

usage
object

Credit cost for this request.

tool_calls
object[]

List of tools that were automatically invoked during this request. Only present if tools were used.

analysis
object

Structured analysis data returned when analysis_mode or mosaic_mode is enabled. Contains emotional metrics, biases, confidence scores, news relevance, and more.