Agent Skill
2/7/2026

model-management

Add, update, or remove text/image/video models. Handles any provider.

P
pollinations
3928GitHub Stars
1Views
npx skills add pollinations/pollinations

SKILL.md

Namemodel-management
DescriptionAdd, update, or remove text/image/video models. Handles any provider.

name: model-management description: "Add, update, or remove text/image/video models. Handles any provider."

Checklist

  1. Update .env and secrets/env.json (sops) with credentials
  2. Update config/handler with model routing
  3. Update registry with pricing and provider
  4. Run tests (see Testing below)

⚠️ Pricing depends on BOTH model AND provider. Always verify pricing on the provider's website.


Files to Update

Text Models

FilePurpose
text.pollinations.ai/.envAPI keys, endpoints
text.pollinations.ai/secrets/env.jsonEncrypted secrets (use sops)
text.pollinations.ai/configs/modelConfigs.tsModel routing config
text.pollinations.ai/availableModels.tsService name → config mapping
shared/registry/text.tsPricing, provider, aliases, description

Image/Video Models

FilePurpose
image.pollinations.ai/.envAPI keys, endpoints
image.pollinations.ai/secrets/env.jsonEncrypted secrets (use sops)
image.pollinations.ai/src/createAndReturnImages.tsModel handlers
shared/registry/image.tsPricing, provider, aliases, description

Quick Actions

Action.envConfig/HandlerRegistry
New model✅ (pricing!)
Change endpoint only--
Change provider✅ (pricing!)
Make paid-only--✅ (paidOnly: true)
Disable model-✅ (remove)✅ (remove)
Upgrade model✅ (if provider changes)✅ (pricing!)

Testing

After updating model files, run these tests from enter.pollinations.ai/:

# 1. Alias resolution (fast, no network) — verifies aliases map to service IDs
npx vitest run test/aliases.test.ts

# 2. Integration tests for the specific model (uses VCR snapshots)
npx vitest run test/integration/text.test.ts --testNamePattern="<service-name> "

Notes:

  • VCR snapshots are auto-recorded on first run if the EC2 text service is reachable
  • Run npm run decrypt-vars first if you haven't already

Secrets (sops)

sops -d <service>/secrets/env.json > /tmp/plain.json
# Edit with jq or manually
cp /tmp/plain.json <service>/secrets/env.json
sops -e -i <service>/secrets/env.json
rm /tmp/plain.json
Skills Info
Original Name:model-managementAuthor:pollinations