> ## 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.

# 모델 목록

> 현재 공개 모델 카탈로그를 반환합니다.

이 엔드포인트로 현재 공개 모델 카탈로그를 조회하세요.

카탈로그는 구체적인 모델 ID보다 제공자 수준 latest 별칭을 먼저 포함합니다.

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

해당 제공자의 권장 플래그십 모델을 Capriole AI가 선택하게 하려면 latest 별칭을 사용하세요. 정확한 모델 버전이 필요하면 구체적인 모델 ID를 사용하세요.

| 모델 선택                                             | 적합한 경우                                   |
| ------------------------------------------------- | ---------------------------------------- |
| `openai-latest`, `claude-latest`, `google-latest` | 한 번 구성한 뒤 Capriole AI가 권장 플래그십을 유지하게 할 때 |
| `openai/gpt-5.6-terra` 같은 구체적인 모델 ID              | 정확한 모델 버전을 고정할 때                         |

`POST /v1/chat`와 `POST /v1/chat/completions`에서 latest 별칭은 다음과 같이 해석됩니다.

| Latest 별칭       | 해석 결과                           |
| --------------- | ------------------------------- |
| `openai-latest` | `openai/gpt-5.6-terra`          |
| `claude-latest` | `anthropic/claude-fable-5`      |
| `google-latest` | `google/gemini-3.1-pro-preview` |

| 엔드포인트                            | 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`                                   |

Anthropic Messages 엔드포인트는 `claude-fable-5`, `claude-opus-5`, `claude-opus-4-8`, `claude-opus-4-7`, `claude-opus-4-6`, `claude-sonnet-4-6`처럼 접두사 없는 구체적인 Claude Messages ID도 받습니다.

`POST /v1/messages`와 `POST /v1/messages/count_tokens`에서 `claude-latest`는 `claude-fable-5`로 해석되며, Chat 및 Chat Completions latest 별칭과 같습니다.

위에 나온 그대로의 별칭 ID를 사용하세요. `openai/openai-latest` 같은 제공자 접두사는 클라이언트 쪽 선택자 패턴이며 Capriole AI 모델 ID가 아닙니다.


## 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.

````