Channels on CobabaAi
A channel connects CobabaAi to one upstream provider (API key, base URL, models).
Add a channel (admin)
- Console → Channels → Add
- Choose provider type (OpenAI, Claude, Gemini, Azure, …)
- Enter credentials and optional custom base URL
- Assign models and set weight / priority
- Enable the channel
Request flow
For POST /v1/chat/completions:
- Resolve the requested model name
- Pick eligible channels by priority
- Distribute load by weight
- 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
/v1root - 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.