Proxlai

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 4,
      "minItems": 2,
      "description": "2 to 4 offering ids from the same market"
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "market"
  ],
  "properties": {
    "market": {
      "type": "string",
      "description": "Market id from list_markets, e.g. 'llm' or 'video-generation'"
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Offering id from search_offerings, e.g. 'openai/gpt-6-luna'"
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "market"
  ],
  "properties": {
    "sort": {
      "enum": [
        "score",
        "price",
        "quality"
      ],
      "type": "string",
      "description": "score (default): best match for the weights; price: cheapest first; quality: best first"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "How many results, default 10"
    },
    "market": {
      "type": "string",
      "description": "Market id from list_markets"
    },
    "filters": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "attr",
          "op",
          "value"
        ],
        "properties": {
          "op": {
            "enum": [
              "eq",
              "lte",
              "gte",
              "in",
              "has"
            ],
            "type": "string",
            "description": "eq: equals; lte/gte: numeric bounds; in: value is one of a list; has: boolean is true or tag list contains value"
          },
          "attr": {
            "type": "string",
            "description": "Attribute key from the category's attribute list"
          },
          "value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "string"
              },
              {
                "type": "boolean"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          }
        }
      },
      "maxItems": 20,
      "description": "Requirements. Attribute keys come from describe_market. Do not add filters the user did not ask for."
    },
    "weights": {
      "type": "object",
      "required": [
        "cost",
        "quality",
        "speed"
      ],
      "properties": {
        "cost": {
          "type": "number",
          "maximum": 1,
          "minimum": 0,
          "description": "How much a lower price matters (0..1)"
        },
        "speed": {
          "type": "number",
          "maximum": 1,
          "minimum": 0,
          "description": "How much speed / low latency matters (0..1)"
        },
        "quality": {
          "type": "number",
          "maximum": 1,
          "minimum": 0,
          "description": "How much output quality matters (0..1)"
        }
      },
      "description": "What matters, each 0..1. Default: cost 0.5, quality 0.4, speed 0.1"
    },
    "maxPrice": {
      "type": "number",
      "minimum": 0,
      "description": "Upper bound in the market's pricing unit (USD)"
    },
    "include_unverified": {
      "type": "boolean",
      "description": "Also rank offerings whose price is an unverified sample, never checked against the provider (default false: left out)"
    }
  }
}