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

# List favorite models



## OpenAPI

````yaml https://dev.hub.oxen.ai/api/_spec/oxen_hub_api.json get /api/ai/models/favorites
openapi: 3.0.0
info:
  title: oxen
  version: 0.224.2
servers:
  - url: https://dev.hub.oxen.ai
    variables: {}
security: []
tags: []
paths:
  /api/ai/models/favorites:
    get:
      tags: []
      summary: List favorite models
      operationId: OxenApiWeb.Controllers.ModelsController.list_favorites
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListModelsResponse'
          description: Favorite models
      callbacks: {}
components:
  schemas:
    ListModelsResponse:
      description: OpenAI-compatible response for listing models.
      properties:
        data:
          items:
            $ref: '#/components/schemas/Model'
          type: array
        object:
          enum:
            - list
          type: string
      required:
        - object
        - data
      title: ListModelsResponse
      type: object
    Model:
      description: >-
        Represents a model available for inference or fine-tuning. Compatible
        with the OpenAI model object.
      properties:
        capabilities:
          properties:
            input:
              items:
                type: string
              type: array
            output:
              items:
                type: string
              type: array
          type: object
        created:
          description: Unix timestamp when the model was registered
          type: integer
        deployments:
          description: Active deployments. Empty for base models.
          items:
            properties:
              status:
                enum:
                  - active
                  - inactive
                  - deploying
                  - deactivating
                  - error
                  - unknown
                type: string
            type: object
          type: array
        description:
          nullable: true
          type: string
        developer:
          nullable: true
          properties:
            logo:
              nullable: true
              type: string
            name:
              type: string
          type: object
        display_name:
          type: string
        endpoint:
          description: API endpoint to call this model
          enum:
            - /chat/completions
            - /images/generate
            - /videos/generate
          type: string
        fine_tuning:
          description: Fine-tuning info, or null if model is not fine-tuneable
          nullable: true
          properties:
            actions:
              description: Supported fine-tune action types
              items:
                type: string
              type: array
            cost_per_second:
              nullable: true
              type: number
          type: object
        id:
          description: Model identifier used in API calls
          type: string
        image_url:
          nullable: true
          type: string
        model_type:
          enum:
            - base
            - custom
          type: string
        object:
          enum:
            - model
          type: string
        owned_by:
          description: '"oxen" for base models, owner namespace for custom models'
          type: string
        pricing:
          properties:
            cost_per_image:
              nullable: true
              type: number
            cost_per_second:
              nullable: true
              type: number
            cost_per_second_high_res:
              nullable: true
              type: number
            cost_per_second_with_audio:
              nullable: true
              type: number
            input_cost_per_token:
              nullable: true
              type: number
            method:
              enum:
                - token
                - time
                - per_image
                - per_video_output_second
              type: string
            output_cost_per_token:
              nullable: true
              type: number
          type: object
        released_at:
          nullable: true
          type: string
        request_schema:
          description: JSON Schema describing model-specific parameters
          nullable: true
          type: object
        showcase:
          description: >-
            Optional marketing content rendered on the public model showcase
            page
          nullable: true
          properties:
            gallery:
              items:
                properties:
                  alt:
                    type: string
                  category:
                    nullable: true
                    type: string
                  details:
                    nullable: true
                    type: string
                  prompt:
                    nullable: true
                    type: string
                  src:
                    description: Absolute URL
                    type: string
                  title:
                    nullable: true
                    type: string
                required:
                  - src
                  - alt
                type: object
              type: array
            hero_image:
              description: Absolute URL
              nullable: true
              type: string
            tagline:
              nullable: true
              type: string
          type: object
        source_model:
          description: Base model this was fine-tuned from
          nullable: true
          type: string
        summary:
          nullable: true
          type: string
      required:
        - id
        - object
        - created
        - owned_by
      title: Model
      type: object

````