Документация API gemini-3.1-pro-preview

gemini-3.1-pro-preview

ТекстGoogleGemini 3.1 Progemini-3.1-pro

Открыть Playground Управление API-ключами

谷歌最强推理模型

Аутентификация

Base URL: https://api.dreamtoai.com
Authorization: Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Имя модели (model): gemini-3.1-pro-preview

Протокол интеграции

Почему этот протокол

适合原本使用 Gemini SDK 或 generateContent 接口的用户直接迁移。

URL эндпоинта

POST/v1beta/models/gemini-3.1-pro-preview:generateContent

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

JSON запроса и ответа

Запрос

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好，世界"
        }
      ]
    }
  ],
  "generationConfig": {
    "temperature": 0.7,
    "topP": 1,
    "maxOutputTokens": 4096
  },
  "tools": []
}

Ответ

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Hello from Mix API"
          }
        ]
      }
    }
  ],
  "modelVersion": "gemini-3.1-pro-preview",
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 16,
    "totalTokenCount": 24
  }
}

Поля запроса и ответа

Поля запроса

Поле	Тип	Обязательно
contents	array	Y
contents[]	object	Y
contents[].role	string	Y
contents[].parts	array	Y
contents[].parts[]	object	Y
contents[].parts[].text	string	Y
generationConfig	object	Y
generationConfig.temperature	number	Y
generationConfig.topP	integer	Y
generationConfig.maxOutputTokens	integer	Y
tools	array	Y

Поля ответа

Поле	Тип	Обязательно
output.text	string	N

Примеры кода

cURLrequest.sh

curl -X POST "https://api.dreamtoai.com/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好，世界"
        }
      ]
    }
  ],
  "generationConfig": {
    "temperature": 0.7,
    "topP": 1,
    "maxOutputTokens": 4096
  },
  "tools": []
}'