# List embeddings models

`GET https://api.llm.buzz/api/v1/embeddings/models`

The model list with `output_modalities=embeddings` fixed, in the shape of `GET /api/v1/models`: with a key, the embeddings models it can call; without one, the public ones. Each lists as `text->embeddings` with its context window and `pricing` `{prompt, completion: "0"}` in US dollars per token, no cache prices and empty `supported_parameters`.

Authentication: optional; without a key it answers the public catalog.

## Parameters

- `limit` (query integer): Page size.
- `offset` (query integer): Rows to skip.

## Responses

- 200: `data`, `total_count` (the matches before paging) and `links`.
- 400: A field is missing or malformed (`invalid_request`, with `metadata.param`), or the model cannot do what the request asks (`unsupported_capability`).

## Example (curl)

```bash
curl https://api.llm.buzz/api/v1/embeddings/models \
  -H "Authorization: Bearer $LLM_BUZZ_KEY"
```

## Example response

```json
{
  "object": "list",
  "data": [
    {
      "id": "qwen/qwen3-embedding-8b",
      "name": "Qwen: Qwen3 Embedding 8B",
      "context_length": 32768,
      "architecture": {
        "input_modalities": [
          "text"
        ],
        "output_modalities": [
          "embeddings"
        ],
        "modality": "text->embeddings"
      },
      "pricing": {
        "prompt": "0.00000001",
        "completion": "0"
      },
      "supported_parameters": []
    }
  ],
  "total_count": 18,
  "links": {
    "next": null
  }
}
```