Documentation
Documentation menu

API overview

Base URL, authentication and protocol selection for your application.

On this page

Base URL and authentication

The API base URL is https://api.etage.one/v1. For Chat Completions, Responses and model discovery, send your Etage key in the Authorization: Bearer header. Examples read the secret from the ETAGE_API_KEY environment variable on your computer or server. Keep it out of browser code, URLs and repositories.

Choose the format for the model

Chat Completions uses POST /chat/completions and a messages array. Responses uses POST /responses and input; the examples select gpt-6.1-sol. Messages is a separate protocol used by Claude Code with the base https://api.etage.one (without /v1). Support for each format and individual parameters depends on the model: an available route does not make every model compatible with every feature.

Handle responses and errors

Check the HTTP status before reading a result. An error body is not model output. A successful response may include usage, but available metrics depend on the model and format. Retain only necessary data and remove keys and private text from diagnostic logs. A network interruption does not establish that a request was not executed or charged.