Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from VOYAGE_API_KEY is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration.

​
Setup

  1. Create a Voyage AI account: Sign up at https://dashboard.voyageai.com. New accounts include free trial tokens for every model, which is enough for evaluation without billing.
  2. Create an API key: In the dashboard, open the API Keys section and create a new key. Copy it immediately.
  3. Store the key: Add VOYAGE_API_KEY=… to your .env file. Requests authenticate with an Authorization: Bearer header.
  4. Verify access: Run the Create Embeddings tool with model voyage-3.5 and a single short input string. A 401 means the key is wrong or revoked.

​
Provider notes

  • Use the same embedding model (and input_type convention) for indexing and querying - vectors from different models are not comparable
  • Contextualized chunk embeddings (voyage-context-3) expect each inner list to be one document’s chunks in order; regular embeddings treat every array item independently
  • Usage beyond the free trial tokens is billed per million tokens and requires adding a payment method in the dashboard
Provider API reference.

​
Tools

​
Verify the connection

Call a read tool such as voyage-ai__create_embeddings with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.