Gemini对话格式 - v1beta

POST

{{url}}/v1beta/models/{model}:generateContent

最后修改时间：2025-11-29 03:42:54

代理 Gemini API 请求。
路径格式: /v1beta/models/{model_name}:{action}

例如:

/v1beta/models/gemini-2.5-pro:generateContent

/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "string",
                    "inlineData": {
                        "mimeType": "string",
                        "data": "string"
                    }
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 0,
        "topP": 0,
        "topK": 0,
        "maxOutputTokens": 0,
        "stopSequences": [
            "string"
        ]
    },
    "safetySettings": [
        {
            "category": "string",
            "threshold": "string"
        }
    ],
    "tools": [
        {}
    ],
    "systemInstruction": {
        "parts": [
            {}
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://api.example.com/v1beta/models/:generateContent' \
--header 'Authorization: Bearer sk-xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "string",
                    "inlineData": {
                        "mimeType": "string",
                        "data": "string"
                    }
                }
            ]
        }
    ],
    "generationConfig": {
        "temperature": 0,
        "topP": 0,
        "topK": 0,
        "maxOutputTokens": 0,
        "stopSequences": [
            "string"
        ]
    },
    "safetySettings": [
        {
            "category": "string",
            "threshold": "string"
        }
    ],
    "tools": [
        {}
    ],
    "systemInstruction": {
        "parts": [
            {}
        ]
    }
}'

返回响应

🟢200成功

application/json

成功

Body

示例

{
    "candidates": [
        {
            "content": {
                "role": "string",
                "parts": [
                    {}
                ]
            },
            "finishReason": "string",
            "safetyRatings": [
                {}
            ]
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 0,
        "candidatesTokenCount": 0,
        "totalTokenCount": 0
    }
}

修改于 2025-11-29 03:42:54

Claude对话格式 - messages

在codex中使用