Package com.azure.ai.openai
Class OpenAIAsyncClient
java.lang.Object
com.azure.ai.openai.OpenAIAsyncClient
Initializes a new instance of the asynchronous OpenAIClient type.
-
Method Summary
Modifier and TypeMethodDescriptionaddUploadPart(String uploadId, AddUploadPartRequest requestBody) Adds a Part to an Upload object.cancelBatch(String batchId) Gets details for a single batch specified by the given batchID.cancelBatchWithResponse(String batchId, com.azure.core.http.rest.RequestOptions requestOptions) Gets details for a single batch specified by the given batchID.cancelUpload(String uploadId) Cancels the Upload.cancelUploadWithResponse(String uploadId, com.azure.core.http.rest.RequestOptions requestOptions) Cancels the Upload.completeUpload(String uploadId, CompleteUploadRequest requestBody) Completes the Upload.completeUploadWithResponse(String uploadId, com.azure.core.util.BinaryData requestBody, com.azure.core.http.rest.RequestOptions requestOptions) Completes the Upload.createBatch(BatchCreateRequest createBatchRequest) Creates and executes a batch from an uploaded file of requests.createBatchWithResponse(com.azure.core.util.BinaryData createBatchRequest, com.azure.core.http.rest.RequestOptions requestOptions) Creates and executes a batch from an uploaded file of requests.createUpload(CreateUploadRequest requestBody) Creates an intermediate Upload object that you can add Parts to.createUploadWithResponse(com.azure.core.util.BinaryData requestBody, com.azure.core.http.rest.RequestOptions requestOptions) Creates an intermediate Upload object that you can add Parts to.deleteFile(String fileId) Delete a previously uploaded file.Mono<com.azure.core.http.rest.Response<FileDeletionStatus>> deleteFileWithResponse(String fileId, com.azure.core.http.rest.RequestOptions requestOptions) Delete a previously uploaded file.Mono<com.azure.core.util.BinaryData> generateSpeechFromText(String deploymentOrModelName, SpeechGenerationOptions speechGenerationOptions) Generates text-to-speech audio from the input text.Mono<com.azure.core.http.rest.Response<com.azure.core.util.BinaryData>> generateSpeechFromTextWithResponse(String deploymentOrModelName, com.azure.core.util.BinaryData speechGenerationOptions, com.azure.core.http.rest.RequestOptions requestOptions) Generates text-to-speech audio from the input text.getAudioTranscription(String deploymentOrModelName, String fileName, AudioTranscriptionOptions audioTranscriptionOptions) Gets transcribed text and associated metadata from provided spoken audio file data.getAudioTranscriptionAsPlainText(String deploymentOrModelName, AudioTranscriptionOptions audioTranscriptionOptions) Gets transcribed text and associated metadata from provided spoken audio data.getAudioTranscriptionText(String deploymentOrModelName, String fileName, AudioTranscriptionOptions audioTranscriptionOptions) Gets transcribed text and associated metadata from provided spoken audio file data.getAudioTranscriptionTextWithResponse(String deploymentOrModelName, String fileName, AudioTranscriptionOptions audioTranscriptionOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets transcribed text and associated metadata from provided spoken audio file data.Mono<com.azure.core.http.rest.Response<AudioTranscription>> getAudioTranscriptionWithResponse(String deploymentOrModelName, String fileName, AudioTranscriptionOptions audioTranscriptionOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets transcribed text and associated metadata from provided spoken audio file data.getAudioTranslation(String deploymentOrModelName, String fileName, AudioTranslationOptions audioTranslationOptions) Gets English language transcribed text and associated metadata from provided spoken audio file data.getAudioTranslationAsPlainText(String deploymentOrModelName, AudioTranslationOptions audioTranslationOptions) Gets English language transcribed text and associated metadata from provided spoken audio data.getAudioTranslationText(String deploymentOrModelName, String fileName, AudioTranslationOptions audioTranslationOptions) Gets English language transcribed text and associated metadata from provided spoken audio file data.getAudioTranslationTextWithResponse(String deploymentOrModelName, String fileName, AudioTranslationOptions audioTranslationOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets English language transcribed text and associated metadata from provided spoken audio file data.Mono<com.azure.core.http.rest.Response<AudioTranslation>> getAudioTranslationWithResponse(String deploymentOrModelName, String fileName, AudioTranslationOptions audioTranslationOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets English language transcribed text and associated metadata from provided spoken audio file data.Gets details for a single batch specified by the given batchID.getBatchWithResponse(String batchId, com.azure.core.http.rest.RequestOptions requestOptions) Gets details for a single batch specified by the given batchID.getChatCompletions(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions) Gets chat completions for the provided chat messages.getChatCompletionsStream(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions) Gets chat completions for the provided chat messages.getChatCompletionsStream(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions, ChatCompletionStreamOptions streamOptions) Gets chat completions for the provided chat messages.Flux<com.azure.core.http.rest.Response<ChatCompletions>> getChatCompletionsStreamWithResponse(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets chat completions for the provided chat messages.Mono<com.azure.core.http.rest.Response<ChatCompletions>> getChatCompletionsWithResponse(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets chat completions for the provided chat messages.Mono<com.azure.core.http.rest.Response<com.azure.core.util.BinaryData>> getChatCompletionsWithResponse(String deploymentOrModelName, com.azure.core.util.BinaryData chatCompletionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets chat completions for the provided chat messages.getCompletions(String deploymentOrModelName, CompletionsOptions completionsOptions) Gets completions for the provided input prompts.getCompletions(String deploymentOrModelName, String prompt) Gets completions for the provided input prompt.getCompletionsStream(String deploymentOrModelName, CompletionsOptions completionsOptions) Gets completions as a stream for the provided input prompts.getCompletionsStream(String deploymentOrModelName, CompletionsOptions completionsOptions, ChatCompletionStreamOptions streamOptions) Gets completions as a stream for the provided input prompts.Mono<com.azure.core.http.rest.Response<Completions>> getCompletionsWithResponse(String deploymentOrModelName, CompletionsOptions completionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets completions for the provided input prompts.Mono<com.azure.core.http.rest.Response<com.azure.core.util.BinaryData>> getCompletionsWithResponse(String deploymentOrModelName, com.azure.core.util.BinaryData completionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets completions for the provided input prompts.getEmbeddings(String deploymentOrModelName, EmbeddingsOptions embeddingsOptions) Return the embeddings for a given prompt.Mono<com.azure.core.http.rest.Response<Embeddings>> getEmbeddingsWithResponse(String deploymentOrModelName, EmbeddingsOptions embeddingsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Return the embeddings for a given prompt.Mono<com.azure.core.http.rest.Response<com.azure.core.util.BinaryData>> getEmbeddingsWithResponse(String deploymentOrModelName, com.azure.core.util.BinaryData embeddingsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Return the embeddings for a given prompt.Returns information about a specific file.Mono<byte[]> getFileContent(String fileId) Returns information about a specific file.Mono<com.azure.core.http.rest.Response<byte[]>> getFileContentWithResponse(String fileId, com.azure.core.http.rest.RequestOptions requestOptions) Returns information about a specific file.Mono<com.azure.core.http.rest.Response<OpenAIFile>> getFileWithResponse(String fileId, com.azure.core.http.rest.RequestOptions requestOptions) Returns information about a specific file.getImageGenerations(String deploymentOrModelName, ImageGenerationOptions imageGenerationOptions) Creates an image given a prompt.Mono<com.azure.core.http.rest.Response<ImageGenerations>> getImageGenerationsWithResponse(String deploymentOrModelName, ImageGenerationOptions imageGenerationOptions, com.azure.core.http.rest.RequestOptions requestOptions) Creates an image given a prompt.Gets a list of all batches owned by the Azure OpenAI resource.listBatches(String after, Integer limit) Gets a list of all batches owned by the Azure OpenAI resource.Mono<com.azure.core.http.rest.Response<PageableList<Batch>>> listBatchesWithResponse(com.azure.core.http.rest.RequestOptions requestOptions) Gets a list of all batches owned by the Azure OpenAI resource.Gets a list of previously uploaded files.listFiles(FilePurpose purpose) Gets a list of previously uploaded files.Mono<com.azure.core.http.rest.Response<List<OpenAIFile>>> listFilesWithResponse(com.azure.core.http.rest.RequestOptions requestOptions) Gets a list of previously uploaded files.uploadFile(FileDetails file, FilePurpose purpose) Uploads a file for use by other operations.
-
Method Details
-
getEmbeddingsWithResponse
public Mono<com.azure.core.http.rest.Response<com.azure.core.util.BinaryData>> getEmbeddingsWithResponse(String deploymentOrModelName, com.azure.core.util.BinaryData embeddingsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Return the embeddings for a given prompt.Request Body Schema
{ user: String (Optional) model: String (Optional) input (Required): [ String (Required) ] }Response Body Schema
{ data (Required): [ (Required){ embedding (Required): [ double (Required) ] index: int (Required) } ] usage (Required): { prompt_tokens: int (Required) total_tokens: int (Required) } }- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.embeddingsOptions- The configuration information for an embeddings request. Embeddings measure the relatedness of text strings and are commonly used for search, clustering, recommendations, and other similar scenarios.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- representation of the response data from an embeddings request. Embeddings measure the relatedness of
text strings and are commonly used for search, clustering, recommendations, and other similar scenarios along
with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getCompletionsWithResponse
public Mono<com.azure.core.http.rest.Response<com.azure.core.util.BinaryData>> getCompletionsWithResponse(String deploymentOrModelName, com.azure.core.util.BinaryData completionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets completions for the provided input prompts. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.Request Body Schema
{ prompt (Required): [ String (Required) ] max_tokens: Integer (Optional) temperature: Double (Optional) top_p: Double (Optional) logit_bias (Optional): { String: int (Optional) } user: String (Optional) n: Integer (Optional) logprobs: Integer (Optional) echo: Boolean (Optional) stop (Optional): [ String (Optional) ] presence_penalty: Double (Optional) frequency_penalty: Double (Optional) best_of: Integer (Optional) stream: Boolean (Optional) model: String (Optional) }Response Body Schema
{ id: String (Required) created: int (Required) choices (Required): [ (Required){ text: String (Required) index: int (Required) logprobs (Required): { tokens (Required): [ String (Required) ] token_logprobs (Required): [ double (Required) ] top_logprobs (Required): [ (Required){ String: double (Required) } ] text_offset (Required): [ int (Required) ] } finish_reason: String(stopped/tokenLimitReached/contentFiltered) (Required) } ] usage (Required): { completion_tokens: int (Required) prompt_tokens: int (Required) total_tokens: int (Required) } }- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.completionsOptions- The configuration information for a completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- completions for the provided input prompts. Completions support a wide variety of tasks and generate text
that continues from or "completes" provided prompt data along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getChatCompletionsWithResponse
public Mono<com.azure.core.http.rest.Response<com.azure.core.util.BinaryData>> getChatCompletionsWithResponse(String deploymentOrModelName, com.azure.core.util.BinaryData chatCompletionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets chat completions for the provided chat messages. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.Request Body Schema
{ messages (Required): [ (Required){ role: String(system/assistant/user) (Required) content: String (Optional) } ] max_tokens: Integer (Optional) temperature: Double (Optional) top_p: Double (Optional) logit_bias (Optional): { String: int (Optional) } user: String (Optional) n: Integer (Optional) stop (Optional): [ String (Optional) ] presence_penalty: Double (Optional) frequency_penalty: Double (Optional) stream: Boolean (Optional) model: String (Optional) }Response Body Schema
{ id: String (Required) created: int (Required) choices (Required): [ (Required){ message (Optional): { role: String(system/assistant/user) (Required) content: String (Optional) } index: int (Required) finish_reason: String(stopped/tokenLimitReached/contentFiltered) (Required) delta (Optional): { role: String(system/assistant/user) (Optional) content: String (Optional) } } ] usage (Required): { completion_tokens: int (Required) prompt_tokens: int (Required) total_tokens: int (Required) } }- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.chatCompletionsOptions- The configuration information for a chat completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- chat completions for the provided chat messages. Completions support a wide variety of tasks and generate
text that continues from or "completes" provided prompt data along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getEmbeddingsWithResponse
public Mono<com.azure.core.http.rest.Response<Embeddings>> getEmbeddingsWithResponse(String deploymentOrModelName, EmbeddingsOptions embeddingsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Return the embeddings for a given prompt.Request Body Schema
{ user: String (Optional) model: String (Optional) input (Required): [ String (Required) ] }Response Body Schema
{ data (Required): [ (Required){ embedding (Required): [ double (Required) ] index: int (Required) } ] usage (Required): { prompt_tokens: int (Required) total_tokens: int (Required) } }- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.embeddingsOptions- The configuration information for an embeddings request. Embeddings measure the relatedness of text strings and are commonly used for search, clustering, recommendations, and other similar scenarios.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- representation of the response data from an embeddings request. Embeddings measure the relatedness of
text strings and are commonly used for search, clustering, recommendations, and other similar scenarios along
with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getCompletionsWithResponse
public Mono<com.azure.core.http.rest.Response<Completions>> getCompletionsWithResponse(String deploymentOrModelName, CompletionsOptions completionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets completions for the provided input prompts. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.Request Body Schema
{ prompt (Required): [ String (Required) ] max_tokens: Integer (Optional) temperature: Double (Optional) top_p: Double (Optional) logit_bias (Optional): { String: int (Optional) } user: String (Optional) n: Integer (Optional) logprobs: Integer (Optional) echo: Boolean (Optional) stop (Optional): [ String (Optional) ] presence_penalty: Double (Optional) frequency_penalty: Double (Optional) best_of: Integer (Optional) stream: Boolean (Optional) model: String (Optional) }Response Body Schema
{ id: String (Required) created: int (Required) choices (Required): [ (Required){ text: String (Required) index: int (Required) logprobs (Required): { tokens (Required): [ String (Required) ] token_logprobs (Required): [ double (Required) ] top_logprobs (Required): [ (Required){ String: double (Required) } ] text_offset (Required): [ int (Required) ] } finish_reason: String(stopped/tokenLimitReached/contentFiltered) (Required) } ] usage (Required): { completion_tokens: int (Required) prompt_tokens: int (Required) total_tokens: int (Required) } }- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.completionsOptions- The configuration information for a completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- completions for the provided input prompts. Completions support a wide variety of tasks and generate text
that continues from or "completes" provided prompt data along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getChatCompletionsWithResponse
public Mono<com.azure.core.http.rest.Response<ChatCompletions>> getChatCompletionsWithResponse(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets chat completions for the provided chat messages. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.Request Body Schema
{ messages (Required): [ (Required){ role: String(system/assistant/user) (Required) content: String (Optional) } ] max_tokens: Integer (Optional) temperature: Double (Optional) top_p: Double (Optional) logit_bias (Optional): { String: int (Optional) } user: String (Optional) n: Integer (Optional) stop (Optional): [ String (Optional) ] presence_penalty: Double (Optional) frequency_penalty: Double (Optional) stream: Boolean (Optional) model: String (Optional) }Response Body Schema
{ id: String (Required) created: int (Required) choices (Required): [ (Required){ message (Optional): { role: String(system/assistant/user) (Required) content: String (Optional) } index: int (Required) finish_reason: String(stopped/tokenLimitReached/contentFiltered) (Required) delta (Optional): { role: String(system/assistant/user) (Optional) content: String (Optional) } } ] usage (Required): { completion_tokens: int (Required) prompt_tokens: int (Required) total_tokens: int (Required) } }- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.chatCompletionsOptions- The configuration information for a chat completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- chat completions for the provided chat messages. Completions support a wide variety of tasks and generate
text that continues from or "completes" provided prompt data along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getChatCompletionsStreamWithResponse
public Flux<com.azure.core.http.rest.Response<ChatCompletions>> getChatCompletionsStreamWithResponse(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets chat completions for the provided chat messages. Chat completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.Code Samples
openAIAsyncClient .getChatCompletionsStreamWithResponse(deploymentOrModelId, new ChatCompletionsOptions(chatMessages), new RequestOptions().setHeader("my-header", "my-header-value")) .subscribe(response -> System.out.print(response.getValue().getId()), error -> System.err.println("There was an error getting chat completions." + error), () -> System.out.println("Completed called getChatCompletionsStreamWithResponse."));- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.chatCompletionsOptions- The configuration information for a chat completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- chat completions stream for the provided chat messages. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.
- Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getEmbeddings
public Mono<Embeddings> getEmbeddings(String deploymentOrModelName, EmbeddingsOptions embeddingsOptions) Return the embeddings for a given prompt.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.embeddingsOptions- The configuration information for an embeddings request. Embeddings measure the relatedness of text strings and are commonly used for search, clustering, recommendations, and other similar scenarios.- Returns:
- representation of the response data from an embeddings request.
Embeddings measure the relatedness of text strings and are commonly used for search, clustering,
recommendations, and other similar scenarios on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getCompletions
public Mono<Completions> getCompletions(String deploymentOrModelName, CompletionsOptions completionsOptions) Gets completions for the provided input prompts. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.completionsOptions- The configuration information for a completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Returns:
- completions for the provided input prompts.
Completions support a wide variety of tasks and generate text that continues from or "completes"
provided prompt data on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getCompletions
Gets completions for the provided input prompt. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.prompt- The prompt to generate completion text from.- Returns:
- completions for the provided input prompts. Completions support a wide variety of tasks and generate text
that continues from or "completes" provided prompt data on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getCompletionsStream
public Flux<Completions> getCompletionsStream(String deploymentOrModelName, CompletionsOptions completionsOptions) Gets completions as a stream for the provided input prompts. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.Code Samples
openAIAsyncClient .getChatCompletionsStream(deploymentOrModelId, new ChatCompletionsOptions(chatMessages)) .subscribe( chatCompletions -> System.out.print(chatCompletions.getId()), error -> System.err.println("There was an error getting chat completions." + error), () -> System.out.println("Completed called getChatCompletionsStream."));- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.completionsOptions- The configuration information for a completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Returns:
- a
Fluxof completions for the provided input prompts. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getCompletionsStream
public Flux<Completions> getCompletionsStream(String deploymentOrModelName, CompletionsOptions completionsOptions, ChatCompletionStreamOptions streamOptions) Gets completions as a stream for the provided input prompts. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.completionsOptions- The configuration information for a completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.streamOptions- the streamOptions value to set.- Returns:
- a
Fluxof completions for the provided input prompts. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getChatCompletions
public Mono<ChatCompletions> getChatCompletions(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions) Gets chat completions for the provided chat messages. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.chatCompletionsOptions- The configuration information for a chat completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Returns:
- chat completions for the provided chat messages.
Completions support a wide variety of tasks and generate text that continues from or "completes"
provided prompt data on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getChatCompletionsStream
public Flux<ChatCompletions> getChatCompletionsStream(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions) Gets chat completions for the provided chat messages. Chat completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.chatCompletionsOptions- The configuration information for a chat completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Returns:
- chat completions stream for the provided chat messages. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.
- Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getChatCompletionsStream
public Flux<ChatCompletions> getChatCompletionsStream(String deploymentOrModelName, ChatCompletionsOptions chatCompletionsOptions, ChatCompletionStreamOptions streamOptions) Gets chat completions for the provided chat messages. Chat completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.chatCompletionsOptions- The configuration information for a chat completions request. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.streamOptions- the streamOptions value to set.- Returns:
- chat completions stream for the provided chat messages. Completions support a wide variety of tasks and generate text that continues from or "completes" provided prompt data.
- Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranscription
public Mono<AudioTranscription> getAudioTranscription(String deploymentOrModelName, String fileName, AudioTranscriptionOptions audioTranscriptionOptions) Gets transcribed text and associated metadata from provided spoken audio file data. Audio will be transcribed in the written language corresponding to the language it was spoken in.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.fileName- The file name that is represented in thefilefield ofAudioTranscriptionOptionsaudioTranscriptionOptions- The configuration information for an audio transcription request.- Returns:
AudioTranscriptiontranscribed text and associated metadata from provided spoken audio data on successful completion ofMono.- Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranscriptionWithResponse
public Mono<com.azure.core.http.rest.Response<AudioTranscription>> getAudioTranscriptionWithResponse(String deploymentOrModelName, String fileName, AudioTranscriptionOptions audioTranscriptionOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets transcribed text and associated metadata from provided spoken audio file data. Audio will be transcribed in the written language corresponding to the language it was spoken in.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.fileName- The file name that is represented in thefilefield ofAudioTranscriptionOptionsaudioTranscriptionOptions- The configuration information for an audio transcription request.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
AudioTranscriptiontranscribed text and associated metadata from provided spoken audio data on successful completion ofMono.- Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranscriptionText
public Mono<String> getAudioTranscriptionText(String deploymentOrModelName, String fileName, AudioTranscriptionOptions audioTranscriptionOptions) Gets transcribed text and associated metadata from provided spoken audio file data. Audio will be transcribed in the written language corresponding to the language it was spoken in.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.fileName- The file name that is represented in thefilefield ofAudioTranscriptionOptionsaudioTranscriptionOptions- The configuration information for an audio transcription request.- Returns:
- transcribed text and associated metadata from provided spoken audio data on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranscriptionTextWithResponse
public Mono<com.azure.core.http.rest.Response<String>> getAudioTranscriptionTextWithResponse(String deploymentOrModelName, String fileName, AudioTranscriptionOptions audioTranscriptionOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets transcribed text and associated metadata from provided spoken audio file data. Audio will be transcribed in the written language corresponding to the language it was spoken in.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.fileName- The file name that is represented in thefilefield ofAudioTranscriptionOptionsaudioTranscriptionOptions- The configuration information for an audio transcription request.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- transcribed text and associated metadata from provided spoken audio file data along with
Responseon successful completion ofMono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranslation
public Mono<AudioTranslation> getAudioTranslation(String deploymentOrModelName, String fileName, AudioTranslationOptions audioTranslationOptions) Gets English language transcribed text and associated metadata from provided spoken audio file data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.fileName- The file name that is represented in thefilefield ofAudioTranslationOptionsaudioTranslationOptions- The configuration information for an audio translation request.- Returns:
AudioTranslationenglish language transcribed text and associated metadata from provided spoken audio file data on successful completion ofMono.- Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranslationWithResponse
public Mono<com.azure.core.http.rest.Response<AudioTranslation>> getAudioTranslationWithResponse(String deploymentOrModelName, String fileName, AudioTranslationOptions audioTranslationOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets English language transcribed text and associated metadata from provided spoken audio file data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.fileName- The file name that is represented in thefilefield ofAudioTranslationOptionsaudioTranslationOptions- The configuration information for an audio translation request.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
AudioTranslationenglish language transcribed text and associated metadata from provided spoken audio file data along withResponseon successful completion ofMono.- Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranslationText
public Mono<String> getAudioTranslationText(String deploymentOrModelName, String fileName, AudioTranslationOptions audioTranslationOptions) Gets English language transcribed text and associated metadata from provided spoken audio file data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.fileName- The file name that is represented in thefilefield ofAudioTranslationOptions.audioTranslationOptions- The configuration information for an audio translation request.- Returns:
- english language transcribed text and associated metadata from provided spoken audio file data on
successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranslationTextWithResponse
public Mono<com.azure.core.http.rest.Response<String>> getAudioTranslationTextWithResponse(String deploymentOrModelName, String fileName, AudioTranslationOptions audioTranslationOptions, com.azure.core.http.rest.RequestOptions requestOptions) Gets English language transcribed text and associated metadata from provided spoken audio file data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.fileName- The file name that is represented in thefilefield ofAudioTranslationOptions.audioTranslationOptions- The configuration information for an audio translation request.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- english language transcribed text and associated metadata from provided spoken audio file data on
successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranscriptionAsPlainText
public Mono<String> getAudioTranscriptionAsPlainText(String deploymentOrModelName, AudioTranscriptionOptions audioTranscriptionOptions) Gets transcribed text and associated metadata from provided spoken audio data. Audio will be transcribed in the written language corresponding to the language it was spoken in.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.audioTranscriptionOptions- The configuration information for an audio transcription request.- Returns:
- transcribed text and associated metadata from provided spoken audio data on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getAudioTranslationAsPlainText
public Mono<String> getAudioTranslationAsPlainText(String deploymentOrModelName, AudioTranslationOptions audioTranslationOptions) Gets English language transcribed text and associated metadata from provided spoken audio data.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.audioTranslationOptions- The configuration information for an audio translation request.- Returns:
- english language transcribed text and associated metadata from provided spoken audio data on successful
completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getImageGenerationsWithResponse
public Mono<com.azure.core.http.rest.Response<ImageGenerations>> getImageGenerationsWithResponse(String deploymentOrModelName, ImageGenerationOptions imageGenerationOptions, com.azure.core.http.rest.RequestOptions requestOptions) Creates an image given a prompt.Request Body Schema
{ model: String (Optional) prompt: String (Required) n: Integer (Optional) size: String(256x256/512x512/1024x1024/1792x1024/1024x1792) (Optional) response_format: String(url/b64_json) (Optional) quality: String(standard/hd) (Optional) style: String(natural/vivid) (Optional) user: String (Optional) }Response Body Schema
{ created: long (Required) data (Required): [ (Required){ url: String (Optional) b64_json: String (Optional) revised_prompt: String (Optional) } ] }- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.imageGenerationOptions- Represents the request data used to generate images.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- the result of a successful image generation operation along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getImageGenerations
public Mono<ImageGenerations> getImageGenerations(String deploymentOrModelName, ImageGenerationOptions imageGenerationOptions) Creates an image given a prompt.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.imageGenerationOptions- Represents the request data used to generate images.- Returns:
- the result of a successful image generation operation on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
generateSpeechFromTextWithResponse
public Mono<com.azure.core.http.rest.Response<com.azure.core.util.BinaryData>> generateSpeechFromTextWithResponse(String deploymentOrModelName, com.azure.core.util.BinaryData speechGenerationOptions, com.azure.core.http.rest.RequestOptions requestOptions) Generates text-to-speech audio from the input text.Request Body Schema
{ input: String (Required) voice: String(alloy/echo/fable/onyx/nova/shimmer) (Required) response_format: String(mp3/opus/aac/flac) (Optional) speed: Double (Optional) }Response Body Schema
BinaryData- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.speechGenerationOptions- A representation of the request options that control the behavior of a text-to-speech operation.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- the response body along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
generateSpeechFromText
public Mono<com.azure.core.util.BinaryData> generateSpeechFromText(String deploymentOrModelName, SpeechGenerationOptions speechGenerationOptions) Generates text-to-speech audio from the input text.- Parameters:
deploymentOrModelName- Specifies either the model deployment name (when using Azure OpenAI) or model name (when using non-Azure OpenAI) to use for this request.speechGenerationOptions- A representation of the request options that control the behavior of a text-to-speech operation.- Returns:
- the response body on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
listFilesWithResponse
public Mono<com.azure.core.http.rest.Response<List<OpenAIFile>>> listFilesWithResponse(com.azure.core.http.rest.RequestOptions requestOptions) Gets a list of previously uploaded files.Query Parameters
You can add these to a request withQuery Parameters Name Type Required Description purpose String No A value that, when provided, limits list results to files matching the corresponding purpose. Allowed values: "fine-tune", "fine-tune-results", "assistants", "assistants_output", "batch", "batch_output", "vision". RequestOptions.addQueryParam(java.lang.String, java.lang.String)Response Body Schema
{ object: String (Required) data (Required): [ (Required){ object: String (Required) id: String (Required) bytes: int (Required) filename: String (Required) created_at: long (Required) purpose: String(fine-tune/fine-tune-results/assistants/assistants_output/batch/batch_output/vision) (Required) status: String(uploaded/pending/running/processed/error/deleting/deleted) (Optional) status_details: String (Optional) } ] }- Parameters:
requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- a list of previously uploaded files along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
deleteFileWithResponse
public Mono<com.azure.core.http.rest.Response<FileDeletionStatus>> deleteFileWithResponse(String fileId, com.azure.core.http.rest.RequestOptions requestOptions) Delete a previously uploaded file.Response Body Schema
{ id: String (Required) deleted: boolean (Required) object: String (Required) }- Parameters:
fileId- The ID of the file to delete.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- a status response from a file deletion operation along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getFileWithResponse
public Mono<com.azure.core.http.rest.Response<OpenAIFile>> getFileWithResponse(String fileId, com.azure.core.http.rest.RequestOptions requestOptions) Returns information about a specific file. Does not retrieve file content.Response Body Schema
{ object: String (Required) id: String (Required) bytes: int (Required) filename: String (Required) created_at: long (Required) purpose: String(fine-tune/fine-tune-results/assistants/assistants_output/batch/batch_output/vision) (Required) status: String(uploaded/pending/running/processed/error/deleting/deleted) (Optional) status_details: String (Optional) }- Parameters:
fileId- The ID of the file to retrieve.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- represents an assistant that can call the model and use tools along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getFileContentWithResponse
public Mono<com.azure.core.http.rest.Response<byte[]>> getFileContentWithResponse(String fileId, com.azure.core.http.rest.RequestOptions requestOptions) Returns information about a specific file. Does not retrieve file content.Response Body Schema
byte[]- Parameters:
fileId- The ID of the file to retrieve.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- represent a byte array along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
listBatchesWithResponse
public Mono<com.azure.core.http.rest.Response<PageableList<Batch>>> listBatchesWithResponse(com.azure.core.http.rest.RequestOptions requestOptions) Gets a list of all batches owned by the Azure OpenAI resource.Query Parameters
You can add these to a request withQuery Parameters Name Type Required Description after String No Identifier for the last event from the previous pagination request. limit Integer No Number of batches to retrieve. Defaults to 20. RequestOptions.addQueryParam(java.lang.String, java.lang.String)Response Body Schema
{ object: String (Required) data (Optional): [ (Optional){ id: String (Required) object: String (Required) endpoint: String (Optional) errors (Optional): { object: String (Required) data (Optional): [ (Optional){ code: String (Optional) message: String (Optional) param: String (Optional) line: Integer (Optional) } ] } input_file_id: String (Required) completion_window: String (Optional) status: String(validating/failed/in_progress/finalizing/completed/expired/cancelling/cancelled) (Optional) output_file_id: String (Optional) error_file_id: String (Optional) created_at: Long (Optional) in_progress_at: Long (Optional) expires_at: Long (Optional) finalizing_at: Long (Optional) completed_at: Long (Optional) failed_at: Long (Optional) expired_at: Long (Optional) cancelling_at: Long (Optional) cancelled_at: Long (Optional) request_counts (Optional): { total: Integer (Optional) completed: Integer (Optional) failed: Integer (Optional) } metadata (Optional): { String: String (Required) } } ] first_id: String (Optional) last_id: String (Optional) has_more: Boolean (Optional) }- Parameters:
requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- a list of all batches owned by the Azure OpenAI resource along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
createBatchWithResponse
public Mono<com.azure.core.http.rest.Response<Batch>> createBatchWithResponse(com.azure.core.util.BinaryData createBatchRequest, com.azure.core.http.rest.RequestOptions requestOptions) Creates and executes a batch from an uploaded file of requests. Response includes details of the enqueued job including job status. The ID of the result file is added to the response once complete.Request Body Schema
{ endpoint: String (Required) input_file_id: String (Required) completion_window: String (Required) metadata (Optional): { String: String (Required) } }Response Body Schema
{ id: String (Required) object: String (Required) endpoint: String (Optional) errors (Optional): { object: String (Required) data (Optional): [ (Optional){ code: String (Optional) message: String (Optional) param: String (Optional) line: Integer (Optional) } ] } input_file_id: String (Required) completion_window: String (Optional) status: String(validating/failed/in_progress/finalizing/completed/expired/cancelling/cancelled) (Optional) output_file_id: String (Optional) error_file_id: String (Optional) created_at: Long (Optional) in_progress_at: Long (Optional) expires_at: Long (Optional) finalizing_at: Long (Optional) completed_at: Long (Optional) failed_at: Long (Optional) expired_at: Long (Optional) cancelling_at: Long (Optional) cancelled_at: Long (Optional) request_counts (Optional): { total: Integer (Optional) completed: Integer (Optional) failed: Integer (Optional) } metadata (Optional): { String: String (Required) } }- Parameters:
createBatchRequest- The specification of the batch to create and execute.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- the Batch object along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
getBatchWithResponse
public Mono<com.azure.core.http.rest.Response<Batch>> getBatchWithResponse(String batchId, com.azure.core.http.rest.RequestOptions requestOptions) Gets details for a single batch specified by the given batchID.Response Body Schema
{ id: String (Required) object: String (Required) endpoint: String (Optional) errors (Optional): { object: String (Required) data (Optional): [ (Optional){ code: String (Optional) message: String (Optional) param: String (Optional) line: Integer (Optional) } ] } input_file_id: String (Required) completion_window: String (Optional) status: String(validating/failed/in_progress/finalizing/completed/expired/cancelling/cancelled) (Optional) output_file_id: String (Optional) error_file_id: String (Optional) created_at: Long (Optional) in_progress_at: Long (Optional) expires_at: Long (Optional) finalizing_at: Long (Optional) completed_at: Long (Optional) failed_at: Long (Optional) expired_at: Long (Optional) cancelling_at: Long (Optional) cancelled_at: Long (Optional) request_counts (Optional): { total: Integer (Optional) completed: Integer (Optional) failed: Integer (Optional) } metadata (Optional): { String: String (Required) } }- Parameters:
batchId- The identifier of the batch.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- details for a single batch specified by the given batchID along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
cancelBatchWithResponse
public Mono<com.azure.core.http.rest.Response<Batch>> cancelBatchWithResponse(String batchId, com.azure.core.http.rest.RequestOptions requestOptions) Gets details for a single batch specified by the given batchID.Response Body Schema
{ id: String (Required) object: String (Required) endpoint: String (Optional) errors (Optional): { object: String (Required) data (Optional): [ (Optional){ code: String (Optional) message: String (Optional) param: String (Optional) line: Integer (Optional) } ] } input_file_id: String (Required) completion_window: String (Optional) status: String(validating/failed/in_progress/finalizing/completed/expired/cancelling/cancelled) (Optional) output_file_id: String (Optional) error_file_id: String (Optional) created_at: Long (Optional) in_progress_at: Long (Optional) expires_at: Long (Optional) finalizing_at: Long (Optional) completed_at: Long (Optional) failed_at: Long (Optional) expired_at: Long (Optional) cancelling_at: Long (Optional) cancelled_at: Long (Optional) request_counts (Optional): { total: Integer (Optional) completed: Integer (Optional) failed: Integer (Optional) } metadata (Optional): { String: String (Required) } }- Parameters:
batchId- The identifier of the batch.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- details for a single batch specified by the given batchID along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
listFiles
Gets a list of previously uploaded files.- Parameters:
purpose- A value that, when provided, limits list results to files matching the corresponding purpose.- Returns:
- a list of previously uploaded files on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
listFiles
Gets a list of previously uploaded files.- Returns:
- a list of previously uploaded files on successful completion of
Mono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
uploadFile
Uploads a file for use by other operations.- Parameters:
file- The file data (not filename) to upload.purpose- The intended purpose of the file.- Returns:
- represents an assistant that can call the model and use tools on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
deleteFile
Delete a previously uploaded file.- Parameters:
fileId- The ID of the file to delete.- Returns:
- a status response from a file deletion operation on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getFile
Returns information about a specific file. Does not retrieve file content.- Parameters:
fileId- The ID of the file to retrieve.- Returns:
- represents an assistant that can call the model and use tools on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getFileContent
Returns information about a specific file. Does not retrieve file content.- Parameters:
fileId- The ID of the file to retrieve.- Returns:
- represent a byte array on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
listBatches
Gets a list of all batches owned by the Azure OpenAI resource.- Parameters:
after- Identifier for the last event from the previous pagination request.limit- Number of batches to retrieve. Defaults to 20.- Returns:
- a list of all batches owned by the Azure OpenAI resource on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
listBatches
Gets a list of all batches owned by the Azure OpenAI resource.- Returns:
- a list of all batches owned by the Azure OpenAI resource on successful completion of
Mono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
getBatch
Gets details for a single batch specified by the given batchID.- Parameters:
batchId- The identifier of the batch.- Returns:
- details for a single batch specified by the given batchID on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
cancelBatch
Gets details for a single batch specified by the given batchID.- Parameters:
batchId- The identifier of the batch.- Returns:
- details for a single batch specified by the given batchID on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
createBatch
Creates and executes a batch from an uploaded file of requests. Response includes details of the enqueued job including job status. The ID of the result file is added to the response once complete.- Parameters:
createBatchRequest- The specification of the batch to create and execute.- Returns:
- the Batch object on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
createUploadWithResponse
public Mono<com.azure.core.http.rest.Response<Upload>> createUploadWithResponse(com.azure.core.util.BinaryData requestBody, com.azure.core.http.rest.RequestOptions requestOptions) Creates an intermediate Upload object that you can add Parts to. Currently, an Upload can accept at most 8 GB in total and expires after an hour after you create it. Once you complete the Upload, we will create a File object that contains all the parts you uploaded. This File is usable in the rest of our platform as a regular File object. For certain purposes, the correct mime_type must be specified. Please refer to documentation for the supported MIME types for your use case. For guidance on the proper filename extensions for each purpose, please follow the documentation on creating a File.Request Body Schema
{ filename: String (Required) purpose: String(assistants/batch/fine-tune/vision) (Required) bytes: int (Required) mime_type: String (Required) }Response Body Schema
{ id: String (Required) created_at: long (Required) filename: String (Required) bytes: long (Required) purpose: String (Required) status: String(pending/completed/cancelled/expired) (Required) expires_at: long (Required) object: String(upload) (Optional) file (Optional): { object: String (Required) id: String (Required) bytes: int (Required) filename: String (Required) created_at: long (Required) purpose: String(fine-tune/fine-tune-results/assistants/assistants_output/batch/batch_output/vision) (Required) status: String(uploaded/pending/running/processed/error/deleting/deleted) (Optional) status_details: String (Optional) } }- Parameters:
requestBody- The request body for the operation options.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- the Upload object can accept byte chunks in the form of Parts along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
completeUploadWithResponse
public Mono<com.azure.core.http.rest.Response<Upload>> completeUploadWithResponse(String uploadId, com.azure.core.util.BinaryData requestBody, com.azure.core.http.rest.RequestOptions requestOptions) Completes the Upload. Within the returned Upload object, there is a nested File object that is ready to use in the rest of the platform. You can specify the order of the Parts by passing in an ordered list of the Part IDs. The number of bytes uploaded upon completion must match the number of bytes initially specified when creating the Upload object. No Parts may be added after an Upload is completed.Request Body Schema
{ part_ids (Required): [ String (Required) ] md5: String (Optional) }Response Body Schema
{ id: String (Required) created_at: long (Required) filename: String (Required) bytes: long (Required) purpose: String (Required) status: String(pending/completed/cancelled/expired) (Required) expires_at: long (Required) object: String(upload) (Optional) file (Optional): { object: String (Required) id: String (Required) bytes: int (Required) filename: String (Required) created_at: long (Required) purpose: String(fine-tune/fine-tune-results/assistants/assistants_output/batch/batch_output/vision) (Required) status: String(uploaded/pending/running/processed/error/deleting/deleted) (Optional) status_details: String (Optional) } }- Parameters:
uploadId- The ID of the upload associated with this operation.requestBody- The request body for the completion operation.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- the Upload object can accept byte chunks in the form of Parts along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
cancelUploadWithResponse
public Mono<com.azure.core.http.rest.Response<Upload>> cancelUploadWithResponse(String uploadId, com.azure.core.http.rest.RequestOptions requestOptions) Cancels the Upload. No Parts may be added after an Upload is cancelled.Response Body Schema
{ id: String (Required) created_at: long (Required) filename: String (Required) bytes: long (Required) purpose: String (Required) status: String(pending/completed/cancelled/expired) (Required) expires_at: long (Required) object: String(upload) (Optional) file (Optional): { object: String (Required) id: String (Required) bytes: int (Required) filename: String (Required) created_at: long (Required) purpose: String(fine-tune/fine-tune-results/assistants/assistants_output/batch/batch_output/vision) (Required) status: String(uploaded/pending/running/processed/error/deleting/deleted) (Optional) status_details: String (Optional) } }- Parameters:
uploadId- The ID of the upload associated with this operation.requestOptions- The options to configure the HTTP request before HTTP client sends it.- Returns:
- the Upload object can accept byte chunks in the form of Parts along with
Responseon successful completion ofMono. - Throws:
com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.
-
createUpload
Creates an intermediate Upload object that you can add Parts to. Currently, an Upload can accept at most 8 GB in total and expires after an hour after you create it. Once you complete the Upload, we will create a File object that contains all the parts you uploaded. This File is usable in the rest of our platform as a regular File object. For certain purposes, the correct mime_type must be specified. Please refer to documentation for the supported MIME types for your use case. For guidance on the proper filename extensions for each purpose, please follow the documentation on creating a File.- Parameters:
requestBody- The request body for the operation options.- Returns:
- the Upload object can accept byte chunks in the form of Parts on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
addUploadPart
Adds a Part to an Upload object. A Part represents a chunk of bytes from the file you are trying to upload. Each Part can be at most 64 MB, and you can add Parts until you hit the Upload maximum of 8 GB. It is possible to add multiple Parts in parallel. You can decide the intended order of the Parts when you complete the Upload.- Parameters:
uploadId- The ID of the upload associated with this operation.requestBody- The request body data payload for the operation.- Returns:
- the upload Part represents a chunk of bytes we can add to an Upload object on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
completeUpload
Completes the Upload. Within the returned Upload object, there is a nested File object that is ready to use in the rest of the platform. You can specify the order of the Parts by passing in an ordered list of the Part IDs. The number of bytes uploaded upon completion must match the number of bytes initially specified when creating the Upload object. No Parts may be added after an Upload is completed.- Parameters:
uploadId- The ID of the upload associated with this operation.requestBody- The request body for the completion operation.- Returns:
- the Upload object can accept byte chunks in the form of Parts on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-
cancelUpload
Cancels the Upload. No Parts may be added after an Upload is cancelled.- Parameters:
uploadId- The ID of the upload associated with this operation.- Returns:
- the Upload object can accept byte chunks in the form of Parts on successful completion of
Mono. - Throws:
IllegalArgumentException- thrown if parameters fail the validation.com.azure.core.exception.HttpResponseException- thrown if the request is rejected by server.com.azure.core.exception.ClientAuthenticationException- thrown if the request is rejected by server on status code 401.com.azure.core.exception.ResourceNotFoundException- thrown if the request is rejected by server on status code 404.com.azure.core.exception.ResourceModifiedException- thrown if the request is rejected by server on status code 409.RuntimeException- all other wrapped checked exceptions if the request fails to be sent.
-