> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinecone.io/llms.txt
> Use this file to discover all available pages before exploring further.

# voyage-law-2

> Voyage AI's voyage-law-2 makes 1024-dimension embeddings for legal text. Generate vectors with Voyage AI's API, then upsert them to a Pinecone index.

[Back to all models](https://docs.pinecone.io/models/overview.md)

![Voyage AI](https://cdn.sanity.io/images/vr8gru94/production/f2bce9e78e611fb34bf845928f6ede4cc377a8a5-100x100.png)

# voyage-law-2

Voyage AI

Bring your own vectors

Specifications

<dl />

## When to use it

Optimized for **legal** retrieval and RAG. See [blog post](https://blog.voyageai.com/2024/04/15/domain-specific-embeddings-and-retrieval-legal-edition-voyage-law-2/) for details. Visit the [Voyage documentation](https://docs.voyageai.com/docs/embeddings) for an overview of all Voyage embedding models and rerankers.

## Quickstart

### Installation

```python theme={null}
!pip install -qU voyageai pinecone
```

### Create index

```python theme={null}
from pinecone import Pinecone, ServerlessSpec

pc = Pinecone(api_key="API_KEY")

# Create Index
index_name = "voyage-law-2"

if not pc.has_index(index_name):
    pc.create_index(
        name=index_name,
        dimension=1024,
        metric="cosine",
        spec=ServerlessSpec(
            cloud="aws",
            region="us-east-1"
        )
    )

index = pc.Index(index_name)
```

### Embed & upsert

```python theme={null}
# Embed data
data = [
    {"id": "vec1", "text": "The plaintiff alleges breach of contract and seeks damages for financial losses incurred."},
    {"id": "vec2", "text": "This Agreement shall commence on the Effective Date and remain in force unless terminated earlier."},
    {"id": "vec3", "text": "Apple Inc. is named in a class-action lawsuit alleging monopolistic practices in its App Store policies."},
    {"id": "vec4", "text": "All disputes arising under this Agreement shall be resolved through binding arbitration in accordance with applicable laws."},
    {"id": "vec5", "text": "The parties hereby agree to maintain confidentiality regarding any proprietary information shared."},
]

import voyageai

vo = voyageai.Client(api_key=VOYAGE_API_KEY)

model_id = "voyage-law-2"

def embed(docs: list[str], input_type: str) -> list[list[float]]:
    embeddings = vo.embed(
		    docs,
		    model=model_id,
		    input_type=input_type
		).embeddings
    return embeddings

# Use "document" input type for documents
embeddings = embed([d["text"] for d in data], input_type="document")

vectors = []
for d, e in zip(data, embeddings):
    vectors.append({
        "id": d['id'],
        "values": e,
        "metadata": {'text': d['text']}
    })

index.upsert(
    vectors=vectors,
    namespace="ns1"
)
```

### Query

```python theme={null}
query = "Tell me about the tech company known as Apple"

# Use "query" input type for queries
x = embed([query], input_type="query")

results = index.query(
    namespace="ns1",
    vector=x[0],
    top_k=3,
    include_values=False,
    include_metadata=True
)

print(results)
```

## Good to know

To generate vectors, use Voyage AI's Python client with a Voyage AI API key. [Register](https://dash.voyageai.com/) to get one.
