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

# List Active Models

> Returns currently active (published) models with slug, type, name, series name, documentation URL, description, and optional display price. Optional query `featured=true` limits results to CMS featured models.



## OpenAPI

````yaml /else-api/list-active-models.json get /api/v1/models
openapi: 3.1.0
info:
  description: List all active (published) models available on the Modellix platform.
  version: 1.0.0
  contact:
    name: Modellix API Support
    email: support@modellix.ai
  title: Models API
servers:
  - url: https://api.modellix.ai/
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/v1/models:
    get:
      summary: List Active Models
      description: >-
        Returns currently active (published) models with slug, type, name,
        series name, documentation URL, description, and optional display price.
        Optional query `featured=true` limits results to CMS featured models.
      operationId: listActiveModels
      parameters:
        - name: featured
          in: query
          required: false
          description: When true, only return Featured Models. Default false.
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Successful response with list of active models
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActiveModelsResponse'
              examples:
                success:
                  summary: List of active models
                  value:
                    models:
                      - slug: google/nano-banana-2
                        type: text-to-image
                        name: Nano Banana 2
                        series_name: Nano Banana
                        docs_url: https://docs.modellix.ai/google/nano-banana-2.md
                        description: >-
                          Gemini 3.1 Flash text-to-image model for fast,
                          high-quality image generation.
                        price:
                          min: 0.0001
                          max: 0.0005
                          unit: $/img
                      - slug: google/nano-banana-2-edit
                        type: image-to-image
                        name: Nano Banana 2 Edit
                        series_name: Nano Banana
                        docs_url: https://docs.modellix.ai/google/nano-banana-2-edit.md
                        description: >-
                          Gemini 3.1 Flash image editing model for transforming
                          and refining input images.
                        price:
                          fixed: 0.0001
                          unit: $/img
        '400':
          description: Invalid query parameters (e.g. featured)
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ActiveModelsResponse:
      type: object
      required:
        - models
      properties:
        models:
          type: array
          description: List of active models
          items:
            $ref: '#/components/schemas/ActiveModel'
    ActiveModel:
      type: object
      required:
        - slug
        - type
        - name
        - series_name
        - docs_url
        - description
      properties:
        slug:
          type: string
          description: Model identifier in provider/model_id format
          example: google/nano-banana-2
        type:
          type: string
          description: Model type/category
          enum:
            - text-to-image
            - image-to-image
            - text-to-video
            - image-to-video
            - video-to-video
            - text-to-speech
          example: text-to-image
        name:
          type: string
          description: Display name of the model
          example: Nano Banana 2
        series_name:
          type: string
          description: Display name of the model series this model belongs to
          example: Nano Banana
        docs_url:
          type: string
          format: uri
          description: URL to the model's developer documentation
          example: https://docs.modellix.ai/google/nano-banana-2.md
        description:
          type: string
          description: Short display description for the model
          example: >-
            Gemini 3.1 Flash text-to-image model for fast, high-quality image
            generation.
        price:
          $ref: '#/components/schemas/ActiveModelPrice'
          description: Optional display price. Omitted when pricing is unavailable.
    ErrorResponse:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          description: Error code
          example: 401
        message:
          type: string
          description: Error message
          example: Authentication failed
    ActiveModelPrice:
      type: object
      required:
        - unit
      description: >-
        Display price in USD. Normal pricing uses `fixed`; composite pricing
        uses `min` and `max`.
      properties:
        fixed:
          type: number
          description: Unit price when pricing_type is normal
          example: 0.0001
        min:
          type: number
          description: Minimum unit price for composite pricing
          example: 0.0001
        max:
          type: number
          description: Maximum unit price for composite pricing
          example: 0.0005
        unit:
          type: string
          enum:
            - $/img
            - $/sec
            - $/M chars
          example: $/img
  responses:
    Unauthorized:
      description: Unauthorized - Invalid or missing API Key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: 401
            message: 'Authentication failed: invalid API key'
    TooManyRequests:
      description: Too many requests - Rate limit exceeded
      headers:
        X-RateLimit-Limit:
          description: Maximum requests per minute
          schema:
            type: integer
            example: 100
        X-RateLimit-Remaining:
          description: Remaining quota in current window
          schema:
            type: integer
            example: 0
        X-RateLimit-Reset:
          description: Rate limit window reset time (Unix timestamp)
          schema:
            type: integer
            example: 1704067260
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: 429
            message: >-
              Rate limit exceeded: 100 requests per minute, retry after 60
              seconds
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: 500
            message: Internal server error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API Key authentication. Format: Bearer YOUR_API_KEY'

````