text.ps1
|
# Nabil Redmann - 2026-03-22 # License: MIT <# .SYNOPSIS Generate text using the Pollinations AI API. .DESCRIPTION Generate text based on the given prompt using the Pollinations AI API, for single line input text. .PARAMETER content The prompt for the text. Piping into this script, will use this parameter. .PARAMETER prompt Alternative to content. The prompt for the text. .PARAMETER settings A hashtable of settings passed to the Pollinations AI API. .PARAMETER model The model to use for text generation. .PARAMETER assignedModelList The endpoint the model is from to use for audio generation (text or audio model list). .PARAMETER POLLINATIONSAI_API_KEY The API key to use for the Pollinations AI API. .PARAMETER key Alternative to POLLINATIONSAI_API_KEY. The API key to use for the Pollinations AI API. .PARAMETER colors Adds a string to the prompt to request ANSI formatting instead of Markdown. Can be set globally with $env:POLLINATIONSAIPS_COLORS=$true .PARAMETER out The local path to save the generated text. .PARAMETER save Will save to the system temp folder. .PARAMETER details Will return the details of the generated text (headers + content). .PARAMETER getSettingsDefault Get the default settings for the Pollinations AI API. .PaRAMETER listModels Get the list of available models for the Pollinations AI API. .EXAMPLE PS C:\> Get-PollinationsAiText -listModels PS C:\> Get-PollinationsAiText -content "a cat" -model "openai" -save List the available models, then generate an text based on the prompt "a cat" and save it. .EXAMPLE PS C:\> Get-PollinationsAiText "a cat" -set @{"system" = "just output a comma separated list of typical colors"} Generate an text based on the prompt "a cat" and set the system prompt to "just output a comma separated list of typical colors". .EXAMPLE PS C:\> $env:POLLINATIONSAI_API_KEY = "sk_..." PS C:\> $s = Get-PollinationsAiText -getSettingsDefault PS C:\> $s Name Value ---- ----- system temperature 1 seed 0 PS C:\> $s.temperature = 2.0 PS C:\> Get-PollinationsAiText -content "a cat" -settings $s -out acat.jpg .NOTES Performance -> set AssignedModelList to either 'text' or 'audio' to prevent 2 extra API calls for checking model lists .NOTES To get audio for designated models, restrict the output modalities to "audio", and use: -set @{"modalities" = "audio"} .NOTES Use -Debug to see the Write-Debug output TEST with httpie: https GET gen.pollinations.ai/text/describe%20a%20cat --verbose -A bearer -a sk_* model==nomnom .OUTPUTS The generated text content OR content and headers as @{ Headers; Content; Uri } using: -details Error: throws @{ StatusCode = <error code>; Message = <error message> } #> Function Get-PollinationsAiText { [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingCmdletAliases', '', Scope = 'Function', Target = '*')] [CmdletBinding(DefaultParameterSetName="None")] param ( [Parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName='None', Position=0, HelpMessage="Prompt for the text")] [Parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName='WithOut', Position=0, HelpMessage="Prompt for the text")] [Parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName='WithSave', Position=0, HelpMessage="Prompt for the text")] [Parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName='WithDetails', Position=0, HelpMessage="Prompt for the text")] [Alias("prompt")] $content, [hashtable] [Parameter(Mandatory=$false, ParameterSetName='None', HelpMessage="A hashtable of settings passed to the Pollinations AI API, see https://enter.pollinations.ai/api/docs#tag/genpollinationsai/GET/text/{prompt}")] [Parameter(Mandatory=$false, ParameterSetName='WithOut', HelpMessage="A hashtable of settings passed to the Pollinations AI API, see https://enter.pollinations.ai/api/docs#tag/genpollinationsai/GET/text/{prompt}")] [Parameter(Mandatory=$false, ParameterSetName='WithSave', HelpMessage="A hashtable of settings passed to the Pollinations AI API, see https://enter.pollinations.ai/api/docs#tag/genpollinationsai/GET/text/{prompt}")] [Parameter(Mandatory=$false, ParameterSetName='WithDetails', HelpMessage="A hashtable of settings passed to the Pollinations AI API, see https://enter.pollinations.ai/api/docs#tag/genpollinationsai/GET/text/{prompt}")] $settings = @{}, [string] [Parameter(Mandatory=$false, ParameterSetName='None', HelpMessage="The model to use for text generation. Defaults to 'ztext'. See https://enter.pollinations.ai/api/docs#tag/genpollinationsai/GET/text/{prompt}.query.model")] [Parameter(Mandatory=$false, ParameterSetName='WithOut', HelpMessage="The model to use for text generation. Defaults to 'ztext'. See https://enter.pollinations.ai/api/docs#tag/genpollinationsai/GET/text/{prompt}.query.model")] [Parameter(Mandatory=$false, ParameterSetName='WithSave', HelpMessage="The model to use for text generation. Defaults to 'ztext'. See https://enter.pollinations.ai/api/docs#tag/genpollinationsai/GET/text/{prompt}.query.model")] [Parameter(Mandatory=$false, ParameterSetName='WithDetails', HelpMessage="The model to use for text generation. Defaults to 'ztext'. See https://enter.pollinations.ai/api/docs#tag/genpollinationsai/GET/text/{prompt}.query.model")] $model = "nova-fast", [string] [Parameter(Mandatory=$false, ParameterSetName='None')] [Parameter(Mandatory=$false, ParameterSetName='WithOut')] [Parameter(Mandatory=$false, ParameterSetName='WithSave')] [Parameter(Mandatory=$false, ParameterSetName='WithDetails')] $assignedModelList = "", # 'text' or 'audio' - set to prevent 2 extra API calls for checking model lists [string] [Parameter(Mandatory=$false, ParameterSetName='None')] [Parameter(Mandatory=$false, ParameterSetName='WithOut')] [Parameter(Mandatory=$false, ParameterSetName='WithSave')] [Parameter(Mandatory=$false, ParameterSetName='WithDetails')] [Alias("key")] $POLLINATIONSAI_API_KEY = $env:POLLINATIONSAI_API_KEY, [switch] [Parameter(Mandatory=$false, ParameterSetName='None')] [Parameter(Mandatory=$false, ParameterSetName='WithOut')] [Parameter(Mandatory=$false, ParameterSetName='WithSave')] [Parameter(Mandatory=$false, ParameterSetName='WithDetails')] [Alias("nocache")] $bypassCache = $false, # this only bypasses the cloudflare cache, resulting in a newly generated response. [switch] [Parameter(Mandatory=$false, ParameterSetName='None')] [Parameter(Mandatory=$false, ParameterSetName='WithDetails')] [Alias("ansi")] [Alias("clicolors")] $colors = $(if ($null -ne $env:POLLINATIONSAIPS_COLORS) { [boolean]$env:POLLINATIONSAIPS_COLORS } else { $false }), [string] [Parameter(Mandatory=$true, ParameterSetName='WithOut')] $out = "", [switch] [Parameter(Mandatory=$true, ParameterSetName='WithSave')] $save = $false, # save a file with `-out <name>` or `-save` to save it with a provided name to the sys temp [switch] [Parameter(Mandatory=$true, ParameterSetName='WithDetails')] [Parameter(Mandatory=$false, ParameterSetName='WithOut')] [Parameter(Mandatory=$false, ParameterSetName='WithSave')] [Parameter(Mandatory=$false, ParameterSetName='GetModelsList')] $details = $false, # stand alone [switch] [Parameter(Mandatory=$true, ParameterSetName='GetSettingsDefault')] $getSettingsDefault = $false, # stand alone [switch] [Parameter(Mandatory=$true, ParameterSetName='GetModelsList')] $listModels = $false ) begin { $contentIn = "" } process { if ($content -is [System.Array]) { $contentIn += ($content -join "`n") } elseif ($null -ne $content -and $content -isnot [string]) { $contentIn += $content.ToString() } elseif ($null -ne $content) { $contentIn += $content + "`n" } } end { if ($contentIn.trim() -match "[\r\n]") { # even escaping to %0A is not supported by the endpoint Write-Error "Using last line as prompt. Only single line input text is supported, join all lines WITHOUT newlines or use Get-PollinationsAi-TextEx instead." } $content = $contentIn.trim() -split "`n" | select -Last 1 # just to be save # --------------------------------------------------------------- $ANSI_FORMATTING = "Format the output with ANSI colors and ANSI formatting, directly for the console/terminal without a code fence (instead of using Markdown), and do not talk about it. " <# .LINK https://enter.pollinations.ai/api/docs#tag/genpollinationsai/GET/text/{prompt} #> $defaultSettingsByApi = @{ seed = 0 # 0 == random, max == 9007199254740991 system = "" temperature = 1.0 voice = "alloy" # only for openai-audio, see https://platform.openai.com/docs/guides/text-to-speech#voice-options } if ($getSettingsDefault) { return $defaultSettingsByApi } Function getList { $uris = @( @('text', "https://gen.pollinations.ai/text/models"), @('audio', "https://gen.pollinations.ai/audio/models"), @('image', "https://gen.pollinations.ai/image/models"), @('video', "https://gen.pollinations.ai/video/models") ) $block = [scriptblock]{ $Key, $Uri = $_ try { $response = Invoke-WebRequest -Uri $Uri -Method Get -UseBasicParsing } catch { $response = $null } if ($null -ne $response) { return $response.content | ConvertFrom-Json |? {$_.output_modalities -Contains "text"} |% {$_ | Add-Member -MemberType NoteProperty -Name 'ModelsList' -Value $Key; $_} |% {if ($null -eq $_.paid_only) {$_ | Add-Member -MemberType NoteProperty -Name 'paid_only' -Value $false}; $_} | select 'paid_only', * -ExcludeProperty 'is_specialized', 'tools' -ErrorAction SilentlyContinue } } if ( (Get-Command ForEach-Object).Parameters.ContainsKey('Parallel') ) { # PowerShell 7+ $list = $uris |% -Parallel $block } else { $list = $uris |% $block } return $list | sort -Property name } if ($listModels -eq $true) { $list = getList if ($details) { return $list } else { return $list | Format-Table } } # --------------------------------------------------------------- if (-not $POLLINATIONSAI_API_KEY) { throw "⚠️ POLLINATIONSAI API KEY is missing! (-key or -POLLINATIONSAI_API_KEY or set `$env:POLLINATIONSAI_API_KEY=`"sk_...`")" } # --------------------------------------------------------------- #* we do not merge the defaults into this settings object by default, because the generated URL query would be longer then necessary $querySettings = @{ "model" = if (-not $model) { "nova-fast" } else { $model } # since this could be set to "" #"json" = "true" # we always want the response as JSON #! *JSON-BUG ... But that results in plaintext or json formatted error https://github.com/pollinations/pollinations/issues/7413 # "modalities[]" = "text" #! There seems to be bug with Pollinations where there is only 'text' as modality, Error: {"message":"feature 'modalities' is not currently supported"}} } + $settings # bypasses cloudflare cache if ($bypassCache) { $querySettings["cacheBuster"] = [string](Get-Date).Ticks + (Get-Random) } $headers = @{ "Authorization" = "Bearer $POLLINATIONSAI_API_KEY" } if ($assignedModelList -eq "") { $assignedModelList = getList |? {$_.name -eq $model} | select -ExpandProperty ModelsList if ($assignedModelList -eq "") { throw [PSCustomObject]@{ Message = "Model unknown. Could not be found in the text or audio list of models." } } } #! SPECIAL FIX FOR OpenAI-Audio if ($model -eq "openai-audio") { $fix = "&" + "modalities[]" + "=" + "text" } $baseUrl = "https://gen.pollinations.ai/{0}" -f $assignedModelList # stringify query and convert prompt $queryStr = ($querySettings.GetEnumerator() |% { [uri]::EscapeDataString($_.Key) + "=" + [uri]::EscapeDataString($_.Value) } ) -join "&" $contentCombined = if ($Colors) { $ANSI_FORMATTING + ' ' + $content } else { $content } $promptSlug = [uri]::EscapeDataString($contentCombined) # newline escaping to %0A is not supported by the endpoint or emtpy lines or something like that ! # construct URI $uri = "{0}/{1}?{2}{3}" -f $baseUrl, $promptSlug, $queryStr, $fix Write-Debug "URI: $uri" # check for PowerShell 7+ $canSkip = (Get-Command Invoke-WebRequest).Parameters.ContainsKey('SkipHttpErrorCheck') if ($canSkip) { $response = Invoke-WebRequest -Uri $uri -Method Get -Headers $headers -UseBasicParsing -SkipHttpErrorCheck # get the error message in the response } else { # Fallback for PowerShell 5.1 --> does only show the status code, since the response is dropped by Invoke-WebRequest try { $response = Invoke-WebRequest -Uri $uri -Method Get -Headers $headers -UseBasicParsing -ErrorAction Stop } catch { $response = @{ StatusCode = $_.Exception.Response.StatusCode.Value__; Message = $_.Exception.Response.StatusCode } } } # check for errors if ($response.StatusCode -ne 200) { $err = if ($response.content) {$response.content | ConvertFrom-Json |% { @{ StatusCode = $_.status; Message = $_.error.message} }} else { $response } Write-Error $err # set error code $global:LASTEXITCODE = $response.StatusCode throw [PSCustomObject]$err } #! *JSON-BUG ... The json param does not work. It results in plaintext or json formatted error https://github.com/pollinations/pollinations/issues/7413 # elseif ($response.Headers["Content-Type"] -notlike "*/json") { # Write-Error $response.Content # # set error code # $global:LASTEXITCODE = 200 # throw [PSCustomObject]@{ StatusCode = $response.StatusCode; Message = $response.Content } # } $ret = "" $isContentBytes = $response -and $response.Content -and $response.Content.GetType().Name -eq "Byte[]" # save the text if ($out -ne "" -or $save -eq $true) { if ($out -eq "") { #* NOTE: 'Content-Disposition' is always missing on the text endpoint $targetFilename = $response.Headers["X-Request-ID"].Trim() if ($targetFilename -eq "") { $targetFilename = (Get-Date).ToString("yyyyMMddHHmmss") + "-" + (Get-Random) } # dir is temp dir $targetDir = [IO.Path]::GetTempPath() $filepath = [IO.Path]::Combine($targetDir, $targetFilename) } else { $filepath = [IO.Path]::Combine($PWD, $out) } if ($Null -eq (Split-Path $filepath -Leaf).Split(".")[1]) { #PWSH 6+ "" -eq (Split-Path $filepath -Leaf | Split-Path -Extension) # 'text/html' ... 'application/json' ... $type = $response.Headers["Content-Type"] -split ";" | select -First 1 |% { $_ -split "/"} | Select-Object -Last 1 if ($type -eq "" -or $type -eq "plain") { $type = "txt" } $filepath += "." + $type } Write-Debug "Filepath: $filepath" if ($isContentBytes) { # save bytes (possibly audio) [IO.File]::WriteAllBytes($filepath, $response.Content) } else { # save the text $response.Content | Out-File -FilePath $filepath } $ret = $filepath } if ($details -eq $true) { $ret = if ($ret) { @{ FilePath = $ret } } else { @{} } #filename available $ret = $ret + @{ Headers = $response.Headers Content = $response.Content Uri = $uri } if (-not $isContentBytes -and $colors) { $ret += @{ FormattedContent = ($response.Content | ConvertFrom-AnsiEscapedString) }} } if ($ret) { return $ret } else { if ($isContentBytes -or $colors -eq $false) { return $response.Content } elseif ($colors) { return ($response.Content | ConvertFrom-AnsiEscapedString) } } } } |