Ask PollinationsAI for a Text

... in pure Powershell 5+ / 7+ (Win, Linux, OSX, Docker, ...) -- for free (registration, but no moneys)

https://enter.pollinations.ai/

Warning

PollinationsAI will cache the response to your request indefinitely (possibly the request as well) and the response can be accessed without authentication.

This might be what you are looking for, if you want to get persistent results to a request or want to share the response (the URL visible with -Debug is without authentication).

DO NOT enter private data (name, address, ...), personal information, information about other people, financial data and other sensetive information. It is not save to use in a corporate environment. Handle it as if you would post on X / Facebook.

See Discussion

Usage

PollinationsAI-Text "a cat"
# Ah, a cat – these furry little bundles ...

PollinationsAI-Text -?
PollinationsAI-Text [-content] <string> [-settings <hashtable>] [-model <string>] [-POLLINATIONSAI_API_KEY <string>] [-bypassCache]
PollinationsAI-Text [-content] <string> -details [-settings <hashtable>] [-model <string>] [-POLLINATIONSAI_API_KEY <string>] [-bypassCache]
PollinationsAI-Text [-content] <string> -save [-details] [-settings <hashtable>] [-model <string>] [-POLLINATIONSAI_API_KEY <string>] [-bypassCache]
PollinationsAI-Text [-content] <string> -out <string> [-details] [-settings <hashtable>] [-model <string>] [-POLLINATIONSAI_API_KEY <string>] [-bypassCache]
PollinationsAI-Text -listModels [-details]
PollinationsAI-Text -getSettingsDefault

Yes: Optional <CommonParameters> is always supported.

Quickly integrate it (install, update)

Note

➡️ Interchangeably use PollinationsAI-Text for .\ask.pollinations_text.ps1 in this documentation. Exact same params apply.

⭐ PollinationsAI-Text can be used globally, using the file itself works only where it is saved.

In your Powershell prompt, paste the following to download the comandlet into the Powershell profile folder and activate it:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://gist.githubusercontent.com/BananaAcid/331cc3c073564f2cb5a831e04aef35e5/raw/integrate.ps1'))

Note: Non-Windows users will see, which has no effect: Set-ExecutionPolicy: Operation is not supported on this platform.

only download it into your current folder

$ErrorActionPreference = 'SilentlyContinue'; Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; Invoke-WebRequest 'https://gist.githubusercontent.com/BananaAcid/331cc3c073564f2cb5a831e04aef35e5/raw/ask.pollinations_text.ps1' -out 'ask.pollinations_text.ps1';

You might want to add your key as environment variable to your profile

"`n`n`$env:POLLINATIONSAI_API_KEY = `"sk_..............`"" >> $PROFILE.CurrentUserAllHosts

... after restarting your powershell console, the key will be available.

Params

arg	default	example	desc
<string> or -content <string> or -prompt <string>	(required)	"Some Text-Prompt"	The content to be created.
-model <string>	"nova-fast"	"gemini"	The model to use. Currently available on PollinationsAI.
-POLLINATIONSAI_API_KEY <string> or -key <string>	$env:POLLINATIONSAI_API_KEY	sk_12345678901234567890	Use a PollonationsAI API Key - if left set to "", $env:POLLINATIONSAI_API_KEY is being checked. Note: Add the API key to your environment variables.
-settings <hashtable> or -set <hashtable>	see below	@{seed = 1234567890}	A hashtable of settings passed to the Pollinations AI API.
-bypassCache or -nocache			Only bypasses the cloudflare cache, resulting in a newly generated response. Without, the first request will generate the result, each subsequent request will result in the cached response.
-out <string>		answer.txt	The local path to save the generated text and returns the path.
-save			Will save to the system temp folder and returns the path.
-details			Does not save but and returns @{ Headers; Content; Uri; [FilePath] } (FilePath only if -save or -out was used)
-getSettingsDefault or -get			Get the default settings for the PollinationsAI API.
-listModels or -list			Outputs a table of models, that are currently available on PollinationsAI.
-listModels -details or -list -details			Outputs a Hashtable of models, to be used in code.
-debug			Outputs the request URI. (This URI does not need authorisation, because it accesses the cached result)

Important

Returns:

• Default: The generated text
• -details: The headers as and content @{ Headers; Content; Uri; [FilePath] } (FilePath only if -save or -out was used)
  • (HTTP-response Headers, Content of the answer, Uri of the cached request)
• -save: The local path to generated file
• -out <name.txt>: The local path to generated file

🎵 Audio: You might get an audio file (using openai-audio), using -save will create a mpeg (mpga) file, returing it by default will be the bytes, as will be the -details content.

⚠️ Because the comandlet returns the paths or data, you can use it within another script!

Caution

on error:

• throws

  @{ StatusCode = <error code>; Message = <error message> }

Note

You can always shorten a param (to use -c or -con instead of -content)

Make it available to your shell as a function (if you did not do the "quickly integrate it") ... for local use

Function PollinationsAI-Text { & <absolutepath>\ask.pollinations_text.ps1 @args }

Doing this, you can use PollinationsAI-Text -listModels in any folder (while in the same session), instead of .\ask.pollinations_text.ps1 -listModels within the script folder only.

To make it always available in a powershell session, add it a file shown with $Profile | Select-Object * (CurrentUserAllHosts is a good place).

Examples

Generate a text based on the prompt "a cat"

PollinationsAI-Text "a cat"
# Ah, a cat – these furry little bundles ...

Get all models and test a prompt

See discussion pollinations/pollinations#7423