Sociaro AI Gateway

The Sociaro gateway is a single entry point to multiple AI providers — OpenAI, Anthropic, Alibaba (DashScope), BytePlus, MuleRouter and more — with one API key, unified usage analytics, cost attribution, budgets and rate limits managed for you.

Base URL: https://api.sociaro.com

How it works

You call the provider’s native API, just with a different host and your gateway key. The gateway is byte-transparent: request and response bodies are forwarded unmodified (including SSE streaming), so every provider SDK, cookbook example and API reference works as-is.

https://api.openai.com/v1/chat/completions
        ↓ becomes ↓
https://api.sociaro.com/openai/v1/chat/completions

The gateway:

1. authenticates your gw_live_… key and checks it is allowed to use the requested model;
2. swaps in the real provider credential server-side — you never handle provider keys;
3. forwards the request and streams the response back byte-for-byte;
4. meters usage and cost in the background (never on your request path).

Quickstart

Get a key from your organization admin (or the dashboard), then:

curl https://api.sociaro.com/openai/v1/chat/completions \
  -H "Authorization: Bearer gw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Anthropic uses its native header, exactly like the upstream API:

curl https://api.sociaro.com/anthropic/v1/messages \
  -H "x-api-key: gw_live_..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-latest",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Or use the Python SDK:

from sociaro import Sociaro

client = Sociaro(api_key="gw_live_...")
response = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

Using official provider SDKs

Because the proxy is byte-transparent, official SDKs work by overriding the base URL and key:

# OpenAI SDK
from openai import OpenAI
client = OpenAI(api_key="gw_live_...", base_url="https://api.sociaro.com/openai/v1")

# Anthropic SDK
from anthropic import Anthropic
client = Anthropic(api_key="gw_live_...", base_url="https://api.sociaro.com/anthropic")

What you get on top

• One key, many providers — authentication & scopes
• Usage & cost analytics — per provider, model, day, or your own attribution tags; see GET /gw/stats
• Async media jobs (video/image/3d) with accurate cost finalization — async jobs
• Self-service key management — issue and revoke keys for your team without contacting support — api-reference
• Budgets and rate limits — predictable spend; clear 402 / 429 error contract

Dashboard

A read-only web dashboard with usage charts, key management and async-job status is available for your organization. Ask your admin for access.