Skip to content
Rivul AI
Explore
FeaturesDeep ResearchRivul MCP
PricingDocsBlogAbout
Sign in
FeaturesPricingRivul MCPDocsBlogAbout
Rivul AI

A free Multimodal AI Research Workspace for documents, recordings, papers and your own library.

Explore

FeaturesDeep ResearchRivul MCP

Resources

DocumentationBlogCompare research tools
About Rivul AIContact and support
© 2026 Rivul AI
PrivacyTerms

Start here

  • QuickstartGet started
  • Bring Your Own KeyGet started
  • What Is MCP for AI Research?Agents
  • TroubleshootingTroubleshooting
  • Limits and QuotasReference

↑↓ to move↵ to openesc to close
Skip to article
Documentation
Overview
  • What is Rivul AI
  • Quickstart
  • Bring your own key
  • Workflows
  • On a phone
  • Papers
    • Citations
    • Claim Checking
    • Analyze
    • Review
    • Export
  • Research
  • Ask Rivul
  • Agents and Runs
  • Skills
  • Rivul MCP
    • Claude Code
    • OpenAI Codex
    • Cursor
    • Google Antigravity
    • Meta Muse Code
    • MCP tool reference
    • REST API reference
    • Keys, apps and activity
    • Usage and fair use
  • Library
  • Search Papers
  • Connectors
  • Document OCR
  • Transcribe
  • Listen
  • Citation Tools
  • Settings
  • Privacy and AI use
  • Export and delete data
  • Common problems
  • Limits and quotas
  • Keyboard Shortcuts
  • Glossary
  1. Documentation
  2. Troubleshooting
  3. Common problems

Troubleshooting

Find the message you saw, read what it means, and fix it. Messages are quoted as Rivul AI shows them.

Last updated Sep 25, 2026

On this page
  • AI provider and API key
  • Fair-use limits
  • PDF uploads and text extraction
  • Document OCR
  • Transcribe
  • Listen
  • Rivul MCP and the REST API
  • Sign-in and access
  • Google Drive and Google Docs
  • Workspaces, papers and agents
  • Still stuck

AI provider and API key

These come from your AI provider through your own key. Rivul AI passes on what the provider reports.

AI provider messages.
Message or symptomWhat it means and what to do
Connect your AI provider in Settings to use AI features.No key is connected. Connect one in Settings → AI provider.
Your AI provider rejected this API key. Update it in Settings.The key was revoked, expired or mistyped. Create a new key with the provider and paste it in.
Your AI provider reports no remaining credit or quota on this key. Check your AI provider account.Add billing or raise the limit in the provider's console. Rivul AI cannot change it.
Your AI provider is rate-limiting this key. Try again in a few seconds.The provider's own rate limit was reached. Wait, then retry.
Your AI model could not answer that request. Try rephrasing, or pick another model in Settings.The model refused or could not complete the request. Rephrase it, or choose another model.
Your AI provider is temporarily unavailable. Try again in a moment.The provider is down or overloaded. Retry shortly.
The model took too long. Try a shorter request.Shorten the selection, the question or the number of sources.
AI provider messages.

Fair-use limits

Fair-use limits stop runaway use and sit well above a person's working pace. When one is reached, the request works again once its window passes.

Fair-use messages.
Message or symptomWhat it means and what to do
That is a lot of AI requests in a short time. Wait a minute and try again.A per-minute window was reached. Wait a minute.
… for one hour. Try again later. / … for one day. Try again later.An hourly or daily window was reached. Daily windows reset at 00:00 UTC.
Several AI requests are already running. Wait for one to finish and try again.Too many AI requests are running at once, for example several tabs. Let one finish.
Too many scholarly lookups in a short time. Wait a moment and try again.The search window was reached. Wait a moment.
Scholarly search is temporarily paused. Your papers and editor still work.Search is paused for everyone. Everything else keeps working.
Fair-use messages.
  • Limits and quotas

PDF uploads and text extraction

Library upload and extraction messages.
Message or symptomWhat it means and what to do
PDF is too large (max 10 MB).Add the paper by DOI or arXiv ID instead, then click Fetch PDF, or upload a smaller copy.
You can store up to 5 PDFs. Delete one before adding another.Delete a stored PDF in the Library. References without a PDF do not count.
This file is empty. / Only PDF files are supportedChoose a PDF with content. For images and scans, use Document OCR.
Upload failed. Check your connection.The transfer stopped. Try again; if processing failed after the upload, click Retry processing.
Needs OCRThe PDF is stored but no text was extracted. Click Re-extract to run OCR on it.
Garbled text / Little textThe extracted text may be unusable, or the PDF is mostly images. Click Re-extract, or upload a text-based copy.
Extraction failedClick Re-extract. The stored PDF still opens in the reader.
Library upload and extraction messages.
  • Library: extraction and indexing status

Document OCR

Document OCR messages.
Message or symptomWhat it means and what to do
This file is larger than 25 MB.Split the document or lower the scan resolution.
This file type is not supported. Use a PDF, PNG, JPEG, TIFF or WebP file.Convert the file, for example export a photo as JPEG.
The OCR server is busy. Try this file again in a minute.Retry in a minute.
Reading this file took too long. Try a smaller file or fewer pages.Split the file.
Rivul AI could not read this file. It may be damaged or password-protected.Remove the password, or save a new copy of the file.
This upload was already read. Add the file again.Each upload is read once. Add the file again.
Document OCR messages.

Transcribe

Transcribe messages.
Message or symptomWhat it means and what to do
This file is larger than 500 MB.Trim the recording, or export the audio only.
This file type is not supported. Use MP3, WAV, M4A, FLAC, OGG, WebM, MP4 or MOV.Convert the recording to one of these formats.
You have used today's 2 hours of transcription. Try again tomorrow.The daily allowance of audio is used. It resets at 00:00 UTC.
No speech was found in this file.Check that the file has an audio track with speech, and that the recording was not muted.
The speech server is busy. Try this file again in a few minutes.Retry in a few minutes. Keep the page open while files are queued.
Transcription did not finish. Try this file again.Add the file again.
Transcribe messages.

Listen

Listen messages.
Message or symptomWhat it means and what to do
You have used today's Rivul voice allowance. Use the browser voice until tomorrow.Switch to the browser voice, which has no limit.
This browser has no on-device English voice. Use the Rivul voice.Switch to the Rivul voice, or install an English voice in your system settings.
The Rivul voice is busy. Try again in a minute, or use the browser voice.Retry, or use the browser voice.
Playback stops when an iPhone or iPad screen locksSafari pauses the browser voice in the background. Return to the page and Listen resumes.
Listen messages.

Rivul MCP and the REST API

Ask your AI client to call usage_status first: it never counts toward usage, so it tells a revoked key from a rate limit.

Rivul MCP and REST messages.
Message or symptomWhat it means and what to do
HTTP 401 Invalid Rivul Atlas keyThe key is revoked or mistyped. Create a new key in Rivul MCP → Access keys, or sign in with Rivul again.
HTTP 403 This Atlas key cannot access that product or scopeThe key is the wrong kind: use an API key for REST and an MCP key for MCP.
Atlas MCP rate limit exceeded. Retry shortly.A fair-use window was reached. Wait for the retry-after time. A second key does not raise the limit.
Atlas fair-use daily limit reached for MCP searches. It resets at 00:00 UTC.Wait for the UTC day to reset.
The Rivul MCP tools do not appear in the clientRestart the client, check that the Rivul MCP server is enabled in its MCP settings, and complete the browser sign-in. Each client guide has its own steps.
Revoke an existing API key before creating more than 1.A workspace holds one active key of each kind. Revoke the old key first.
Rivul MCP and REST messages.
  • Set up Rivul MCP

Sign-in and access

Sign-in messages.
Message or symptomWhat it means and what to do
Sign-in did not complete. Try Continue with Google again.The Google window was closed or interrupted. Try again.
Too many attempts. Please wait a minute.Wait a minute, then sign in again.
Registration closedNew accounts are not being accepted right now. Existing accounts can still sign in.
Someone else may have access to my accountSecure your Google account first, then report it through the contact form. Rivul AI never asks for a Google password or a sign-in code.
Sign-in messages.
  • Open the contact form

Google Drive and Google Docs

Google Drive messages.
Message or symptomWhat it means and what to do
Your browser blocked the Google window. Allow pop-ups for this site and try again.Allow pop-ups for rivul.ai, then retry.
Google Drive could not load. Check your connection or content blockers and try again.Pause the content blocker for rivul.ai, or allow Google's cookies when the file picker asks.
Google Drive access was not granted. / Google Drive access expired. Try again.Connect again and approve access to the files you pick.
Your PDF storage is full.Delete a stored PDF first; you can store 5 at a time.
Google Drive messages.

Workspaces, papers and agents

Account and agent messages.
Message or symptomWhat it means and what to do
Keep up to 2 workspaces. Delete one before adding another.Delete a workspace in Settings → Danger zone.
You can keep up to 20 agents. Delete one to create another.Delete an agent you no longer use.
Research agents are temporarily unavailable. Your agents and past runs are kept.Agents are paused for everyone. Nothing is lost; try again later.
The AI request limit was reached before the report could be written. Try again in a few minutes.The run used its fair-use window. Run it again in a few minutes.
Account and agent messages.

Still stuck

Use Share Feedback in the app, or the contact form at rivul.ai/contact. Describe what you did and the exact message, and include a request ID if one was shown. Never include passwords, API keys or session cookies. Messages are read; there is no guaranteed response.

  • Open the contact form

Related guides

  • Bring Your Own KeyConnect your own Google Gemini, OpenAI, Anthropic, xAI, Mistral, or Meta API key. See what needs it, and how it is stored.
  • Rivul MCP Usage and Fair-Use LimitsRivul MCP is free. What the fair-use rate limits are, how to read your usage, and what happens when a limit is reached.
  • Limits and QuotasEvery per-account limit in one place: storage, uploads, agents, skills, OCR, transcription, Listen and Rivul MCP.
PreviousExport and delete dataNextLimits and quotas

Something here wrong or missing? Use the contact form.

On this page

  • AI provider and API key
  • Fair-use limits
  • PDF uploads and text extraction
  • Document OCR
  • Transcribe
  • Listen
  • Rivul MCP and the REST API
  • Sign-in and access
  • Google Drive and Google Docs
  • Workspaces, papers and agents
  • Still stuck
Back to top
Rivul AI
Explore
FeaturesDeep ResearchRivul MCP
PricingDocsBlogAbout
Sign in
FeaturesPricingRivul MCPDocsBlogAbout