Code Examples

curl -X POST https://api.tokenrouter.com/route \
  -H "Authorization: Bearer tr_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Explain quantum computing in simple terms",
    "temperature": 0.7,
    "max_tokens": 1000
  }'

import requests
import json

class TokenRouterClient:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = "https://api.tokenrouter.com"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }
    
    def route(self, prompt, **kwargs):
        data = {"prompt": prompt, **kwargs}
        response = requests.post(
            f"{self.base_url}/route",
            headers=self.headers,
            json=data
        )
        return response.json()
    
    def get_usage_stats(self, start_date=None, end_date=None):
        params = {}
        if start_date:
            params["start_date"] = start_date
        if end_date:
            params["end_date"] = end_date
            
        response = requests.get(
            f"{self.base_url}/analytics/usage",
            headers=self.headers,
            params=params
        )
        return response.json()

# Usage
client = TokenRouterClient("tr_your_api_key_here")

result = client.route(
    prompt="Analyze market trends for Q4 2024",
    model_preferences=["gpt-4", "claude-3-opus"],
    temperature=0.3,
    max_tokens=2000,
    cost_priority="quality"
)

print(f"Selected model: {result['tokenrouter']['selected_model']}")
print(f"Cost savings: {result['tokenrouter']['cost_savings']}")
print(f"Response: {result['choices'][0]['message']['content']}")

import requests
import json

def get_weather(location, unit="fahrenheit"):
    # Mock weather function
    return {
        "location": location,
        "temperature": 72 if unit == "fahrenheit" else 22,
        "condition": "sunny",
        "unit": unit
    }

def handle_function_calls(response):
    if response.get("choices", [{}])[0].get("message", {}).get("tool_calls"):
        tool_calls = response["choices"][0]["message"]["tool_calls"]
        
        for tool_call in tool_calls:
            function_name = tool_call["function"]["name"]
            function_args = json.loads(tool_call["function"]["arguments"])
            
            if function_name == "get_weather":
                result = get_weather(**function_args)
                print(f"Weather in {result['location']}: {result['temperature']}°{result['unit'][0].upper()}, {result['condition']}")

# Make the request
url = "https://api.tokenrouter.com/route"
headers = {
    "Authorization": "Bearer tr_your_api_key_here",
    "Content-Type": "application/json"
}
data = {
    "prompt": "What is the weather like in San Francisco and New York?",
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "get_weather",
                "description": "Get current weather for a location",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "location": {"type": "string", "description": "City name"},
                        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
                    },
                    "required": ["location"]
                }
            }
        }
    ],
    "tool_choice": "auto"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

# Handle function calls if present
handle_function_calls(result)