Skip to content

KeyPool Integration Guide

KeyPool gives your team one stable API surface for AI services that each have their own auth headers, quotas, and SDK quirks.

What You Get

  • One team token for every supported service.
  • Shared service access through one stable endpoint per supported provider.
  • Consistent failure handling when a provider is temporarily unavailable or rate-limited.
  • Usage controls defined by your KeyPool workspace.
  • Service-specific guidance for SDK setup, base URLs, and edge cases.

Start Here

  1. Get your KeyPool Team Token from your workspace admin.
  2. Pick the service you want to integrate from the navigation.
  3. Set KEYPOOL_BASE_URL to the base URL provided by your KeyPool administrator.
  4. Send Authorization: Bearer <TEAM_TOKEN> on every request to KeyPool.
  5. Use the API Reference page to test the exact service endpoints in-browser.

Base URL Patterns

Most services use the same URL pattern:

https://your-keypool.example.com/v1/{service}

Two services use a service header for SDK compatibility:

  1. Firecrawl SDKs should target the KeyPool origin and use x-keypool-service: firecrawl.
  2. Tavily examples in this guide use the KeyPool origin plus x-keypool-service: tavily for the same reason.

Supported Services