update

Author: mrbullwinkle

articles/ai-services/openai/includes/api-surface.md

@@ -21,8 +21,8 @@ Each API surface/specification encapsulates a different set of Azure OpenAI capa
 
 | API | Latest preview release | Latest GA release | Specifications | Description |
 |:---|:----|:----|:----|:---|
-| **Control plane** | `2024-04-01-preview` | [`2023-05-01`](/rest/api/aiservices/accountmanagement/deployments/create-or-update?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP) | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices) | Azure OpenAI shares a common control plane with all other Azure AI Services. The control plane API is used for things like [creating Azure OpenAI resources](/rest/api/aiservices/accountmanagement/accounts/create?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP), [model deployment](/rest/api/aiservices/accountmanagement/deployments/create-or-update?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP), and other higher level resource management tasks. The control plane also governs what is possible to do with capabilities like Azure Resource Manager, Bicep, Terraform, and Azure CLI.|
-| **Data plane - authoring** | `2024-05-01-preview` | `2024-06-01` | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/authoring) | The data plane authoring API controls [fine-tuning](/rest/api/azureopenai/fine-tuning?view=rest-azureopenai-2024-05-01-preview), [file-upload](/rest/api/azureopenai/files/upload?view=rest-azureopenai-2024-05-01-preview&tabs=HTTP), [ingestion jobs](/rest/api/azureopenai/ingestion-jobs/create?view=rest-azureopenai-2024-05-01-preview&tabs=HTTP), and certain [model level queries](/rest/api/azureopenai/models/get?view=rest-azureopenai-2024-05-01-preview&tabs=HTTP)
+| **Control plane** | `2024-04-01-preview` | [`2023-05-01`](/rest/api/aiservices/accountmanagement/deployments/create-or-update?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP&preserve-view=true) | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices) | Azure OpenAI shares a common control plane with all other Azure AI Services. The control plane API is used for things like [creating Azure OpenAI resources](/rest/api/aiservices/accountmanagement/accounts/create?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP&preserve-view=true), [model deployment](/rest/api/aiservices/accountmanagement/deployments/create-or-update?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP&preserve-view=true), and other higher level resource management tasks. The control plane also governs what is possible to do with capabilities like Azure Resource Manager, Bicep, Terraform, and Azure CLI.|
+| **Data plane - authoring** | `2024-05-01-preview` | `2024-06-01` | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/authoring) | The data plane authoring API controls [fine-tuning](/rest/api/azureopenai/fine-tuning?view=rest-azureopenai-2024-05-01-preview), [file-upload](/rest/api/azureopenai/files/upload?view=rest-azureopenai-2024-05-01-preview&tabs=HTTP&preserve-view=true), [ingestion jobs](/rest/api/azureopenai/ingestion-jobs/create?view=rest-azureopenai-2024-05-01-preview&tabs=HTTP&preserve-view=true), and certain [model level queries](/rest/api/azureopenai/models/get?view=rest-azureopenai-2024-05-01-preview&tabs=HTTP&preserve-view=true)
 | **Data plane - inference** | `2024-05-01-preview` | `2024-06-01` | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference) | The dataplane inference API provides the inference capabilties/endpoints for features like completions, chat completions, embeddings, speech/whisper, on your data, Dall-e, assistants, etc. | 
 
 ## Authentication

articles/ai-services/openai/includes/api-versions/latest-inference.md

@@ -20,7 +20,7 @@ Creates a completion for the provided prompt, parameters and chosen model.
 
 | Name | In | Required | Type | Description |
 |------|------|----------|------|-----------|
-| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: https://aoairesource.openai.azure.com. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
+| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: `https://aoairesource.openai.azure.com`. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
 | deployment-id | path | Yes | string | Deployment id of the model which was deployed. |
 | api-version | query | Yes | string | API version |
 
@@ -73,20 +73,9 @@ Creates a completion for the provided prompt, parameters and chosen model.
 | Name | Type | Description | Default |
 |------|------|-------------|--------|
 | completion_tokens | number |  |  |
-
-#### prompt_tokens
-
-| Name | Type | Description | Default |
-|------|------|-------------|--------|
 | prompt_tokens | number |  |  |
-
-#### total_tokens
-
-| Name | Type | Description | Default |
-|------|------|-------------|--------|
 | total_tokens | number |  |  |
 
-
 **Status Code:** 200
 
 **Description**: OK 
@@ -159,7 +148,7 @@ Get a vector representation of a given input that can be easily consumed by mach
 
 | Name | In | Required | Type | Description |
 |------|------|----------|------|-----------|
-| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: https://aoairesource.openai.azure.com. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
+| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: `https://aoairesource.openai.azure.com`. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
 | deployment-id | path | Yes | string |  |
 | api-version | query | Yes | string | API version |
 
@@ -282,7 +271,7 @@ Creates a completion for the chat message
 
 | Name | In | Required | Type | Description |
 |------|------|----------|------|-----------|
-| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: https://aoairesource.openai.azure.com. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
+| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: `https://aoairesource.openai.azure.com`. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
 | deployment-id | path | Yes | string | Deployment id of the model which was deployed. |
 | api-version | query | Yes | string | API version |
 
@@ -659,7 +648,7 @@ Transcribes audio into the input language.
 
 | Name | In | Required | Type | Description |
 |------|------|----------|------|-----------|
-| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: https://aoairesource.openai.azure.com. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
+| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: `https://aoairesource.openai.azure.com`. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
 | deployment-id | path | Yes | string | Deployment id of the whisper model. |
 | api-version | query | Yes | string | API version |
 
@@ -745,7 +734,7 @@ Transcribes and translates input audio into English text.
 
 | Name | In | Required | Type | Description |
 |------|------|----------|------|-----------|
-| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: https://aoairesource.openai.azure.com. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
+| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: `https://aoairesource.openai.azure.com`. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
 | deployment-id | path | Yes | string | Deployment id of the whisper model which was deployed. |
 | api-version | query | Yes | string | API version |
 
@@ -832,7 +821,7 @@ Generates a batch of images from a text caption on a given DALLE model deploymen
 
 | Name | In | Required | Type | Description |
 |------|------|----------|------|-----------|
-| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: https://aoairesource.openai.azure.com. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
+| endpoint | path | Yes | string<br>url | Supported Azure OpenAI endpoints (protocol and hostname, for example: `https://aoairesource.openai.azure.com`. Replace "aoairesource" with your Azure OpenAI resource name). | https://{your-resource-name}.openai.azure.com |
 | deployment-id | path | Yes | string | Deployment id of the `dall-e` model which was deployed. |
 | api-version | query | Yes | string | API version |