/v1/route

Request

POST /v1/route
Content-Type: application/json

Body

{
  "prompt": "Write a Python function to sort a list",
  "mode": "balanced"
}

Parameters

Parameter	Type	Required	Description
prompt	string	Yes	The prompt to route
mode	string	No	cheap, balanced, or accurate

Response

{
  "mode": "balanced",
  "candidates": [
    {
      "id": "gpt-4o-mini",
      "provider": "openai",
      "quality_score": 0.85,
      "cost_score": 0.92,
      "objective": 0.88
    },
    {
      "id": "claude-sonnet-4-20250514",
      "provider": "anthropic",
      "quality_score": 0.95,
      "cost_score": 0.15,
      "objective": 0.62
    }
  ]
}

Use Cases

• Debug routing - See why a model was picked
• Tune parameters - Compare different modes
• Build dashboards - Show routing decisions in real-time
• A/B testing - Compare model selections