model-management

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

File	Purpose
text.pollinations.ai/.env	API keys, endpoints
text.pollinations.ai/secrets/env.json	Encrypted secrets (use sops)
text.pollinations.ai/configs/modelConfigs.ts	Model routing config
text.pollinations.ai/availableModels.ts	Service name → config mapping
shared/registry/text.ts	Pricing, provider, aliases, description

Image/Video Models

File	Purpose
image.pollinations.ai/.env	API keys, endpoints
image.pollinations.ai/secrets/env.json	Encrypted secrets (use sops)
image.pollinations.ai/src/createAndReturnImages.ts	Model handlers
shared/registry/image.ts	Pricing, provider, aliases, description

---

Quick Actions

Action	.env	Config/Handler	Registry
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