GenerateContent格式

请求方法与路径

POST

/v1beta/models/{model}:generateContent

Gemini 原生格式，仅支持 Gemini 系列模型。流式输出时，将路径中的 generateContent 换成 streamGenerateContent，并加查询参数 alt=sse。

身份验证

详见调用指南 - 鉴权。

路径参数

model*string

模型 ID，如 gemini-3.5-flash。

请求头参数

详见调用指南 - 公共请求头。

请求体

application/json

body

contents*array<>

对话内容列表，按轮次排列。

systemInstruction?

generationConfig?

生成参数。

tools?array<>

工具定义。

toolConfig?

工具调用配置。

safetySettings?array<>

安全过滤设置。

响应体

成功创建响应

application/json

response

responseId?string

响应 ID。

modelVersion?string

实际使用的模型版本。

candidates?array<>

候选结果列表。

usageMetadata?

Token 用量统计。

请求示例

curl -X POST 'https://api.cysuo.com/v1beta/models/string:generateContent' \
  -H 'Content-Type: application/json' \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好，请介绍一下你自己。"
        }
      ]
    }
  ]
}'

请求示例

curl -X POST 'https://api.cysuo.com/v1beta/models/string:generateContent' \  -H 'Content-Type: application/json' \  -d '{  "contents": [    {      "role": "user",      "parts": [        {          "text": "你好，请介绍一下你自己。"        }      ]    }  ]}'

响应示例数据结构200

{
  "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  }}

GenerateContent格式

请求方法与路径Copy Anchor Link

身份验证Copy Anchor Link

路径参数Copy Anchor Link

请求头参数Copy Anchor Link

请求体Copy Anchor Link

响应体Copy Anchor Link

请求方法与路径

身份验证

路径参数

请求头参数

请求体

响应体