{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-classify-request-schema.json",
  "title": "ClassifyRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/huggingbay-xyz-classify-api-openapi.yml#/components/schemas/ClassifyRequest",
  "properties": {
    "model": {
      "type": "string",
      "title": "Model"
    },
    "input": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "title": "Input"
    },
    "omit_raw_result": {
      "type": "boolean",
      "title": "Omit Raw Result",
      "description": "Compact decision-first face (decision, answer labels, next_call, weight, receipt) without the raw label rows. Defaults false here for REST compatibility; the raw envelope always carries the same decision face.",
      "default": false
    },
    "candidate_labels": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Candidate Labels"
    },
    "multi_label": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Multi Label"
    },
    "top_k": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Top K"
    },
    "hypothesis_template": {
      "type": "string",
      "title": "Hypothesis Template",
      "default": "This example is {}."
    },
    "task_hint": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Task Hint"
    },
    "namespace": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 256
        },
        {
          "type": "null"
        }
      ],
      "title": "Namespace",
      "description": "Private learned-routing namespace used by model='auto'."
    },
    "routing_mode": {
      "type": "string",
      "enum": [
        "default",
        "strict"
      ],
      "title": "Routing Mode",
      "description": "default permits the bounded same-kind fallback; strict requires a live private proof.",
      "default": "default"
    },
    "prefer_warm": {
      "type": "boolean",
      "title": "Prefer Warm",
      "description": "Prefer a resident compatible specialist when model='auto'.",
      "default": true
    }
  },
  "type": "object",
  "required": [
    "model",
    "input"
  ]
}