Skip to navigation
IntegrationIntegrationsAgent Frameworks

Eve (gateway)

Eve accepts provider-authored AI SDK language models. Configure an OpenAI-compatible provider for Respan to route Eve model calls through the Respan gateway with one API key.

An Eve string model such as "openai/gpt-5.4-mini" uses Vercel AI Gateway. To use Respan Gateway, pass the provider model object shown below. AI_GATEWAY_API_KEY is a Vercel AI Gateway credential and is not used by this setup.

Setup

1

Install packages

npm install eve@0.26.1 ai@7.0.26 @ai-sdk/openai@4.0.16

Eve 0.26 requires Node.js 24 or newer.

2

Set the Respan API key

export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"

No provider API key is required. The Respan gateway handles provider authentication.

3

Configure the Eve model

Create or update agent/agent.ts. Eve also expects agent/instructions.md (or an instructions/ directory), which eve init creates for you:

agent/agent.ts
import { createOpenAI } from "@ai-sdk/openai";
import { defineAgent } from "eve";
const respan = createOpenAI({
  apiKey: process.env.RESPAN_API_KEY!,
  baseURL: "https://api.respan.ai/api",
});
export default defineAgent({
  model: respan.chat("gpt-5.5"),
});

With AI SDK 7, call respan.chat(...) explicitly. Calling respan(...) selects the Responses API, while this key-only configuration uses Respan’s Chat Completions route.

4

Run Eve

npx eve dev

Switch models

Keep the provider configuration and replace gpt-5.5 with another identifier from the full model list. Provider prefixes make cross-provider routing explicit.

Eve’s provider-managed web_search tool is not available through this OpenAI-compatible Chat Completions route. Use an authored Eve tool when your agent needs web search.