---
title: "List Base Models"
method: GET
path: "/api/v3/models/base"
tags: ["Models"]
---

# List Base Models

`GET /api/v3/models/base`

## Request

- Base URL: `https://api.nugen.in`
- URL: `https://api.nugen.in/api/v3/models/base`
- Auth: HTTP bearer

Retrieve the list of available base models.


This endpoint returns all general-purpose base models available for use in chat completions, embeddings, and domain alignment workflows.


**Query Parameters:**

- `alignment_ready` (optional): `true` or `false`
- `inference_ready` (optional): `true` or `false`
- `type` (optional): `text-generation` or `image-text-to-text`
- `limit` (optional): Number of models to return (1-100, default: 10)
- `offset` (optional): Number of models to skip for pagination (default: 0)


**Returns:**

- `models`: List of base model objects, each containing:
  - `model_id`: Unique model identifier
  - `model_name`: Human-readable model name
  - `parameters`: Model parameter count
  - `alignment_ready`: Whether model can be used as a base for domain alignment
  - `inference_ready`: Whether model is deployed for chat, completions, embeddings or rerank
  - `available_on_request`: Whether this model requires an access request before use
  - `type`: Hugging Face `pipeline_tag`, `text-generation` or `image-text-to-text`. Embedding and reranking base models are not listed; use an aligned model id for both
  - `model_card`: URL of the model card README on Hugging Face


**Example Request:**

```json
GET /api/v3/models/base
Headers: {"Authorization": "Bearer <api_key>"}
```


**Example Response:**

```json
{
  "models": [
    {
      "model_id": "Qwen/Qwen2.5-0.5B-Instruct",
      "model_name": "Qwen/Qwen2.5-0.5B-Instruct",
      "parameters": "0.49B",
      "alignment_ready": true,
      "inference_ready": true,
      "available_on_request": false,
      "type": "text-generation",
      "model_card": "https://huggingface.co/Qwen/Qwen2.5-0.5B-Instruct/blob/main/README.md"
    },
    {
      "model_id": "nomic-ai/nomic-embed-text-v1.5",
      "model_name": "nomic-ai/nomic-embed-text-v1.5",
      "parameters": "0.14B",
      "alignment_ready": false,
      "inference_ready": true,
      "available_on_request": false,
      "type": "embedding",
      "model_card": "https://huggingface.co/nomic-ai/nomic-embed-text-v1.5/blob/main/README.md"
    }
  ]
}
```
**Notes:**

- Base models are general-purpose starting points for domain alignment
- These models can be used directly or as base models for domain alignment
- Use `/models/aligned` to see your custom domain-aligned models
- `alignment_ready` indicates if the model can be used as a base for domain alignment

## Query parameters

- `alignment_ready` boolean, nullable: Only models that can, or cannot, be aligned
- `inference_ready` boolean, nullable: Only models that are, or are not, deployed for inference
- `type` string, nullable: Only models whose type matches exactly, e.g. text-generation or embedding
- `limit` integer: Number of models to return
- `offset` integer: Number of models to skip

## Response `200`

Returns a list of all available base models that can be used for domain alignment.

- ModelListBaseResponse: The base models available for alignment.
  - `models` ModelListBaseItem[], required: List of available base models
    - `model_id` string, required: Unique identifier for the base model
    - `model_name` string, required: Human-readable display name of the model
    - `parameters` string: Model parameter count or configuration details
    - `alignment_ready` boolean: Whether this model can be used as a base model for domain alignment
    - `inference_ready` boolean: Whether this model is deployed for chat, completions, embeddings or rerank
    - `available_on_request` boolean: Whether this model requires an access request before use
    - `type` string, required: The Hugging Face pipeline_tag: text-generation or image-text-to-text
    - `model_card` string, nullable: URL of the model card README on Hugging Face

## Other responses

- `400`: Bad request - invalid query parameters
- `401`: Invalid API key
- `403`: Authorization header missing or not a Bearer token
- `404`: No base models found
- `422`: Validation error - invalid request parameters

---

[API](https://skmtc.dev/nugen/apis/nugen-intelligence-api.md) - [All operations](https://skmtc.dev/nugen/apis/nugen-intelligence-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nugen/apis/nugen-intelligence-api/revisions/62baa7960a4a?raw)