Voyage Embedding Models for RAG
Voyage 4 family, asymmetric query/document modes, shared space and honest limits.
Voyage’s embedding models are strongest when retrieval quality, long context, and query-versus-document tuning matter more than zero-ops convenience. Voyage AI’s text embeddings documentation (docs.voyageai.com, captured September 2026) lists the current 4-series family with 32,000-token context windows, selectable output dimensions of 256, 512, 1024 (default), or 2048, and a stated rule that all embeddings created with the 4 series are compatible with each other. That shared space can remove one of the ugliest migration costs in retrieval systems: a full re-index when you switch models inside that family. The parent map sits at embedding models for retrieval.
What are Voyage embedding models, and what makes them distinctive for RAG?
Voyage provides hosted text embedding models built for retrieval, including general-purpose, latency-optimized, code, finance, and legal variants, plus an open-weight voyage-4-nano model on Hugging Face. In a RAG stack, that matters because the embedder decides what the index can find before the vector database ever searches it. Voyage’s September 2026 docs repeat the same core shape: long context windows, retrieval-specific query versus document tuning through input_type, and configurable output dimensions on the current family.
The retrieval-specific angle is the real difference. Voyage does not frame embeddings as a generic text-to-vector utility alone. Its docs expose input_type for query versus document, keep 32,000-token context on the current general and code rows, and keep a 16,000-token window on voyage-law-2. Stores such as Weaviate, Pinecone, Qdrant and Milvus then search those vectors; they do not invent a different geometry. Concept background sits at embeddings in RAG.
Which Voyage models are current, and when should you use each one?
Use voyage-4-large when you want maximum general and multilingual retrieval quality, voyage-4 when you want the balanced default, voyage-4-lite when latency and cost dominate, voyage-code-4 for code retrieval and coding-agent workloads, voyage-finance-2 for finance, and voyage-law-2 for legal retrieval. The open-weight voyage-4-nano is the row to inspect when local development or self-hosting matters more than a fully hosted API. Voyage’s docs still list older rows such as voyage-code-3 as accessible earlier models, and recommend the current models in that inventory for new work.
| Model | Context length | Published dimensions | Best fit in RAG |
|---|---|---|---|
| voyage-4-large | 32,000 tokens | 1024 default; also 256, 512, 2048 | Highest-quality general and multilingual retrieval on the current family |
| voyage-4 | 32,000 tokens | 1024 default; also 256, 512, 2048 | Balanced default when you want current-generation quality without the largest model |
| voyage-4-lite | 32,000 tokens | 1024 default; also 256, 512, 2048 | Latency-sensitive or cost-sensitive retrieval paths |
| voyage-code-4 | 32,000 tokens | 1024 default; also 256, 512, 2048 | Code search and coding-agent retrieval |
| voyage-finance-2 | 32,000 tokens | 1024 | Finance retrieval and finance-heavy RAG |
| voyage-law-2 | 16,000 tokens | 1024 | Legal retrieval and long-context legal RAG |
| voyage-4-nano | 32,000 tokens | 1024 default; also 256, 512, 2048 | Open-weight local development or self-hosted experimentation inside the Voyage 4 family |
The open-weight row still needs care because deployment surfaces can lag the main docs. Voyage’s September 2026 embeddings page lists voyage-4-nano with the same dimension choices and 4-series compatibility as the hosted siblings. Verify the live Hugging Face card and the API surface you will call before you freeze an index width. The broader provider-neutral chooser lives at how to choose an embedding model for RAG.
How do Voyage’s query and document modes change retrieval quality?
Voyage is an asymmetric retrieval encoder, so documents should be embedded as document and user questions as query. Voyage’s docs say the API automatically prepends retrieval prompts when input_type is set: Represent the query for retrieving supporting documents: for queries and Represent the document for retrieval: for documents. That is not cosmetic syntax. It is the contract that tells the model which side of retrieval it is encoding. Embeddings generated with and without input_type remain compatible per the same docs, but retrieval tasks should still set the role explicitly.
The effect shows up in measured docs-QA work. The LangChain Team’s November 2023 evaluation on a 6,522-document corpus with 50 gold query-answer pairs kept GPT-4 fixed as the generator and swapped only the embedding model. On their reported metrics, voyage-01 beat OpenAI’s text-embedding-ada-002 on retrieval quality (47.55 NDCG@10 versus 45.81) and on GPT-4-scored response quality (5.08 versus 4.34). Their fine-tuned voyage-langchain-01 rose further to 52.40 retrieval quality and 6.25 response quality. That is a narrower claim than “Voyage wins every benchmark,” but it is a useful one: retrieval-specific tuning changed answer quality in a real docs QA workload. The wider evaluation method belongs on RAG evaluation.
What does the shared Voyage 4 embedding space change operationally?
The shared embedding space across voyage-4-large, voyage-4, voyage-4-lite, and voyage-4-nano means you can switch among those models without rebuilding the entire vector index. Voyage’s docs state that all embeddings created with the 4 series are compatible with each other, and the open-model row for voyage-4-nano repeats that compatibility. Teams can index with a higher-fidelity 4-series model and serve some query paths with a faster or cheaper 4-series sibling because the vectors remain directly comparable.
That compatibility is not a universal escape hatch. It applies inside the Voyage 4 family, not across every Voyage model ever published. If you switch from a Voyage 4 model to an older 3.x model, or from a general model to a domain-specific family such as voyage-law-2, you still face the normal migration cost of re-embedding the corpus. That is why this feature matters: it removes one migration boundary, not all of them. The deeper re-embedding and migration problem lives at embedding drift and re-indexing.
What are Voyage’s capabilities and limits, side by side?
Voyage’s capabilities are real, but each comes with an engineering ceiling. Long context, asymmetric roles, shared 4-series geometry, flexible dimensions, domain variants and an open-weight path each buy something specific, and each carries a constraint you must plan for before the first production ingest.
| Capability | What you get | The limit that rides along |
|---|---|---|
| Long context on the current family | 32,000-token windows on the current general and code rows, plus 16,000 on voyage-law-2 | Long context does not make giant chunks retrieve well. You still have to test chunking on your own corpus. |
| Query-versus-document tuning | Asymmetric retrieval embeddings from the same endpoint via input_type | Wrappers that ignore the query/document distinction leave retrieval quality on the table. |
| Shared Voyage 4 space | Model swaps inside the 4-series without a full re-index | The compatibility boundary is the family itself. Older or domain-specific models still imply migration. |
| Flexible dimensions and output dtypes | 256, 512, 1024, or 2048 on flexible models, plus float, int8, uint8, binary, and ubinary output dtypes on the listed flexible set | Compression and smaller vectors save storage only if recall loss is acceptable on your own evaluation set. |
| Batch ceilings | Up to 1,000 texts per call, with model-specific total-token ceilings in the embed API | Bulk indexing still has throughput boundaries; Voyage docs list family-specific caps such as 1M, 320K, or 120K tokens per list depending on model. |
| Domain-specific models | Dedicated legal, finance, and code retrieval families | Those gains do not automatically transfer to a general corpus with different vocabulary. |
| Open-weight option | voyage-4-nano creates a local or self-hosted path inside the same family | Confirm the live model card and serving stack before pinning architecture. |
The matrix is easiest to trust when you tie it back to the primary docs. Voyage’s September 2026 embeddings reference publishes the dimension and dtype options, including binary and ubinary on the flexible models, and publishes the batch and total-token ceilings on the Python embed call. Those are operational limits, not marketing footnotes: a free-looking token allowance still fails if a single list exceeds the model’s token ceiling. Dimension mechanics beyond this profile live on embedding dimensions, truncation and Matryoshka.
How much do Voyage embeddings cost as of September 2026?
Voyage’s public token pricing should be verified on the live pricing surface before budgeting, because rates move. The MongoDB-hosted Voyage docs surface captured earlier in this project’s July 2026 teardown listed voyage-4-large at $0.12 per 1M tokens, voyage-4 at $0.06, voyage-4-lite at $0.02, voyage-code-3 at $0.18, and specialized voyage-finance-2 and voyage-law-2 rows at $0.12, with free-tier token allowances that differed between general and specialized rows. Treat those as that capture’s published figures, not as an independent audit of September 2026 list prices, and re-check Voyage’s current pricing page before you sign a budget.
The more important engineering fact is not the price table alone. It is where the bill compounds. Query embedding cost is often negligible compared with the cost of ingesting and re-ingesting the corpus. The expensive architecture mistake is rarely one extra query embedding. It is choosing a model family casually, then paying to re-embed millions of chunks after the fact. Whole-system cost planning belongs at what a RAG system costs to run.
When do Voyage’s domain-specific and custom embeddings outperform general models?
Voyage’s specialization shows up when retrieval has domain vocabulary that general models blur together. Harvey’s July 2024 legal case study is the clearest published proof in this cluster. Harvey and Voyage fine-tuned a legal retrieval model from voyage-law-2 on more than 20 billion tokens of US case law plus expert-annotated retrieval examples, and they report that the resulting voyage-law-2-harvey model reduced irrelevant material in top results by nearly 25 percent versus the next-best off-the-shelf models while using one-third of the embedding dimensionality. That combination matters because it improves retrieval while also lowering storage and latency pressure.
The narrower lesson is more durable than the legal example. Domain-specific Voyage models can win when the corpus contains terminology that a general embedder treats as semantically flat. LangChain’s 2023 docs-QA experiment showed the same pattern on a smaller scale: the fine-tuned voyage-langchain-01 beat general voyage-01, which itself beat OpenAI’s older general model, because the tuned model had seen the domain vocabulary. The boundary is just as important as the upside: if your corpus is not legal, finance, code, or another tight domain, benchmark the specialized model against a good general embedder before you assume the specialization transfers. The deeper adaptation playbook belongs on domain-specific embeddings and fine-tuning.
How does Voyage compare with OpenAI, Cohere, and open-weight embedding models?
Voyage is strongest when you want a hosted text-retrieval specialist with long context, asymmetric query/document tuning, and domain variants. OpenAI is usually the easiest text-only default. Cohere has a broader multimodal and multilingual deployment story on its current Embed lineup. Open-weight models are strongest when local control matters more than hosted convenience. API Scout’s 2026 comparison captures one broad benchmark surface without pretending it settles the decision: it lists voyage-3-large at 68.2 on MTEB, OpenAI text-embedding-3-large at 64.6, and text-embedding-3-small at 62.3, then warns that chunking and retrieval design usually matter more in practice than a small leaderboard gap.
The honest summary is narrower than a ranked-list headline. Choose Voyage when retrieval quality itself is the product problem and you value long context, model-role tuning, and domain variants from one family. Choose OpenAI’s embedding models when you want the simplest hosted default for text RAG. Choose Cohere’s embedding models when multimodal or very broad multilingual deployment is the deciding factor. Choose the open-source comparison when self-hosting and privacy dominate, and use embedding model selection for RAG when you are not yet sure whether this profile’s strengths match your workload.
How do Voyage embeddings fit with Weaviate and other vector stores?
Voyage embeddings fit with Weaviate and other vector stores as the encoder that produces the floats those stores index and search. Weaviate can store Voyage vectors and run near-vector or hybrid search over them; the store still expects a consistent width and a consistent model family inside one collection. Mixing Voyage 4 vectors with an older family, or mixing truncated widths without a planned cutover, breaks neighbour order the same way it would with any other provider.
Keep input_type correct on both ingest and query paths when you wire Voyage through any client, including framework wrappers. A Weaviate-first stack does not erase Voyage’s asymmetric contract. Print a small probe set of gold queries after the first index build, and again after any model or dimension change, before you trust production traffic.
Voyage is a hosted retrieval specialist: long context, asymmetric query and document roles, domain variants, and a shared Voyage 4 embedding space that can skip a full re-index inside that family. Voyage AI’s September 2026 docs own the current model table, including voyage-code-4 and voyage-4-nano, the default 1024-dimension flexible set, and the batch ceilings on the embed API. The honest limits are family-boundary migration, domain transfer that must be measured, compression recall trade-offs, and pricing that should be re-checked live. Choose Voyage when those strengths match the retrieval job; otherwise leave for the sibling profiles or the neutral selection page.
Voyage embedding models fit RAG when long context, asymmetric query and document modes, domain variants and a shared Voyage 4 embedding space matter more than a generic hosted default. Pricing and context figures above come from Voyage and MongoDB-hosted Voyage docs as of the July 2026 capture, with family boundaries still requiring re-embedding outside that series. Measure recall on your corpus, compare neighbouring profiles for OpenAI, Cohere and open-source models, and keep Weaviate as the default vector-store example when the retrieval stack is named beside the embedder.
- Cohere embeddings
- BGE and open-source embeddings
- OpenAI embeddings
- Voyage embeddings