Path parameters

  • model_idstring Required

    The unique identifier of the trained model.

Query parameters

  • If set to true and a compressed_definition is provided, the request defers definition decompression and skips relevant validations.

  • Whether to wait for all child operations (e.g. model download) to complete.

application/json

BodyRequired

  • The compressed (GZipped and Base64 encoded) inference definition of the model. If compressed_definition is specified, then definition cannot be specified.

  • Hide definition attributes Show definition attributes object
  • A human-readable description of the inference trained model.

  • Inference configuration provided when storing the model config

    Hide inference_config attributes Show inference_config attributes object
    • Hide regression attributes Show regression attributes object
    • Hide classification attributes Show classification attributes object
      • Specifies the number of top class predictions to return. Defaults to 0.

      • Specifies the maximum number of feature importance values per document.

      • Specifies the type of the predicted field to write. Acceptable values are: string, number, boolean. When boolean is provided 1.0 is transformed to true and 0.0 to false.

      • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

      • Specifies the field to which the top classes are written. Defaults to top_classes.

    • Hide text_classification attributes Show text_classification attributes object
      • Specifies the number of top class predictions to return. Defaults to 0.

      • Tokenization options stored in inference configuration

        Hide tokenization attributes Show tokenization attributes object
        • bertobject
          Hide bert attributes Show bert attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • bert_jaobject
          Hide bert_ja attributes Show bert_ja attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • mpnetobject
          Hide mpnet attributes Show mpnet attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • robertaobject
          Hide roberta attributes Show roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

          • Should the tokenizer prefix input with a space character

        • Hide xlm_roberta attributes Show xlm_roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

      • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

      • Classification labels to apply other than the stored labels. Must have the same deminsions as the default configured labels

      • Hide vocabulary attribute Show vocabulary attribute object
    • Hide zero_shot_classification attributes Show zero_shot_classification attributes object
      • Tokenization options stored in inference configuration

        Hide tokenization attributes Show tokenization attributes object
        • bertobject
          Hide bert attributes Show bert attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • bert_jaobject
          Hide bert_ja attributes Show bert_ja attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • mpnetobject
          Hide mpnet attributes Show mpnet attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • robertaobject
          Hide roberta attributes Show roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

          • Should the tokenizer prefix input with a space character

        • Hide xlm_roberta attributes Show xlm_roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

      • Hypothesis template used when tokenizing labels for prediction

      • classification_labelsarray[string] Required

        The zero shot classification labels indicating entailment, neutral, and contradiction Must contain exactly and only entailment, neutral, and contradiction

      • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

      • Indicates if more than one true label exists.

      • labelsarray[string]

        The labels to predict.

    • fill_maskobject
      Hide fill_mask attributes Show fill_mask attributes object
      • The string/token which will be removed from incoming documents and replaced with the inference prediction(s). In a response, this field contains the mask token for the specified model/tokenizer. Each model and tokenizer has a predefined mask token which cannot be changed. Thus, it is recommended not to set this value in requests. However, if this field is present in a request, its value must match the predefined value for that model/tokenizer, otherwise the request will fail.

      • Specifies the number of top class predictions to return. Defaults to 0.

      • Tokenization options stored in inference configuration

        Hide tokenization attributes Show tokenization attributes object
        • bertobject
          Hide bert attributes Show bert attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • bert_jaobject
          Hide bert_ja attributes Show bert_ja attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • mpnetobject
          Hide mpnet attributes Show mpnet attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • robertaobject
          Hide roberta attributes Show roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

          • Should the tokenizer prefix input with a space character

        • Hide xlm_roberta attributes Show xlm_roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

      • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

      • vocabularyobject Required
        Hide vocabulary attribute Show vocabulary attribute object
    • Hide learning_to_rank attributes Show learning_to_rank attributes object
    • nerobject
      Hide ner attributes Show ner attributes object
      • Tokenization options stored in inference configuration

        Hide tokenization attributes Show tokenization attributes object
        • bertobject
          Hide bert attributes Show bert attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • bert_jaobject
          Hide bert_ja attributes Show bert_ja attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • mpnetobject
          Hide mpnet attributes Show mpnet attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • robertaobject
          Hide roberta attributes Show roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

          • Should the tokenizer prefix input with a space character

        • Hide xlm_roberta attributes Show xlm_roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

      • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

      • The token classification labels. Must be IOB formatted tags

      • Hide vocabulary attribute Show vocabulary attribute object
    • Hide pass_through attributes Show pass_through attributes object
      • Tokenization options stored in inference configuration

        Hide tokenization attributes Show tokenization attributes object
        • bertobject
          Hide bert attributes Show bert attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • bert_jaobject
          Hide bert_ja attributes Show bert_ja attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • mpnetobject
          Hide mpnet attributes Show mpnet attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • robertaobject
          Hide roberta attributes Show roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

          • Should the tokenizer prefix input with a space character

        • Hide xlm_roberta attributes Show xlm_roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

      • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

      • Hide vocabulary attribute Show vocabulary attribute object
    • Hide text_embedding attributes Show text_embedding attributes object
      • The number of dimensions in the embedding output

      • Tokenization options stored in inference configuration

        Hide tokenization attributes Show tokenization attributes object
        • bertobject
          Hide bert attributes Show bert attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • bert_jaobject
          Hide bert_ja attributes Show bert_ja attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • mpnetobject
          Hide mpnet attributes Show mpnet attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • robertaobject
          Hide roberta attributes Show roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

          • Should the tokenizer prefix input with a space character

        • Hide xlm_roberta attributes Show xlm_roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

      • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

      • vocabularyobject Required
        Hide vocabulary attribute Show vocabulary attribute object
    • Hide text_expansion attributes Show text_expansion attributes object
      • Tokenization options stored in inference configuration

        Hide tokenization attributes Show tokenization attributes object
        • bertobject
          Hide bert attributes Show bert attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • bert_jaobject
          Hide bert_ja attributes Show bert_ja attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • mpnetobject
          Hide mpnet attributes Show mpnet attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • robertaobject
          Hide roberta attributes Show roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

          • Should the tokenizer prefix input with a space character

        • Hide xlm_roberta attributes Show xlm_roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

      • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

      • vocabularyobject Required
        Hide vocabulary attribute Show vocabulary attribute object
    • Hide question_answering attributes Show question_answering attributes object
      • Specifies the number of top class predictions to return. Defaults to 0.

      • Tokenization options stored in inference configuration

        Hide tokenization attributes Show tokenization attributes object
        • bertobject
          Hide bert attributes Show bert attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • bert_jaobject
          Hide bert_ja attributes Show bert_ja attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • mpnetobject
          Hide mpnet attributes Show mpnet attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

        • robertaobject
          Hide roberta attributes Show roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

          • Should the tokenizer prefix input with a space character

        • Hide xlm_roberta attributes Show xlm_roberta attributes object
          • Should the tokenizer lower case the text

          • Maximum input sequence length for the model

          • spannumber

            Tokenization spanning options. Special value of -1 indicates no spanning takes place

          • truncatestring

            Values are first, second, or none.

          • Is tokenization completed with special tokens

      • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

      • The maximum answer length to consider

  • inputobject
    Hide input attribute Show input attribute object
  • metadataobject

    An object map that contains metadata about the model.

  • Values are tree_ensemble, lang_ident, or pytorch.

  • The estimated memory usage in bytes to keep the trained model in memory. This property is supported only if defer_definition_decompression is true or the model definition is not supplied.

  • The platform architecture (if applicable) of the trained mode. If the model only works on one platform, because it is heavily optimized for a particular processor architecture and OS combination, then this field specifies which. The format of the string must match the platform identifiers used by Elasticsearch, so one of, linux-x86_64, linux-aarch64, darwin-x86_64, darwin-aarch64, or windows-x86_64. For portable models (those that work independent of processor architecture or OS features), leave this field unset.

  • tagsarray[string]

    An array of tags to organize the model.

  • Hide prefix_strings attributes Show prefix_strings attributes object
    • ingeststring

      String prepended to input at ingest

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • model_idstring Required
    • Values are tree_ensemble, lang_ident, or pytorch.

    • tagsarray[string] Required

      A comma delimited string of tags. A trained model can have many tags, or none.

    • versionstring
    • Information on the creator of the trained model.

    • create_timestring | number

      A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.

      One of:

      Time unit for milliseconds

    • Any field map described in the inference configuration takes precedence.

      Hide default_field_map attribute Show default_field_map attribute object
      • *string Additional properties
    • The free-text description of the trained model.

    • The estimated heap usage in bytes to keep the trained model in memory.

    • The estimated number of operations to use the trained model.

    • True if the full model definition is present.

    • Inference configuration provided when storing the model config

      Hide inference_config attributes Show inference_config attributes object
      • Hide regression attributes Show regression attributes object
      • Hide classification attributes Show classification attributes object
        • Specifies the number of top class predictions to return. Defaults to 0.

        • Specifies the maximum number of feature importance values per document.

        • Specifies the type of the predicted field to write. Acceptable values are: string, number, boolean. When boolean is provided 1.0 is transformed to true and 0.0 to false.

        • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

        • Specifies the field to which the top classes are written. Defaults to top_classes.

      • Hide text_classification attributes Show text_classification attributes object
        • Specifies the number of top class predictions to return. Defaults to 0.

        • Tokenization options stored in inference configuration

          Hide tokenization attributes Show tokenization attributes object
          • bertobject
            Hide bert attributes Show bert attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • bert_jaobject
            Hide bert_ja attributes Show bert_ja attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • mpnetobject
            Hide mpnet attributes Show mpnet attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • robertaobject
            Hide roberta attributes Show roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

            • Should the tokenizer prefix input with a space character

          • Hide xlm_roberta attributes Show xlm_roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

        • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

        • Classification labels to apply other than the stored labels. Must have the same deminsions as the default configured labels

        • Hide vocabulary attribute Show vocabulary attribute object
      • Hide zero_shot_classification attributes Show zero_shot_classification attributes object
        • Tokenization options stored in inference configuration

          Hide tokenization attributes Show tokenization attributes object
          • bertobject
            Hide bert attributes Show bert attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • bert_jaobject
            Hide bert_ja attributes Show bert_ja attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • mpnetobject
            Hide mpnet attributes Show mpnet attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • robertaobject
            Hide roberta attributes Show roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

            • Should the tokenizer prefix input with a space character

          • Hide xlm_roberta attributes Show xlm_roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

        • Hypothesis template used when tokenizing labels for prediction

        • classification_labelsarray[string] Required

          The zero shot classification labels indicating entailment, neutral, and contradiction Must contain exactly and only entailment, neutral, and contradiction

        • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

        • Indicates if more than one true label exists.

        • labelsarray[string]

          The labels to predict.

      • fill_maskobject
        Hide fill_mask attributes Show fill_mask attributes object
        • The string/token which will be removed from incoming documents and replaced with the inference prediction(s). In a response, this field contains the mask token for the specified model/tokenizer. Each model and tokenizer has a predefined mask token which cannot be changed. Thus, it is recommended not to set this value in requests. However, if this field is present in a request, its value must match the predefined value for that model/tokenizer, otherwise the request will fail.

        • Specifies the number of top class predictions to return. Defaults to 0.

        • Tokenization options stored in inference configuration

          Hide tokenization attributes Show tokenization attributes object
          • bertobject
            Hide bert attributes Show bert attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • bert_jaobject
            Hide bert_ja attributes Show bert_ja attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • mpnetobject
            Hide mpnet attributes Show mpnet attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • robertaobject
            Hide roberta attributes Show roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

            • Should the tokenizer prefix input with a space character

          • Hide xlm_roberta attributes Show xlm_roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

        • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

        • vocabularyobject Required
          Hide vocabulary attribute Show vocabulary attribute object
      • Hide learning_to_rank attributes Show learning_to_rank attributes object
      • nerobject
        Hide ner attributes Show ner attributes object
        • Tokenization options stored in inference configuration

          Hide tokenization attributes Show tokenization attributes object
          • bertobject
            Hide bert attributes Show bert attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • bert_jaobject
            Hide bert_ja attributes Show bert_ja attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • mpnetobject
            Hide mpnet attributes Show mpnet attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • robertaobject
            Hide roberta attributes Show roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

            • Should the tokenizer prefix input with a space character

          • Hide xlm_roberta attributes Show xlm_roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

        • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

        • The token classification labels. Must be IOB formatted tags

        • Hide vocabulary attribute Show vocabulary attribute object
      • Hide pass_through attributes Show pass_through attributes object
        • Tokenization options stored in inference configuration

          Hide tokenization attributes Show tokenization attributes object
          • bertobject
            Hide bert attributes Show bert attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • bert_jaobject
            Hide bert_ja attributes Show bert_ja attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • mpnetobject
            Hide mpnet attributes Show mpnet attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • robertaobject
            Hide roberta attributes Show roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

            • Should the tokenizer prefix input with a space character

          • Hide xlm_roberta attributes Show xlm_roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

        • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

        • Hide vocabulary attribute Show vocabulary attribute object
      • Hide text_embedding attributes Show text_embedding attributes object
        • The number of dimensions in the embedding output

        • Tokenization options stored in inference configuration

          Hide tokenization attributes Show tokenization attributes object
          • bertobject
            Hide bert attributes Show bert attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • bert_jaobject
            Hide bert_ja attributes Show bert_ja attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • mpnetobject
            Hide mpnet attributes Show mpnet attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • robertaobject
            Hide roberta attributes Show roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

            • Should the tokenizer prefix input with a space character

          • Hide xlm_roberta attributes Show xlm_roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

        • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

        • vocabularyobject Required
          Hide vocabulary attribute Show vocabulary attribute object
      • Hide text_expansion attributes Show text_expansion attributes object
        • Tokenization options stored in inference configuration

          Hide tokenization attributes Show tokenization attributes object
          • bertobject
            Hide bert attributes Show bert attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • bert_jaobject
            Hide bert_ja attributes Show bert_ja attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • mpnetobject
            Hide mpnet attributes Show mpnet attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • robertaobject
            Hide roberta attributes Show roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

            • Should the tokenizer prefix input with a space character

          • Hide xlm_roberta attributes Show xlm_roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

        • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

        • vocabularyobject Required
          Hide vocabulary attribute Show vocabulary attribute object
      • Hide question_answering attributes Show question_answering attributes object
        • Specifies the number of top class predictions to return. Defaults to 0.

        • Tokenization options stored in inference configuration

          Hide tokenization attributes Show tokenization attributes object
          • bertobject
            Hide bert attributes Show bert attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • bert_jaobject
            Hide bert_ja attributes Show bert_ja attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • mpnetobject
            Hide mpnet attributes Show mpnet attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

          • robertaobject
            Hide roberta attributes Show roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

            • Should the tokenizer prefix input with a space character

          • Hide xlm_roberta attributes Show xlm_roberta attributes object
            • Should the tokenizer lower case the text

            • Maximum input sequence length for the model

            • spannumber

              Tokenization spanning options. Special value of -1 indicates no spanning takes place

            • truncatestring

              Values are first, second, or none.

            • Is tokenization completed with special tokens

        • The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value.

        • The maximum answer length to consider

    • inputobject Required
      Hide input attribute Show input attribute object
      • field_namesarray[string] Required

        An array of input field names for the model.

    • The license level of the trained model.

    • metadataobject
      Hide metadata attributes Show metadata attributes object
    • Hide model_package attributes Show model_package attributes object
    • locationobject
      Hide location attribute Show location attribute object
      • indexobject Required
        Hide index attribute Show index attribute object
    • Hide prefix_strings attributes Show prefix_strings attributes object
      • ingeststring

        String prepended to input at ingest

PUT /_ml/trained_models/{model_id}
curl \
 --request PUT 'http://api.example.com/_ml/trained_models/{model_id}' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"compressed_definition":"string","definition":{"preprocessors":[{"frequency_encoding":{"field":"string","feature_name":"string","frequency_map":{"additionalProperty1":42.0,"additionalProperty2":42.0}},"one_hot_encoding":{"field":"string","hot_map":{"additionalProperty1":"string","additionalProperty2":"string"}},"target_mean_encoding":{"field":"string","feature_name":"string","target_map":{"additionalProperty1":42.0,"additionalProperty2":42.0},"default_value":42.0}}],"trained_model":{"tree":{"classification_labels":["string"],"feature_names":["string"],"target_type":"string","tree_structure":[{"decision_type":"string","default_left":true,"leaf_value":42.0,"left_child":42.0,"node_index":42.0,"right_child":42.0,"split_feature":42.0,"split_gain":42.0,"threshold":42.0}]},"tree_node":{"decision_type":"string","default_left":true,"leaf_value":42.0,"left_child":42.0,"node_index":42.0,"right_child":42.0,"split_feature":42.0,"split_gain":42.0,"threshold":42.0},"ensemble":{"aggregate_output":{"logistic_regression":{"weights":42.0},"weighted_sum":{"weights":42.0},"weighted_mode":{"weights":42.0},"exponent":{"weights":42.0}},"classification_labels":["string"],"feature_names":["string"],"target_type":"string","trained_models":[{}]}}},"description":"string","inference_config":{"regression":{"results_field":"string","num_top_feature_importance_values":42.0},"classification":{"num_top_classes":42.0,"num_top_feature_importance_values":42.0,"prediction_field_type":"string","results_field":"string","top_classes_results_field":"string"},"text_classification":{"num_top_classes":42.0,"tokenization":{"bert":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"bert_ja":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"mpnet":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true,"add_prefix_space":true},"xlm_roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true}},"results_field":"string","classification_labels":["string"],"vocabulary":{"index":"string"}},"zero_shot_classification":{"tokenization":{"bert":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"bert_ja":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"mpnet":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true,"add_prefix_space":true},"xlm_roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true}},"hypothesis_template":"string","classification_labels":["string"],"results_field":"string","multi_label":true,"labels":["string"]},"fill_mask":{"mask_token":"string","num_top_classes":42.0,"tokenization":{"bert":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"bert_ja":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"mpnet":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true,"add_prefix_space":true},"xlm_roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true}},"results_field":"string","vocabulary":{"index":"string"}},"learning_to_rank":{"default_params":{"additionalProperty1":{},"additionalProperty2":{}},"feature_extractors":[{}],"num_top_feature_importance_values":42.0},"ner":{"tokenization":{"bert":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"bert_ja":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"mpnet":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true,"add_prefix_space":true},"xlm_roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true}},"results_field":"string","classification_labels":["string"],"vocabulary":{"index":"string"}},"pass_through":{"tokenization":{"bert":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"bert_ja":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"mpnet":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true,"add_prefix_space":true},"xlm_roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true}},"results_field":"string","vocabulary":{"index":"string"}},"text_embedding":{"embedding_size":42.0,"tokenization":{"bert":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"bert_ja":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"mpnet":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true,"add_prefix_space":true},"xlm_roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true}},"results_field":"string","vocabulary":{"index":"string"}},"text_expansion":{"tokenization":{"bert":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"bert_ja":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"mpnet":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true,"add_prefix_space":true},"xlm_roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true}},"results_field":"string","vocabulary":{"index":"string"}},"question_answering":{"num_top_classes":42.0,"tokenization":{"bert":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"bert_ja":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"mpnet":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true},"roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true,"add_prefix_space":true},"xlm_roberta":{"do_lower_case":true,"max_sequence_length":42.0,"span":42.0,"truncate":"first","with_special_tokens":true}},"results_field":"string","max_answer_length":42.0}},"input":{"field_names":"string"},"metadata":{},"model_type":"tree_ensemble","model_size_bytes":42.0,"platform_architecture":"string","tags":["string"],"prefix_strings":{"ingest":"string","search":"string"}}'