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-genai

5

Import and configure the client

import { genai } from "google-genai";

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

const client = genai.Client({
  api_key: process.env.GOOGLE_API_KEY,
  client_options: {
    api_endpoint: "gateway.helicone.ai",
  },
  default_metadata: [
    ["helicone-auth", `Bearer ${process.env.HELICONE_API_KEY}`],
    ["helicone-target-url", "https://generativelanguage.googleapis.com"],
  ],
  transport: "rest",
});

6

Generate content using the model

async function run() {
  const response = await client.models.generate_content({
    model: "gemini-2.0-flash",
    contents: "Tell me a story in 300 words.",
  });
  console.log(response.text);
}

run();