POST /v1/openai/chat/completions
Raw HTTP gateway. JSON messages (not messages_json); stream=true returns SSE. The gateway owns metering and settlement.
The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.
Parameters
X-Nexus-Operation-Keyheader · string · required
Request body
modelstring · requiredmessagesarray · requiredstreambooleanmax_tokensintegermax_completion_tokensinteger
cURL
curl --request POST 'https://nexus-api.rainlib.com/v1/openai/chat/completions' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'X-Nexus-Operation-Key: <X-Nexus-Operation-Key>' \
--header 'Content-Type: application/json' \
--data '{
"model": "<published-route-alias>",
"messages": [
{
"role": "user",
"content": "<user-message>"
}
],
"stream": true
}'Response contract
200 · OpenAI-compatible JSON or text/event-stream; consume terminal SSE errors and usage.
—400 · Invalid request
—401 · Authentication required
—402 · Insufficient credit
—403 · Permission denied
—429 · Rate limited
—502 · Provider unavailable
—Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.