API Reference

Base URL: https://api.capless.ai/v1 · Auth: Authorization: Bearer cap_…

POST /v1/chat/completions

OpenAI-compatible. Supported params: model, messages, stream, max_tokens, temperature, top_p, tools, tool_choice, stop.

Streaming: standard SSE (data: {...} … data: [DONE]). Tool calling: OpenAI format (structured tool_calls).

GET /v1/models

Available models (requires auth).

Usage headers

X-Capless-Remaining-Window, X-Capless-Window-Reset-At, X-Capless-Remaining-Month, X-Capless-Month-Reset-At.

Errors

HTTP	code	Meaning
401	invalid_api_key	Invalid or disabled key
403	trial_expired	7-day trial ended — re-activate in the dashboard
400	context_too_large	Prompt exceeds your plan's context
429	capless_window_limit	4h rolling window exhausted (includes Retry-After)
429	capless_month_limit	Monthly quota exhausted
429	capless_concurrency_limit	More concurrent requests than your plan allows
501	not_implemented	Roadmap endpoint (embeddings)