CreateTranscriptionJobDetails

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/oracle/main/json-schema/oracle-create-transcription-job-details-schema.json",
  "title": "CreateTranscriptionJobDetails",
  "description": "The information about new Transcription Job.",
  "x-generated": "2026-10-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/oracle-aiservicespeech-api-openapi.yml#/components/schemas/CreateTranscriptionJobDetails",
  "properties": {
    "additionalTranscriptionFormats": {
      "description": "Transcription Format. By default, the JSON format is used.",
      "items": {
        "enum": [
          "SRT"
        ],
        "type": "string"
      },
      "minItems": 1,
      "type": "array"
    },
    "compartmentId": {
      "description": "The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the compartment where you want to create the job.",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "definedTags": {
      "additionalProperties": {
        "additionalProperties": {
          "description": "The value of the tag. Only string, integer and boolean types are supported.\n",
          "type": "object"
        },
        "description": "Key-value pair representing predefined tags' keys and values scoped to a namespace.\nExample: `{\"bar-key\": \"value\"}`.\n",
        "type": "object"
      },
      "description": "Defined tags for this resource. Each key is predefined and scoped to a namespace.\nExample: `{\"foo-namespace-1\": {\"bar-key-1\": \"value-1\", \"bar-key-2\": \"value-2\"}, \"foo-namespace-2\": {\"bar-key-1\": \"value-1\", \"bar-key-2\": \"value-2\"}}`.\n",
      "type": "object"
    },
    "description": {
      "description": "A short description of the job.",
      "maxLength": 255,
      "type": "string"
    },
    "displayName": {
      "description": "A user-friendly display name for the job.",
      "maxLength": 255,
      "type": "string"
    },
    "freeformTags": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only.\nExample: `{\"bar-key\": \"value\"}`.\n",
      "type": "object"
    },
    "inputLocation": {
      "$ref": "#/$defs/InputLocation"
    },
    "modelDetails": {
      "$ref": "#/$defs/TranscriptionModelDetails"
    },
    "normalization": {
      "$ref": "#/$defs/TranscriptionNormalization"
    },
    "outputLocation": {
      "$ref": "#/$defs/OutputLocation"
    }
  },
  "required": [
    "compartmentId",
    "inputLocation",
    "outputLocation"
  ],
  "type": "object",
  "$defs": {
    "Diarization": {
      "description": "Speaker diarization is a combination of speaker segmentation and speaker clustering. Provide diarization details to enable this feature.",
      "properties": {
        "isDiarizationEnabled": {
          "default": false,
          "description": "Set true to enable Speaker diarization and tag transcription with speaker tags. By default this is disabled.",
          "type": "boolean"
        },
        "numberOfSpeakers": {
          "description": "Number of speakers in the audio provided. By default service will auto detect all speakers in audio file",
          "maximum": 16,
          "minimum": 2,
          "type": "integer",
          "x-default-description": "null"
        }
      },
      "type": "object"
    },
    "InputLocation": {
      "description": "The location of the input(s).",
      "properties": {
        "locationType": {
          "description": "The type of input location.\n",
          "enum": [
            "OBJECT_LIST_INLINE_INPUT_LOCATION",
            "OBJECT_LIST_FILE_INPUT_LOCATION"
          ],
          "type": "string"
        }
      },
      "required": [
        "locationType"
      ],
      "type": "object"
    },
    "OutputLocation": {
      "description": "OCI Object Storage Location.",
      "properties": {
        "bucketName": {
          "description": "Object Storage bucket name.",
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        "namespaceName": {
          "description": "Object Storage namespace.",
          "maxLength": 1024,
          "minLength": 1,
          "type": "string"
        },
        "prefix": {
          "description": "Object Storage folder name.",
          "maxLength": 1024,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "namespaceName",
        "bucketName",
        "prefix"
      ],
      "type": "object"
    },
    "TranscriptionFilter": {
      "description": "Transcription Filter.",
      "properties": {
        "type": {
          "description": "The type of filters.\n",
          "enum": [
            "PROFANITY"
          ],
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "TranscriptionModelDetails": {
      "description": "Model details.",
      "properties": {
        "domain": {
          "default": "GENERIC",
          "description": "Domain for input files.",
          "enum": [
            "GENERIC"
          ],
          "type": "string"
        },
        "languageCode": {
          "default": "en-US",
          "description": "Oracle supported language codes are (Oracle models are locale specific).\n- en-US: English - United States (default)\n- es-ES: Spanish - Spain\n- pt-BR: Portuguese - Brazil\n- en-GB: English - Great Britain\n- en-AU: English - Australia\n- en-IN: English - India\n- hi-IN: Hindi - India\n- fr-FR: French - France\n- de-DE: German - Germany\n- it-IT: Italian - Italy\n\nWhisper supported language codes are (Whisper models are locale agnostic).\n- auto: Auto-detect language\n- af: Afrikaans\n- ar: Arabic\n- az: Azerbaijani\n- be: Belarusian\n- bg: Bulgarian\n- bs: Bosnian\n- ca: Catalan\n- cs: Czech\n- cy: Welsh\n- da: Danish\n- de: German\n- el: Greek\n- en: English (default)\n- es: Spanish\n- et: Estonian\n- fa: Persian\n- fi: Finnish\n- fr: French\n- gl: Galician\n- he: Hebrew\n- hi: Hindi\n- hr: Croatian\n- hu: Hungarian\n- hy: Armenian\n- id: Indonesian\n- is: Icelandic\n- it: Italian\n- ja: Japanese\n- kk: Kazakh\n- kn: Kannada\n- ko: Korean\n- lt: Lithuanian\n- lv: Latvian\n- mi: Maori\n- mk: Macedonian\n- mr: Marathi\n- ms: Malay\n- ne: Nepali\n- nl: Dutch\n- no: Norwegian\n- pl: Polish\n- pt: Portuguese\n- ro: Romanian\n- ru: Russian\n- sk: Slovak\n- sl: Slovenian\n- sr: Serbian\n- sv: Swedish\n- sw: Swahili\n- ta: Tamil\n- th: Thai\n- tl: Tagalog\n- tr: Turkish\n- uk: Ukrainian\n- ur: Urdu\n- vi: Vietnamese\n- zh: Chinese\n",
          "enum": [
            "en-US",
            "es-ES",
            "pt-BR",
            "en-GB",
            "en-AU",
            "en-IN",
            "hi-IN",
            "fr-FR",
            "de-DE",
            "it-IT",
            "auto",
            "af",
            "ar",
            "az",
            "be",
            "bg",
            "bs",
            "ca",
            "cs",
            "cy",
            "da",
            "de",
            "el",
            "en",
            "es",
            "et",
            "fa",
            "fi",
            "fr",
            "gl",
            "he",
            "hi",
            "hr",
            "hu",
            "hy",
            "id",
            "is",
            "it",
            "ja",
            "kk",
            "kn",
            "ko",
            "lt",
            "lv",
            "mi",
            "mk",
            "mr",
            "ms",
            "ne",
            "nl",
            "no",
            "pl",
            "pt",
            "ro",
            "ru",
            "sk",
            "sl",
            "sr",
            "sv",
            "sw",
            "ta",
            "th",
            "tl",
            "tr",
            "uk",
            "ur",
            "vi",
            "zh"
          ],
          "type": "string"
        },
        "modelType": {
          "default": "ORACLE",
          "description": "Select a model to use for generating transcriptions. Currently supported models are:\n- ORACLE\n- WHISPER_MEDIUM\n- WHISPER_LARGE_V2 (upon service request)\n- WHISPER_LARGE_V3T\n",
          "type": "string"
        },
        "transcriptionSettings": {
          "$ref": "#/$defs/TranscriptionSettings"
        }
      }
    },
    "TranscriptionNormalization": {
      "description": "Information to Normalize generated transcript.",
      "properties": {
        "filters": {
          "description": "List of filters.",
          "items": {
            "$ref": "#/$defs/TranscriptionFilter"
          },
          "type": "array"
        },
        "isPunctuationEnabled": {
          "default": true,
          "description": "Whether to add punctuation in the generated transcription. Enabled by default.",
          "type": "boolean"
        }
      }
    },
    "TranscriptionSettings": {
      "default": {
        "diarization": {
          "isDiarizationEnabled": false
        }
      },
      "description": "Processes to perform on the generated transcription.",
      "properties": {
        "additionalSettings": {
          "additionalProperties": {
            "type": "string"
          },
          "description": "Simple key-value pair for setting model specific properties. For more details, refer the documentation.",
          "type": "object"
        },
        "diarization": {
          "$ref": "#/$defs/Diarization"
        }
      },
      "type": "object"
    }
  }
}