Chat SDK

AI SDK Middleware

Inject contextual ads into model responses with idlenAdsMiddleware

AI SDK Middleware

idlenAdsMiddleware() plugs into the Vercel AI SDK middleware chain.

Example

import { wrapLanguageModel } from 'ai';
import { openai } from '@ai-sdk/openai';
import { idlenAdsMiddleware } from '@idlen/chat-sdk/ai-sdk';

const model = wrapLanguageModel({
  model: openai('gpt-4o-mini'),
  middleware: idlenAdsMiddleware({
    apiKey: 'idl_pk_...',
    frequency: 3,
    format: 'chat_sponsored_recommendation',
    position: 'append'
  })
});

Options

Option	Type	Default	Description
`apiKey`	`string`	required	Publisher API key
`frequency`	`number`	`3`	Inject one ad every N responses
`format`	`ChatAdFormat`	`chat_sponsored_recommendation`	Ad format
`position`	`'append' \	'prepend'`	`append`

Notes

Use middleware for LLM output augmentation.
Use getAdForContent / fetchAdForContent for non-conversational UI surfaces.

React Integration

Use useIdlenAd in React apps for chat and non-chat ad slots

Ad Formats

Choose the right chat ad format for your UX