> ## Documentation Index
> Fetch the complete documentation index at: https://portkey-docs-feature-comparison-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Nomic
> Use Nomic's superior embedding models through Portkey.
## Quick Start
Get started with Nomic in under 2 minutes:
```python Python icon="python" theme={null}
from portkey_ai import Portkey
# 1. Install: pip install portkey-ai
# 2. Add @nomic provider in model catalog
# 3. Use it:
portkey = Portkey(api_key="PORTKEY_API_KEY")
response = portkey.chat.completions.create(
model="@nomic/nomic-embed-text-v1.5",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)
```
```js Javascript icon="square-js" theme={null}
import Portkey from 'portkey-ai'
// 1. Install: npm install portkey-ai
// 2. Add @nomic provider in model catalog
// 3. Use it:
const portkey = new Portkey({
apiKey: "PORTKEY_API_KEY"
})
const response = await portkey.chat.completions.create({
model: "@nomic/nomic-embed-text-v1.5",
messages: [{ role: "user", content: "Hello!" }]
})
console.log(response.choices[0].message.content)
```
```python OpenAI Py icon="python" theme={null}
from openai import OpenAI
from portkey_ai import PORTKEY_GATEWAY_URL
# 1. Install: pip install openai portkey-ai
# 2. Add @nomic provider in model catalog
# 3. Use it:
client = OpenAI(
api_key="PORTKEY_API_KEY", # Portkey API key
base_url=PORTKEY_GATEWAY_URL
)
response = client.chat.completions.create(
model="@nomic/nomic-embed-text-v1.5",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)
```
```js OpenAI JS icon="square-js" theme={null}
import OpenAI from "openai"
import { PORTKEY_GATEWAY_URL } from "portkey-ai"
// 1. Install: npm install openai portkey-ai
// 2. Add @nomic provider in model catalog
// 3. Use it:
const client = new OpenAI({
apiKey: "PORTKEY_API_KEY", // Portkey API key
baseURL: PORTKEY_GATEWAY_URL
})
const response = await client.chat.completions.create({
model: "@nomic/nomic-embed-text-v1.5",
messages: [{ role: "user", content: "Hello!" }]
})
console.log(response.choices[0].message.content)
```
```bash cURL theme={null}
curl https://api.portkey.ai/v1/embeddings \
-H "Content-Type: application/json" \
-H "x-portkey-api-key: $PORTKEY_API_KEY" \
-H "x-portkey-provider: @nomic" \
-d '{
"model": "nomic-embed-text-v1.5",
"input": "create vector representation on this sentence"
}'
```
## Add Provider in Model Catalog
Before making requests, add Nomic to your Model Catalog:
1. Go to [**Model Catalog → Add Provider**](https://app.portkey.ai/model-catalog/providers)
2. Select **Nomic**
3. Enter your [Nomic API key](https://atlas.nomic.ai/)
4. Name your provider (e.g., `nomic`)
See all setup options and detailed configuration instructions
***
## Supported Models
Nomic is known for their high-quality embedding models:
| Model | Context Length | Description |
| --------------------- | -------------- | --------------------------------------- |
| nomic-embed-text-v1.5 | 8,192 tokens | Latest high-performance embedding model |
| nomic-embed-text-v1 | 8,192 tokens | Previous generation embedding model |
Check [Nomic's documentation](https://docs.nomic.ai/) for more details.
***
## Next Steps
Add fallbacks, load balancing, and more
Monitor and trace your Nomic requests
Cache embeddings for faster responses
Add custom metadata to requests
For complete SDK documentation:
Complete Portkey SDK documentation