API Documentation

Everything you need to integrate API Coleen, manage your LLM spend, and configure alerts.

Quickstart

API Coleen acts as a drop-in reverse proxy for OpenAI, Anthropic, and Google Gemini. To get started, you simply change your API base URL to our proxy and use your API Coleen key instead of your provider key.

# Instead of https://api.openai.com/v1
BASE_URL=https://api.apicoleen.com/v1/proxy/openai

# Use your API Coleen project key
API_KEY=ac_test_123456789

Once connected, all your requests are automatically logged, cost-calculated, and displayed in your dashboard in real-time.

Rate Limits

To ensure stability and prevent abuse, API Coleen enforces a dynamic rate limit on proxy requests. Your rate limit is determined by your active billing plan.

PlanProxy Rate LimitIdeal For
Free60 req / minTesting & Hobby projects
Starter300 req / minEarly-stage startups
Growth1,000 req / minScaling applications
Professional3,000 req / minHigh-volume production

Handling 429 Errors

If you exceed your plan's rate limit, our API will return a 429 Too Many Requests status code. We recommend implementing exponential backoff in your application logic to handle these gracefully. If you consistently hit these limits, consider upgrading your plan in the Billing dashboard.

API Reference

API Coleen proxies requests transparently to the underlying providers. Supported providers include:

  • OpenAI: /api/proxy/openai
  • Anthropic: /api/proxy/anthropic
  • Google Gemini: /api/proxy/gemini
  • Groq: /api/proxy/groq
  • OpenRouter: /api/proxy/openrouter

Include the Authorization: Bearer <YOUR_API_COLEEN_KEY> header in your requests. The request body must perfectly match the target provider's schema.

Alerts & Webhooks

Never get caught by surprise bills again. API Coleen can notify you when your LLM spend reaches a certain threshold of your defined monthly budget.

Browser Push

Native OS notifications (Free for all users).

Email Alerts

Directly to your account email address.

Slack & Discord

Via webhook integrations.

Telegram

Instant messages to your Telegram chat.