[Microsoft Translator - Azure AI Translator] API Review

[azure-sdk]

New API Review meeting has been requested.

Service Name: Microsoft Translator - Azure AI Translator
Review Created By: Scott Greenwood
Review Date: 02/20/2025 08:00 AM PT
Release Plan: 1252
PR:
Hero Scenarios Link: Not Provided
Core Concepts Doc Link: Not Provided

Description: Adding LLM support to the translator API

Detailed meeting information and documents provided can be accessed here
For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[mikekistler]

Notes from API Review 2/20/25

• Recommend rename modelType to model
• Should model be "deploymentName" ? This is the convention in Azure.
  • Look into this
• Add a default value on the model / deploymentName.
  • And remove the "?" because the property is not "optional" in the resource
• Remove lines 119 - 124
• Need to update your API version
  • And switch to date-based versioning if possible
• Adding a new property to the body (in a new api version) and making it mutually exclusive to an existing property is not breaking.

Pls address the above and then request a re-review and we can probably sign off without an additional meeting.