Images

There are two ways to generate images, and which one you use depends on the model family.

Family	Path	Reference
GPT image models	`POST /v1/images/generations`	Create an image
Gemini image models	`POST /v1beta/models/{model}:generateContent`	Generate an image with Gemini

The OpenAI-compatible route is the familiar one: point the OpenAI SDK at https://api.pipellm.ai/v1 and call it unchanged. It also covers editing an existing image. Gemini image models have no /v1/images/* route of their own. They generate through the same generateContent endpoint as text models and return the image as an inline part. There is no /v2/images route on PipeLLM. See Nano Banana for the full Gemini request and response examples.

Model	Typical use
`gemini-3.1-flash-lite-image`	Cheapest and fastest
`gemini-3.1-flash-image`	Fast image generation
`gemini-3-pro-image`	Higher-fidelity production images

curl -X POST \
  "https://api.pipellm.ai/v1beta/models/gemini-3.1-flash-image:generateContent" \
  -H "x-goog-api-key: $PIPELLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "A red bicycle leaning against a cafe window"}]
    }]
  }'

Confirm the current image model IDs with GET /v1/models. For video, use POST /v2/videos.

Get Started

Guides

WebSearch

Protocol Conversion