AI Tokens

Understand AI Tokens

By

Understanding AI Tokens

In the world of Large Language Models (LLMs), tokens are the fundamental building blocks for processing and understanding text.

Think of tokens as small chunks, each typically representing 3-4 characters. A 100-word passage generally breaks down into approximately 125–135 tokens.

When working with AI models, you'll encounter two types:

  • Input tokens: The prompts you send to the AI.
  • Output tokens: The AI’s generated response.
Note: In Clay, you can control usage by setting a maximum output length in your model configuration.

What Is TPM?

TPM (Tokens Per Minute) refers to how many tokens a model can process within one minute—across both input and output. Different features and providers have different TPM requirements, often tied to your API tier.

API tier requirements

ChatGPT Generate Text

  • Requirement: 30,000 TPM
  • Access: Works with any paid tier as long as the API key has access to GPT-4 or GPT-4 Turbo
  • (Note: Free-tier or unpaid OpenAI keys may not have access)

ClayGent Web Research

  • OpenAI: Requires Tier 2 or higher (≥450,000 TPM)
  • Anthropic: Requires Tier 4 or higher (≥400,000 TPM)
  • Gemini:
    • Requires Tier 2, but only works with the Gemini 2.0 Flash model
    • Gemini 1.5 models may require additional access through Vertex AI or custom tiers

Upgrade API tier

If you need higher token limits or access to advanced features, you'll need to upgrade your API tier with your chosen provider.

Here's how to find more information on upgrading, with each major provider.

Monitoring API Usage

Each platform provides tools to track your usage:

Clay credits vs. personal API keys

When you're using Clay's AI tools, you will have two options for managing your API access: using Clay credits or connecting your own personal API keys.

Each option has different benefits and considerations in terms of cost, convenience, and management requirements. Let's explore these options:

Clay credits

  • Clay manages rate limits, tier access, and scaling for you.
  • No need to worry about upgrading API tiers manually.

Personal API Keys

  • Can reduce costs depending on your usage.
  • Requires meeting provider-specific tier requirements.
Note: When using a personal API key, price breakdowns won't appear in the Clay UI. You'll need to monitor your usage and upgrade tiers manually.
Starter
Explorer
Pro
Enterprise