EmpirioLabs AI Models API

openapi: 3.2.0
info:
  title: Reference Models API
  version: 1.0.0
tags:
- name: Models
paths:
  /v1/models:
    get:
      operationId: models_listModels
      summary: List models
      description: 'Returns the full model catalog. Each model includes pricing,

        context window, capability flags, and the full parameter

        schema. This endpoint is public and returns only

        tenant-agnostic model metadata.


        Every model carries a boolean `native_inference` field, true when

        EmpirioLabs serves the model on its own managed GPU infrastructure

        (the Native Inference designation in the catalog). Filter it

        together with `category` to select native models, for example

        native text models. Native models also name the exact Hugging Face

        repository being served in `hugging_face_id`.


        `pricing` uses the OpenRouter convention of per-token USD strings.

        A model that is not priced per token, such as a video model priced

        per second or a speech model priced per 1,000 characters, reports

        `"-1"` in `prompt`, `completion` and `input_cache_read`. Its rates

        are listed in `unit_pricing`, one entry per unit and tier, and the

        full display breakdown is in `pricing_rows`.'
      tags:
      - Models
      responses:
        '200':
          description: The complete model catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Models_listModels_Response_200'
  /v1/models/{model_id}:
    get:
      operationId: models_retrieveModel
      summary: Retrieve a model
      description: 'Returns the full per-model schema: pricing rows, parameter

        table (name, type, default, min/max, allowed values, descriptions,

        conditional flags), capability flags, and modalities. Same

        data the docs site and the playground render from. This endpoint

        is public and returns only tenant-agnostic model metadata.'
      tags:
      - Models
      parameters:
      - name: model_id
        in: path
        description: Canonical model slug.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Full model schema with parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelDetail'
        '404':
          description: Resource not found (model id, ...
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Models_listModels_Response_200:
      type: object
      properties:
        models:
          type: array
          items:
            $ref: '#/components/schemas/ModelDetail'
    ModelDetail:
      type: object
      properties:
        model_id:
          type: string
        name:
          type: string
        description:
          type: string
        pricing:
          type: object
        native_inference:
          type: boolean
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            param:
              type: string
            code:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT