Voyage AI and ElevenLabs

Optional services for meaning-based search and voice notes.

Read as Markdown

Both services are optional. Voyage AI is highly recommended for search. ElevenLabs is recommended if you want to use voice notes. Neither replaces your model provider.

You can add their keys during installation or later in the admin app. You do not need to install either company's SDK. Optakt One connects to their APIs.

Voyage AI

What it does

Voyage AI turns text into embeddings: numerical representations used to find related meaning, not just matching words. Optakt One uses them when it stores and searches memory and the archive.

Without Voyage AI, new text is not embedded. Search still has its wording and connection-based paths, but loses the meaning-based part. We strongly recommend connecting your own key.

Our launch-period key

We currently provide a shared Voyage AI key during launch, so you can start without opening an account there. This is a launch provision, not a permanent service included in your Optakt One plan. The shared key may become unavailable if its costs become unsustainable.

Your own key puts that usage under your own account rather than the shared launch allowance. If the shared key stops working, replace it with your own; do not depend on it for long-term access.

Get and connect a key

  1. Create a Voyage AI account and open the API keys dashboard (opens in a new window).
  2. Choose Create new secret key. Keep the key private; do not paste it into chat.
  3. Open optakt, log in as a scope admin, and select the agent scope you want to configure.
  4. Under Integrations, if Voyage AI is already connected with the launch key, select it and press d to disconnect it. Then press a, choose Processing → Voyage AI, and enter your own key.
  5. The app checks the connection. Press r on the integration to refresh its status later.

The key belongs to that agent scope. Other scopes keep their own connection. Replacing the launch key does not erase existing memories or embeddings.

Voyage's API key guide (opens in a new window) covers its account-side setup. Its Python installation instructions are not needed for Optakt One.

Costs and data

Usage under your own key is governed and billed by Voyage AI, separately from your Optakt One licence. Check Voyage's current pricing (opens in a new window) and the usage in your dashboard.

Voyage receives the text being embedded and the search phrases: memory and archive content and the names in it, not the full conversation history. See Data and privacy.

ElevenLabs

What it does

ElevenLabs transcribes voice and video notes before your agent reads them. We recommend it if you want to use voice notes.

Without it, Optakt One uses the transcription tools installed on your agent's machine. The same local fallback is used if ElevenLabs fails. You can use voice notes without an ElevenLabs account; the transcription work runs there instead.

Get and connect a key

  1. Create an ElevenLabs account and open its API key settings (opens in a new window).
  2. Create an API key with access to speech-to-text. Make sure the account has the allowance needed for your use. Keep the key private; do not paste it into chat.
  3. Open optakt, log in as a scope admin, and select the agent scope.
  4. Under Integrations, press a, choose Processing → ElevenLabs, and enter the key. The app checks the connection.
  5. Send your agent a voice note. It receives the transcription as text. Adding, changing or disconnecting the integration takes effect on the next note; you do not need to restart the service.

To replace a connected key, disconnect that integration with d and add it again with a. ElevenLabs also lets you restrict, expire and rotate keys: see its API key guide (opens in a new window).

Costs and data

Your account's plan, quota and API usage charges are set by ElevenLabs, separately from your Optakt One licence. Check your account's usage and billing information (opens in a new window) rather than assuming transcription is included in your Optakt plan.

When connected, ElevenLabs receives the audio or video note for transcription. If you want those notes transcribed locally instead, disconnect the integration. See Data and privacy.