Portkey

Portkey is an AI Gateway that provides a unified interface to access multiple AI providers with advanced features like routing, load balancing, retries, and observability. Use Portkey to build production-ready AI applications with better reliability and cost optimization.

With Portkey, you can:

• Route requests across multiple AI providers
• Implement fallback mechanisms for better reliability
• Monitor and analyze your AI usage
• Cache responses for cost optimization
• Apply rate limiting and usage controls

Authentication

You need both a Portkey API key and a virtual key for model routing. Get them from Portkey here.

1export PORTKEY_API_KEY=***
2export PORTKEY_VIRTUAL_KEY=***

1setx PORTKEY_API_KEY ***
2setx PORTKEY_VIRTUAL_KEY ***

Example

Use Portkey with your Agent:

1from kern.agent import Agent
2from kern.models.portkey import Portkey
3
4agent = Agent(
5    model=Portkey(id="gpt-5-mini"),
6    markdown=True
7)
8
9# Print the response in the terminal
10agent.print_response("What is Portkey and why would I use it as an AI gateway?")

Advanced Configuration

You can configure Portkey with custom routing and retry policies:

1from kern.agent import Agent
2from kern.models.portkey import Portkey
3
4config = {
5    "strategy": {
6        "mode": "fallback"
7    },
8    "targets": [
9        {"virtual_key": "openai-key"},
10        {"virtual_key": "anthropic-key"}
11    ]
12}
13
14agent = Agent(
15    model=Portkey(
16        id="gpt-5-mini",
17        config=config,
18    ),
19)

Params

Portkey also supports the params of OpenAI.