Generate Content

Method and Path

POST

/v1beta/models/{model}:generateContent

Native Gemini format. Supports Gemini models only. For streaming, replace generateContent in the path with streamGenerateContent and add the query parameter alt=sse.

Authorization

See API Guide - Authentication.

Path Parameters

model*string

Model ID, e.g. gemini-3.5-flash.

Header Parameters

See API Guide - Common Request Headers.

Request Body

application/json

body

contents*array<>

Conversation contents, in turn order.

systemInstruction?

generationConfig?

Generation parameters.

tools?array<>

Tool definitions.

toolConfig?

Tool calling configuration.

safetySettings?array<>

Safety filter settings.

Response Body

Successful response

application/json

response

responseId?string

Response ID.

modelVersion?string

Version of the model actually used.

candidates?array<>

List of candidates.

usageMetadata?

Token usage statistics.

Example Request

curl -X POST 'https://api.cysuo.com/v1beta/models/string:generateContent' \
  -H 'Content-Type: application/json' \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Hello, please introduce yourself."
        }
      ]
    }
  ]
}'

Example Request

curl -X POST 'https://api.cysuo.com/v1beta/models/string:generateContent' \  -H 'Content-Type: application/json' \  -d '{  "contents": [    {      "role": "user",      "parts": [        {          "text": "Hello, please introduce yourself."        }      ]    }  ]}'

Example ResponseSchema200

{
  "responseId": "string",
  "modelVersion": "string",
  "candidates": [
    {
      "content": {
        "role": "user",
        "parts": [
          {
            "text": "string",
            "inlineData": {
              "mimeType": "string",
              "data": "string"
            },
            "fileData": {
              "mimeType": "string",
              "fileUri": "string"
            }
          }
        ]
      },
      "finishReason": "string",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0,
    "cachedContentTokenCount": 0,
    "thoughtsTokenCount": 0
  }
}

{  "responseId": "string",  "modelVersion": "string",  "candidates": [    {      "content": {        "role": "user",        "parts": [          {            "text": "string",            "inlineData": {              "mimeType": "string",              "data": "string"            },            "fileData": {              "mimeType": "string",              "fileUri": "string"            }          }        ]      },      "finishReason": "string",      "index": 0    }  ],  "usageMetadata": {    "promptTokenCount": 0,    "candidatesTokenCount": 0,    "totalTokenCount": 0,    "cachedContentTokenCount": 0,    "thoughtsTokenCount": 0  }}

Generate Content

Method and PathCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Header ParametersCopy Anchor Link