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

# Retrieve model

> One entry of `GET /models`, or an OpenAI-shaped 404.



## OpenAPI

````yaml /ai-backend-public.yaml get /api/v1/spaces/{spaceId}/openai/models/{model}
openapi: 3.1.0
info:
  title: nuwacom Public API
  description: Customer-facing HTTP served by ai-backend.
  version: 1.0.0
servers:
  - url: https://{customer-tenant}.nuwacom.ai
security: []
paths:
  /api/v1/spaces/{spaceId}/openai/models/{model}:
    get:
      tags:
        - Completion API
      summary: Retrieve model
      description: One entry of `GET /models`, or an OpenAI-shaped 404.
      operationId: retrieveModel
      parameters:
        - name: spaceId
          in: path
          required: true
          schema:
            type: string
            title: Spaceid
        - name: model
          in: path
          required: true
          schema:
            type: string
            description: The model id to look up.
            title: Model
          description: The model id to look up.
      responses:
        '200':
          description: The model, if this space may name it in `model`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model'
        default:
          description: OpenAI-shaped error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    Model:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          const: model
          title: Object
          default: model
        created:
          type: integer
          title: Created
        owned_by:
          type: string
          title: Owned By
          default: nuwacom
        capabilities:
          $ref: '#/components/schemas/ModelCapabilities'
      type: object
      required:
        - id
        - created
        - capabilities
      title: Model
      description: An entry in ``GET /v1/spaces/{spaceId}/openai/models``.
    OpenAIErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/OpenAIErrorBody'
      type: object
      required:
        - error
      title: OpenAIErrorResponse
      description: >-
        The envelope these routes answer every failure with, whatever the
        status.


        Declared as the routes' ``default`` response, which serves two purposes:
        the

        generated OpenAPI then describes what callers actually receive, and
        FastAPI

        stops advertising its own 422 shape — a response this route class never
        lets

        through, since it rewrites validation failures into a 400 of this shape.
    ModelCapabilities:
      properties:
        response_formats:
          items:
            $ref: '#/components/schemas/ResponseFormatType'
          type: array
          title: Response Formats
          description: The `response_format` types this model can be held to.
        reasoning_efforts:
          anyOf:
            - items:
                $ref: '#/components/schemas/ReasoningEffort'
              type: array
            - type: 'null'
          title: Reasoning Efforts
          description: >-
            The `reasoning_effort` values this model takes. `null` accepts every
            value; an empty list accepts none.
        unsupported_parameters:
          items:
            type: string
          type: array
          title: Unsupported Parameters
          description: >-
            Parameters this model refuses with a 400 whatever their value:
            sampling parameters, and `knowledge` on a model that cannot call
            tools.
        fixed_temperature:
          anyOf:
            - type: number
            - type: 'null'
          title: Fixed Temperature
          description: The only `temperature` this model takes, where it takes exactly one.
        max_temperature:
          anyOf:
            - type: number
            - type: 'null'
          title: Max Temperature
          description: The highest `temperature` this model takes, where that is below 2.
      type: object
      required:
        - response_formats
        - reasoning_efforts
        - unsupported_parameters
        - fixed_temperature
        - max_temperature
      title: ModelCapabilities
      description: >-
        What ``POST /chat/completions`` accepts for this model, beyond the
        common contract.


        A nuwacom extension of OpenAI's model object, which the OpenAI SDKs keep
        as an

        extra field. It answers in advance what would otherwise come back as a
        400.
    OpenAIErrorBody:
      properties:
        message:
          type: string
          title: Message
        type:
          type: string
          title: Type
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
      type: object
      required:
        - message
        - type
      title: OpenAIErrorBody
      description: >-
        The ``error`` object OpenAI clients read ``type``/``code``/``param``
        off.
    ResponseFormatType:
      type: string
      enum:
        - text
        - json_object
        - json_schema
    ReasoningEffort:
      type: string
      enum:
        - none
        - minimal
        - low
        - medium
        - high
        - xhigh
        - max
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.