Endpoint
POST https://api.pipellm.ai/v1beta/models/{model}:generateContent
这条 free route 只接受 Gemini 原生格式请求，并只路由到 Gemini 平台。如果你想
保留 Gemini 格式去调用 OpenAI 或 Anthropic 模型，请使用
Gemini Format Converter。
安装 SDK
pip install google-genai
代码示例
- 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?"),
)
}
请求格式
{
"contents": [
{
"role": "user",
"parts": [
{"text": "Your message here"}
]
}
],
"generationConfig": {
"temperature": 0.7,
"maxOutputTokens": 1024
}
}
响应格式
{
"candidates": [
{
"content": {
"parts": [
{"text": "The sky appears blue because..."}
],
"role": "model"
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 10,
"candidatesTokenCount": 50,
"totalTokenCount": 60
}
}
相关文档
路由与协议
查看原生路由约束和 converter 路由
Gemini 概述
查看 Header、模型和路由族说明
Gemini Format Converter
保留 Gemini 格式，调用其他协议族模型