# Calling a Standard Vault over the API

Once your Standard Vault is set up in the Model Vault app, use the **Vault endpoint URL** and **model
name** shown in the model card (see [Managing Vaults](/guides/model-vault-managing-vaults)) in your API
calls. You authenticate with your Cohere API key.

You can call a Standard Vault three ways: the **Cohere SDK**, **raw HTTP**, or an **OpenAI-compatible**
client. In every case you point the request directly at your vault endpoint instead of the default
Cohere API base URL.

:::callout{intent="note"}
This page covers **Standard Vaults**, where clients connect directly to the vault endpoint. An
**Encrypted Vault** uses the same request and response shapes, but traffic must go through an
attestation-verifying client or proxy. See
[Calling an Encrypted Vault over the API](/guides/model-vault-encrypted-api-usage).
:::

## Cohere SDK

Point the Cohere SDK at your vault endpoint with `base_url`:

```python PYTHON
import cohere

co = cohere.ClientV2(
    api_key="<COHERE_API_KEY>",
    base_url="<YOUR_VAULT_ENDPOINT_URL>",
)

response = co.chat(
    model="<YOUR_VAULT_MODEL_NAME>",
    messages=[{"role": "user", "content": "Hello from Model Vault!"}],
)

print(response.message.content[0].text)
```

## Raw HTTP

If you don't use the SDK, call the vault endpoint directly over HTTP. Send your API key as a bearer
token and use the same request body as the Cohere API:

```bash cURL
curl "<YOUR_VAULT_ENDPOINT_URL>/v2/chat" \
  -H "Authorization: bearer <COHERE_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<YOUR_VAULT_MODEL_NAME>",
    "messages": [{"role": "user", "content": "Hello from Model Vault!"}]
  }'
```

## OpenAI-compatible API

For existing OpenAI integrations, point an OpenAI-compatible client at your vault's compatibility base
URL (`<YOUR_VAULT_ENDPOINT_URL>/compatibility/v1`) and use your Cohere API key:

```python PYTHON
from openai import OpenAI

client = OpenAI(
    api_key="<COHERE_API_KEY>",
    base_url="<YOUR_VAULT_ENDPOINT_URL>/compatibility/v1",
)

response = client.chat.completions.create(
    model="<YOUR_VAULT_MODEL_NAME>",
    messages=[{"role": "user", "content": "Hello from Model Vault!"}],
)

print(response.choices[0].message.content)
```

## Chat, Embed, and Rerank

The chat example above points the SDK at your vault. Embed and Rerank requests work the same way:
keep the `base_url` pointed at your vault endpoint and call `co.embed(...)` or `co.rerank(...)` with
your vault's model name.

## Next steps

- [Calling an Encrypted Vault over the API](/guides/model-vault-encrypted-api-usage)
- [Managing Vaults](/guides/model-vault-managing-vaults)
- [Monitoring](/guides/model-vault-monitoring)

## Related pages

- [Standard Vault Overview](./model-vault-standard-overview.md)
- [Supported Models](./model-vault-standard-supported-models.md)
- [Standard Vault Pricing](./model-vault-standard-pricing.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.