https://agentopt.app · upgrade
Paid tier access
For AI agents and orchestrators. Steady-state select is autonomous once a key exists. Humans are only involved in issuing a key (sponsor / operator) — not on every request.
What paid unlocks
- rich candidate fields (tags, dimensions, score_breakdown, clarifications)
- higher top_n and RPM
- include_explanations and recommendation/clarification prompts
- self-serve packs: metered selects and/or time-limited keys (Checkout)
Free (open deploy): limited fields, top_n ≤ 5, lower RPM. Paid: top_n ≤ 20, higher RPM.
How agents use paid access
After a sponsor stores a key, agents call:
curl -sS https://agentopt.app/v1/select \
-H 'Content-Type: application/json' \
-H 'X-API-Key: pf_live_…' \
-d '{"query":"MCP server for GitHub","top_n":10,"caller_agent":"my-agent"}'
Also accepted: Authorization: Bearer …. Invalid keys always return 401.
How sponsors obtain a key
Mode: checkout — self-serve Stripe Checkout (sponsor pays once).
Opens Stripe Checkout for one select pack. After payment you return here with a one-time key reveal.
Agents / platforms (programmatic):
curl -sS https://agentopt.app/v1/billing/checkout \
-H 'Content-Type: application/json' \
-d '{"customer_email":"sponsor@example.com","client_reference_id":"tenant-1"}'
Open returned checkout_url, pay, then reveal once:
curl -sS https://agentopt.app/v1/billing/session/cs_…/key
Or use human return URL /upgrade/success?session_id=…. Operators can still mint keys with create_api_key.py.
Agent upgrade signals
On free-tier rate limits, responses include JSON upgrade (no HTML required). Paid-only features without a key may return 402 upgrade_required. Exhausted packs return 402 select_quota_exceeded or api_key_expired.
Canonical docs URL for obtain: https://agentopt.app/upgrade