/// <summary>
/// This operation generates a description of an image in human readable
/// language with complete sentences. The description is based on a collection
/// of content tags, which are also returned by the operation. More than one
/// description can be generated for each image. Descriptions are ordered by
/// their confidence score. All descriptions are in English.
/// Two input methods are supported -- (1) Uploading an image or (2) specifying
/// an image URL.
/// A successful response will be returned in JSON. If the request failed, the
/// response will contain an error code and a message to help understand what
/// went wrong.
/// </summary>
/// <param name='operations'>
/// The operations group for this extension method.
/// </param>
/// <param name='url'>
/// Publicly reachable URL of an image.
/// </param>
/// <param name='maxCandidates'>
/// Maximum number of candidate descriptions to be returned. The default is 1.
/// </param>
/// <param name='language'>
/// The desired language for output generation. If this parameter is not
/// specified, the default value is &quot;en&quot;.Supported
/// languages:en - English, Default. es - Spanish, ja - Japanese, pt -
/// Portuguese, zh - Simplified Chinese. Possible values include: 'en', 'es',
/// 'ja', 'pt', 'zh'
/// </param>
/// <param name='cancellationToken'>
/// The cancellation token.
/// </param>
public static async Task <ImageDescription> DescribeImageAsync(this IComputerVisionClient operations, string url, int?maxCandidates = 1, string language = default(string), CancellationToken cancellationToken = default(CancellationToken))
{
using (var _result = await operations.DescribeImageWithHttpMessagesAsync(url, maxCandidates, language, null, cancellationToken).ConfigureAwait(false))
{
return(_result.Body);
}
}