Generate Content

For authentication and model list, see Overview.

Endpoint

POST https://api.pipellm.ai/v1beta/models/{model}:generateContent

This free route accepts Gemini native requests and routes only to Gemini platforms. To keep the Gemini format while calling OpenAI or Anthropic models, use the Gemini Format Converter.

Install SDK

pip install google-genai

Code Examples

cURL
Python
Node.js
Go

curl "https://api.pipellm.ai/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $PIPELLM_API_KEY" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "Why is the sky blue?"}
        ]
      }
    ]
  }'

import os
from google import genai

client = genai.Client(
  api_key=os.getenv('PIPELLM_API_KEY'),
  http_options={'base_url': 'https://api.pipellm.ai'}
)

response = client.models.generate_content(
  model='gemini-3-flash-preview',
  contents='Why is the sky blue?'
)

print(response.text)

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({
  apiKey: process.env.PIPELLM_API_KEY,
  httpOptions: {
    baseUrl: 'https://api.pipellm.ai'
  }
});

const response = await ai.models.generateContent({
  model: 'gemini-3-flash-preview',
  contents: 'Why is the sky blue?'
});

console.log(response.text);

package main

import (
  "context"
  "os"
  "github.com/google/generative-ai-go/genai"
  "google.golang.org/api/option"
)

func main() {
  ctx := context.Background()
  client, _ := genai.NewClient(ctx,
    option.WithAPIKey(os.Getenv("PIPELLM_API_KEY")),
    option.WithEndpoint("https://api.pipellm.ai"),
  )
  defer client.Close()

  model := client.GenerativeModel("gemini-3-flash-preview")
  resp, _ := model.GenerateContent(ctx,
    genai.Text("Why is the sky blue?"),
  )
}

Request Format

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {"text": "Your message here"}
      ]
    }
  ],
  "generationConfig": {
    "temperature": 0.7,
    "maxOutputTokens": 1024
  }
}

Response Format

{
  "candidates": [
    {
      "content": {
        "parts": [
          {"text": "The sky appears blue because..."}
        ],
        "role": "model"
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 50,
    "totalTokenCount": 60
  }
}

Routing & Protocols

Native-route constraints and converter routes

Gemini Overview

Headers, models, and route family overview

Gemini Format Converter

Keep Gemini format while calling other providers

Overview

Using the API

OpenAI Compatible

Anthropic

Gemini

Endpoint

Install SDK

Code Examples

Request Format

Response Format

Routing & Protocols

Gemini Overview

Gemini Format Converter

Overview

Using the API

OpenAI Compatible

Anthropic

Gemini

​Endpoint

​Install SDK

​Code Examples

​Request Format

​Response Format

​Related Docs

Routing & Protocols

Gemini Overview

Gemini Format Converter

Endpoint

Install SDK

Code Examples

Request Format

Response Format

Related Docs