Community Agents

Create Endpoint Agent

Register an agent running on an external OpenAI-compatible endpoint. Pollinations sends a short-lived agent run token instead of a stored bearer credential. Private is the default; public agents require an allowlisted account and become public after 3 hours. API keys require account:keys.

post/account/my-models/endpoint-agents

Request

  • Base URL: https://gen.pollinations.ai
  • URL: https://gen.pollinations.ai/account/my-models/endpoint-agents
  • Auth: HTTP bearer

Request body

inputModalitiesstring[]

Input types accepted by the agent. Defaults to text.

outputModalitiesstring[]

Output types produced by the agent. Defaults to text.

namestring required
titlestring required

Display name shown in the model catalog.

descriptionstring
visibility'private' | 'public'

"private": owner-only and free at runtime; saved prices and fallbacks are retained. "public": callable by anyone and listed in the catalog when reliability permits. Publishing requires an allowlisted account.

api'chat_completions' | 'responses' required
urlstring uri required

Exact upstream endpoint URL for the selected text API, including its path and query parameters.

upstreamModelstring
requiredSafetyFeaturesstring[]

Input safety checks callers cannot disable. Use sexual and violence to block harmful prompts before they reach the provider.

perUserRpmnumber nullable

Maximum requests per minute for each Pollinations user. Decimals are supported; 0.5 means one request every two minutes. Null means no Pollinations-side limit.

Response

Created endpoint agent

idstring required
modelIdstring required
namestring required
titlestring required
descriptionstring nullable required
visibility'private' | 'public' required

"private": owner-only and free at runtime; saved prices and fallbacks are retained. "public": callable by anyone and listed in the catalog when reliability permits. Publishing requires an allowlisted account.

requiredSafetyFeaturesstring[] required

Input safety checks callers cannot disable. Use sexual and violence to block harmful prompts before they reach the provider.

createdAtstring required
updatedAtstring required
inputModalitiesstring[]

Input types accepted by the agent. Defaults to text.

outputModalitiesstring[]

Output types produced by the agent. Defaults to text.

type'endpoint_agent' required
api'chat_completions' | 'responses' required
urlstring uri required

Exact upstream endpoint URL for the selected text API, including its path and query parameters.

upstreamModelstring required
perUserRpmnumber nullable required

Maximum requests per minute for each Pollinations user. Decimals are supported; 0.5 means one request every two minutes. Null means no Pollinations-side limit.

Changes

No recorded changes to this operation across all 1 revision of this API.