Skip to content

Channels on CobabaAi

A channel connects CobabaAi to one upstream provider (API key, base URL, models).

Add a channel (admin)

  1. Console → Channels → Add
  2. Choose provider type (OpenAI, Claude, Gemini, Azure, …)
  3. Enter credentials and optional custom base URL
  4. Assign models and set weight / priority
  5. Enable the channel

Request flow

For POST /v1/chat/completions:

  1. Resolve the requested model name
  2. Pick eligible channels by priority
  3. Distribute load by weight
  4. Fail over to the next channel when configured

Best practices

  • Separate channels per upstream account
  • Use a low-quota channel for staging
  • Use clear model names for operators and customers
  • Monitor Console → Logs for 429/5xx by channel

Custom OpenAI-compatible upstream

  • Type: OpenAI
  • Base URL: upstream /v1 root
  • API key: as required

Compliance

Connect only providers and keys you are allowed to use. CobabaAi logs traffic for operations; it does not grant rights to bypass upstream terms of service.

CobabaAi — AI model gateway