Gemini 3.7 Flash API: агенты для кода, 1M

google/gemini-3.7-flash/chat

Gemini 3.7 Flash от Google — быстрая чат-модель для повседневного кода, агентных инструментов и многошаговых задач через OpenAI-совместимый API. Читает до 1 048 576 токенов, отвечает до 65 536, три уровня reasoning effort.

Ввод $0.675Вывод $3.375за 1 млн токеновКешированный ввод $0.0675Официальная цена Google~~$0.75$3.75~~

Запустить модель Открыть API

Отправить запрос

Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.

SDK и интеграции

POSThttps://api.spicyapi.ai/v1/chat/completions

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

Храните API-ключ в серверной переменной окружения SPICY_API_KEY. Используйте Bearer-аутентификацию и Content-Type: application/json для JSON-запросов.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "google/gemini-3.7-flash/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Пример построен по входной схеме этой модели — той же, по которой API проверяет каждый запрос.

Для одного логического запроса сохраняйте один Idempotency-Key. После обрыва сети не отправляйте запрос автоматически с новым ключом. Сохраните request_id для проверки уже принятого запроса. Предыдущий поток чата повторно не воспроизводится.

Входные параметры

Параметры модели находятся на одном уровне с model в теле JSON. Этот эндпоинт не использует объект-обёртку input.

messagesarray<object>Обязательно

Упорядоченные реплики, старые первыми. Содержимое — строка или массив частей text, image_url и video_url. Видео отправляется как загруженный файл, а видео в одном запросе может занимать в сумме до 14 MB. Правила задачи и договорённость об инструментах — в системном сообщении, дальше добавляйте по одному ходу.

По умолчанию: Не задано
Ограничения: minItems:1

messages[].rolestringОбязательно внутри объекта

Role of the message author.

По умолчанию: Не задано
Допустимые значения: "system""developer""user""assistant""tool"

messages[].namestringНеобязательно

Optional name identifying the speaker within its role.

По умолчанию: Не задано

messages[].contentstring | array | nullНеобязательно

Message content, either plain text or a list of content parts.

По умолчанию: Не задано

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "video_url"
        ],
        "properties": {
          "type": {
            "const": "video_url"
          },
          "video_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Необязательно

Tool calls the assistant requested in this message.

По умолчанию: Не задано

messages[].tool_call_idstringНеобязательно

Identifier of the tool call this message answers. Required on tool messages.

По умолчанию: Не задано

messages[].reasoning_contentstringНеобязательно

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

По умолчанию: Не задано

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "video_url"
              ],
              "properties": {
                "type": {
                  "const": "video_url"
                },
                "video_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "minItems": 1,
  "description": "Ordered conversation turns. Text content only on this endpoint."
}

response_formatobjectНеобязательно

Просите объект JSON и называйте каждый ключ в системном сообщении — так результаты извлечения возвращаются разбираемыми.

По умолчанию: Не задано

tool_choicestring | objectНеобязательно

auto, none, required или объект с именем конкретной функции.

По умолчанию: Не задано

toolsarray<object>Необязательно

До 128 описаний функций в одном запросе.

По умолчанию: Не задано
Ограничения: maxItems:128

top_pnumberНеобязательно

От 0,01 до 1. Меняйте его либо temperature, но не оба сразу в одном сравнении.

По умолчанию: 1
Ограничения: minimum:0.01
maximum:1

temperaturenumberНеобязательно

От 0 до 2, по умолчанию 1. Google советует оставлять модели Gemini 3 на 1,0: при меньших значениях генерация может зациклиться или просесть по качеству. Структурированный вывод задавайте через response_format и системное сообщение.

По умолчанию: 1
Ограничения: minimum:0
maximum:2

seedintegerНеобязательно

Любое целое число. Тот же seed при в остальном одинаковом запросе делает ответы почти повторяющимися, так что можно менять по одному параметру и сравнивать честно; идентичный результат он не гарантирует. Значения по умолчанию нет — каждый запрос выбирает заново. На цену не влияет.

По умолчанию: Не задано

stopstring | arrayНеобязательно

До 4 последовательностей — строкой или массивом. Ответ обрывается, как только модель пишет одну из них, а совпавший текст не возвращается. Значения по умолчанию нет. Тариф не меняется: оборванный раньше ответ оплачивается только за фактически сгенерированные токены.

По умолчанию: Не задано
Ограничения: minLength:1
minItems:1
maxItems:4

reasoning_effortstringНеобязательно

minimal, low, medium или high; по умолчанию medium. Обычные шаги прекрасно идут на low, а тот шаг, который должен попасть в цель, поднимается до high отдельно.

По умолчанию: "medium"
Допустимые значения: "minimal""low""medium""high"

max_tokensintegerНеобязательно

Ограничивает ответ значением 65 536, по умолчанию 16 384. Токены на размышление берутся из этого же бюджета, поэтому слишком маленький потолок может израсходоваться до начала ответа и вернуть пустую строку. Оставляйте настоящий запас или снижайте reasoning_effort, когда ответ должен быть коротким.

По умолчанию: 16384
Ограничения: minimum:1
maximum:65536

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "seed": {
      "type": "integer",
      "x-ui": {
        "order": 55,
        "widget": "number",
        "affects_price": false
      },
      "description": "Seed for the sampler, so a repeated request comes back close to the same."
    },
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "video_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "video_url"
                    },
                    "video_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "minItems": 1,
      "description": "Ordered conversation turns. Text content only on this endpoint."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 16384,
      "maximum": 65536,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply. Thinking tokens are drawn from this same budget."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "minimal",
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "medium",
      "description": "How much the model works through the task before answering."
    }
  },
  "x-image-token-limit": 2000,
  "x-input-token-limit": 1048576,
  "additionalProperties": false,
  "x-max-tokens-includes-reasoning": true
}

Прочитать результат

При stream: false запрос сразу возвращает полный ответ чата. Читайте choices[].message; опрашивать задачу не нужно. Если клиент поддерживает Server-Sent Events, можно указать stream: true.

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

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "google/gemini-3.7-flash/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Ответ приведён для примера структуры. usage содержит число токенов; фактический расход и стоимость зависят от запроса.

SDK и интеграции

Используйте SpicyAPI в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Команды терминала и скрипты автоматизации.

MCP

Claude Code · Cursor · Codex

Agent Skill

Многоразовые инструкции для ИИ-ассистента.

n8n

Узлы сообщества для самостоятельного хостинга и импортируемые шаблоны HTTP Request для n8n Cloud.

ComfyUI

Процессы работы с изображениями, видео и аудио на узловом холсте.

Другие интеграции

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Посмотреть готовые рабочие процессы

Это чат-модель, поэтому она работает везде, где работает chat API от OpenAI: клиент оставьте свой, поменяйте базовый URL и укажите идентификатор этой модели.

Направьте сюда любой OpenAI-совместимый клиент

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/google/gemini-3.7-flash/chat

Все инструменты, поддерживающие OpenAI chat API, подключаются одинаково: SDK, Vercel AI SDK, LangChain, aider и Cline. Сервер MCP и CLI spicyapi работают с асинхронными задачами обработки медиа. Настройка каждого инструмента описана в разделе для разработчиков.

Использование в SillyTavern и приложениях для ролевых игр

В SillyTavern, RisuAI, Agnai или любом приложении с OpenAI-совместимой настройкой вставьте базовый URL ниже и свой API-ключ, а в качестве модели выберите google/gemini-3.7-flash/chat. Вызовы прямо из браузера разрешены, а ползунки, которые эта модель не поддерживает, игнорируются, а не вызывают ошибку.

Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-3.7-flash/chat

Руководство по SillyTavern RisuAI, Agnai и другие Расширение для SillyTavern

Использование в ComfyUI

Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и выберите google/gemini-3.7-flash/chat в узле SpicyAPI Chat, чтобы использовать эту модель внутри графа ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Готовые воркфлоу Руководство по установке Исходный код на GitHub

Встроенная панель читает ту же схему, что и эта страница, поэтому не может разойтись с API. Если содержимое должно индексироваться поиском по документации, возьмите JSON из /api/embed/models/ и отрисуйте его самостоятельно.

<iframe src="https://spicyapi.ai/embed/ru/models/gemini-3-7-flash/api?model=google%2Fgemini-3.7-flash%2Fchat" width="100%" height="560" loading="lazy" title="Пример запроса" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Открыть панель

Рабочая область

Отправить запрос

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

Входные параметры

Прочитать результат

SDK и интеграции

Использование в SillyTavern и приложениях для ролевых игр

Использование в ComfyUI