Skip to content

onedotnet/soxai-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

SoxAI Python SDK

The official Python client for SoxAI — a unified AI API gateway that gives you access to 200+ AI models from 40+ providers through a single OpenAI-compatible API.

Installation

pip install soxai

Quick Start

from soxai import SoxAI

client = SoxAI(api_key="sox-your-key")

# Use any model from any provider — same SDK
response = client.chat.completions.create(
    model="claude-sonnet-4-6",  # or gpt-4o, gemini-2.5-flash, deepseek-chat, ...
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

Why SoxAI?

  • One API key for OpenAI, Anthropic, Google, DeepSeek, Meta, and 35+ more providers
  • Automatic failover — if one provider goes down, requests route to another
  • Team management — per-developer API keys with spending limits
  • Compatible with Claude Code, Codex CLI, Gemini CLI — just set ANTHROPIC_BASE_URL
  • Free $5 credit to start, no credit card required

Examples

Streaming

from soxai import SoxAI

client = SoxAI(api_key="sox-your-key")

stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Write a haiku about APIs."}],
    stream=True,
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

Multi-Model Comparison

from soxai import SoxAI

client = SoxAI(api_key="sox-your-key")

models = ["gpt-4o-mini", "claude-sonnet-4-6", "gemini-2.5-flash", "deepseek-chat"]
prompt = "Explain the CAP theorem in one sentence."

for model in models:
    r = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": prompt}],
    )
    print(f"{model}: {r.choices[0].message.content}")

Image Generation

from soxai import SoxAI

client = SoxAI(api_key="sox-your-key")

response = client.images.generate(
    model="dall-e-3",
    prompt="A futuristic API gateway, digital art",
    size="1024x1024",
)
print(response.data[0].url)

Environment Variable

export SOXAI_API_KEY="sox-your-key"
from soxai import SoxAI

client = SoxAI()  # reads from SOXAI_API_KEY

Using with Existing OpenAI Code

Already using the OpenAI SDK? You can also just change base_url:

from openai import OpenAI

client = OpenAI(
    api_key="sox-your-key",
    base_url="https://api.soxai.io/v1",
)
# Everything else stays the same

Links

License

MIT

About

SoxAI Python SDK — Access 200+ AI models through one OpenAI-compatible API

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages