> ## Documentation Index
> Fetch the complete documentation index at: https://student-213fb9fc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Models

> List all available models on AJ STUDIOZ Cloud Infra (Ollama-compatible)

## Overview

Returns a list of all models currently available on AJ STUDIOZ Cloud Infra. This endpoint is compatible with the Ollama `GET /api/tags` format.

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer YOUR_API_KEY`
</ParamField>

***

## Response

<ResponseField name="models" type="array">
  Array of model objects, each containing:
</ResponseField>

<ResponseField name="models[].name" type="string">
  The full model name including tag (e.g. `"gemma3:27b"`).
</ResponseField>

<ResponseField name="models[].model" type="string">
  Same as `name`. The identifier to use in API requests.
</ResponseField>

<ResponseField name="models[].modified_at" type="string">
  ISO 8601 timestamp when the model was added or updated.
</ResponseField>

<ResponseField name="models[].size" type="integer">
  Model size in bytes.
</ResponseField>

<ResponseField name="models[].digest" type="string">
  Short content digest hash for the model.
</ResponseField>

<ResponseField name="models[].details" type="object">
  Additional model details (may contain empty fields):

  * `parent_model` — parent model if derived
  * `format` — model serialization format
  * `family` — model family
  * `parameter_size` — human-readable parameter count
  * `quantization_level` — quantization format
</ResponseField>

***

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.ajstudioz.co.in/api/tags \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python (Ollama SDK) theme={null}
  from ollama import Client

  client = Client(
      host="https://api.ajstudioz.co.in",
      headers={"Authorization": "Bearer YOUR_API_KEY"}
  )

  models = client.list()
  for model in models.models:
      size_gb = model.size / 1e9
      print(f"{model.model:<40} {size_gb:>8.1f} GB")
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.get(
      "https://api.ajstudioz.co.in/api/tags",
      headers={"Authorization": "Bearer YOUR_API_KEY"}
  )
  data = response.json()

  for model in data["models"]:
      print(model["name"])
  ```
</CodeGroup>

<ResponseExample>
  ```json Response theme={null}
  {
    "models": [
      {
        "name": "gpt-oss:120b",
        "model": "gpt-oss:120b",
        "modified_at": "2025-08-05T00:00:00Z",
        "size": 65290180781,
        "digest": "d98fe6ba01e6",
        "details": { "parent_model": "", "format": "", "family": "", "families": null, "parameter_size": "", "quantization_level": "" }
      },
      {
        "name": "gemma3:27b",
        "model": "gemma3:27b",
        "modified_at": "2025-03-12T00:00:00Z",
        "size": 55000000000,
        "digest": "c1d2e3f40004",
        "details": { "parent_model": "", "format": "", "family": "", "families": null, "parameter_size": "", "quantization_level": "" }
      },
      {
        "name": "kimi-k2:1t",
        "model": "kimi-k2:1t",
        "modified_at": "2025-09-05T00:00:00Z",
        "size": 1118481408000,
        "digest": "9665a13eb6f1",
        "details": { "parent_model": "", "format": "", "family": "", "families": null, "parameter_size": "", "quantization_level": "" }
      }
    ]
  }
  ```
</ResponseExample>