Skip to main content
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:

​
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. 
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.