Skip to content
Catalyst Docs

Services

Services in Catalyst represent AI provider endpoints. Configure services to connect to OpenAI, Anthropic Claude, or custom AI providers.

What is a Service?

Section titled “What is a Service?”

A service defines the connection to an AI provider’s API:

  • API Endpoint - The URL where requests are sent
  • API Key - Authentication credentials
  • Provider Type - OpenAI, Claude, or custom

Models are then linked to services to define which endpoint they use.

Default Service

Section titled “Default Service”

Catalyst includes a default VooV service that provides access to basic AI capabilities without configuration.

Adding a Service

Section titled “Adding a Service”
  1. Navigate to Services from the sidebar menu
  2. Click Add Service
  3. Fill in the details:
    • Name - A friendly name for the service
    • Provider - Select OpenAI, Claude, or Custom
    • API Endpoint - The base URL for API requests
    • API Key - Your API key from the provider

OpenAI Service

Section titled “OpenAI Service”

For OpenAI:

Claude Service

Section titled “Claude Service”

For Anthropic Claude:

Custom Service

Section titled “Custom Service”

For OpenAI-compatible providers (like local LLMs, Azure OpenAI, etc.):

  • Endpoint: Your provider’s API URL
  • API Key: As required by your provider

Linking Models to Services

Section titled “Linking Models to Services”

After creating a service, you can import or create models that use it:

  1. Go to Models
  2. When adding a model, select your service from the dropdown
  3. The model will use the service’s endpoint and credentials

Proxy Support

Section titled “Proxy Support”

Catalyst can proxy API requests through its backend for:

  • Secure key handling (keys not exposed to browser)
  • Request logging and monitoring
  • Rate limiting

This is configured automatically when using certain service types.

Managing API Keys

Section titled “Managing API Keys”
  • API keys are encrypted before storage
  • Keys are never exposed in the browser
  • Rotate keys regularly for security
  • Delete unused services to remove stored keys

Troubleshooting

Section titled “Troubleshooting”

Authentication Failed

Section titled “Authentication Failed”
  • Verify your API key is correct
  • Check the key has not expired
  • Ensure the key has required permissions

Connection Errors

Section titled “Connection Errors”
  • Verify the endpoint URL is correct
  • Check your network allows outbound HTTPS
  • For custom endpoints, verify the service is running

Model Not Working

Section titled “Model Not Working”
  • Confirm the model is linked to the correct service
  • Verify the service endpoint supports the model
  • Check API rate limits haven’t been exceeded