Skip to main content
POST
Gemini model method (vendor-neutral)

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Headers

x-veryfront-project-reference
string

Project UUID or slug used to attribute billing finalization.

Required string length: 1 - 255
x-veryfront-project-id
string

Project ID used to attribute billing finalization.

Required string length: 1 - 255
x-veryfront-project-slug
string

Project slug used to attribute billing finalization.

Required string length: 1 - 255
x-veryfront-agent-run-id
string

Durable run ID. Required for run-bound service-account credentials.

Required string length: 1 - 245
x-veryfront-conversation-id
string

Durable conversation ID. Required with agent run attribution.

Required string length: 1 - 255
x-veryfront-message-id
string

Durable message ID. Required with agent run attribution.

Required string length: 1 - 255
x-veryfront-agent-id
string

Agent ID. Must match the authenticated run-bound credential.

Required string length: 1 - 255
x-veryfront-billing-group-id
string

Optional billing group. Run requests are pinned to agent-run:.

Required string length: 1 - 255

Path Parameters

model_method
string
required

The model and the Gemini method, <model>:<method>. The model is a catalog id or alias (gemini-2.5-flash, google/gemini-2.5-flash); the method is generateContent, streamGenerateContent, embedContent or batchEmbedContents.

Example:

"gemini-2.5-flash:generateContent"

Body

application/json

Gemini-native request body (contents for generateContent, content for embedContent, requests for batchEmbedContents), forwarded as sent.

Response

Upstream provider response (forwarded as-is)