Skip to main content
POST

Authorizations

Authorization
string
header
required

Authorization: Bearer YOUR_API_KEY

Path Parameters

model
string
required

Model ID in Google Native API format (e.g. gemini-3.5-flash, gemini-2.5-flash).

Example:

"gemini-3.5-flash"

Body

application/json
contents
object[]
required

Conversation contents. Supports multi-turn dialogue and multimodal input.

Minimum array length: 1
systemInstruction
object

System instruction (optional). Use text parts only.

generationConfig
object

Generation parameters (sampling, length, structured output, modalities, thinking, etc.).

tools
object[]

Tools the model may call (function calling, search, code execution, etc.).

toolConfig
object

Tool configuration shared across all tools in the request.

safetySettings
object[]

Per-request safety settings for candidates.

cachedContent
string

Cached content resource name, e.g. cachedContents/{id}.

Response

Content generated successfully

candidates
object[]
promptFeedback
object
usageMetadata
object
modelVersion
string
responseId
string