Setting Up API Key Integrations

Deploy and configure API key-based integrations in Metorial

API key integrations use a single set of credentials for your entire application. Perfect for services like search APIs (Exa, Tavily) where you don’t need user-specific authorization—just get an API key, configure it, and start building.

What you’ll learn:

• How to deploy and configure API key-based providers
• How to test integrations

Related resources:

• Deploy Your First Provider
• Integrations Overview

Deploying an API Key Integration

1. Get Your API Key

   Sign up for the service (e.g., Exa, Tavily) and generate an API key.

2. Find the Provider

   In Metorial, go to Providers and search for the integration.

3. Create a Deployment

   Click Deploy, name your deployment, and paste your API key. Metorial creates a Provider Auth Config to store your credentials securely.

4. Test

   Use the test console to verify the deployment works.

Using API Key Integrations

After deploying your integration, pass the provider deployment ID when creating a session. The integration handles authentication automatically using the credentials you configured.

TypeScript

import { Metorial } from 'metorial';
import { metorialAiSdk } from '@metorial/ai-sdk';
import { anthropic } from '@ai-sdk/anthropic';
import { generateText } from 'ai';

let metorial = new Metorial({ 
	apiKey: process.env.METORIAL_API_KEY 
});

let session = await metorial.connect({
  adapter: metorialAiSdk(),
  providers: [
	{ providerDeploymentId: 'your-exa-deployment-id' }
  ]
});

let tools = session.tools();

What’s Next?

OAuth Integrations

Set up user-authorized integrations.

SDK Quickstart

Build your first AI agent.