API reference

Responses

OpenAI's Responses API, used by Codex and the newer OpenAI SDK features.

POSThttps://sov.solibra.ai/v1/responses

Request

The body is OpenAI's Responses request: model, input, instructions, tools, reasoning, stream and the rest. Send your Sovereign key as Authorization: Bearer.

curl https://sov.solibra.ai/v1/responses \
  -H "Authorization: Bearer $SOV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6.1-sol", "input": "What is a gateway?"}'

Response

A Responses API response, or a stream of its events with "stream": true. The x-sov-model header names the model that answered.

Stored conversations

With previous_response_id or conversation, the earlier turns are held by OpenAI, so the request stays on OpenAI's models. Send the whole input yourself to let Sovereign choose among every model.

What Sovereign adjusts

Field When What happens
model always Set to the model chosen for the request.
reasoning.effort the chosen model reasons Set to the effort the request needs.