Skip to main content
POST
/
v3
/
compat
/
v1beta
/
models
/
{model}
:streamGenerateContent
Stream Generate Content API
curl --request POST \
  --url https://api.opper.ai/v3/compat/v1beta/models/{model}:streamGenerateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": "<unknown>",
  "input": "<unknown>"
}
'
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "codeExecutionResult": {},
            "executableCode": {},
            "functionCall": {},
            "inlineData": {},
            "text": "<string>",
            "thought": true,
            "thoughtSignature": "<string>"
          }
        ],
        "role": "<string>"
      },
      "index": 123,
      "finishReason": "<string>",
      "groundingMetadata": {},
      "urlContextMetadata": {}
    }
  ],
  "modelVersion": "<string>",
  "responseId": "<string>",
  "usageMetadata": {
    "cachedContentTokenCount": 123,
    "candidatesTokenCount": 123,
    "opper": {},
    "promptTokenCount": 123,
    "thoughtsTokenCount": 123,
    "totalTokenCount": 123
  }
}

Authorizations

Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token.

Headers

X-Opper-Name
string

Function name for tracing and project-level guardrail function-scope filtering.

X-Opper-Parent-Span-Id
string<uuid>

Parent span ID for distributed tracing context.

Path Parameters

model
string
required

Model id — a bare Gemini name (e.g. gemini-2.5-flash, resolved against the Gemini-direct provider) or an Opper-canonical id (e.g. vertexai/gemini-2.5-flash).

Query Parameters

alt
enum<string>

Set to sse for Server-Sent Events framing (matches Google SDK behaviour).

Available options:
sse

Body

application/json
contents
any
required

Any value

input
any
required

Any value

agent
string
background
boolean
custom_model_credentials
object
generation_config
object
model
string
previous_interaction_id
string
response_format
object
response_mime_type
string
safety_settings
object[]
store
boolean
stream
boolean
system_instruction
object
tool_config
object
tools
object[]

Response

Successful response

candidates
object[]
required
modelVersion
string
responseId
string
usageMetadata
object