# Gemini 3.5 Flash-Lite — текст, Google, через API СОЮЗа

> Идентификатор для поля `model`: `gemini-3.5-flash-lite`. Страница: https://souz.ai/models/gemini-3.5-flash-lite. Текст → Текст. Выпущена 21 июля 2026.

СОЮЗ — единый API к нейросетям разных вендоров: один ключ, общий баланс в рублях, списание только за успешный запрос. Эта модель вызывается по контракту ниже.

Gemini 3.5 Flash-Lite — находит данные в PDF, снимках и записях. Для разбора документов и небольших задач внутри агентов.

## Цены

Неуспешный запрос не тарифицируется. В ответах API итог — `price` у задачи и `usage.cost` у чата — целые микроединицы валюты платформы (1 единица = 1 000 000 микро), а сама валюта приезжает рядом полем `currency` (сейчас `RUB`). У незавершённой задачи `price: null`.

- Входные токены — от 21,545738 ₽ за 1M
- Выходные токены — от 179,547813 ₽ за 1M

Цены и типичное время пресетов роутинга — поле `routing`: `cheap` «Дешевле», `balanced` «Баланс» (по умолчанию), `fast` «Быстрее». Пресет задаёт порядок каналов; где пресеты начинают с одного канала, цена у них общая. Потолок `max_price_multiplier` (`1.5`, `2`, `3`, `5`, `10`) не даёт пробовать каналы дороже цены пресета больше чем во столько раз.

- Цена по каналам: Красный (`red`) — 21,545738 / 179,547813 ₽ за 1M токенов (вход / выход); Оранжевый (`orange`) — 46,929 / 391,38786 ₽ за 1M токенов (вход / выход); Жёлтый (`yellow`) — 43,091475 / 359,095625 ₽ за 1M токенов (вход / выход); Зелёный (`green`) — 43,091475 / 359,095625 ₽ за 1M токенов (вход / выход); Голубой (`cyan`) — 77,564655 / 646,372125 ₽ за 1M токенов (вход / выход).

Цена «от» — у самого дешёвого канала; цены и скорость каждого — в блоке «Каналы». При авто-роутинге цена может меняться.

## Каналы

Канал — постоянный цвет внутри модели: у каждого свои ставки, задержка, скорость и стабильность. Цвет не означает «дешёвый» или «быстрый», одинаковый цвет у другой модели — другой канал. Задержка и скорость — медиана за последний час (у чата задержка — до первого токена), стабильность — доля успешных вызовов за 7 дней; «нет данных» — замеров пока мало, а не ноль.

Каналов: 5. Данные на момент сборки страницы; свежие — `GET https://api.souz.ai/v1/models/gemini-3.5-flash-lite/channels` без ключа (там же HEX цвета, пределы входа и p90).

| Канал (`id`) | Название | Доступен | Ставки | До первого токена, p50 за сутки | Скорость, p50 за сутки | Контекст / ответ, токенов | Стабильность, 7 дней |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `red` | Красный | да | вход 21,545738 ₽, выход 179,547813 ₽ за 1M токенов; кэш 2,154574 ₽ | 0,6 с | 569 ток/с | 1 млн / 65,5 тыс. | нет данных |
| `orange` | Оранжевый | да | вход 46,929 ₽, выход 391,38786 ₽ за 1M токенов; кэш 4,6929 ₽ | 2,1 с | 522 ток/с | 1 млн / 65,5 тыс. | нет данных |
| `yellow` | Жёлтый | да | вход 43,091475 ₽, выход 359,095625 ₽ за 1M токенов; кэш 4,309148 ₽ | 0,6 с | нет данных | 1 млн / 65,5 тыс. | нет данных |
| `green` | Зелёный | да | вход 43,091475 ₽, выход 359,095625 ₽ за 1M токенов; кэш 4,309148 ₽ | 0,7 с | 653 ток/с | 1 млн / 65,5 тыс. | нет данных |
| `cyan` | Голубой | да | вход 77,564655 ₽, выход 646,372125 ₽ за 1M токенов; кэш 7,756466 ₽ | 0,6 с | нет данных | 1 млн / 65,5 тыс. | нет данных |

Как выбрать канал:

- По умолчанию канал выбирает Авто-роутинг: пресет `routing` (`cheap`, `balanced`, `fast`) задаёт порядок каналов, при отказе запрос переходит к следующему.
- На один запрос — поле `routing_options`: `{"only": ["red"]}` — только этот канал, без запасных; `{"order": ["red"]}` — сначала он, затем остальные; `"allow_fallbacks": false` — только каналы из `order`; `{"ignore": [...]}` — исключить; `{"sort": "price"}` (`latency`, `throughput`) — порядок по критерию вместо пресета; `max_price` — пределы ставок. В диалоге передавайте постоянный `session_id`: успешный канал закрепляется на 10 минут. SDK OpenAI — через `extra_body`.
- Бесплатная проверка без запуска: `POST https://api.souz.ai/v1/models/gemini-3.5-flash-lite/routing/preview` с теми же `routing`, `routing_options` и `params` — каналы в порядке попыток (`channels`) и оценка `estimated_price`; пустой `channels` — с такими условиями запрос не выполнить.
- Закрепить по умолчанию для всех запросов аккаунта к модели: `PATCH https://api.souz.ai/v1/settings` ключом управления с `{"routing_options": {"gemini-3.5-flash-lite": {"only": ["red"]}}}`. PATCH заменяет всю карту — сначала прочитайте `GET https://api.souz.ai/v1/settings` и сохраните настройки других моделей. Запрос без `routing_options` наследует настройку; `{}` в запросе — автоматический выбор на один вызов.
- MCP: https://api.souz.ai/mcp — инструменты `list_channels`, `compare_channels`, `preview_routing`, `pin_channel`, `unpin_channel`. Подключение в Claude Code: `claude mcp add --transport http souz https://api.souz.ai/mcp --header "Authorization: Bearer $SOUZ_API_KEY"`.
- Каким каналом выполнен запрос — поле `channel` в ответе (у чата — и в каждом чанке потока), в задаче, вебхуке и истории запросов; `attempt_count` — сколько было попыток.

## Подключение по API

- Адрес: `POST https://api.souz.ai/v1/chat/completions`
- Авторизация: заголовок `Authorization: Bearer <ключ>`. Ключ создаётся в кабинете: https://souz.ai/keys.
- Тело запроса — JSON, `Content-Type: application/json`, поле `model` — `gemini-3.5-flash-lite`.
- Ответ приходит сразу; формат совместим с OpenAI Chat Completions (`messages`, `choices`, `usage`). `stream: true` — ответ потоком (SSE, `data:` с чанками, в конце `[DONE]`). Сколько списано — `usage.cost` и `usage.currency`.
- Ошибки — JSON вида `{ "error": { "type", "code", "message", "detail" } }` с кодом HTTP 4xx/5xx; ветвиться — по `type` и `code`. `401` — неверный ключ; `402` с кодом `insufficient_balance` — не хватает средств на балансе, `key_spend_limit_exceeded` или `member_spend_limit_exceeded` — исчерпан лимит трат ключа или участника, повтор не поможет; `400` с кодом `capability_mismatch` или `invalid_request` — запрос не подходит модели, в `error.detail[]` — поле (`path`), причина (`reason`) и что подойдёт (`allowed`); `503 model_unavailable` — модель сейчас недоступна, повторите после `Retry-After`.
- Руководство по API целиком: https://souz.ai/docs, спецификация OpenAPI: https://api.souz.ai/openapi.json.

## Параметры запроса

Отправляются поля из этой таблицы. Кроме них — `messages` и поля OpenAI: незнакомые поля уходят модели как есть, а `routing`, `routing_options`, `max_price_multiplier` и `store` — наши, модели не передаются.

| Поле | Тип | Обязательное | Значения | По умолчанию | Описание |
| --- | --- | --- | --- | --- | --- |
| `temperature` | число | нет | число, от 0 до 2, шаг 0,1 | `1` | Температура. Чем выше, тем разнообразнее ответ. |
| `max_tokens` | целое | нет | целое, от 1 до 65 536 | — | Максимум токенов. Верхняя граница длины ответа, включая скрытые токены размышлений. |
| `reasoning_effort` | перечисление | нет | minimal, low, medium, high | `minimal` | Глубина мышления. Размышления у этой модели обязательны, выключить их нельзя. |

## Ограничения

- Контекст: 1 048 576 токенов
- Максимум в ответе: 65 536 токенов

## Примеры запроса

### cURL

```bash
curl https://api.souz.ai/v1/chat/completions \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash-lite",
    "messages": [
      {
        "role": "user",
        "content": "Привет! Что ты умеешь?"
      }
    ],
    "temperature": 1,
    "reasoning_effort": "minimal"
  }'
```

### Python

```python
import os
import requests

SOUZ_API_KEY = os.environ["SOUZ_API_KEY"]

response = requests.post(
    "https://api.souz.ai/v1/chat/completions",
    headers={"Authorization": f"Bearer {SOUZ_API_KEY}"},
    json={
      "model": "gemini-3.5-flash-lite",
      "messages": [
        {
          "role": "user",
          "content": "Привет! Что ты умеешь?"
        }
      ],
      "temperature": 1,
      "reasoning_effort": "minimal"
    },
)
print(response.json())
```

### TypeScript

```typescript
const response = await fetch("https://api.souz.ai/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOUZ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "gemini-3.5-flash-lite",
    "messages": [
      {
        "role": "user",
        "content": "Привет! Что ты умеешь?"
      }
    ],
    "temperature": 1,
    "reasoning_effort": "minimal"
  }),
});
console.log(await response.json());
```

### Канал

```python
import os
from openai import OpenAI

client = OpenAI(base_url="https://api.souz.ai/v1", api_key=os.environ["SOUZ_API_KEY"])

response = client.chat.completions.create(
    model="gemini-3.5-flash-lite",
    messages=[{"role":"user","content":"Привет! Что ты умеешь?"}],
    # Только канал «red»: без запасных каналов
    extra_body={"routing_options": {"only":["red"]}},
)
print(response.choices[0].message.content)
print(response.model_extra["channel"])  # фактический канал
```

## Примеры ответа

### Ответ

```json
{
  "id": "chatcmpl-9f2ac1",
  "object": "chat.completion",
  "created": 1774170000,
  "model": "gemini-3.5-flash-lite",
  "channel": "red",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Привет! Я умею…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 128,
    "total_tokens": 152,
    "cost": 23499,
    "currency": "RUB"
  }
}
```

## Вопросы и ответы

**Что такое Gemini 3.5 Flash-Lite?**

Gemini 3.5 Flash-Lite — находит данные в PDF, снимках и записях. Для разбора документов и небольших задач внутри агентов. Доступна в СОЮЗе по единому API и в плейграунде на этой странице.

**Сколько стоит Gemini 3.5 Flash-Lite?**

Gemini 3.5 Flash-Lite стоит: входные токены — от 21,545738 ₽ за 1M, выходные токены — от 179,547813 ₽ за 1M. Цена «от» — у самого дешёвого канала; цены и скорость каждого — в блоке «Каналы». При авто-роутинге цена может меняться. Списывается только успешный запрос по фактическому числу токенов, неудачный не стоит ничего.

**Что Gemini 3.5 Flash-Lite принимает на вход и что отдаёт?**

Gemini 3.5 Flash-Lite принимает текст и отдаёт текст.

**Какой размер контекста у Gemini 3.5 Flash-Lite?**

У Gemini 3.5 Flash-Lite контекст — 1 048 576 токенов, максимум в ответе — 65 536 токенов.

**Как вызвать Gemini 3.5 Flash-Lite через API?**

Запросом POST https://api.souz.ai/v1/chat/completions с полем model: "gemini-3.5-flash-lite" и ключом СОЮЗа в заголовке Authorization: Bearer. Формат совместим с OpenAI Chat Completions, stream: true отдаёт ответ потоком. Примеры на cURL, Python и TypeScript — в разделе «Подключение по API».

**Что такое каналы Gemini 3.5 Flash-Lite и как выбрать конкретный?**

Gemini 3.5 Flash-Lite выполняется через 5 каналов: «Красный» (red), «Оранжевый» (orange), «Жёлтый» (yellow), «Зелёный» (green) и «Голубой» (cyan). У каждого канала свои ставки, задержка, скорость и стабильность за 7 дней — они в блоке «Каналы» на этой странице и в GET https://api.souz.ai/v1/models/gemini-3.5-flash-lite/channels. Цвет не означает «дешёвый» или «быстрый», а одинаковый цвет у другой модели — другой канал. По умолчанию канал выбирает Авто-роутинг по пресету «Дешевле», «Баланс» или «Быстрее». Конкретный канал задаёт поле routing_options: {"only": ["red"]} — только этот канал, {"order": ["red"]} — сначала он, затем остальные. Чтобы закрепить канал для всех запросов к модели, сохраните ту же настройку в аккаунте: PATCH https://api.souz.ai/v1/settings ключом управления или в кабинете. Каким каналом выполнен запрос, видно в поле channel ответа и в истории.

**Можно ли попробовать Gemini 3.5 Flash-Lite без кода?**

Да: плейграунд на этой странице запускает Gemini 3.5 Flash-Lite с теми же параметрами, что и API. Нужен аккаунт СОЮЗа. Итоговая стоимость считается по фактическому расходу токенов. Пока запрос выполняется, в истории вместо цены стоит прочерк; итог появляется только после завершения.

**Когда вышла Gemini 3.5 Flash-Lite?**

Gemini 3.5 Flash-Lite выпущена Google 21 июля 2026.

## Ссылки

- Страница модели: https://souz.ai/models/gemini-3.5-flash-lite
- Каталог моделей: https://souz.ai/models
- Все модели одним файлом: https://souz.ai/llms.txt
- Кабинет (ключи, баланс, история запросов): https://souz.ai/overview