generateContent

POST

https://{base_url}/v1beta/models/{model_name}:generateContent

基础节点：
https://grsaiapi.com (全球节点)
https://grsai.dakka.com.cn (国内节点)

例子：
https://grsaiapi.com/v1beta/models/gemini-3.8-flash:generateContent
https://grsai.dakka.com.cn/v1beta/models/gemini-3.8-flash:generateContent

请求参数

Path 参数

Header 参数

Body 参数application/json必填

示例

文字提问传递图片提问

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好"
        }
      ]
    }
  ],
  "generationConfig": {
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文字提问传递图片提问

curl --location 'https://v1beta/models/:generateContent' \
--header 'Authorization: Bearer sk-xxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好"
        }
      ]
    }
  ],
  "generationConfig": {
  }
}'

返回响应

🟢200json响应

application/json

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "你好！很高兴为您提供帮助，请问有什么我可以帮您的吗？"
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP"
        }
    ],
    "modelVersion": "gemini-3.8-flash",
    "responseId": "16-23ff3109-34d3-4c41-b8c6-de94aea8365a",
    "usageMetadata": {
        "candidatesTokenCount": 250,
        "promptTokenCount": 86,
        "totalTokenCount": 336
    }
}

修改于 2026-09-07 03:24:22

streamGenerateContent

/v1/chat/completions