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

# Listar modelos

> Retorna o catálogo público atual de modelos.

Use este endpoint para obter o catálogo público atual de modelos.

O catálogo inclui aliases latest no nível do provedor antes dos IDs de modelo concretos:

* `openai-latest`
* `claude-latest`
* `google-latest`

Use um alias latest quando quiser que a Capriole AI escolha o modelo principal que recomendamos para aquele provedor. Use um ID de modelo concreto quando precisar de uma versão exata.

| Escolha de modelo                                    | Melhor para                                                                         |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `openai-latest`, `claude-latest`, `google-latest`    | Configure uma vez e deixe a Capriole AI manter você no modelo principal recomendado |
| IDs de modelo concretos, como `openai/gpt-5.6-terra` | Fixar uma versão exata do modelo                                                    |

Os aliases latest são resolvidos da seguinte forma em `POST /v1/chat` e `POST /v1/chat/completions`:

| Alias latest    | Resolve para                    |
| --------------- | ------------------------------- |
| `openai-latest` | `openai/gpt-5.6-terra`          |
| `claude-latest` | `anthropic/claude-fable-5`      |
| `google-latest` | `google/gemini-3.1-pro-preview` |

| Endpoint                         | Aliases latest                                    |
| -------------------------------- | ------------------------------------------------- |
| `POST /v1/chat`                  | `openai-latest`, `claude-latest`, `google-latest` |
| `POST /v1/chat/completions`      | `openai-latest`, `claude-latest`, `google-latest` |
| `POST /v1/responses`             | `openai-latest`                                   |
| `POST /v1/messages`              | `claude-latest`                                   |
| `POST /v1/messages/count_tokens` | `claude-latest`                                   |

Os endpoints Anthropic Messages também aceitam IDs concretos de Claude Messages sem prefixo, como `claude-fable-5`, `claude-opus-5`, `claude-opus-4-8`, `claude-opus-4-7`, `claude-opus-4-6` e `claude-sonnet-4-6`.

Em `POST /v1/messages` e `POST /v1/messages/count_tokens`, `claude-latest` resolve para `claude-fable-5`, alinhado ao alias latest de Chat e Chat Completions.

Use os IDs de alias sem prefixo mostrados acima. Prefixos de provedor como `openai/openai-latest` são padrões de seletor no lado do cliente, não IDs de modelo da Capriole AI.


## OpenAPI

````yaml api-reference/openapi.json GET /v1/models
openapi: 3.1.0
info:
  title: Capriole AI API
  description: >-
    Public API for model discovery, text chat, and protocol-compatible model
    endpoints.
  version: 1.0.0
servers:
  - url: https://api.caprioletech.com
security: []
paths:
  /v1/models:
    get:
      summary: List public models
      description: Returns the current public model catalog.
      operationId: listModels
      responses:
        '200':
          description: Public model list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPublicModelsResponse'
              examples:
                default:
                  value:
                    data:
                      - id: openai-latest
                      - id: openai/gpt-5.6-terra
                      - id: openai/gpt-5.6-luna
                      - id: openai/gpt-5.5
                      - id: openai/gpt-5.4-mini
                      - id: claude-latest
                      - id: anthropic/claude-fable-5
                      - id: anthropic/claude-opus-5
                      - id: anthropic/claude-opus-4-8
                      - id: anthropic/claude-opus-4-7
                      - id: anthropic/claude-opus-4-6
                      - id: anthropic/claude-sonnet-4-6
                      - id: google-latest
                      - id: google/gemini-3.1-pro-preview
                      - id: google/gemini-3.5-flash
                      - id: xai/grok-4.5
                      - id: zai/glm-5.2
                      - id: moonshot/kimi-k3
        '429':
          $ref: '#/components/responses/RateLimitErrorResponse'
        '500':
          $ref: '#/components/responses/InternalServerErrorResponse'
components:
  schemas:
    ListPublicModelsResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/PublicModelItem'
    PublicModelItem:
      type: object
      required:
        - id
      properties:
        id:
          type: string
          description: Model identifier
    DetailError:
      type: object
      required:
        - detail
      properties:
        detail:
          type: string
          description: Error detail from the API
  responses:
    RateLimitErrorResponse:
      description: Rate limit error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DetailError'
          examples:
            rateLimitExceeded:
              value:
                detail: 'Rate limit exceeded: 100 per 1 minute'
    InternalServerErrorResponse:
      description: Internal server error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DetailError'
          examples:
            internalServerError:
              value:
                detail: An internal server error occurred. Please try again later.

````