Is AIgateway a drop-in replacement for Portkey?

Yes if you're using Portkey's OpenAI-compatible surface. Change the base URL to https://api.aigateway.sh/v1 and swap the API key — every other line of code stays the same. Streaming format is unchanged.

Will my existing model slugs work?

Some slugs match exactly, others differ. Check /models for the AIgateway equivalent of each model you call. Portkey's naming convention → AIgateway uses provider/model.

How long does migration take?

60 seconds if you run `aig migrate portkey` (it scans your codebase and rewrites the patterns automatically). Test suite should be green immediately because the OpenAI surface is preserved.

Can I get a credit match for my Portkey invoice?

Yes — email your last Portkey invoice to switch@aigateway.sh and we match the credit (up to $1,000) within 24 hours. See /switch/portkey for details.

What's different about AIgateway's pricing?

5% per call (our entire revenue model) + payment-processor passthrough at top-up (Stripe's standard rate). No monthly fee, no seat fee, no per-model surcharge. Cached requests get a 50% discount. $5 free credits on signup, redeemable on a curated edge-tier shortlist (Kimi K2.6, FLUX-2 Klein, Whisper Turbo, Aura 2, Gemma 4 vision, BGE-M3, Llama Guard 3), valid for 7 days. Topups never expire and unlock the full catalog.

View as /docs.md

Migrate

Migrate from Portkey

Portkey-compatible gateway with 5% PAYG (no $49/mo flat), every modality (not just text), and a programmatic sub-account API instead of workspace-only keys.

CLI automation for Portkey is shipping: `aig migrate portkey` walks the working tree and rewrites every match.

TL;DR — three lines

# 1. set your AIgateway key
export AIGATEWAY_API_KEY="sk-aig-..."

# 2. change the base URL
base_url="https://api.aigateway.sh/v1"  # was https://api.portkey.ai/v1

# 3. aig migrate portkey     # or rewrite by hand

Automated: `aig migrate portkey`

Walks the current directory tree (ignoring node_modules, build outputs, lockfiles), shows you a preview of every change, and applies them after a y/N confirmation. Leaves *.aig-migrate.bak backups alongside each rewritten file unless you pass --no-backup.

# install once
npm i -g aigateway-cli

# preview without writing
aig migrate portkey --dry-run

# apply (with backups)
aig migrate portkey

# CI-friendly: skip the prompt
aig migrate portkey --yes --no-backup

What changes, line-by-line

The table below is what aig migrate portkey rewrites. If you're doing it by hand, do these in order.

Thing	Portkey	AIgateway
Base URL	https://api.portkey.ai/v1	https://api.aigateway.sh/v1
API key env var	PORTKEY_API_KEY	AIGATEWAY_API_KEY
Auth header	x-portkey-api-key	Authorization: Bearer …
Trace header	x-portkey-trace-id	x-aig-tag
Virtual key (vk_…)	Portkey virtual key	AIgateway sub-account key (sk-aig-…)
Config	x-portkey-config header	Routing rules in dashboard
Platform fee	$49/mo flat (Pro) or 5% per call (PAYG)	5% per call, no monthly fee
Per-user keys	Workspace-only	Sub-account API (programmatic)

Before / after — Python (OpenAI SDK)

BEFORE · Portkey

from openai import OpenAI

client = OpenAI(
    base_url="https://api.portkey.ai/v1",
    api_key=os.environ["PORTKEY_API_KEY"],
)
r = client.chat.completions.create(
    model="anthropic/claude-opus-4.7",
    messages=[{"role": "user", "content": "Hi"}],
)

AFTER · AIgateway

from openai import OpenAI

client = OpenAI(
    base_url="https://api.aigateway.sh/v1",
    api_key=os.environ["AIGATEWAY_API_KEY"],
)
r = client.chat.completions.create(
    model="anthropic/claude-opus-4.7",
    messages=[{"role": "user", "content": "Hi"}],
)

Behavioral notes

Virtual keys are the trickiest piece — swap them for AIgateway sub-account keys (see /sub-accounts). The mint endpoint is POST /v1/sub-accounts.
Gateway configs (retries, fallbacks, conditional routing) are declared once per AIgateway account in the dashboard, not per-request in headers.
Cost-attribution: Portkey-Property-* headers map to x-aig-tag — one tag per request, query usage by tag at /v1/usage/by-tag.

Credit match

Email your last invoice from Portkey to switch@aigateway.sh and we match the credit up to $1,000 (24-hour turnaround). Or read the full pitch at /switch/portkey.