API Overview
Openference exposes a stable OpenAI-compatible surface plus direct Anthropic format for Claude. All requests require a validAuthorization: Bearer sk-token-... header (or legacy sk-user-).
Base URL
Core Endpoints
| Method & Path | Format | Description |
|---|---|---|
POST /chat/completions | OpenAI | Chat completions with streaming & tools |
POST /messages | Anthropic | Claude Messages API |
POST /responses | OpenAI | Responses API (used by Codex etc.) |
POST /embeddings | OpenAI | Text embeddings |
GET /models | OpenAI | List models available to the caller |
Format handling
- If the model route supports the client format natively, we pass through.
- Otherwise we automatically convert between OpenAI ↔ Anthropic ↔ Gemini.
Model names
Use the exact model ID returned byGET /v1/models (or shown on the website).
Some routes may map an alias to a specific upstream model ID.
Streaming
Add"stream": true (OpenAI) or the equivalent for Anthropic.
We forward SSE correctly.