本文档由灵云API 提供，请前往灵云API官方地址创建Token调试API接口

聊天接口

POST

https://lingyunapi.com/v1beta/models/gemini-2.5-flash:generateContent

🧩 1. 指定模型

在请求路径中直接写入模型名称，例如：/v1beta/models/gemini-2.5-flash:generateContent

🔐 2. 传入密钥

将密钥放在请求参数中，参数名为 key：

参数名	类型	位置	说明
`key`	string	query	调用所需的 API 密钥

示例请求路径：https://lingyunapi.com/v1beta/models/gemini-2.5-flash:generateContent?key=YOUR_API_KEY

⚠️ 请将 YOUR_API_KEY 替换为你自己的有效密钥。

请求参数

Query 参数

Header 参数

Body 参数application/json必填

示例

{
      "contents": [{
        "parts":[{"text": "你好哇"}]
        }]
       }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://lingyunapi.com/v1beta/models/gemini-2.5-flash:generateContent?key=XXX' \
--header 'Content-Type: application/json' \
--data '{
      "contents": [{
        "parts":[{"text": "你好哇"}]
        }]
       }'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "text": "你好哇！很高兴你来找我。\n\n有什么我可以帮你做的吗？或者有什么想聊的？😊"
                    }
                ]
            },
            "finishReason": "STOP",
            "index": 0,
            "safetyRatings": []
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 3,
        "candidatesTokenCount": 969,
        "totalTokenCount": 972,
        "thoughtsTokenCount": 0,
        "promptTokensDetails": null
    }
}

修改于 2025-11-11 04:01:02

更多请求示例