cfworkerai

Vercel AI SDK - CFWorkerAI Provider

The CFWorkerAI provider for the Vercel AI SDK contains language model support for the CFWorkerAI chat API.

More information about the Cloudflare AI Gateway can be found at: Cloudflare AI Gateway

All available models can be found at: Available Models

Important Note

This is currently a beta version of the CFWorkerAI provider. If you encounter any issues, please open an issue on the GitHub repository.

Setup

The CFWorkerAI provider is available in the cfworkerai module. You can install it with

npm i cfworkerai

Once installed, you have to setup the environment variables CF_TOKEN and CF_BASE_URL:

CF_TOKEN=YOUR_CLOUDFLARE_TOKEN
CF_BASE_URL=https://gateway.ai.cloudflare.com/v1/{CLOUDFLARE_ACCOUNT_ID}/{GATEWAY_ID}/workers-ai

Your Cloudflare token can be found at: Cloudflare API Tokens

Provider Instance

You can import the default provider instance cfworkerai from cfworkerai:

import { cfworkerai } from 'cfworkerai';

Example

import { cfworkerai } from 'cfworkerai';
import { generateText } from 'ai';

// Text to text - simple
const result1 = await generateText({
  model: cfworkerai('@cf/meta/llama-2-7b-chat-fp16'),
  prompt: 'Write a vegetarian lasagna recipe for 4 people.',
});

// Text to text - chat
const result2 = await streamText( {
    model: cfworkerai( '@cf/google/gemma-2b-it-lora' ),
    messages: [
        { role: 'system', content: 'You are a helpful AI assistant.' },
        { role: 'user', content: 'What is the capital of France?' },
        { role: 'assistant', content: 'Paris is the capital of France.' },
    ],
  } );

// Image to text
const image = await fetch( 'https://cdn.pixabay.com/photo/2015/04/23/22/00/tree-736885__480.jpg' )
      .then( response => response.blob() )

const result3 = await generateText( {
  model: cfworkerai( model, { use_rest: true } ),
  messages: [
    {
      role: 'user',
      content: [
        { type: "text", text: 'Describe the image' },
        { type: "image", image: await image.arrayBuffer() }
      ]
    }
  ]
} )