{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-azure-openai/json-schema/microsoft-azure-openai-fine-tuning-job-creation-schema.json",
  "title": "FineTuningJobCreation",
  "description": "Defines the values of a fine tune job.",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-azure-openai-fine-tuning-api-openapi.yml#/components/schemas/FineTuningJobCreation",
  "required": [
    "model",
    "training_file"
  ],
  "type": "object",
  "properties": {
    "model": {
      "description": "The identifier (model-id) of the base model used for this fine-tune.",
      "minLength": 1,
      "type": "string"
    },
    "training_file": {
      "description": "The file identity (file-id) that is used for training this fine tuned model.",
      "minLength": 1,
      "type": "string"
    },
    "validation_file": {
      "description": "The file identity (file-id) that is used to evaluate the fine tuned model during training.",
      "type": "string"
    },
    "hyperparameters": {
      "$ref": "#/$defs/FineTuningHyperParameters"
    },
    "suffix": {
      "description": "The suffix used to identify the fine-tuned model. The suffix can contain up to 40 characters (a-z, A-Z, 0-9,- and _) that will be added to your fine-tuned model name.",
      "type": "string"
    },
    "seed": {
      "format": "int32",
      "description": "The seed used for the finetuning job. Passing in the same seed and job parameters should produce the same results, but may differ in rare cases. If a seed is not specified, one will be generated for you.",
      "type": "integer"
    }
  },
  "$defs": {
    "FineTuningHyperParameters": {
      "title": "FineTuningHyperParameters",
      "description": "The hyper parameter settings used in a fine tune job.",
      "type": "object",
      "properties": {
        "n_epochs": {
          "format": "int32",
          "description": "The number of epochs to train the model for. An epoch refers to one full cycle through the training dataset.",
          "type": "integer"
        },
        "batch_size": {
          "format": "int32",
          "description": "The batch size to use for training. The batch size is the number of training examples used to train a single forward and backward pass.\nIn general, we've found that larger batch sizes tend to work better for larger datasets.\nThe default value as well as the maximum value for this property are specific to a base model.",
          "type": "integer"
        },
        "learning_rate_multiplier": {
          "format": "double",
          "description": "The learning rate multiplier to use for training. The fine-tuning learning rate is the original learning rate used for pre-training multiplied by this value.\nLarger learning rates tend to perform better with larger batch sizes.\nWe recommend experimenting with values in the range 0.02 to 0.2 to see what produces the best results.",
          "type": "number"
        }
      }
    }
  }
}