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

# Models

> Use DeerAPI to call the Models endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Models workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/text/openai/get-models.openapi.json GET /v1/models
openapi: 3.1.0
info:
  title: List Models API
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /v1/models:
    get:
      summary: List Models API
      description: Use this field according to the endpoint schema.
      operationId: get_v1_models
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - object
                  - data
                properties:
                  object:
                    type: string
                    description: Use this field according to the endpoint schema.
                  data:
                    type: array
                    description: Use this field according to the endpoint schema.
                    items:
                      type: object
                      required:
                        - id
                        - object
                        - created
                        - owned_by
                      properties:
                        id:
                          type: string
                          description: Use this field according to the endpoint schema.
                        object:
                          type: string
                          description: Use this field according to the endpoint schema.
                        created:
                          type: integer
                          description: Use this field according to the endpoint schema.
                        owned_by:
                          type: string
                          description: Use this field according to the endpoint schema.
                        supported_endpoint_types:
                          type: array
                          description: Use this field according to the endpoint schema.
                          items:
                            type: string
                      additionalProperties: true
                examples:
                  Default:
                    summary: Default
                    value:
                      object: list
                      data:
                        - id: gpt-5.4
                          object: model
                          created: 1626777600
                          owned_by: openai
                          supported_endpoint_types:
                            - chat
                            - responses
                        - id: text-embedding-3-small
                          object: model
                          created: 1626777600
                          owned_by: openai
                          supported_endpoint_types:
                            - embeddings
      x-codeSamples:
        - lang: Python
          label: Example
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/v1/models"
            headers = {"Authorization": "Bearer " + os.environ["DEERAPI_KEY"]}
            response = requests.request("GET", url, headers=headers)
            print(response.json())
        - lang: JavaScript
          label: Example
          source: |
            const response = await fetch("https://api.deerapi.com/v1/models", {
              method: "GET",
              headers: { Authorization: `Bearer ${process.env.DEERAPI_KEY}` },
            });
            console.log(await response.json());
        - lang: Shell
          label: Example
          source: |
            curl -s "https://api.deerapi.com/v1/models" \
              -H "Authorization: Bearer $DEERAPI_KEY"
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````