OpenAI-Compatible

Endpoints, authentication, tools, streaming, and examples for Sovereign's OpenAI-compatible API.

Base URL:

https://api.sovrun.one/v1

Authentication

Authorization: Bearer sk-sov-live_<key_id>_<secret>

Endpoints

GET  /models
POST /chat/completions
POST /responses
GET  /status
GET  /healthz
GET  /readyz

Model

Use:

sovereign-alpha

Chat Completions

curl https://api.sovrun.one/v1/chat/completions \
  -H "Authorization: Bearer sk-sov-live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sovereign-alpha",
    "messages": [
      {
        "role": "user",
        "content": "Create a concise checklist for reviewing firewall ACL changes."
      }
    ]
  }'

Responses API

curl https://api.sovrun.one/v1/responses \
  -H "Authorization: Bearer sk-sov-live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sovereign-alpha",
    "input": "Explain the risk of exposed admin panels in a production network."
  }'

Streaming

Set stream to true.

Sovereign returns OpenAI-style server-sent events. It also emits a final usage block when the upstream provider provides one.

Tool Calls

Supported fields include:

tools
tool_choice
parallel_tool_calls
legacy functions
legacy function_call

Tool execution remains the client's responsibility.

Unsupported Inputs

Image inputs are rejected on this surface.

{
  "error": {
    "message": "unsupported_image_input",
    "type": "invalid_request_error",
    "code": "unsupported_image_input"
  }
}

Errors

Errors follow the OpenAI-style shape:

{
  "error": {
    "message": "insufficient_credits",
    "type": "invalid_request_error",
    "param": null,
    "code": "insufficient_credits"
  }
}

OpenAI-Compatible

On this page