MechaMental
Api reference

Models Library

List Models

GET
/v1/models

Query Parameters

type?|

Filter by model type

provider?|

Filter by provider

category?|

Filter by category

include_unavailable?Include Unavailable

Include unavailable models

Defaultfalse
limit?Limit

Maximum number of items to return (1-200)

Default50
Range1 <= value <= 200
cursor?|

Cursor for pagination (from previous response's next_cursor)

Header Parameters

authorization?string|null

Response Body

application/json

application/json

curl -X GET "https://loading/v1/models"
{
  "total": 0,
  "has_more": false,
  "next_cursor": "string",
  "models": [
    {
      "model_id": "string",
      "name": "string",
      "slug": "string",
      "description": "string",
      "type": "chat",
      "provider": "string",
      "provider_model_id": "string",
      "capabilities": {
        "streaming": true,
        "tools": false,
        "vision": false,
        "json_mode": false,
        "dimensions": 0,
        "system_message": true,
        "multi_turn": true
      },
      "limits": {
        "context_length": 4096,
        "max_output_tokens": 2048,
        "requests_per_minute": 0,
        "tokens_per_minute": 0
      },
      "pricing": {
        "input_per_1k_tokens": 0,
        "output_per_1k_tokens": 0,
        "currency": "USD"
      },
      "status": "available",
      "category": "string",
      "tags": [],
      "is_default": false
    }
  ],
  "defaults": {
    "property1": "string",
    "property2": "string"
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

List Providers

GET
/v1/models/providers

Header Parameters

authorization?string|null

Response Body

application/json

application/json

curl -X GET "https://loading/v1/models/providers"
{
  "providers": [
    {
      "id": "string",
      "name": "string",
      "type": "local",
      "status": "healthy",
      "status_reason": "string",
      "models_count": 0,
      "latency_ms": 0
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Get Provider Status

GET
/v1/models/providers/{provider_id}/status

Path Parameters

provider_id*Provider Id

Provider ID

Header Parameters

authorization?string|null

Response Body

application/json

application/json

curl -X GET "https://loading/v1/models/providers/string/status"
{
  "id": "string",
  "name": "string",
  "type": "local",
  "status": "healthy",
  "status_reason": "string",
  "base_url": "string",
  "models": [],
  "latency_ms": 0,
  "last_health_check": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Get Model

GET
/v1/models/{model_id}

Path Parameters

model_id*Model Id

Model ID

Header Parameters

authorization?string|null

Response Body

application/json

application/json

curl -X GET "https://loading/v1/models/string"
{
  "model_id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "type": "chat",
  "provider": "string",
  "provider_model_id": "string",
  "capabilities": {
    "streaming": true,
    "tools": false,
    "vision": false,
    "json_mode": false,
    "dimensions": 0,
    "system_message": true,
    "multi_turn": true
  },
  "limits": {
    "context_length": 4096,
    "max_output_tokens": 2048,
    "requests_per_minute": 0,
    "tokens_per_minute": 0
  },
  "pricing": {
    "input_per_1k_tokens": 0,
    "output_per_1k_tokens": 0,
    "currency": "USD"
  },
  "status": "available",
  "category": "string",
  "tags": [],
  "is_default": false,
  "metadata": {},
  "created_at": "string",
  "updated_at": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}