Get Session Detail

Use this API to retrieve detailed metadata about a specific video session. You must provide a valid session_id and API key to access the session information.

Prerequisites

• You have access to session IDs retrieved via the List Sessions API or other workflows.
• You have a valid memories.ai API key.

Host URL

• https://api.memories.ai

Endpoint

GET /serve/api/v1/get_session_detail

Request Example

import requests

url = "https://api.memories.ai/serve/api/v1/get_session_detail"
headers = {"Authorization": "<API_KEY>"}
params = {"sessionId": "<SESSION_ID>", "unique_id": "<UNIQUE_ID>"}

response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:
    print("Session detail retrieved successfully:")
    print(response.json())
else:
    print("Failed to retrieve session detail:", response.status_code)
    print(response.text)

Request Parameters

Name	Location	Type	Required	Description
sessionId	query	int	Yes	Unique identifier for the video session
Authorization	header	string	Yes	Your API key for authentication
unique_id	body	string	No	default by default

Response Example

{
  "code": "0000",
  "msg": "success",
  "data": {
    "title": "tell me where to travel in mid june?",
    "messages": [
      {
        "role": "user",
        "content": "tell me where to travel in mid june?"
      },
      {
        "role": "assistant",
        "content": "When planning travel for mid-June, it's a fantastic time to consider a variety of destinations...",
        "thinkings": [
          {
            "title": "Information Retrieval",
            "content": "Okay, I need to figure out the best travel destinations for mid-June. That's a pretty broad question..."
          },
          {
            "title": "Information Retrieval",
            "content": "Okay, I need to figure out how these videos relate to the user's question about 'best travel destinations in mid June.'..."
          }
        ],
        "refs": [
          {
            "video": {
              "duration": "10",
              "video_no": "VI606140356924534784",
              "video_name": "test_video_gz_visual_understanding_fuse_s9_video_fuse_4_video_fuse_4"
            },
            "refItems": [
              {
                "videoNo": "VI606140356924534784",
                "startTime": 23,
                "type": "keyframe"
              },
              {
                "videoNo": "VI606140356924534784",
                "startTime": 30,
                "endTime": 36,
                "type": "visual_ts",
                "text": "A close-up view shows a collection of items on a concrete surface. To the left, two brown, round objects resembling small barrels or planters are visible. One has a blue lid or insert..."
              },
              {
                "videoNo": "VI606140356924534784",
                "startTime": 30,
                "endTime": 36,
                "type": "audio_ts",
                "text": "A close-up view shows a collection of items on a concrete surface. To the left, two brown, round objects resembling small barrels or planters are visible. One has a blue lid or insert..."
              }
            ]
          }
        ]
      }
    ],
    "session_id": "590197794380320770"
  },
  "failed": false,
  "success": true
}

Response Structure

Response Structure

Name	Type	Description
code	string	Response status code
msg	string	Human-readable status message
data	object	Session information
» title	string	Title or query related to the session
» messages	list of objects	List of messages in the session
»» role	string	Role of the message sender (user or assistant)
»» content	string	Text content of the message
»» thinkings	list of objects	(assistant only) Thought process or reasoning steps
»»» title	string	Title describing the reasoning step
»»» content	string	Detailed explanation of that reasoning step
»» refs	list of objects	(assistant only) Reference evidence based on related videos
»»» video	object	Metadata of the referenced video
»»»» video_no	string	Unique video identifier
»»»» video_name	string	Name of the referenced video
»»»» duration	string	Duration of the video (in seconds or minutes)
»»» refItems	list of objects	List of reference items with temporal and type information
»»»» videoNo	string	Video ID the reference item belongs to
»»»» type	string	Type of reference (keyframe, visual_ts, audio_ts, etc.)
»»»» startTime	int	Start time of the reference segment (in seconds)
»»»» endTime	int (optional)	End time of the reference segment (if applicable)
»»»» text	string (optional)	Transcript or descriptive content associated with the reference
session_id	string	Unique identifier of the session
success	boolean	Indicates whether the request was successful
failed	boolean	Indicates whether the request failed

Notes

• The sessionId must be a valid and existing identifier in your account.
• Use this API to retrieve rich context about a specific session for display or downstream processing.