Public/Videos/Get-VideoContent.ps1
function Get-VideoContent { [CmdletBinding()] [OutputType([byte[]])] param ( [Parameter(Mandatory, Position = 0, ValueFromPipeline, ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()] [Alias('video_id')] [Alias('Id')] [string][UrlEncodeTransformation()]$VideoId, [Parameter()] [ValidateNotNullOrEmpty()] [string]$OutFile, [Parameter()] [Completions('video', 'thumbnail', 'spritesheet')] [string][LowerCaseTransformation()]$Variant = 'video', [Parameter()] [switch]$WaitForCompletion, [Parameter()] [int]$TimeoutSec = 0, [Parameter()] [ValidateRange(0, 100)] [int]$MaxRetryCount = 0, [Parameter()] [OpenAIApiType]$ApiType = [OpenAIApiType]::OpenAI, [Parameter()] [System.Uri]$ApiBase, [Parameter(DontShow)] [string]$ApiVersion, [Parameter()] [ValidateSet('openai', 'azure', 'azure_ad')] [string]$AuthType = 'openai', [Parameter()] [securestring][SecureStringTransformation()]$ApiKey, [Parameter()] [Alias('OrgId')] [string]$Organization, [Parameter()] [System.Collections.IDictionary]$AdditionalQuery, [Parameter()] [System.Collections.IDictionary]$AdditionalHeaders, [Parameter()] [object]$AdditionalBody ) begin { # Get API context $OpenAIParameter = Get-OpenAIAPIParameter -EndpointName 'Videos.Content' -Parameters $PSBoundParameters -ErrorAction Stop $ApiType = $OpenAIParameter.ApiType # Parse Common params $CommonParams = ParseCommonParams $PSBoundParameters } process { # region Wait for completion if ($WaitForCompletion) { Write-Verbose -Message "Waiting for the job with id '$VideoId' to be completed..." $FinishedJob = $VideoId | PSOpenAI\Wait-Video @CommonParams if ($FinishedJob.status -in ('completed', 'succeeded')) { Write-Verbose -Message "The job with id '$VideoId' is completed." } else { Write-Error -Message "The job with id '$VideoId' was not completed. The status is '$($FinishedJob.status)'." return } } # endregion # For Azure OpenAI, the job id is not equal to the video id. # video id is required to get from the finished job object. if ($ApiType -eq [OpenAIApiType]::Azure) { $JobObject = PSOpenAI\Get-Video -VideoId $VideoId @CommonParams if ($null -eq $JobObject) { Write-Error -Message "The job with id '$VideoId' was not found." } else { $VideoId = $JobObject.generations[0].id } } #region Construct Query URI $QueryUri = $OpenAIParameter.Uri.ToString() -f $VideoId $UriBuilder = [System.UriBuilder]::new($QueryUri) if ($ApiType -eq [OpenAIApiType]::Azure) { $UriBuilder.Path += "/$Variant" } if ($ApiType -eq [OpenAIApiType]::OpenAI) { if ($PSBoundParameters.ContainsKey('Variant')) { $QueryParam = [System.Web.HttpUtility]::ParseQueryString($UriBuilder.Query) $QueryParam.Add('variant', $Variant) $UriBuilder.Query = $QueryParam.ToString() } } $QueryUri = $UriBuilder.Uri #endregion #region Send API Request $params = @{ Method = 'Get' Uri = $QueryUri TimeoutSec = $OpenAIParameter.TimeoutSec MaxRetryCount = $OpenAIParameter.MaxRetryCount ApiKey = $OpenAIParameter.ApiKey AuthType = $OpenAIParameter.AuthType Organization = $OpenAIParameter.Organization AdditionalQuery = $AdditionalQuery AdditionalHeaders = $AdditionalHeaders AdditionalBody = $AdditionalBody } $Response = Invoke-OpenAIAPIRequest @params # error check if ($null -eq $Response) { return } #endregion #region Output if ($OutFile) { Write-ByteContent -OutFile $OutFile -Bytes ([byte[]]$Response) } else { Write-Output $Response } #endregion } end { } } |