ai-gateway-proxy

A lightweight proxy handler for Vercel AI Gateway.

Features

• Request/Response Hooks - Transform requests and responses with beforeRequest, afterResponse, and onError hooks
• Streaming Support - Full SSE streaming with content aggregation using AI SDK V3 protocol
• Framework Agnostic - Works with Next.js, Hono, Express, and other frameworks

Installation

npm install ai-gateway-proxy

Quick Start

Next.js App Router

Create a catch-all route at app/api/ai/[...segments]/route.ts:

import { createGatewayProxy } from "ai-gateway-proxy";

export const { GET, POST, PUT, DELETE, PATCH } = createGatewayProxy();

Hono / Other Frameworks

For frameworks without catch-all route support, use the extractPath option:

import { Hono } from "hono";
import { createGatewayProxy } from "ai-gateway-proxy";

const app = new Hono();

const proxy = createGatewayProxy({
  extractPath: (request) => {
    const url = new URL(request.url);
    return url.pathname.replace(/^\/api\/ai\//, "");
  },
});

app.all("/api/ai/*", (c) => proxy(c.req.raw));

Authentication

The proxy automatically handles authentication using one of the following methods (in priority order):

1. API Key - Set AI_GATEWAY_API_KEY environment variable
2. OIDC - Automatic when deployed on Vercel

Documentation

For full documentation including configuration options, hooks, and API reference, see the documentation.

License

MIT