Checklist
- Update
.env and secrets/env.json (sops) with credentials - Update config/handler with model routing
- Update registry with pricing and provider
- 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
