Python SDK

pip install openai

from openai import OpenAI
 
client = OpenAI(
    api_key="sk-...",
    base_url="https://sovereigneg.com/v1"
)

export OPENAI_API_KEY=sk-...
export OPENAI_BASE_URL=https://sovereigneg.com/v1

from openai import OpenAI
client = OpenAI()  # reads from env vars

response = client.chat.completions.create(
    model="...",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ],
    temperature=0.7,
    max_tokens=256,
)
 
print(response.choices[0].message.content)

stream = client.chat.completions.create(
    model="...",
    messages=[{"role": "user", "content": "Write a haiku"}],
    stream=True,
)
 
for chunk in stream:
    content = chunk.choices[0].delta.content or ""
    print(content, end="", flush=True)

from openai import AsyncOpenAI
import asyncio
 
async_client = AsyncOpenAI(
    api_key="sk-...",
    base_url="https://sovereigneg.com/v1"
)
 
async def main():
    response = await async_client.chat.completions.create(
        model="...",
        messages=[{"role": "user", "content": "Hello"}],
    )
    print(response.choices[0].message.content)
 
asyncio.run(main())

response = client.embeddings.create(
    model="..."  # live embed id,
    input="Hello from Cairo!"
)
 
print(f"Dimensions: {len(response.data[0].embedding)}")

response = client.chat.completions.create(
    model="...",
    messages=[{"role": "user", "content": "What's the weather in Cairo?"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get weather for a city",
            "parameters": {
                "type": "object",
                "properties": {"city": {"type": "string"}},
                "required": ["city"]
            }
        }
    }]
)

from openai import APIError, RateLimitError, AuthenticationError
 
try:
    response = client.chat.completions.create(...)
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    retry_after = e.response.headers.get("Retry-After", 60)
    print(f"Rate limited. Retry after {retry_after}s")
except APIError as e:
    print(f"API error: {e.message}")

from langchain_openai import ChatOpenAI
 
llm = ChatOpenAI(
    model="...",
    api_key="sk-...",
    base_url="https://sovereigneg.com/v1"
)
 
response = llm.invoke("Hello from LangChain!")