Skip to main content
POST
Create a chat completion
POST /v1/chat/completions is the compatibility endpoint for clients that still use OpenAI Chat Completions. It uses the same Cloud auth, stack resolution, routing, billing, fallback, verification, and trace runtime as /v1/responses.

Prefer Responses for new clients

Use /v1/responses for new integrations when your client supports it. Keep Chat Completions for existing libraries and compatibility paths.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
messages
object[]
required
model
string
default:astrolabe/auto
stream
boolean
default:false
tools
object[]
tool_choice
any
response_format
any
metadata
object

Response

Successful JSON or streaming response.

id
string
object
string
created
integer
model
string
choices
object[]
usage
object
astrolabe
object