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 = client.responses.create(model="gpt-6.1-sol", input="What is a gateway?")
print(response.output_text)
const response = await client.responses.create({ model: "gpt-6.1-sol", input: "What is a gateway?" });
console.log(response.output_text);
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. |