API reference
Endpoints, headers and what's supported.
Base URL: https://api.gethephaestus.com. The API mirrors Anthropic's, so Anthropic's own Messages API docs are the full reference for request and response fields. This page covers what is specific to Hephaestus.
Endpoints
| Method | Path | Notes |
|---|---|---|
| POST | /v1/messages | Create a message. Streaming and non-streaming. Billed per token. |
| POST | /v1/messages/count_tokens | Count tokens before sending. Free. |
| GET | /v1/models | List the available model IDs. |
Headers
| Header | Required | |
|---|---|---|
| x-api-key | one of | Your hph_live_ key. |
| Authorization | one of | Bearer hph_live_… |
| anthropic-version | recommended | Defaults to 2023-06-01. |
| anthropic-beta | optional | Passed through unchanged for beta features. |
| content-type | yes | application/json |
Not available
- Batches API, Files API and Skills: not offered.
- Fast mode (
speed: "fast"): returns 400. - Code execution tool (
code_execution_*): returns 400.
Everything else in the Messages API, including server-side web search and web fetch, works.
Response headers
request-id is passed through. Quote it if you contact support about a specific request.
Errors
Errors use Anthropic's format so SDKs parse them natively. See Errors.