Skip to main content

​
Gemini 基础对话示例

以下示例展示如何使用Gemini的 /v1beta/models/{model}:generateContent 接口进行基础文本生成。

​
快速开始

只需要替换 <API-KEY> 为你的实际API密钥即可运行。 
curl -X POST "https://model-api.skyengine.com.cn/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "你好，请介绍一下你自己"
          }
        ]
      }
    ],
    "generationConfig": {
      "maxOutputTokens": 3000,
      "temperature": 0.7
    }
  }'

​
结果示例

200
{
  "sdkHttpResponse": {
    "headers": {
      "Alt-Svc": [
        "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"
      ],
      "Content-Type": [
        "application/json; charset=UTF-8"
      ],
      "Date": [
        "Mon, 29 Sep 2025 07:44:45 GMT"
      ],
      "Server": [
        "scaffolding on HTTPServer2"
      ],
      "Vary": [
        "Origin",
        "X-Origin",
        "Referer"
      ],
      "X-Content-Type-Options": [
        "nosniff"
      ],
      "X-Frame-Options": [
        "SAMEORIGIN"
      ],
      "X-Xss-Protection": [
        "0"
      ]
    }
  },
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "你好！很高兴能介绍我自己。\n\n我是一个大型语言模型，由 Google 训练。\n\n我的主要能力包括：\n\n*   **理解并生成人类语言**：我可以理解你"
          }
        ],
        "role": "model"
      },
      "finishReason": "MAX_TOKENS",
      "avgLogprobs": -4.488159561157227
    }
  ],
  "createTime": "2025-09-29T07:44:40.11712Z",
  "modelVersion": "gemini-2.5-flash",
  "responseId": "c1ffee8d5e2342cd901652cbc6e99e5a",
  "usageMetadata": {
    "candidatesTokenCount": 40,
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 40
      }
    ],
    "promptTokenCount": 6,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 6
      }
    ],
    "thoughtsTokenCount": 958,
    "totalTokenCount": 1004,
    "trafficType": "ON_DEMAND"
  }
}

​
重要参数说明

  • contents: 输入内容数组，每个元素包含 parts 数组
  • parts: 内容部分，包含 text 字段
  • generationConfig: 生成配置
    • maxOutputTokens: 最大输出token数量
    • temperature: 控制输出随机性，0-2之间

​
错误处理

Gemini API的常见错误：
  • 400 Bad Request: 请求格式错误
  • 401 Unauthorized: API密钥无效
  • 429 Too Many Requests: 请求频率过高
  • 503 Service Unavailable: 服务暂时不可用