生成内容

POST

https://router.shengsuanyun.com/api/v1/models/{model}:generateContent

使用 Gemini 模型生成内容。支持纯文本、多模态输入（图片、音频、视频、PDF）、工具调用、JSON 模式输出等多种功能，与Google ai studio官方接口相同，更新不及时可参考官方文档。

请求参数

Authorization

API Key

在 header 添加参数

x-goog-api-key

示例：

x-goog-api-key: ********************

API Key

在 query 添加参数

key

示例：

key: ********************

Path 参数

Query 参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

成功响应 - 返回模型生成的内容

Body

🟠400

🟠401

🟠429

🔴500

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://router.shengsuanyun.com/api/v1/models/:generateContent?key&alt' \
--header 'x-goog-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "你好，Gemini！请介绍一下你自己。"
                }
            ]
        }
    ]
}'

响应示例

200 - 成功响应示例

{
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "text": "你好！我是 Gemini，由 Google 开发的大型语言模型。我可以帮助你进行对话、回答问题、分析图片和视频、编写代码等多种任务。有什么我可以帮助你的吗？"
                    }
                ],
                "role": "model"
            },
            "finishReason": "STOP",
            "index": 0,
            "safetyRatings": [
                {
                    "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
                    "probability": "NEGLIGIBLE"
                },
                {
                    "category": "HARM_CATEGORY_HATE_SPEECH",
                    "probability": "NEGLIGIBLE"
                },
                {
                    "category": "HARM_CATEGORY_HARASSMENT",
                    "probability": "NEGLIGIBLE"
                },
                {
                    "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
                    "probability": "NEGLIGIBLE"
                }
            ]
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 8,
        "candidatesTokenCount": 45,
        "totalTokenCount": 53
    }
}

修改于 2025-11-28 03:47:54

SDK 调用

流式生成内容