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>"
}
'import requests
url = "https://api.opper.ai/v3/compat/v1beta/models/{model}:streamGenerateContent"
payload = {
"contents": "<unknown>",
"input": "<unknown>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({contents: '<unknown>', input: '<unknown>'})
};
fetch('https://api.opper.ai/v3/compat/v1beta/models/{model}:streamGenerateContent', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}Stream Generate Content
Streaming variant of generateContent. Pass ?alt=sse (as Google’s SDKs do) to receive Server-Sent Events; each data: line is a partial GenerateContentResponse. The request body matches :generateContent.
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>"
}
'import requests
url = "https://api.opper.ai/v3/compat/v1beta/models/{model}:streamGenerateContent"
payload = {
"contents": "<unknown>",
"input": "<unknown>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({contents: '<unknown>', input: '<unknown>'})
};
fetch('https://api.opper.ai/v3/compat/v1beta/models/{model}:streamGenerateContent', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}Authorizations
Headers
Comma-separated key:value usage-attribution tags (e.g. tenant:acme,project:demo, max 8). Recorded on the generation's billing/metrics rows; group spend by any key via GET /v2/analytics/usage?group_by=. Header-borne twin of the /v3/session URL prefix tags (which win per key when both are present); opper.-prefixed keys and session_id are reserved. Malformed values return 400.
Path Parameters
Query Parameters
Body
Opt in to automatic prompt caching for Anthropic-family models routed through this Gemini-shape endpoint: {"type":"ephemeral"} (optionally "ttl":"1h"). Places one moving cache breakpoint on the largest cacheable prefix. Caching is off unless set; no-op on Gemini and other providers with automatic server-side caching. Cache writes cost 1.25x input and reads 0.1x
Fallback models tried in order when the model before them fails for any reason (provider error; rate limit; timeout; a member blocked by one of your rules). Same OpenRouter shape: send the primary in model (or agent) and the rest here; or omit both and the first entry is the primary. Each entry is any model string: a bare pooled name; a provider/model id; an org alias. Not allowed together with a dynamic/ route. At most 10 entries. Which model answered is in the X-Opper-Served-Model header.