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 });

await metorial.withProviderSession(
    metorialAiSdk,
    {
        providers: [{ providerDeploymentId: 'your-exa-deployment-id' }]
    },
    async session => {
        let { text } = await generateText({
            model: anthropic('claude-sonnet-4-5'),
            prompt: 'Search for the latest AI news',
            tools: session.tools
        });
        console.log(text);
    }
);

​
What’s Next?

OAuth Integrations

Set up user-authorized integrations.

SDK Quickstart

Build your first AI agent.