API Reference

from openai import OpenAI

client = OpenAI(
    base_url="https://api.thermly.net/v1",  # ← Add this
    api_key="sk-thermo-your-key-here",      # ← Your Thermly key
)

response = client.chat.completions.create(
    model="auto",  # Thermly picks the cheapest adequate model
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

Authorization: Bearer sk-thermo-your-key-here

{
  "id": "thermo-a1b2c3d4e5f6",
  "object": "chat.completion",
  "created": 1709000000,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 8,
    "total_tokens": 20
  },
  "x_thermostat": {
    "actual_model": "gpt-4o-mini",
    "complexity_level": 1,
    "cached": false
  }
}

from openai import OpenAI

client = OpenAI(
    base_url="https://api.thermly.net/v1",
    api_key="sk-thermo-your-key-here",
)

# Smart routing - Thermly picks the best model
response = client.chat.completions.create(
    model="auto",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain how DNS works."},
    ],
)
print(response.choices[0].message.content)

# Direct model - specify exactly which model to use
response = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Write a haiku about coding."}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.thermly.net/v1",
  apiKey: "sk-thermo-your-key-here",
});

const response = await client.chat.completions.create({
  model: "auto",
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(response.choices[0].message.content);

curl https://api.thermly.net/v1/chat/completions \
  -H "Authorization: Bearer sk-thermo-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

{
  "error": {
    "message": "Human-readable error description",
    "type": "error_type",
    "code": "error_code"
  }
}