Gemini JavaScript SDK Integration

Use Gemini’s JavaScript SDK to integrate with Helicone to log your Gemini AI usage.

Proxy Integration

Fetch

1

Create an account + Generate an API Key

Log into helicone or create an account. Once you have an account, you can generate an API key.

2

Create Google Generative AI API Key

Visit the Google Generative AI API Key page. Follow the instructions to create a new API key. Make sure to save the key as you will need it for the next steps.

3

Set API keys as environment variables

export HELICONE_API_KEY=<your Helicone API key>
export GOOGLE_API_KEY=<your Google Generative AI API key>

4

Install necessary packages

Ensure you have the necessary packages installed in your Javascript project:

npm install node-fetch

5

Send a request using fetch

const fetch = require('node-fetch');

const url = `https://gateway.helicone.ai/v1beta/models/model-name:generateContent?key=${process.env.GOOGLE_API_KEY}`;

const headers = {
  'Content-Type': 'application/json',
  'Helicone-Auth': `Bearer ${process.env.HELICONE_API_KEY}`,
  'Helicone-Target-URL': `https://generativelanguage.googleapis.com`,
};

const body = JSON.stringify({
  contents: [{
    parts: [{
      text: 'Write a story about a magic backpack.'
    }]
  }]
});

fetch(url, { method: 'POST', headers: headers, body: body })
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Google Generative AI SDK

1

Create an account + Generate an API Key

Log into helicone or create an account. Once you have an account, you can generate an API key.

2

Create Google Generative AI API Key

Visit the Google Generative AI API Key page. Follow the instructions to create a new API key. Make sure to save the key as you will need it for the next steps.

3

Set API keys as environment variables

export HELICONE_API_KEY=<your Helicone API key>
export GOOGLE_API_KEY=<your Google Generative AI API key>

4

Install necessary packages

Ensure you have the necessary packages installed in your Javascript project:

npm install @google/generative-ai

5

Import and configure the client

import { GoogleGenerativeAI } from "@google/generative-ai";

if (!process.env.GOOGLE_API_KEY) {
  throw new Error("GOOGLE_API_KEY environment variable must be set");
}

if (!process.env.HELICONE_API_KEY) {
  throw new Error("HELICONE_API_KEY environment variable must be set");
}

const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY);

const modelParams = {
  model: "gemini-2.0-flash",
  systemInstruction: "You are a helpful assistant that can answer questions and help with tasks.",
};

const modelInstance = genAI.getGenerativeModel(modelParams, {
  baseUrl: "https://gateway.helicone.ai",
  customHeaders: {
    'Helicone-Auth': `Bearer ${process.env.HELICONE_API_KEY}`,
    'Helicone-Target-URL': 'https://generativelanguage.googleapis.com'
  }
});

6

Generate content using the model

async function generateContent() {
  try {
    const response = await modelInstance.generateContent("Hello, world!");
    console.log(JSON.stringify(response, null, 2));
  } catch (error) {
    console.error("Error generating content:", error);
  }
}

generateContent();