Skip to main content
Astrolabe exposes:
  • GET /health
  • GET /v1/models
  • GET /v1/lanes
  • POST /v1/responses
  • POST /v1/chat/completions
/v1/responses is the primary endpoint. /v1/chat/completions is the compatibility endpoint.

​
Authentication

If ASTROLABE_API_KEY is set, send either:
  • Authorization: Bearer <ASTROLABE_API_KEY>
  • x-api-key: <ASTROLABE_API_KEY>
In production, Astrolabe refuses to start without ASTROLABE_API_KEY.

​
Response metadata

Astrolabe adds route headers such as:
  • x-astrolabe-category
  • x-astrolabe-lane
  • x-astrolabe-initial-model
  • x-astrolabe-final-model
Non-stream JSON responses also include inline Astrolabe metadata.