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

# Model List

> Query the models available to the current API Key, compatible with OpenAI, Claude, and Gemini styles.

# Model List

Query the list of available models. The route determines the compatible format based on the request headers: it returns OpenAI style by default; with `x-api-key` and `anthropic-version`, it uses Claude style; with `x-goog-api-key` or the `key` query parameter, it uses Gemini style.

<Info>
  If you only want to know “roughly what text model names are available in the system” and do not want to send an API request right away, you can first look at the “Common Model Name Examples” in the [text model support matrix](/en/texts/model-matrix). However, the models actually available for your current key are still determined by the response from this endpoint.
</Info>

## Common Model Name Examples

| Family       | Common Model Names                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------ |
| GPT / OpenAI | `gpt-4o`, `gpt-4o-mini`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `o1`, `o3`                                     |
| Claude       | `claude-sonnet-4-20250514`, `claude-sonnet-4-6`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-haiku-4-5-20251001` |
| Gemini       | `gemini-2.0-flash`, `gemini-2.5-flash`, `gemini-2.5-pro`, `gemini-3.1-pro-preview`                                 |
| DeepSeek     | `deepseek-chat`, `deepseek-reasoner`, `deepseek-v4-flash`, `deepseek-v4-pro`, `deepseek-r1`                        |
| Qwen         | `qwen-max`, `qwen3-max`, `qwen3-omni-flash`                                                                        |

## Path

| Method | Path                    | Description                                |
| ------ | ----------------------- | ------------------------------------------ |
| `GET`  | `/v1/models`            | OpenAI/Claude/Gemini compatible model list |
| `GET`  | `/v1/models/{model}`    | Query a single model                       |
| `GET`  | `/v1beta/models`        | Gemini native model list                   |
| `GET`  | `/v1beta/openai/models` | OpenAI-compatible model list under Gemini  |

## Request Example

<RequestExample>
  ```bash theme={null}
  curl https://octopusx.ai/v1/models \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

### Claude Style

```bash theme={null}
curl https://octopusx.ai/v1/models \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01"
```

### Gemini Style

```bash theme={null}
curl https://octopusx.ai/v1beta/models \
  -H "x-goog-api-key: YOUR_API_KEY"
```

## Response Example

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "gpt-4o",
        "object": "model",
        "created": 1735689600,
        "owned_by": "openai"
      },
      {
        "id": "claude-sonnet-4-20250514",
        "object": "model",
        "created": 1735689600,
        "owned_by": "anthropic"
      }
    ]
  }
  ```

  ```json 401 theme={null}
  {
    "error": {
      "message": "Invalid API key provided",
      "type": "invalid_request_error",
      "param": "",
      "code": "invalid_api_key"
    }
  }
  ```

  ```json 429 theme={null}
  {
    "error": {
      "message": "The request rate is too high currently, please try again later",
      "type": "new_api_error",
      "param": "",
      "code": "too_many_requests"
    }
  }
  ```

  ```json 500 theme={null}
  {
    "error": {
      "message": "bad response body",
      "type": "new_api_error",
      "param": "",
      "code": "bad_response_body"
    }
  }
  ```
</ResponseExample>

### Query a Single Model

```bash theme={null}
curl https://octopusx.ai/v1/models/gpt-4o \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Related Interfaces

* [Chat Completions Interface (Default Non-Streaming)](./chat-completions-non-stream)
* [Gemini Native Format](./gemini-native)