Back

Avatar The VocaGPT App FAQ Avatar

Supported Devices and Systems

    The App runs on iPhone and iPad, iOS 15+.

The App Trial

    When first installed, the App runs in trial mode, which includes 20,000 tokens and lasts for two weeks. The trial ends when you either exceed the token limit or reach the two-week mark, whichever happens first. Before using the App, you must agree to the Terms of Service. This applies to both trial and purchased versions.

    Please Note:

    • The trial AI Service utilizes an Azure OpenAI GPT-4o-mini model.
    • If you want to try your own AI accounts with the App, we recommend you enter and test your own API keys in VocaGPT during this trial period.

App Trial Completion and App Purchase

    Once the trial has ended, if you wish to continue using the App, you will need to purchase the App. You have a number of purchasing options:

    • Purchase the basic App. If you just purchase the basic App you will need to use your own AI Service Accounts and place your API keys into the App. See the In-App demonstration related to entering your own API Key.
    • Purchase the App and an AI Service subscription. This allows you to connect with a ChatGPT 4o-mini model with a quota of 1M tokens and 6 months of use. When that subscription expires, you will need to purchase another to keep using the native AI Service. Of course you can also use your own personal AI accounts by including your API keys.
    • If you wish to keep using the translation and language guide agents, you will need to purchase the Language Agent pack.

    To purchase the App products (by performing an In-App purchase), go to: Navigation => Products

Benefits Of The App

  • The pay-for-use API pricing model is extremely more cost effective than fixed subscription fees.
  • The convenience of having information available at your fingertips, especially when you are on the go.
  • Vocalization is a more natural way to express your queries.

Agents

    Agents are separated into:

    • General Purpose Agents (Ask AI for general queries and App Support for questions about the app itself)
    • Special Purpose Agents (Ideas, Tech Support, How To, Travel and Cooking)
    • Language Agents (Translate and Language Guide (recognizes English, speaks in both English and the target language, this allows for explanations in English and vocalization of examples in the target language))

    All agents have:

    • Selectable input and output languages and voices. You can download higher quality Apple voices in your Device Settings.
    • Associated properties such as speech rate, variability, verbosity, context count (the number of previous queries that are included in the next request for context) and sentence buffer count (the number of sentences that will be received before response vocalization is initiated).

AI Service Providers

    The App supports AI Models from:

    • OpenAI
    • Anthropic
    • Google
    • Mistral AI
    • Azure (These are OpenAI models hosted on Azure. You need to obtain your own personal Azure account, and create your own OpenAI model deployments)

Guide on Obtaining Your Own API Keys

    The information below is subject to change by the respective providers. Last updated: January 2026

    • OpenAI

      To get your OpenAI API Key and optional Organization ID, follow these steps:

      1. Go to platform.openai.com and sign up or log in. Note: This is separate from your ChatGPT account and doesn't require a ChatGPT subscription.
      2. If you're a new user, you'll be prompted to create an organization. Click "Start Building" and provide a name for your organization. You can skip inviting team members for now.
      3. Before creating API keys, set up billing by clicking "Settings" (gear icon) in the left menu, then select "Billing." Add a payment method and purchase credits. A starting amount of $5 is recommended for testing.
      4. Navigate to "API Keys" by clicking the gear icon (Settings) and selecting "API Keys" from the left menu.
      5. Click "Create New API Key" in the top right corner. Give your key a descriptive name (such as "VocaGPT Integration") and assign it to a project.
      6. Your API key will be displayed once. Copy it immediately and store it securely—you won't be able to see it again. This is the key you'll enter into VocaGPT.
      7. If your account has an Organization ID assigned, you can find it in Settings > Organization > General. Enter this in VocaGPT if required. If you don't have one, leave it blank.

    • Azure OpenAI

      To get your API Key, Endpoint URL, Deployment Name, and API Version for Azure OpenAI, follow these steps:

      1. Go to the Azure portal at portal.azure.com and sign in with your Microsoft account.
      2. Search for "Azure OpenAI" in the search bar and select it from the results.
      3. Click "Create" to set up a new Azure OpenAI resource. Fill in the required details: subscription, resource group, region, and a unique resource name (you'll use this name later).
      4. Choose your pricing tier (Standard S0 is typical), configure network settings (select "All networks" for testing), and proceed through the setup wizard.
      5. Click "Review + Create," then "Create." Wait for the deployment to complete.
      6. Once deployed, go to your resource. Under "Resource Management" in the left menu, click "Keys and Endpoint." Copy one of the API keys and the Endpoint URL—you'll need both.
      7. To deploy a model, click "Go to Azure AI Foundry portal" from the Overview tab, or navigate to Model Deployments. Click "Deploy model" > "Deploy base model."
      8. Select your desired model (such as gpt-4o-mini or gpt-35-turbo), give the deployment a name (this is your Deployment Name), and click "Create."
      9. For the API Version, the current recommended version is part of the v1 API (e.g., "2024-02-15-preview" or newer). Check Azure's documentation for the latest version supported by your deployment.
      10. Enter the API Key, Endpoint URL, Deployment Name, and API Version into VocaGPT's Azure OpenAI service configuration.

    • Google Gemini

      To get your Google Gemini API Key, you have two options:

      Option 1: Quick Setup (Recommended for Testing)

      1. Go to Google AI Studio and sign in with your Google account.
      2. If this is your first visit, you'll need to accept the Terms of Service for Generative AI.
      3. Click "Get API key" or navigate to the "API Keys" section in the left sidebar.
      4. Click "Create API Key." You'll be prompted to either select an existing Google Cloud project or create a new one.
      5. If creating a new project, give it a descriptive name, then click "Create."
      6. Your API key will be generated and displayed. Copy it immediately and store it securely. This is the key you'll use in VocaGPT.
      7. For added security, consider adding API key restrictions in the Google Cloud Console to limit usage to specific IP addresses or apps.

      Option 2: Via Google Cloud Console (For Advanced Users)

      1. Go to the Google Cloud Console and sign in.
      2. Create a new project or select an existing one.
      3. Navigate to "APIs & Services" > "Library" from the sidebar menu.
      4. Search for "Generative Language API" and enable it for your project.
      5. Go to "APIs & Services" > "Credentials" and click "+ Create Credentials" > "API key."
      6. Copy the generated API key and store it securely. This is the key you'll add in VocaGPT.

    • Anthropic Claude

      To get your Anthropic Claude API Key, follow these steps:

      1. Visit the Anthropic Console at console.anthropic.com and create an account or log in.
      2. After signing up, you'll be taken to your dashboard. You'll need to set up billing before you can create API keys.
      3. Navigate to "Settings" and then "Billing." Add your payment information and select a plan. The "Build" plan is pay-as-you-go and suitable for most users. You'll need to purchase an initial amount of credits (minimum $5).
      4. Once billing is set up, go to the "API Keys" section, which you can find in the left sidebar or navigation menu of the console.
      5. Click "Create Key" or "+ Create Key" in the top right corner.
      6. Give your key a descriptive name (such as "VocaGPT Integration") and assign it to a workspace if prompted.
      7. Your API key will be displayed once. Copy it immediately and save it in a secure location—you won't be able to view it again. This is the key you'll use in VocaGPT.
      8. If needed, you can manage or delete API keys from the same API Keys page in the console.

    • Mistral AI

      To get your Mistral AI API Key, follow these steps:

      1. Go to the Mistral Console at console.mistral.ai and sign up or log in.
      2. If you're creating a new account, you'll need to set up a workspace. Provide a name and indicate whether it's for individual or team use, then accept Mistral's terms and conditions.
      3. Before creating API keys, set up billing by navigating to your Organization settings at admin.mistral.ai. Add your payment information under the billing section. You can choose between the "Experiment" (free tier) or "Scale" (pay-as-you-go) plans.
      4. Return to console.mistral.ai. In the left sidebar, locate the "API Keys" section under your workspace and click on it.
      5. Click "Create new key" to generate a new API key.
      6. Enter a name for your key and optionally set an expiration date. It's recommended to set an expiration date and rotate keys regularly for security.
      7. Click "Create key." Your API key will be displayed once. Copy it immediately and store it securely—you won't be able to see it again. This is the key you'll use in VocaGPT.
      8. Note: New API keys may take a few minutes to become active.

Adding your AI Service Provider API Key into the App

    You can view the steps in entering an API key into the App by:

    • Watching the in-App demonstration at:

      Navigation => App Demos => General Demos => API Key Entry

    • Or watching a recording of the demonstration on the VocaGPT YouTube Channel

Tips on Using The Universal Clipboard to Copy API Keys Between Devices

    You can use Apple's Universal Clipboard feature to copy API keys displayed on one device (such as your Mac) and paste them directly into the App running on another device (such as your iPhone or iPad). This significantly simplifies the process of entering long API keys.

    Requirements for Universal Clipboard:

    For Universal Clipboard to work, both devices must have:

    • Wi-Fi turned on
    • Bluetooth turned on
    • Handoff enabled (found on the Mac in: System Settings > General > AirDrop & Handoff > Allow Handoff between this Mac and your iCloud devices, or for the iPhone/iPad in Settings > General > AirPlay & Continuity > Handoff)
    • Both devices signed in to the same Apple ID with two-factor authentication enabled

    For more information, see: Apple's Universal Clipboard Support

    Troubleshooting Universal Clipboard on Mac:

    If Universal Clipboard is not working even when everything is correctly configured on your Mac, try these steps in order:

    1. Reset the User Activity Daemon:
      Open Terminal and run:
      killall useractivityd
    2. Restart Bluetooth:
      In Terminal, run:
      sudo pkill bluetoothd
      (You'll be prompted to enter your administrator password)
    3. Restart the Dock:
      In Terminal, run:
      killall Dock
    4. Verify Settings:
      After running these commands, double-check that Wi-Fi, Bluetooth, and Handoff are still enabled on both devices.
    5. Test Again:
      Try copying text on one device and pasting on the other. You may need to wait a few seconds for the clipboard to sync.
    6. If Still Not Working:
      Restart both devices and ensure they are within Bluetooth range (approximately 30 feet or 10 meters) of each other.

AI Service Models, Portal Settings and Token Constraints

App Operation

  • Speech recognition is provided by the Apple SFSpeechRecognizer service.
  • Speech synthesis and associated voices in various languages and genders are all provided by the Apple AVSpeechSynthesizer service.
  • Additional premium and enhanced voices can be downloaded onto your device by going to:
      System Settings => Accessibility => Spoken Content => Voices => your language.

The App Refund Process

  • To request a refund from Apple, go to the Navigation => Purchase History view. This will list your purchases, then click on the refund button beside your purchased product. This will send a refund request to Apple who will adjudicate the request and if granted, the App will receive and process the refund transaction. This may take time to be processed.
  • Single AI Credit pack purchases are not refundable as these are consumable products.

App Release History

  • Version 2.0, February 2026.

    • Completely new App UI and new look.
    • Addition of current models and removal of deprecated ones.
    • Addition of language guide agent.
    • Trial AI Service now uses ChatGPT 4o-mini model.
    • Addition of subscription AI Service, with similar capabilities to the trial AI Service.
    • Completely new purchase model with packs: the basic app, the language-based agents separated into the language agent pack, and the subscription pack.

  • Version 1.4, August 2024.

    • Adds new provider: MistralAI with the models: Nemo, Large, Open-8x22B, Open-8x7B and Open-7B Adds new models: Google Flash 1.5

  • Version 1.3, July 2024.

    • Adds new models: OpenAI ChatGPT-4o-mini, Anthropic Claude 3.5 Sonnet.

  • Version 1.2, June 2024.

    • Adds new models: OpenAI ChatGPT-4o, ChatGPT-4-turbo and Gemini 1.5-pro.

    Adds new capability: photo capture and AI request photo attachments to models that support image input (ChatGPT-4o, ChatGPT-4-turbo, Gemini 1.5-pro, Anthropic Claude 3.0 Opus, Sonnet and Haiku)

  • Version 1.1, March 2024.

    • Initial release.