VivaDictaVivaDicta

Use Your Subscriptions

Sign in with ChatGPT, Copilot, or Claude — use AI at no extra cost.

Already paying for ChatGPT, GitHub Copilot, or Claude? You can use VivaDicta's AI processing features at no extra cost by signing in with your existing subscription — no separate API key needed.

OAuth Sign-In

VivaDicta supports one-click sign-in for several providers. Instead of creating and managing API keys, just sign in with your account. For a visual step-by-step guide, see OAuth Sign-In Setup.

ChatGPT (OpenAI)

Works with: ChatGPT Plus, Pro, or Team subscription.

  1. In VivaDicta, click AI Providers in the sidebar.
VivaDicta sidebar with AI Providers highlighted
  1. Click on the OpenAI provider card.
AI Providers grid with OpenAI card highlighted
  1. Click Sign in with ChatGPT and authorize in your browser.
OpenAI provider detail with Sign in with ChatGPT button

Google Gemini

Works with: Any Google account (free tier available).

  1. In VivaDicta, go to AI Provider settings → Google Gemini.
  2. Click Sign in with Google.
  3. VivaDicta auto-discovers your Google Cloud project during sign-in.

GitHub Copilot

Works with: GitHub Copilot Free, Pro, Business, or Enterprise. A free tier is available with 50 messages per month — no credit card required.

The Pro plan ($10/mo) gives you expanded access to Claude, GPT, Gemini, and Grok models — all through VivaDicta.

  1. In VivaDicta, go to AI Provider settings → GitHub Copilot.
  2. Click Sign in with GitHub.
  3. Enter the device code shown in VivaDicta on GitHub's authorization page.
  4. VivaDicta fetches available models based on your plan (Free, Pro, Pro+).

OpenRouter

Works with: OpenRouter account with credits.

  1. In VivaDicta, go to AI Provider settings → OpenRouter.
  2. Click Sign in with OpenRouter.
  3. VivaDicta exchanges your OAuth authorization for an API key automatically.

VivAgents Server

Use your existing subscriptions via CLI agents (Claude Code, Codex CLI, Gemini CLI) installed on your Mac. The VivAgents Server is built into VivaDicta for Mac — just enable sharing and your iOS devices can connect instantly. It also runs as a standalone server on macOS and Linux.

See the VivAgents Server guide for full setup instructions.

Note: CLI agents (Claude Code, Codex) are designed for software development use. Using them for general text processing may fall outside the intended use and could lead to account restrictions. By enabling this feature you proceed at your own risk.

API Key vs OAuth vs VivAgents

MethodCostSetupLimitations
API KeyPay-as-you-goCopy & paste keySeparate billing
OAuth Sign-InUses your subscriptionOne-click sign-inSubject to subscription rate limits
VivAgentsUses your subscriptionInstall CLI + enable sharingIntended for dev use (see note above)

Fallback Chain

When multiple methods are configured for the same provider, VivaDicta tries them in priority order. If one fails, it automatically falls back to the next:

  • OpenAI: ChatGPT OAuth → VivAgents (Codex CLI) → API Key
  • Gemini: Google OAuth → VivAgents (Gemini CLI) → API Key
  • Anthropic: VivAgents (Claude CLI) → API Key (Anthropic has no OAuth yet)

You can enable all methods at once — VivaDicta picks the highest-priority one that works. The active method is shown on the provider card in the AI Providers screen.

← AI RewriteOAuth Sign-In Setup →