curl --request POST \
--url https://api.astrolabe.run/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "astrolabe/auto",
"input": "Explain routing stacks in one sentence."
}
'{
"id": "<string>",
"object": "<string>",
"created": 123,
"status": "<string>",
"model": "<string>",
"output": [
{}
],
"usage": {},
"metadata": {}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}Gateway endpoints
Responses
Primary Astrolabe Cloud inference endpoint. Supports virtual models, concrete model IDs, routing stack selection, streaming, billing, and route traces.
POST
/
v1
/
responses
curl --request POST \
--url https://api.astrolabe.run/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "astrolabe/auto",
"input": "Explain routing stacks in one sentence."
}
'{
"id": "<string>",
"object": "<string>",
"created": 123,
"status": "<string>",
"model": "<string>",
"output": [
{}
],
"usage": {},
"metadata": {}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>",
"details": "<unknown>"
}
}POST /v1/responses is the recommended Astrolabe Cloud inference endpoint for new integrations.
It accepts OpenAI-style Responses payloads and adds Cloud routing, billing, stack policy, fallback, verification, and traceability.
Recommended request
{
"model": "astrolabe/auto",
"input": "Summarize this support conversation.",
"metadata": {
"astrolabe": {
"stack": "customer-data",
"quality": "high",
"verification": "auto"
}
}
}
Streaming
Setstream: true for server-sent events. Streaming responses still include Cloud request, stack, model, and rate-limit headers.
Billing
The gateway reserves prepaid balance before provider execution and finalizes the debit from provider usage where available.Authorizations
bearerAuthapiKeyAuth
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json