Voyage AI

​

Setup

pnpm add braintrust voyageai

npm install braintrust voyageai

BRAINTRUST_API_KEY=<your-braintrust-api-key>
VOYAGE_API_KEY=<your-voyage-api-key>

# For organizations on the EU data plane, use https://api-eu.braintrust.dev
# For self-hosted deployments, use your data plane URL
# BRAINTRUST_API_URL=<your-braintrust-api-url>

​

Auto-instrumentation

import { initLogger } from "braintrust";
import { VoyageAIClient } from "voyageai";

initLogger({
  projectName: "voyageai-example",
  apiKey: process.env.BRAINTRUST_API_KEY,
});

const client = new VoyageAIClient({
  apiKey: process.env.VOYAGE_API_KEY,
});

const response = await client.embed({
  input: ["Braintrust traces all your AI calls."],
  model: "voyage-3-lite",
});

console.log(response.data?.[0]?.embedding?.length);

node --import braintrust/hook.mjs trace-voyageai-auto.js

​

Manual instrumentation

import { initLogger, wrapVoyageAI } from "braintrust";
import { VoyageAIClient } from "voyageai";

initLogger({
  projectName: "voyageai-example",
  apiKey: process.env.BRAINTRUST_API_KEY,
});

const client = wrapVoyageAI(
  new VoyageAIClient({
    apiKey: process.env.VOYAGE_API_KEY,
  }),
);

const response = await client.embed({
  input: ["Braintrust traces all your AI calls."],
  model: "voyage-3-lite",
});

console.log(response.data?.[0]?.embedding?.length);

​

What Braintrust traces

• Embedding spans (voyageai.embed): input texts and the model as metadata, output summarized as the number of returned embeddings, and token usage (prompt_tokens, tokens).
• Multimodal embedding spans (voyageai.multimodalEmbed): multimodal content (text, images, video) as input, output summarized as the number of returned embeddings, and token usage.
• Rerank spans (voyageai.rerank): query and documents as input, results as a list of {index, relevance_score} items (capped at 100), and request parameters (model, returnDocuments, topK, truncation) as metadata.
• Contextualized embedding spans (voyageai.contextualizedEmbed): inputs and model as metadata, output summarized as the total number of returned embeddings, and token usage.
• Response metadata (model name when returned by the API).
• Errors captured on every call.

​

Resources

• Voyage AI TypeScript SDK.
• Voyage AI API reference.