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

# List models

> List available models and their information. This request does not require a body.



## OpenAPI

````yaml /model-inference/api/model-inference-api.json get /models
openapi: 3.1.0
info:
  title: ScitiX Model Inference API
  version: 1.0.0
  description: >-
    List models and generate output using the Chat Completions, Messages, or
    Responses protocol.


    Authenticate with `Authorization: Bearer <API_KEY>`. Supported protocols,
    parameters, and response fields vary by model. Check the model documentation
    before making a request.
servers:
  - url: https://api.scitix.ai/model-api
    description: >-
      Base URL for the ScitiX Model Inference API. This reference uses the URL
      without `/v1` and appends each endpoint path.
security:
  - BearerAuth: []
tags:
  - name: Models
    description: List models and their attributes.
  - name: Chat Completions
    description: Generate chat replies using the Chat Completions protocol.
  - name: Messages
    description: Generate messages using the Anthropic Messages protocol.
  - name: Responses
    description: Generate model responses using the Responses protocol.
paths:
  /models:
    get:
      tags:
        - Models
      summary: List models
      description: >-
        List available models and their information. This request does not
        require a body.
      operationId: listModels
      responses:
        '200':
          description: >-
            Model list returned successfully. Available models and attributes
            depend on the actual response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelList'
              examples:
                Model list response excerpt:
                  summary: Model list response excerpt
                  description: >-
                    This excerpt shows a subset of models and fields. Refer to
                    the actual response for the full model list and attributes.
                    The Qwen example includes identification fields only;
                    omitted optional fields are not necessarily unsupported.
                  value:
                    object: list
                    data:
                      - id: deepseek-ai/deepseek-v4.1-flash-1017
                        object: model
                        owned_by: deepseek
                        context_window: 1048576
                        context_length: 1048576
                        max_output: 393216
                        pricing:
                          input: 2
                          output: 8
                          cache_read: 0.04
                      - created: 0
                        id: Qwen/Qwen3.6-27B
                        object: model
                        owned_by: Qwen
                        permission: null
                        root: ''
                        parent: ''
        '401':
          description: Authentication failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Invalid key:
                  value:
                    error:
                      msg: authorization api key not valid
                      code: unauthorized
                      message: >-
                        authorization api key not valid (request_id:
                        5cdab30c-a403-43e6-bd89-18770dea11d2)
                      type: authentication_error
                      traceId: 588df95074d8f30269ab8c9451baa570
                      request_id: 5cdab30c-a403-43e6-bd89-18770dea11d2
                  summary: Invalid key
                Missing authorization header:
                  value:
                    error:
                      msg: Missing authorization header
                      code: unauthorized
                      message: >-
                        Missing authorization header (request_id:
                        a6be5b38-8299-47e9-a7ae-04a2e86469cc)
                      type: authentication_error
                      traceId: 1c1e74c354b0b1129005477a3efbd5e8
                      request_id: a6be5b38-8299-47e9-a7ae-04a2e86469cc
                  summary: Missing authorization header
        default:
          description: >-
            Other error response. Use the HTTP status, error message, and
            request ID to investigate.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ModelList:
      type: object
      required:
        - object
        - data
      properties:
        object:
          type: string
          description: List object type, set to `list`.
        data:
          type: array
          items:
            $ref: '#/components/schemas/Model'
          description: List of models, including each model's ID and related information.
      additionalProperties: true
      description: >-
        Model-list response. The `data` array contains information about each
        model.
    ErrorResponse:
      type: object
      description: >-
        Errors may use top-level fields, a nested `error` object, or an object
        with `object=error`. Handle the structure actually returned and retain
        the error information and request identifiers for troubleshooting.
      anyOf:
        - type: object
          required:
            - type
            - message
          properties:
            type:
              type: string
              example: invalid_request_error
              description: >-
                Error type, which distinguishes authentication, request format,
                rate limiting, and other issues.
            code:
              type:
                - string
                - integer
                - 'null'
              description: >-
                Error code. May be a string, integer, or `null`. Use the error
                type and message to investigate; do not rely only on numeric
                codes.
            message:
              type: string
              description: >-
                Error message, which may include a request or trace identifier.
                Retain the complete message for troubleshooting.
          additionalProperties: true
        - type: object
          required:
            - error
          properties:
            error:
              type: object
              required:
                - message
              properties:
                message:
                  type: string
                  description: >-
                    Error message, which may include a request or trace
                    identifier. Retain the complete message for troubleshooting.
                type:
                  type: string
                  description: >-
                    Error type, which distinguishes authentication, request
                    format, rate limiting, and other issues.
                code:
                  type:
                    - string
                    - integer
                    - 'null'
                  description: >-
                    Error code. May be a string, integer, or `null`. Use the
                    error type and message to investigate; do not rely only on
                    numeric codes.
                msg:
                  type: string
                  description: Short error description.
                request_id:
                  type: string
                  description: >-
                    Platform-generated request ID for request correlation and
                    troubleshooting.
                traceId:
                  type: string
                  description: Trace identifier returned in the error response.
                trace_id:
                  type: string
                  description: Trace identifier returned in the error response.
              additionalProperties: true
              description: Error information object.
            type:
              type: string
              example: error
              description: Top-level type identifier in an error response.
          additionalProperties: true
        - type: object
          required:
            - object
            - message
          properties:
            object:
              type: string
              enum:
                - error
              description: Error object type, set to `error`.
            message:
              type: string
              description: >-
                Error message, which may include a request or trace identifier.
                Retain the complete message for troubleshooting.
            type:
              type: string
              example: BadRequestError
              description: >-
                Error type, which distinguishes authentication, request format,
                rate limiting, and other issues.
            code:
              type:
                - integer
                - string
                - 'null'
              description: >-
                Error code. May be a string, integer, or `null`. Use the error
                type and message to investigate; do not rely only on numeric
                codes.
          additionalProperties: true
    Model:
      type: object
      description: >-
        Information about one model. Optional fields vary by model. A missing
        field alone does not establish that a capability is unsupported.
      properties:
        id:
          type: string
          description: >-
            Model ID. Preserve capitalization and the vendor prefix when making
            requests.
          example: Qwen/Qwen3.6-27B
        object:
          type: string
          description: Model object type, set to `model`.
        created:
          type: integer
          description: >-
            Creation-time field returned by the API. A value of `0` does not
            establish the model's actual creation time.
          example: 0
        owned_by:
          type: string
          description: Model ownership identifier.
          example: Qwen
        permission:
          description: Permission information returned by the API. May be `null`.
        root:
          type: string
          description: The `root` field returned by the API. May be an empty string.
        parent:
          type: string
          description: The `parent` field returned by the API. May be an empty string.
        context_window:
          type: integer
          description: Model context window size in tokens. Some models omit this field.
        context_length:
          type: integer
          description: >-
            Context length returned by the API, in tokens. Some models omit this
            field.
        max_output:
          type: integer
          description: >-
            Maximum output length returned by the API, in tokens. Some models
            omit this field.
        capabilities:
          type: array
          description: >-
            List of model capability identifiers. Some models omit this field;
            its absence does not mean a capability is unsupported.
          items:
            type: string
          example:
            - function_calling
            - structured_outputs
            - prompt_caching
        pricing:
          $ref: '#/components/schemas/ModelPricing'
          description: >-
            Model unit prices in USD per million tokens. For current prices and
            billing rules, see the model details in the console.
      additionalProperties: true
      required:
        - id
        - object
    ModelPricing:
      type: object
      description: >-
        Model unit prices in USD per million tokens. Fields vary by model. For
        current prices and billing rules, see the model details.
      properties:
        input:
          type: number
          description: Unit price for input tokens.
        output:
          type: number
          description: Unit price for output tokens.
        cache_read:
          type: number
          description: Unit price for cache reads.
        cache_write:
          type: number
          description: Unit price for cache writes.
        cache_write_5m:
          type: number
          description: >-
            The `cache_write_5m` unit price returned by the API. See the model
            details for applicable rules.
        cache_write_1h:
          type: number
          description: >-
            The `cache_write_1h` unit price returned by the API. See the model
            details for applicable rules.
        cache_input_independent:
          type: boolean
          description: >-
            The `cache_input_independent` flag returned by the API. Refer to the
            model details for its meaning and applicable rules.
        context_tiers:
          type: array
          description: >-
            Model unit prices in USD per million tokens, grouped by context
            length. See the model details for tier rules.
          items:
            $ref: '#/components/schemas/ModelContextTier'
      additionalProperties: true
    ModelContextTier:
      type: object
      properties:
        over_tokens:
          type: integer
          description: >-
            Token tier threshold returned by the API. Refer to the model details
            for applicable rules.
        input:
          type: number
          description: Unit price for input tokens in this tier.
        output:
          type: number
          description: Unit price for output tokens in this tier.
        cache_read:
          type: number
          description: Unit price for cache reads in this tier.
        cache_write:
          type: number
          description: Unit price for cache writes in this tier.
      additionalProperties: true
      description: Model unit prices in USD per million tokens for one context-length tier.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authenticate with an API key using Bearer authentication. Do not expose
        real keys in documentation, code, or repositories.

````

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