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

# Models

> OpenAI-compatible inference at models.ageneral.ai

**Models** is Ageneral’s OpenAI-compatible inference API at **`https://models.ageneral.ai`**. Request and response shapes align with common OpenAI client libraries for chat, responses, and listing models.

Use **Models** to:

* List models available to your credential with **`GET /v1/models`**.
* Run chat workloads with **`POST /v1/chat/completions`**.
* Run Responses-compatible workloads with **`POST /v1/responses`**.

## How routing and billing work

**Models** forwards allowed requests to provider backends enabled for your **project**, records usage, and applies billing to your Ageneral account. Spend checks run when billing gates apply.

## Endpoints

| Method   | Path                       | Purpose                                                     |
| -------- | -------------------------- | ----------------------------------------------------------- |
| **GET**  | **`/v1/models`**           | List models for the caller                                  |
| **POST** | **`/v1/chat/completions`** | Chat-style completions; supports streaming where configured |
| **POST** | **`/v1/responses`**        | Responses-compatible requests                               |

Model identifiers use **`provider/model`** syntax, for example **`openai/gpt-4o-mini`**. The set returned by **`GET /v1/models`** depends on **project** configuration. See [Catalog](/guides/models/catalog).

## Authentication

* Send **`Authorization: Bearer <token>`** on every request.
* Use a **virtual key** (**`sk-bf-…`**) when **your software** calls **Models**.
* **Ageneral-hosted agents** call **Models** with **infrastructure credentials** you do not create in the console.

A signed-in browser session on **`https://ageneral.ai`** does **not** authorize **Models** requests by itself.

See [Authentication](/authentication) for the full credential matrix.

## Next steps

| Topic                 | Guide                                                  |
| --------------------- | ------------------------------------------------------ |
| First request         | [Quickstart](/quickstart)                              |
| Listing models        | [Catalog](/guides/models/catalog)                      |
| Body fields           | [Request parameters](/api-reference/models-parameters) |
| Credits and errors    | [Usage and billing](/guides/models/usage-and-billing)  |
| Interactive reference | [Models API](/reference/models/list)                   |

## Related links

* [Authentication](/authentication)
* [Agents](/agents)