Introduction
Hyphen Developers
Hyphen is one key for every frontier model, behind one base URL.
Point any OpenAI- or Anthropic-compatible tool at the Hyphen gateway, drop in your key, and you are done. No juggling provider accounts, no per-provider billing, no surprise overage — just a short list of models and a monthly cap you control.
Code
One base URL, one key
Every endpoint — Chat Completions, Responses, Anthropic Messages, embeddings — is served from the same base URL and authenticated with the same key.
Why it works everywhere
Under the hood the gateway is an OpenAI-compatible proxy. It speaks three wire formats so your tools don't have to care what runs upstream:
| Endpoint | Wire format | Used by |
|---|---|---|
POST /v1/chat/completions | OpenAI Chat Completions | The default surface — OpenAI SDK, Cursor, Cline, Aider, Continue, Hermes |
POST /v1/responses | OpenAI Responses API | Codex CLI |
POST /v1/messages | Anthropic Messages API | Claude Code |
GET /v1/models | Model discovery | Any client |
POST /v1/embeddings | OpenAI Embeddings | RAG / search |
Because the gateway translates between these formats, a tool that only speaks the Responses API (Codex) or only speaks Anthropic Messages (Claude Code) can still reach the same upstream models as everything else.
The models
Hyphen serves four models. Reach for them by tier:
| Model | Reach for it when… |
|---|---|
m2.5 | Fast and cheap — high-volume, low-latency calls |
m2.7 | Balanced default for day-to-day agent work |
m3 | Strongest reasoning — hard refactors, deep planning |
text | Plain text completion |
Prefer a stable name? Three aliases map onto the models above and keep working
as the mapping is upgraded: hyphen-fast = m2.5, hyphen-sonnet = m2.7,
hyphen-opus = m3. Full detail on the Models page.
One key, one cap
Each key carries a monthly USD budget. When it is spent, requests return HTTP 429 with the reset date — nothing runs over budget by accident. Credits can extend a key past its cap. See Rate limits & caps.
Next steps
- Quickstart — get a key and make your first request in three steps.
- Models — the full model list and how to pick one.
- Connect your coding agent — Claude Code, Codex CLI, Hermes, OpenClaw, and more.
- API Reference — the full interactive spec.