updating how-to and whats new

Author: aahill

articles/cognitive-services/language-service/sentiment-opinion-mining/how-to/call-api.md

@@ -52,17 +52,30 @@ If you're using the REST API, to get Opinion Mining in your results, you must in
 
 By default, sentiment analysis will use the latest available AI model on your text. You can also configure your API requests to use a specific model version. The model you specify will be used to perform sentiment analysis operations.
 
-| Supported Versions | latest version |
-|--|--|
-| `2019-10-01`, `2020-04-01`, `2021-10-01` | `2021-10-01`   |
-
-> [!IMPORTANT]
-> To use the latest model version in your API calls, you must specify `2021-10-01` using the model version parameter. See the reference documentation for more information.
->    * [REST API](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-1/operations/Sentiment)
->    * [.NET](https://docs.microsoft.com/dotnet/api/azure.ai.textanalytics.analyzesentimentaction?view=azure-dotnet#properties)
->    * [Python](https://docs.microsoft.com/python/api/azure-ai-textanalytics/azure.ai.textanalytics.textanalyticsclient?view=azure-python#analyze-sentiment-documents----kwargs-)
->    * [Java](https://docs.microsoft.com/java/api/com.azure.ai.textanalytics.models.analyzesentimentoptions.setmodelversion?view=azure-java-stable#com_azure_ai_textanalytics_models_AnalyzeSentimentOptions_setModelVersion_java_lang_String_)
->    * [JavaScript](https://docs.microsoft.com/javascript/api/@azure/ai-text-analytics/analyzesentimentoptions?view=azure-node-latest)
+| Supported Versions | latest Generally Available version | latest preview version |
+|--|--|--|
+| `2019-10-01`, `2020-04-01`, `2021-10-01-preview` | `2020-04-01`   | `2021-10-01-preview`   |
+
+### Using a preview model version
+
+To use the a preview model version in your API calls, you must specify the model version using the model version parameter. For example, if you were sending a request using Python:
+
+```python
+result = text_analytics_client.analyze_sentiment(documents, show_opinion_mining=True, model_version="2021-10-01-preview")
+```
+
+or if you were using the REST API:
+
+```rest
+https://your-resource-name.cognitiveservices.azure.com/text/analytics/v3.1/sentiment?opinionMining=true&model-version=2021-10-01-preview
+```
+
+See the reference documentation for more information.
+* [REST API](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-1/operations/Sentiment)
+* [.NET](https://docs.microsoft.com/dotnet/api/azure.ai.textanalytics.analyzesentimentaction?view=azure-dotnet#properties)
+* [Python](https://docs.microsoft.com/python/api/azure-ai-textanalytics/azure.ai.textanalytics.textanalyticsclient?view=azure-python#analyze-sentiment-documents----kwargs-)
+* [Java](https://docs.microsoft.com/java/api/com.azure.ai.textanalytics.models.analyzesentimentoptions.setmodelversion?view=azure-java-stable#com_azure_ai_textanalytics_models_AnalyzeSentimentOptions_setModelVersion_java_lang_String_)
+* [JavaScript](https://docs.microsoft.com/javascript/api/@azure/ai-text-analytics/analyzesentimentoptions?view=azure-node-latest)
 
 ### Input languages
 

articles/cognitive-services/language-service/whats-new.md

@@ -30,7 +30,7 @@ Azure Cognitive Service for Language is updated on an ongoing basis. To stay up-
     * [Custom Text Classification preview](custom-classification/overview.md)
     * [Conversational Language Understanding preview](conversational-language-understanding/overview.md)
 
-* Model version `2021-10-01` for [Sentiment Analysis and Opinion mining](sentiment-opinion-mining/overview.md), which provides:
+* Preview model version `2021-10-01-preview` for [Sentiment Analysis and Opinion mining](sentiment-opinion-mining/overview.md), which provides:
     * Improved prediction quality.
     * [Additional language support](sentiment-opinion-mining/language-support.md?tabs=sentiment-analysis) for the opinion mining feature.
     * For more information, see the [project z-code site](https://www.microsoft.com/research/project/project-zcode/).