生成内容

POST

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

使用 Gemini 模型生成内容。支持纯文本、多模态输入（图片、音频、视频、PDF）、工具调用、JSON 模式输出等多种功能

请求参数

Authorization

API Key

在 query 添加参数

key

示例：

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

API Key

在 header 添加参数

x-goog-api-key

示例：

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

Path 参数

Query 参数

Body 参数application/json必填

最基础的对话示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "你好，Gemini！请介绍一下你自己。"
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200

application/json

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

Body

示例

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

🟠400

🟠401

🟠429

🔴500

修改于 2025-11-27 10:44:43

创建消息

流式生成内容