For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Resources
Log inGet a demo
GuidesAPI reference
GuidesAPI reference
    • Get Started
  • Features
    • Projects
    • Cost Governance and Savings
    • Context Compression
UnifiedAgent HandlerGateway
UnifiedAgent HandlerGateway
Resources
Log inGet a demo
On this page
  • Merge Gateway SDK
  • OpenAI SDK
  • Other SDKs
  • Next steps

Get started

Send your first request through Merge Gateway
Was this page helpful?
Next

Projects

Built with

Merge Gateway is a unified API for large language models. Route requests to OpenAI, Anthropic, Google, Azure, and AWS Bedrock through a single endpoint — with built-in failover, intelligent routing, cost optimization, and observability.

You’ll need a Merge Gateway API key. Get one from the Merge Gateway dashboard.

Merge Gateway SDK

1

Install the SDK

$pip install merge-gateway-sdk
2

Send a request

1from merge_gateway import MergeGateway
2
3client = MergeGateway(api_key="YOUR_API_KEY")
4
5response = client.responses.create(
6 model="openai/gpt-5.2",
7 input=[
8 {"type": "message", "role": "system", "content": "You are a helpful programming tutor. Explain the concepts clearly with practical examples."},
9 {"type": "message", "role": "user", "content": "Explain the concept of recursion in programming with a simple set of examples."},
10 ],
11)
12
13print(response.output[0].content[0].text)
3

Try a different model

Swap the model string to route to a different provider. No other code changes needed.

1response = client.responses.create(
2 model="anthropic/claude-sonnet-4-20250514",
3 input=[
4 {"type": "message", "role": "system", "content": "You are a helpful programming tutor. Explain the concepts clearly with practical examples."},
5 {"type": "message", "role": "user", "content": "Explain the concept of recursion in programming with a simple set of examples."},
6 ],
7)

OpenAI SDK

Already using the OpenAI SDK? Point it at Merge Gateway to get multi-provider routing without changing your application code.

1

Point to Gateway

1from openai import OpenAI
2
3client = OpenAI(
4 api_key="YOUR_API_KEY",
5 base_url="https://api-gateway.merge.dev/v1/openai",
6)
2

Send a request

Use the standard chat.completions.create method — no provider prefix needed on the model name.

1response = client.chat.completions.create(
2 model="gpt-5.2",
3 messages=[
4 {"role": "system", "content": "You are a helpful programming tutor. Explain the concepts clearly with practical examples."},
5 {"role": "user", "content": "Explain the concept of recursion in programming with a simple set of examples."},
6 ],
7)
8
9print(response.choices[0].message.content)

Other SDKs

Gateway is compatible with any SDK that lets you set a custom base URL.

SDKBase URL
OpenAIhttps://api-gateway.merge.dev/v1/openai
Anthropichttps://api-gateway.merge.dev/v1/anthropic
LangChainhttps://api-gateway.merge.dev/v1/openai
Anthropic SDK
1from anthropic import Anthropic
2
3client = Anthropic(
4 api_key="YOUR_API_KEY",
5 base_url="https://api-gateway.merge.dev/v1/anthropic",
6)
7
8message = client.messages.create(
9 model="claude-sonnet-4-20250514",
10 max_tokens=1024,
11 messages=[
12 {"role": "user", "content": "Explain the concept of recursion in programming with a simple set of examples."},
13 ],
14)
15
16print(message.content[0].text)

Next steps

Routing policies

Configure intelligent routing, failover, and cost optimization across providers.

Context compression

Automatically reduce token usage and avoid context window limits.

API reference

Explore the full Gateway API.