Skip to main content
Google Gemini — це дуже потужна AI система діалогу, яка може генерувати плавні та природні відповіді всього за кілька секунд, якщо ввести підказку. Gemini може надати вражаючу інтелектуальну допомогу, значно підвищуючи продуктивність і креативність людей. Цей документ в основному описує процес використання Gemini Chat Completion API, за допомогою якого ми можемо легко використовувати офіційні функції діалогу Gemini.

Процес заявки

Щоб використовувати Gemini Chat Completion API, спочатку можна перейти на сторінку Gemini Chat Completion API і натиснути кнопку «Acquire», щоб отримати необхідні для запиту облікові дані: Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, запрошуючи вас зареєструватися та увійти. Після входу або реєстрації ви автоматично повернетеся на цю сторінку. При першій заявці буде надано безкоштовний ліміт, який дозволяє безкоштовно використовувати цей API.

Основне використання

Далі ви можете заповнити відповідні поля на інтерфейсі, як показано на малюнку:

При першому використанні цього інтерфейсу нам потрібно заповнити принаймні три поля: одне з них — authorization, яке можна вибрати безпосередньо зі списку. Інший параметр — model, model — це категорія моделі, яку ми вибираємо для використання з офіційного сайту Gemini, тут у нас є 6 основних моделей, деталі можна переглянути в наданих моделях. Останній параметр — messages, messages — це масив запитів, який представляє можливість одночасно завантажувати кілька запитів, кожен з яких містить role та content, де role вказує на роль запитувача, ми надали три ідентичності: user, assistant, system. Інший content — це конкретний зміст нашого запиту. Ви також можете помітити, що праворуч є відповідний код виклику, який ви можете скопіювати та запустити, або просто натиснути кнопку «Try» для тестування.

Після виклику ми отримуємо наступний результат:
Повернений результат містить кілька полів, описаних нижче:
  • id, ID, що генерує цю задачу діалогу, використовується для унікальної ідентифікації цієї задачі діалогу.
  • model, вибрана модель з офіційного сайту Gemini.
  • choices, інформація про відповіді Gemini на запитання.
  • usage: статистична інформація про токени для цього запитання-відповіді.
Серед choices міститься інформація про відповіді Gemini, в якій choices є конкретною інформацією про відповіді Gemini, як показано на малюнку.

Можна побачити, що поле content в choices містить конкретний зміст відповіді Gemini.

Потокова відповідь

Цей інтерфейс також підтримує потокову відповідь, що дуже корисно для веб-інтеграції, оскільки дозволяє веб-сторінці реалізувати ефект поетапного відображення. Якщо ви хочете отримати потокову відповідь, ви можете змінити параметр stream в заголовку запиту на true. Зміна, як показано на малюнку, але код виклику потребує відповідних змін, щоб підтримувати потокову відповідь.

Після зміни stream на true, API буде повертати відповідні JSON дані по рядках, на рівні коду нам потрібно внести відповідні зміни, щоб отримати результати по рядках. Приклад коду виклику на Python:
Вихідний результат виглядає наступним чином:
Можна побачити, що choices містить інформацію, яка узгоджується з основним використанням, це включає конкретний зміст відповідей Gemini на кілька діалогів, що дозволяє відповідати на відповідні питання на основі кількох діалогових змістів.

Gemini-3.0 багатофункціональна модель

Приклад запиту:
Приклад результату:
Звичайно, ви також можете передати посилання на відео, конкретний вхід виглядає так:
Приклад результату:
З вище наведеного видно, що модель Gemini 3.0 може підтримувати мультимодальне розуміння.

Gemini-3.1 Мультимодальна модель

Gemini 3.1 Pro є оновленою версією Gemini 3.0 Pro, базова модель - gemini-3.1-pro-preview, також підтримує текстові, зображення, відео та інші мультимодальні входи, має більш потужні можливості для міркування та розуміння. Спосіб використання повністю ідентичний Gemini 3.0 Pro, потрібно лише замінити параметр model на gemini-3.1-pro. Приклад запиту:
Gemini 3.1 Pro також підтримує розуміння відео:
Формат відповіді такий же, як у Gemini 3.0 Pro, деталі дивіться в розділі про мультимодальні моделі Gemini-3.0 вище.

Обробка помилок

При виклику API, якщо виникає помилка, API поверне відповідний код помилки та інформацію. Наприклад:
  • 400 token_mismatched: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 400 api_not_implemented: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 401 invalid_token: Неавторизовано, недійсний або відсутній токен авторизації.
  • 429 too_many_requests: Занадто багато запитів, ви перевищили ліміт запитів.
  • 500 api_error: Внутрішня помилка сервера, щось пішло не так на сервері.

Приклад відповіді на помилку

Висновок

Завдяки цьому документу, ви дізналися, як використовувати API Gemini Chat Completion для легкого реалізації функцій діалогу офіційного Gemini. Сподіваємося, цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.