Overview

The Styrr Hosted API lets you use multi-model fallback routing from any language — Python, Go, Rust, curl — without installing the TypeScript package.

Endpoint

POST https://styrr.finoptix.dev/v1/chat/completions

Authentication

Pass your API key in the Authorization header:

Authorization: Bearer <your-styrr-api-key>

Request Body

{
  "models": [
    { "id": "nvidia/nemotron-3-ultra-550b:free" },
    { "id": "google/gemma-4-31b-it:free" }
  ],
  "messages": [
    { "role": "user", "content": "Hello!" }
  ],
  "tools": [
    {
      "name": "get_weather",
      "description": "Get weather for a city",
      "parameters": {
        "type": "object",
        "properties": { "city": { "type": "string" } }
      }
    }
  ]
}

Response

{
  "text": "Hi! How can I help you today?",
  "modelUsed": "nvidia/nemotron-3-ultra-550b:free",
  "latencyMs": 1234,
  "toolCalls": null
}

From Any Language

# curl
curl -X POST https://styrr.finoptix.dev/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "models": [{"id": "nvidia/nemotron-3-ultra-550b:free"}],
    "messages": [{"role": "user", "content": "Hello"}]
  }'

# Python
import requests
resp = requests.post(
    "https://styrr.finoptix.dev/v1/chat/completions",
    headers={"Authorization": f"Bearer {api_key}"},
    json={"models": [{"id": "..."}], "messages": [...]},
)
print(resp.json()["text"])