Developers
Call Claude, GPT and Gemini from Python
Python is the most common language for AI work. Because Somnus speaks the OpenAI chat format, the official openai package works unchanged — you only set a different base URL.
Install
bash
pip install openaiBasic request
python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["SOMNUS_API_KEY"],
base_url="https://gateway-production-c837.up.railway.app/v1",
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[
{"role": "user", "content": "Explain recursion in one sentence."}
],
)
print(resp.choices[0].message.content)Streaming
python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["SOMNUS_API_KEY"],
base_url="https://gateway-production-c837.up.railway.app/v1",
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[
{"role": "system", "content": "You are a friendly, concise assistant."},
{"role": "user", "content": "Write a haiku about the sea."}
],
stream=True,
)
for chunk in resp:
print(chunk.choices[0].delta.content or "", end="")JSON output
python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["SOMNUS_API_KEY"],
base_url="https://gateway-production-c837.up.railway.app/v1",
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[
{"role": "system", "content": "Reply only with JSON."},
{"role": "user", "content": "Return {\"city\": ..., \"country\": ...} for the Eiffel Tower."}
],
response_format={"type": "json_object"},
)
print(resp.choices[0].message.content)Python notes
- Read the key from an environment variable, never hard-code it.
- Use the async client (AsyncOpenAI) for web servers.
- Works in notebooks, scripts, FastAPI and Django.
Questions
Which models can I use?
Any of the 50+ models on Somnus — change the model string. The examples use claude-sonnet-5.
Where do I get a key?
Create an account, and your key appears in the dashboard with $5 of free credit.
Run this code with free credit
Create an account and get $5 of free API credit — enough to try every example on this page.
Get $5 free creditRelated
Browse more: Alternatives · Compare · Use cases · Developers · Solutions · Tools