文本对话（Gemini 格式）

POST

/v1beta/models/{model}:generateContent

创建一个 Gemini generateContent 请求，完全兼容 Google Gemini API 原生格式。

与 OpenAI 格式的主要区别：

认证方式：URL 参数 ?key=YOUR_API_KEY

消息角色使用 user 和 model（而非 assistant）

内容使用 parts 数组结构

配置参数使用 generationConfig 对象

流式输出： 使用 /v1beta/models/{model}:streamGenerateContent 端点。

请求参数

Path 参数

Body 参数application/json必填

示例

基础对话带系统指令多模态（图片输入）思考模式

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

基础对话带系统指令多模态（图片输入）思考模式

curl --location 'https://jiniu.ai/v1beta/models/:generateContent' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "你好，请介绍一下你自己"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

成功返回生成结果

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "text": "你好！我是 Gemini，很高兴为你服务。"
                    }
                ]
            },
            "finishReason": "STOP",
            "index": 0
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 8,
        "candidatesTokenCount": 20,
        "totalTokenCount": 28
    }
}

🟠400请求有误

🟠401没有权限

🟠402

修改于 2026-05-25 14:37:10

文本对话（Anthropic Claude 格式）

文本对话 - 流式输出（Gemini 格式）