Skip to main content
GET
https://api.u1.archetypeai.app/v0.5
/
lens
/
metadata
curl https://api.dev.u1.archetypeai.app/v0.5/lens/metadata \
  -H "Authorization: Bearer $ATAI_API_KEY"
[
  {
    "lens_id": "lns-test-lens-b2ba0058",
    "lens_name": "Test Lens",
    "lens_status": "LENS_STATUS_MOUNTED",
    "lens_modifiable": true,
    "lens_config": {
      "lens_name": "Test Lens"
    }
  },
  {
    "lens_id": "lns-fd669361822b07e2-bc608aa3fdf8b4f9",
    "lens_name": "Activity Monitor",
    "lens_status": "LENS_STATUS_MOUNTED",
    "lens_modifiable": false,
    "lens_config": {
      "model_pipeline": [
        {
          "processor_name": "lens_camera_processor",
          "processor_config": {}
        }
      ],
      "model_parameters": {
        "focus": "Describe the video.",
        "model_name": "Newton",
        "instruction": "Answer the following question about the video:",
        "max_replicas": 1,
        "min_replicas": 1,
        "model_version": "Newton::c2_3_7b_2508014e10af56",
        "max_new_tokens": 512,
        "camera_buffer_size": 5,
        "camera_buffer_step_size": 5
      }
    }
  }
]

Overview

This endpoint returns detailed information about each lens available to your organization, including lens IDs, names, and configurations.

Request

Authorization
string
required
Bearer token for authentication. Format: Bearer $ATAI_API_KEY
lens_id
string
Optional. Filter the response to a specific lens by ID.
shard_index
integer
default:"-1"
Optional. Shard index for pagination. Use -1 to retrieve all lenses.
max_items_per_shard
integer
default:"-1"
Optional. Maximum items per shard. Use -1 for no limit.

Response

Returns an array of lens objects, each containing:
lens_id
string
Unique identifier for the lens
lens_name
string
Human-readable name of the lens
lens_status
string
Current status of the lens (e.g., “LENS_STATUS_MOUNTED”)
lens_modifiable
boolean
Whether the lens can be modified or deleted
lens_config
object
Configuration object containing lens-specific settings and parameters
curl https://api.dev.u1.archetypeai.app/v0.5/lens/metadata \
  -H "Authorization: Bearer $ATAI_API_KEY"
[
  {
    "lens_id": "lns-test-lens-b2ba0058",
    "lens_name": "Test Lens",
    "lens_status": "LENS_STATUS_MOUNTED",
    "lens_modifiable": true,
    "lens_config": {
      "lens_name": "Test Lens"
    }
  },
  {
    "lens_id": "lns-fd669361822b07e2-bc608aa3fdf8b4f9",
    "lens_name": "Activity Monitor",
    "lens_status": "LENS_STATUS_MOUNTED",
    "lens_modifiable": false,
    "lens_config": {
      "model_pipeline": [
        {
          "processor_name": "lens_camera_processor",
          "processor_config": {}
        }
      ],
      "model_parameters": {
        "focus": "Describe the video.",
        "model_name": "Newton",
        "instruction": "Answer the following question about the video:",
        "max_replicas": 1,
        "min_replicas": 1,
        "model_version": "Newton::c2_3_7b_2508014e10af56",
        "max_new_tokens": 512,
        "camera_buffer_size": 5,
        "camera_buffer_step_size": 5
      }
    }
  }
]