AdvancedUsing Beaver with your own key

your key, beaver's research tools

Your own key gives you unlimited use of Beaver for free. You only pay your provider. Plus Tools are optional. They add Beaver's search, extraction and research tables for 0.25 credits a question.

New to Beaver? You don't need an API key. See plans

An optional add-on

What Plus Tools add to your key

Chat and editing work the same either way. Plus Tools change how your model finds and reads papers.

Your keyYour key + Plus Tools
Chat with your library, notes and PDFsYesYes
Edit notes, annotations, tags and metadataYesYes
Library searchOrdered by similarityAI-ranked
Reading many papersYour model reads every pageExtract returns the relevant passages
Search 240M+ works beyond your libraryNot availableBy topic, author, journal or citations
Research tablesNot availableIncluded
CostBeaver is free. Your API bill only.Your API bill + 0.25 credits a question
01 · AI-ranked search

Put the most relevant
papers first.

Beaver searches your library by topic and orders the results by how similar they are to your question. That is fast, but a paper with similar wording can land above the one that actually answers it.

With Plus Tools, Beaver uses a ranking model on top. It checks three times as many papers against your question, puts the best matches first and drops the weak ones.

  • Used in every topic search of your library
  • Used when searching the 240M+ scholarly works beyond it
How Beaver searches your library →
Question: how does police contact affect adolescents' mental health?
Similarity order
1
2
3
4
5
6
7
8
AI-ranked
1
2
3
4
5
3 weak matches dropped
Answers the questionSimilar wording, no answerSchematic
Without extract
≈ 50,000 tokens of an 80-page report in your model's context, carried into every step that follows
With extract
extraction model
a few hundred tokens: only the passages that answer your question
02 · Extract

Ask one question
across fifty papers.

When your model reads a paper, the full text goes into its context. An 80-page report is tens of thousands of tokens, and you pay for them again at every step.

With Plus Tools, Beaver uses a fast, inexpensive model to read each file. It returns only the passages relevant to your question so your model works from short excerpts.

  • A smaller API bill
  • More precise answers, because the context stays short
  • Compare 20, 50 or more papers in one question
  • Scanned PDFs are read with OCR
Extract can pay for Plus Tools. With a frontier model, reading one 80-page report directly can cost more than the 0.25 credits (about 2 to 4 cents) you pay per question.

Also part of Plus Tools

What it costs

0.25 credits per question

You pay your provider for tokens, so a question costs 0.25 credits instead of 1. Extraction and deep search run on Beaver's servers and still use credits.

Beaver modelYour key + Plus Tools
Ask a question1 credit0.25 credits
Long conversation (past ~150k tokens)+1 creditNothing extra
Many steps (after the first 10)+1 per 5 stepsNothing extra
Extract from files (first 5 included)+1 per 5 files+1 per 5 files
Search beyond your libraryIncludedIncluded
Deep search (citations, an author's full work)Included+1 per search
Fill a research table row from its PDF0.2 credits0.2 credits
25 credits
Free plan, one time
up to 100 questions
50 credits
Credit pack, $8, no subscription
up to 200 questions
120 credits
Plus plan, every month
up to 480 questions

Counts assume 0.25 credits per question. Without Plus Tools, your key never uses credits. How credits work →

Setup

How to turn on Plus Tools

  1. 1
    Add your API key

    In Beaver, open Settings → API Keys and paste a key from OpenAI, Anthropic or Google. Use a paid key, ideally tier 2 or higher.

  2. 2
    Enable Plus Tools

    In the same section, find Plus Tools and click Enable. Any credits work, including the free ones.

  3. 3
    Pick your model

    Close settings and choose a model under Your API Key in the model selector.

If you run out of credits, Plus Tools pause. Your key keeps working for everything else. API key guide →

Your own key or the Beaver model?

Your key + Plus Tools
  • You already pay for API access, or your institution provides a key
  • You want to choose the model and provider yourself
  • You use Beaver a lot and would rather pay per token
The Beaver model
  • You don't want to configure anything
  • You'd rather not deal with provider tiers, rate limits and verification
  • You want one predictable monthly price

For most people, the Beaver model is the simpler choice. Compare plans →

try plus tools with your own key

Add your key, enable Plus Tools and ask a question. The 25 free credits cover up to 100 questions.