> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darkbloom.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Available models — GET /v1/models

> GET /v1/models — returns available inference models with provider count, attestation status, and trust level. Compatible with OpenAI's model list format.

The models endpoint returns the set of models currently available across the Darkbloom provider network. The response extends the OpenAI model list format with Darkbloom-specific metadata: how many providers are serving each model, whether any of those providers are attested, and their aggregate trust level.

Use this endpoint to discover which model IDs are valid for inference requests and to check real-time network availability before sending a request.

## Authentication

This endpoint requires a Bearer token:

```
Authorization: Bearer eigeninference-...
```

## Response

<ResponseField name="object" type="string">
  Always `"list"`.
</ResponseField>

<ResponseField name="data" type="object[]">
  Array of model objects.

  <Expandable title="model fields">
    <ResponseField name="id" type="string">
      The model ID to use in inference requests. Pass this value as the `model` field in [chat completions](/reference/chat-completions) and other inference endpoints.
    </ResponseField>

    <ResponseField name="object" type="string">
      Always `"model"`.
    </ResponseField>

    <ResponseField name="owned_by" type="string">
      Always `"eigeninference"`.
    </ResponseField>

    <ResponseField name="metadata" type="object">
      Darkbloom-specific metadata for the model.

      <Expandable title="metadata fields">
        <ResponseField name="metadata.model_type" type="string">
          The model category. `"text"` for language models.
        </ResponseField>

        <ResponseField name="metadata.quantization" type="string">
          The quantization format in use, e.g. `"8bit"`.
        </ResponseField>

        <ResponseField name="metadata.provider_count" type="integer">
          Number of providers currently connected and serving this model.
        </ResponseField>

        <ResponseField name="metadata.attested_providers" type="integer">
          Number of providers for this model that have passed attestation.
        </ResponseField>

        <ResponseField name="metadata.trust_level" type="string">
          The highest trust level across all providers for this model. `"self_signed"` or `"hardware"`.
        </ResponseField>

        <ResponseField name="metadata.display_name" type="string">
          Human-readable model name.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Available models

| Model ID                                | Display name                  | Architecture                     |
| --------------------------------------- | ----------------------------- | -------------------------------- |
| `qwen3.5-27b-claude-opus-8bit`          | Qwen3.5 27B Claude Opus 8-bit | 27B dense, Claude Opus distilled |
| `mlx-community/gemma-4-26b-a4b-it-8bit` | Gemma 4 26B 8-bit             | 26B MoE, 4B active               |
| `mlx-community/Trinity-Mini-8bit`       | Trinity Mini 8-bit            | 27B Adaptive MoE                 |
| `mlx-community/Qwen3.5-122B-A10B-8bit`  | Qwen3.5 122B MoE 8-bit        | 122B MoE, 10B active             |
| `mlx-community/MiniMax-M2.5-8bit`       | MiniMax M2.5 8-bit            | 239B MoE, 11B active             |

## Example

```bash cURL theme={null}
curl https://api.darkbloom.dev/v1/models \
  -H "Authorization: Bearer eigeninference-..."
```

### Example response

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "qwen3.5-27b-claude-opus-8bit",
      "object": "model",
      "created": 0,
      "owned_by": "eigeninference",
      "metadata": {
        "model_type": "text",
        "quantization": "8bit",
        "provider_count": 3,
        "attested_providers": 2,
        "trust_level": "hardware",
        "display_name": "Qwen3.5 27B Claude Opus 8-bit"
      }
    },
    {
      "id": "mlx-community/gemma-4-26b-a4b-it-8bit",
      "object": "model",
      "created": 0,
      "owned_by": "eigeninference",
      "metadata": {
        "model_type": "text",
        "quantization": "8bit",
        "provider_count": 5,
        "attested_providers": 5,
        "trust_level": "hardware",
        "display_name": "Gemma 4 26B 8-bit"
      }
    },
    {
      "id": "mlx-community/Qwen3.5-122B-A10B-8bit",
      "object": "model",
      "created": 0,
      "owned_by": "eigeninference",
      "metadata": {
        "model_type": "text",
        "quantization": "8bit",
        "provider_count": 1,
        "attested_providers": 1,
        "trust_level": "hardware",
        "display_name": "Qwen3.5 122B MoE 8-bit"
      }
    }
  ]
}
```