Gemini 3 Flash Preview API: быстрый чат на 256K

google/gemini-3-flash-preview/chat

Gemini 3 Flash Preview от Google — лёгкая чат-модель с OpenAI-совместимым API. Читает до 256 000 токенов, отвечает до 65 536, три уровня reasoning effort, до 128 инструментов, вывод JSON и стриминг.

Ввод $0.45Вывод $2.70за 1 млн токеновКешированный ввод $0.045Официальная цена Google~~$0.50~~$3

Запустить модель Открыть 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-flash-preview/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, audio_url и input_audio. Загруженные видео и аудио в сумме могут занимать до 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"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "audio_url"
        ],
        "properties": {
          "type": {
            "const": "audio_url"
          },
          "audio_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "input_audio"
        ],
        "properties": {
          "type": {
            "const": "input_audio"
          },
          "input_audio": {
            "type": "object",
            "required": [
              "data",
              "format"
            ],
            "properties": {
              "data": {
                "type": "string"
              },
              "format": {
                "enum": [
                  "wav",
                  "mp3"
                ],
                "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"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "audio_url"
              ],
              "properties": {
                "type": {
                  "const": "audio_url"
                },
                "audio_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "input_audio"
              ],
              "properties": {
                "type": {
                  "const": "input_audio"
                },
                "input_audio": {
                  "type": "object",
                  "required": [
                    "data",
                    "format"
                  ],
                  "properties": {
                    "data": {
                      "type": "string"
                    },
                    "format": {
                      "enum": [
                        "wav",
                        "mp3"
                      ],
                      "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 отдельно. У самого Google по умолчанию для этой модели high; этот эндпоинт остаётся на medium, чтобы обычные ходы оставались быстрыми.

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

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

Ограничивает ответ значением 65 536, по умолчанию 16 384. Для пошаговой игры 300–800 не дают модели ответить сразу целой главой. Токены рассуждения тарифицируются как вывод, поэтому оставляйте запас сверх ожидаемого видимого ответа.

По умолчанию: 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"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "audio_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "audio_url"
                    },
                    "audio_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "input_audio"
                  ],
                  "properties": {
                    "type": {
                      "const": "input_audio"
                    },
                    "input_audio": {
                      "type": "object",
                      "required": [
                        "data",
                        "format"
                      ],
                      "properties": {
                        "data": {
                          "type": "string"
                        },
                        "format": {
                          "enum": [
                            "wav",
                            "mp3"
                          ],
                          "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."
    },
    "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": 256000,
  "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-flash-preview/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-flash-preview/chat

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

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

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

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

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

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

Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и выберите google/gemini-3-flash-preview/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-flash-preview/api?model=google%2Fgemini-3-flash-preview%2Fchat" width="100%" height="560" loading="lazy" title="Пример запроса" style="border:1px solid rgba(0,0,0,.12)"></iframe>

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

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

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

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

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

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

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

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

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