@@ -57,7 +57,10 @@ public LanguageTranslatorService(string versionDate, IAuthenticator authenticato
5757 /// <summary>
5858 /// Translate.
5959 ///
60- /// Translates the input text from the source language to the target language.
60+ /// The translate request containing the text, and either using a model ID or the source/target fields to select
61+ /// a language pair for translation. If present, the model ID takes precedence over source/target fields. If no
62+ /// explicit model is selected via model ID and the source language is omitted, the service will try to
63+ /// automatically detect the source language.
6164 /// </summary>
6265 /// <param name="request">The translate request containing the text, and either a model ID or source and target
6366 /// language pair.</param>
@@ -544,15 +547,18 @@ public DetailedResponse<DocumentList> ListDocuments()
544547 /// <param name="file">The contents of the source file to translate.
545548 ///
546549 /// [Supported file
547- /// types](https://cloud.ibm.com/docs/services/ language-translator?topic=language-translator-document-translator-tutorial#supported-file-formats)
550+ /// types](https://cloud.ibm.com/docs/language-translator?topic=language-translator-document-translator-tutorial#supported-file-formats)
548551 ///
549552 /// Maximum file size: **20 MB**.</param>
550553 /// <param name="filename">The filename for file.</param>
551554 /// <param name="fileContentType">The content type of file. (optional)</param>
552- /// <param name="modelId">The model to use for translation. `model_id` or both `source` and `target` are
553- /// required. (optional)</param>
555+ /// <param name="modelId">The model to use for translation. For example, `en-de` selects the IBM provided base
556+ /// model for English to German translation. A model ID overrides the source and target parameters and is
557+ /// required if you use a custom model. If no model ID is specified, you must specify a target language.
558+ /// (optional)</param>
554559 /// <param name="source">Language code that specifies the language of the source document. (optional)</param>
555- /// <param name="target">Language code that specifies the target language for translation. (optional)</param>
560+ /// <param name="target">Language code that specifies the target language for translation. Required if model ID
561+ /// is not specified. (optional)</param>
556562 /// <param name="documentId">To use a previously submitted document as the source for a new translation, enter
557563 /// the `document_id` of the document. (optional)</param>
558564 /// <returns><see cref="DocumentStatus" />DocumentStatus</returns>
0 commit comments