stripe__ai/llm/ai-sdk/provider/examples

Stripe AI SDK Provider Examples

This directory contains examples demonstrating how to use the Stripe AI SDK Provider to interact with various LLM models through Stripe's llm.stripe.com proxy.

Overview

The Stripe AI SDK Provider is a custom provider for the Vercel AI SDK that routes all requests through Stripe's LLM proxy, automatically tracking token usage for billing purposes.

Setup

1. Install dependencies (from the ai-sdk-provider directory):

cd llm/ai-sdk-provider
npm install

2. Set up environment variables in the examples directory:

cd examples
cp .env.example .env

Then edit .env and add your credentials:

# Required: Your Stripe API key
STRIPE_API_KEY=sk_test_...

# Required: Your Stripe Customer ID
STRIPE_CUSTOMER_ID=cus_...

Running examples

Each example file demonstrates different use cases. Run them from the examples directory:

OpenAI models

cd examples
npx ts-node openai.ts

Examples include:

• Simple text generation
• Streaming responses
• Multi-turn conversations
• Reasoning models (o3)
• Tool calling

Google Gemini models

npx ts-node google.ts

Examples include:

• Text generation with Gemini 2.5 Pro
• Streaming with Gemini Flash
• Using Gemini Lite models
• Custom headers

Anthropic Claude models

npx ts-node anthropic.ts

Examples include:

• Simple text generation
• Streaming with Claude Opus
• Claude Sonnet and Haiku models
• Tool calling
• Per-call customer ID override

Supported models

OpenAI

• openai/gpt-5
• openai/gpt-5-mini
• openai/gpt-5-nano
• openai/gpt-4.1
• openai/gpt-4.1-mini
• openai/gpt-4.1-nano
• openai/gpt-4o
• openai/gpt-4o-mini
• openai/o3, openai/o3-mini, openai/o3-pro
• openai/o1, openai/o1-mini, openai/o1-pro

Google Gemini

• google/gemini-2.5-pro
• google/gemini-2.5-flash
• google/gemini-2.5-flash-lite
• google/gemini-2.0-flash
• google/gemini-2.0-flash-lite

Anthropic Claude

• anthropic/claude-opus-4-1
• anthropic/claude-opus-4
• anthropic/claude-sonnet-4
• anthropic/claude-3-7-sonnet
• anthropic/claude-3-5-haiku
• anthropic/claude-3-haiku

Usage patterns

Basic setup

import { createStripe } from '@stripe/ai-sdk/provider';
import { generateText } from 'ai';

const stripeLLM = createStripe({
  apiKey: process.env.STRIPE_API_KEY!,
  customerId: process.env.STRIPE_CUSTOMER_ID, // Optional default
});

const model = stripe('openai/gpt-5');

Customer ID options

You can specify the customer ID in three ways (in order of priority):

1. Per-call override (highest priority):

await generateText({
  model: stripe('openai/gpt-5'),
  prompt: 'Hello!',
  providerOptions: {
    stripe: {
      customerId: 'cus_override'
    }
  }
});

2. Model-level setting:

const model = stripe('openai/gpt-5', {
  customerId: 'cus_model_level'
});

3. Provider-level default:

const stripeLLM = createStripe({
  apiKey: '...',
  customerId: 'cus_default'
});

Streaming

import { streamText } from 'ai';

const result = await streamText({
  model: stripe('google/gemini-2.5-flash'),
  prompt: 'Tell me a story',
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

Tool calling

const result = await generateText({
  model: stripe('anthropic/claude-sonnet-4'),
  prompt: 'What is the weather?',
  tools: {
    getWeather: {
      description: 'Get weather for a location',
      parameters: {
        type: 'object',
        properties: {
          location: { type: 'string' }
        },
        required: ['location']
      },
      execute: async ({ location }) => {
        return { temperature: 72, condition: 'Sunny' };
      }
    }
  }
});

How it works

1. All requests are routed to https://llm.stripe.com/chat/completions
2. Your Stripe API key is included as the Authorization header
3. The customer ID is included as the X-Stripe-Customer-ID header
4. Stripe automatically tracks token usage and bills the customer according to your Token Billing configuration

Learn more

• Stripe Token Billing Documentation
• Vercel AI SDK Documentation
• AI SDK Provider Specification