API Keys

import catsu

client = catsu.Client()

# Override API key for this specific request
response = client.embed(
    model="voyage-3",
    input="Text",
    api_key="custom-voyage-key"
)

# Use different API keys for different requests
response1 = client.embed(
    model="voyage-3",
    input="Text for user A",
    api_key="user-a-voyage-key"
)

response2 = client.embed(
    model="voyage-3",
    input="Text for user B",
    api_key="user-b-voyage-key"
)

def embed_for_user(user_id: str, text: str):
    # Fetch user's API key from database
    user_api_key = get_user_api_key(user_id)

    client = catsu.Client()
    return client.embed(
        model="voyage-3",
        input=text,
        api_key=user_api_key  # User's own key
    )

api_keys = ["key1", "key2", "key3"]
current_key_index = 0

def embed_with_rotation(text: str):
    global current_key_index

    try:
        response = client.embed(
            model="voyage-3",
            input=text,
            api_key=api_keys[current_key_index]
        )
        return response
    except RateLimitError:
        # Rotate to next key
        current_key_index = (current_key_index + 1) % len(api_keys)
        return embed_with_rotation(text)

# Production key
prod_client = catsu.Client()

# Test with development key
test_response = prod_client.embed(
    model="voyage-3",
    input="Test embedding",
    api_key="dev-api-key"
)

import os

# Environment variable
os.environ["VOYAGE_API_KEY"] = "env-key"

# Client-level keys
client = catsu.Client(
    api_keys={"voyageai": "client-key"}
)

# Request uses "request-key" (highest priority)
response = client.embed(
    model="voyage-3",
    input="Text",
    api_key="request-key"
)

# Request uses "client-key" (no request-level override)
response = client.embed(
    model="voyage-3",
    input="Text"
)

# ❌ Bad: Hardcoded keys
response = client.embed(
    model="voyage-3",
    input="Text",
    api_key="sk-1234567890"  # Never do this!
)

# ✅ Good: Load from environment or secure storage
import os
response = client.embed(
    model="voyage-3",
    input="Text",
    api_key=os.getenv("VOYAGE_API_KEY")
)

# Load keys from secure vault/secrets manager
from your_secrets_manager import get_secret

api_key = get_secret("voyage_api_key")

response = client.embed(
    model="voyage-3",
    input="Text",
    api_key=api_key
)

# Voyage AI
client.embed(model="voyage-3", input="Text", api_key="voyage-key")

# OpenAI
client.embed(model="text-embedding-3-small", input="Text", api_key="openai-key")

# Cohere
client.embed(model="embed-v4.0", input="Text", api_key="cohere-key")

# Works for all 11 providers