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

# List models

> List OpenAI-compatible public model metadata without authentication. This route returns the same non-organization-specific catalog as `/api/v1/models`, including when credentials are supplied. Redis caches complete JSON responses for 24 hours and admin mutations or worker model syncs and price imports for any provider invalidate the shared generation. HTTP responses use Cache-Control: no-store; configured cache outages return 503. Inference authorization remains required.

The response is aligned with gateway model discovery and exposes safe logical model IDs, supported parameters, privacy tiers and customer prices. Attestation and encryption evidence is returned by the attestation endpoint, not model discovery.



## OpenAPI

````yaml openapi.json GET /v1/models
openapi: 3.1.0
info:
  contact:
    email: developers@trynito.ai
    name: Nito Developer Support
    url: https://docs.trynito.ai/support
  description: >-
    Nito developer API: inference, Fusion, model catalog, attestation, web
    retrieval, document parsing, API key management, balance, rate-limit
    snapshots, and MCP.
  termsOfService: https://trynito.ai/terms
  title: Nito API
  version: '2026-07-01'
servers:
  - description: Configured gateway
    url: https://app.trynito.ai
security: []
tags:
  - description: >-
      OpenAI Chat Completions-compatible inference routes backed by gateway
      routing, billing, privacy, and streaming controls.
    name: Chat
  - description: >-
      Stateless OpenAI Responses-compatible shims for agent clients, including
      the compact output-item endpoint used by standalone compaction flows.
    name: Responses
  - description: >-
      Anthropic Messages-compatible request, response, token-count, and
      streaming surfaces mapped into canonical gateway contracts.
    name: Messages
  - description: >-
      Model discovery and browser model-picker metadata for safe logical model
      selection.
    name: Models
  - description: >-
      Request-local Attestation metadata for supported Attestable models in the
      Confidential and Encrypted tiers.
    name: Attestation
  - description: >-
      Streamable HTTP MCP transport documented with resource-bound bearer-token
      authentication.
    name: MCP
  - description: >-
      Standalone, credential-authenticated web search and fetch without an
      inference model.
    name: Web
  - description: >-
      OAuth-authorized organization API key administration with explicit consent
      and current owner/admin authorization.
    name: API Keys
  - description: >-
      Browser billing, usage, referral, balance, auto top-up, and x402 funding
      surfaces using integer nanos.
    name: Billing
externalDocs:
  description: Nito developer documentation
  url: https://docs.trynito.ai/nito
paths:
  /v1/models:
    get:
      tags:
        - Models
      summary: List OpenAI-compatible models
      description: >-
        List OpenAI-compatible public model metadata without authentication.
        This route returns the same non-organization-specific catalog as
        `/api/v1/models`, including when credentials are supplied. Redis caches
        complete JSON responses for 24 hours and admin mutations or worker model
        syncs and price imports for any provider invalidate the shared
        generation. HTTP responses use Cache-Control: no-store; configured cache
        outages return 503. Inference authorization remains required.


        The response is aligned with gateway model discovery and exposes safe
        logical model IDs, supported parameters, privacy tiers and customer
        prices. Attestation and encryption evidence is returned by the
        attestation endpoint, not model discovery.
      operationId: listOpenAIModels
      parameters:
        - description: chat, image, embedding, other, or all
          example: chat
          in: query
          name: type
          required: false
          schema:
            enum:
              - chat
              - text
              - image
              - images
              - embedding
              - embeddings
              - other
              - all
            type: string
        - description: Case-insensitive model search
          example: gpt
          in: query
          name: q
          required: false
          schema:
            type: string
        - description: anon, private, confidential, or encrypted
          example: private
          in: query
          name: privacy_tier
          required: false
          schema:
            enum:
              - anon
              - private
              - confidential
              - encrypted
            type: string
        - description: frontier, open_source, open-source, or unknown
          example: frontier
          in: query
          name: source
          required: false
          schema:
            enum:
              - frontier
              - open_source
              - open-source
              - unknown
            type: string
        - description: Comma-separated capability filter
          example: reasoning,web_search
          in: query
          name: supports
          required: false
          schema:
            pattern: >-
              ^\s*(?:[Ff][Ii][Ll][Ee][-_][Aa][Tt][Tt][Aa][Cc][Hh][Mm][Ee][Nn][Tt][Ss]|[Ii][Mm][Aa][Gg][Ee][-_][Ii][Nn][Pp][Uu][Tt][Ss]|[Ii][Mm][Aa][Gg][Ee][-_][Gg][Ee][Nn][Ee][Rr][Aa][Tt][Ii][Oo][Nn]|[Ww][Ee][Bb][-_][Tt][Oo][Oo][Ll][Ss]|[Ww][Ee][Bb][-_][Ss][Ee][Aa][Rr][Cc][Hh]|[Ww][Ee][Bb][-_][Ff][Ee][Tt][Cc][Hh]|[Rr][Ee][Aa][Ss][Oo][Nn][Ii][Nn][Gg]|[Ff][Uu][Nn][Cc][Tt][Ii][Oo][Nn][-_][Tt][Oo][Oo][Ll][Ss]|[Tt][Oo][Oo][Ll][-_][Cc][Hh][Oo][Ii][Cc][Ee]|[Jj][Ss][Oo][Nn][-_][Mm][Oo][Dd][Ee]|[Ss][Tt][Rr][Uu][Cc][Tt][Uu][Rr][Ee][Dd][-_][Oo][Uu][Tt][Pp][Uu][Tt][Ss]|[Ss][Tt][Rr][Ii][Cc][Tt][-_][Ff][Uu][Nn][Cc][Tt][Ii][Oo][Nn][-_][Tt][Oo][Oo][Ll][Ss]|[Tt][Oo][Oo][Ll][-_][Cc][Aa][Ll][Ll][-_][Cc][Oo][Nn][Cc][Uu][Rr][Rr][Ee][Nn][Cc][Yy][-_][Cc][Oo][Nn][Tt][Rr][Oo][Ll]|[Pp][Aa][Rr][Aa][Ll][Ll][Ee][Ll][-_][Tt][Oo][Oo][Ll][-_][Cc][Aa][Ll][Ll][Ss]|[Ss][Tt][Oo][Pp][-_][Ss][Ee][Qq][Uu][Ee][Nn][Cc][Ee][Ss]|[Ff][Rr][Ee][Qq][Uu][Ee][Nn][Cc][Yy][-_][Pp][Ee][Nn][Aa][Ll][Tt][Yy]|[Pp][Rr][Ee][Ss][Ee][Nn][Cc][Ee][-_][Pp][Ee][Nn][Aa][Ll][Tt][Yy]|[Aa][Tt][Tt][Ee][Ss][Tt][Aa][Bb][Ll][Ee]|[Tt][Ee][Ee][-_][Aa][Tt][Tt][Ee][Ss][Tt][Aa][Tt][Ii][Oo][Nn]|[Ee][Nn][Cc][Rr][Yy][Pp][Tt][Ee][Dd])\s*(,\s*(?:[Ff][Ii][Ll][Ee][-_][Aa][Tt][Tt][Aa][Cc][Hh][Mm][Ee][Nn][Tt][Ss]|[Ii][Mm][Aa][Gg][Ee][-_][Ii][Nn][Pp][Uu][Tt][Ss]|[Ii][Mm][Aa][Gg][Ee][-_][Gg][Ee][Nn][Ee][Rr][Aa][Tt][Ii][Oo][Nn]|[Ww][Ee][Bb][-_][Tt][Oo][Oo][Ll][Ss]|[Ww][Ee][Bb][-_][Ss][Ee][Aa][Rr][Cc][Hh]|[Ww][Ee][Bb][-_][Ff][Ee][Tt][Cc][Hh]|[Rr][Ee][Aa][Ss][Oo][Nn][Ii][Nn][Gg]|[Ff][Uu][Nn][Cc][Tt][Ii][Oo][Nn][-_][Tt][Oo][Oo][Ll][Ss]|[Tt][Oo][Oo][Ll][-_][Cc][Hh][Oo][Ii][Cc][Ee]|[Jj][Ss][Oo][Nn][-_][Mm][Oo][Dd][Ee]|[Ss][Tt][Rr][Uu][Cc][Tt][Uu][Rr][Ee][Dd][-_][Oo][Uu][Tt][Pp][Uu][Tt][Ss]|[Ss][Tt][Rr][Ii][Cc][Tt][-_][Ff][Uu][Nn][Cc][Tt][Ii][Oo][Nn][-_][Tt][Oo][Oo][Ll][Ss]|[Tt][Oo][Oo][Ll][-_][Cc][Aa][Ll][Ll][-_][Cc][Oo][Nn][Cc][Uu][Rr][Rr][Ee][Nn][Cc][Yy][-_][Cc][Oo][Nn][Tt][Rr][Oo][Ll]|[Pp][Aa][Rr][Aa][Ll][Ll][Ee][Ll][-_][Tt][Oo][Oo][Ll][-_][Cc][Aa][Ll][Ll][Ss]|[Ss][Tt][Oo][Pp][-_][Ss][Ee][Qq][Uu][Ee][Nn][Cc][Ee][Ss]|[Ff][Rr][Ee][Qq][Uu][Ee][Nn][Cc][Yy][-_][Pp][Ee][Nn][Aa][Ll][Tt][Yy]|[Pp][Rr][Ee][Ss][Ee][Nn][Cc][Ee][-_][Pp][Ee][Nn][Aa][Ll][Tt][Yy]|[Aa][Tt][Tt][Ee][Ss][Tt][Aa][Bb][Ll][Ee]|[Tt][Ee][Ee][-_][Aa][Tt][Tt][Ee][Ss][Tt][Aa][Tt][Ii][Oo][Nn]|[Ee][Nn][Cc][Rr][Yy][Pp][Tt][Ee][Dd])\s*)*$
            type: string
        - description: Minimum context window in tokens
          example: 0
          in: query
          name: min_context
          required: false
          schema:
            minimum: 0
            type: integer
        - description: Maximum input price per million tokens
          example: 0
          in: query
          name: max_input_million_token_nanos
          required: false
          schema:
            minimum: 0
            type: integer
        - description: Maximum output price per million tokens
          example: 0
          in: query
          name: max_output_million_token_nanos
          required: false
          schema:
            minimum: 0
            type: integer
        - description: Maximum combined price per million tokens
          example: 0
          in: query
          name: max_combined_million_token_nanos
          required: false
          schema:
            minimum: 0
            type: integer
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  - architecture:
                      input_modalities:
                        - text
                        - image
                      modality: text->text
                      output_modalities:
                        - text
                    capabilities:
                      supports_image_inputs: true
                      supports_reasoning: true
                      supports_web_search: true
                    context_window: 128000
                    created: 1778268600
                    description: General-purpose chat model.
                    display_name: GPT 5.5
                    id: openai/gpt-5.5
                    object: model
                    owned_by: nito
                    privacy_tier: private
                    source: frontier
                    supported_parameters:
                      - reasoning
                    type: chat
                object: list
              schema:
                $ref: '#/components/schemas/ModelList'
          description: OK
          headers:
            Cache-Control:
              description: >-
                Full responses are cached internally in Redis; clients and
                intermediaries must not store them.
              example: no-store
              schema:
                type: string
            X-RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
        '400':
          content:
            application/json:
              example:
                error:
                  code: invalid_request
                  message: The request is invalid.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Invalid request
          headers:
            Cache-Control:
              description: >-
                Full responses are cached internally in Redis; clients and
                intermediaries must not store them.
              example: no-store
              schema:
                type: string
        '429':
          content:
            application/json:
              example:
                error:
                  code: rate_limited
                  message: rate limited
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Request rate limit exceeded
          headers:
            Cache-Control:
              description: >-
                Full responses are cached internally in Redis; clients and
                intermediaries must not store them.
              example: no-store
              schema:
                type: string
            Retry-After:
              description: >-
                Seconds to wait before retrying when the gateway can compute a
                retry window.
              example: '60'
              schema:
                type: string
            X-RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
        '500':
          content:
            application/json:
              example:
                error:
                  code: internal_error
                  message: internal error
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal server error
          headers:
            Cache-Control:
              description: >-
                Full responses are cached internally in Redis; clients and
                intermediaries must not store them.
              example: no-store
              schema:
                type: string
        '503':
          content:
            application/json:
              example:
                error:
                  code: unavailable
                  message: model discovery is temporarily unavailable
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Public catalog or configured Redis response cache unavailable
          headers:
            Cache-Control:
              description: >-
                Full responses are cached internally in Redis; clients and
                intermediaries must not store them.
              example: no-store
              schema:
                type: string
      security: []
components:
  schemas:
    ModelList:
      description: >-
        Schema for `ModelList` values returned by or accepted by the Nito
        gateway.
      example:
        data:
          - architecture:
              input_modalities:
                - text
                - image
              modality: text->text
              output_modalities:
                - text
            capabilities:
              supports_image_inputs: true
              supports_reasoning: true
              supports_web_search: true
            context_window: 128000
            created: 1778268600
            description: General-purpose chat model.
            display_name: GPT 5.5
            id: openai/gpt-5.5
            object: model
            owned_by: nito
            privacy_tier: private
            source: frontier
            type: chat
            supported_parameters:
              - reasoning
        object: list
      properties:
        data:
          description: The `data` field on `ModelList`.
          example: []
          items:
            $ref: '#/components/schemas/Model'
            description: Nested schema within `ModelList` for `ModelList.data.items`.
          type: array
        object:
          description: The `object` field on `ModelList`.
          enum:
            - list
          example: list
          type: string
      required:
        - object
        - data
      type: object
    ErrorResponse:
      description: >-
        Schema for `ErrorResponse` values returned by or accepted by the Nito
        gateway.
      example:
        error:
          code: invalid_request
          message: The request is invalid.
          param: model
      properties:
        error:
          $ref: '#/components/schemas/Error'
          description: The `error` field on `ErrorResponse`.
          example: example
      required:
        - error
      type: object
    Model:
      description: Schema for `Model` values returned by or accepted by the Nito gateway.
      example:
        architecture:
          input_modalities:
            - text
            - image
          modality: text->text
          output_modalities:
            - text
        capabilities:
          supports_image_inputs: true
          supports_reasoning: true
          supports_web_search: true
        context_window: 128000
        created: 1778268600
        description: General-purpose chat model.
        display_name: GPT 5.5
        id: openai/gpt-5.5
        object: model
        owned_by: nito
        privacy_tier: private
        source: frontier
        type: chat
        supported_parameters:
          - reasoning
      properties:
        architecture:
          description: The `architecture` field on `Model`.
          example: {}
          properties:
            input_modalities:
              description: The `input_modalities` field on `Model`.
              example: []
              items:
                description: >-
                  Nested schema within `Model` for
                  `Model.architecture.input_modalities.items`.
                type: string
              type: array
            modality:
              description: The `modality` field on `Model`.
              example: example
              type: string
            output_modalities:
              description: The `output_modalities` field on `Model`.
              example: []
              items:
                description: >-
                  Nested schema within `Model` for
                  `Model.architecture.output_modalities.items`.
                type: string
              type: array
          required:
            - input_modalities
            - output_modalities
            - modality
          type: object
        capabilities:
          description: The `capabilities` field on `Model`.
          example: {}
          properties:
            supports_file_attachments:
              description: The `supports_file_attachments` field on `Model`.
              example: true
              type: boolean
            supports_image_generation:
              description: The `supports_image_generation` field on `Model`.
              example: true
              type: boolean
            supports_image_inputs:
              description: The `supports_image_inputs` field on `Model`.
              example: true
              type: boolean
            supports_reasoning:
              description: The `supports_reasoning` field on `Model`.
              example: true
              type: boolean
            supports_web_fetch:
              description: The `supports_web_fetch` field on `Model`.
              example: true
              type: boolean
            supports_web_search:
              description: The `supports_web_search` field on `Model`.
              example: true
              type: boolean
          type: object
        context_window:
          description: The `context_window` field on `Model`.
          example: 1
          type: integer
        created:
          description: The `created` field on `Model`.
          example: 1778268600
          type: integer
        description:
          description: The `description` field on `Model`.
          example: example
          type: string
        display_name:
          description: The `display_name` field on `Model`.
          example: example
          type: string
        id:
          description: The `id` field on `Model`.
          example: 00000000-0000-4000-8000-000000000001
          type: string
        object:
          description: The `object` field on `Model`.
          enum:
            - model
          example: model
          type: string
        owned_by:
          description: The `owned_by` field on `Model`.
          example: example
          type: string
        pricing:
          description: The `pricing` field on `Model`.
          example: {}
          properties:
            cache_read_input_token_nanos:
              description: The `cache_read_input_token_nanos` field on `Model`.
              example: 1000000000
              type: integer
            cache_write_input_token_nanos:
              description: The `cache_write_input_token_nanos` field on `Model`.
              example: 1000000000
              type: integer
            currency_code:
              description: The `currency_code` field on `Model`.
              example: USD
              type: string
            image_output_nanos:
              description: The `image_output_nanos` field on `Model`.
              example: 1000000000
              type: integer
            input_token_nanos:
              description: The `input_token_nanos` field on `Model`.
              example: 1000000000
              type: integer
            output_token_nanos:
              description: The `output_token_nanos` field on `Model`.
              example: 1000000000
              type: integer
            reasoning_output_token_nanos:
              description: The `reasoning_output_token_nanos` field on `Model`.
              example: 1000000000
              type: integer
            unit:
              description: The `unit` field on `Model`.
              example: example
              type: string
          type: object
        privacy_tier:
          description: The `privacy_tier` field on `Model`.
          enum:
            - anon
            - private
            - confidential
            - encrypted
          example: anon
          type: string
        source:
          description: The `source` field on `Model`.
          example: example
          type: string
        supported_parameters:
          description: >-
            Sorted optional controls from the final effective route.
            structured_outputs and strict_function_tools are semantic
            qualifiers, not top-level request fields. This is not an exhaustive
            list of common request fields.
          example: []
          items:
            description: >-
              Nested schema within `Model` for
              `Model.supported_parameters.items`.
            type: string
          type: array
        type:
          description: The `type` field on `Model`.
          example: example
          type: string
      required:
        - id
        - object
        - created
        - owned_by
        - description
        - type
        - source
        - architecture
        - capabilities
        - privacy_tier
        - supported_parameters
      type: object
    Error:
      description: Schema for `Error` values returned by or accepted by the Nito gateway.
      example:
        code: example
        message: example
        operation_id: 00000000-0000-4000-8000-000000000001
        param: example
      properties:
        code:
          description: The `code` field on `Error`.
          example: example
          type: string
        message:
          description: The `message` field on `Error`.
          example: example
          type: string
        operation_id:
          description: The `operation_id` field on `Error`.
          example: 00000000-0000-4000-8000-000000000001
          type: string
        param:
          description: The `param` field on `Error`.
          example: example
          type: string
      required:
        - message
        - code
      type: object
  headers:
    RateLimitLimit:
      description: Maximum requests for the controlling gateway request-rate bucket.
      schema:
        type: string
    RateLimitRemaining:
      description: >-
        Additional requests immediately available in the controlling gateway
        request-rate bucket.
      schema:
        type: string
    RateLimitReset:
      description: >-
        UTC Unix epoch seconds, rounded up, when the controlling gateway
        request-rate bucket is fully replenished.
      schema:
        type: string

````

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