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

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

Щоб використовувати API Gemini Chat Completion, спочатку перейдіть до консолі Ace Data Cloud, щоб отримати ваш API Token, залиште його на випадок потреби. Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, запрошуючи вас зареєструватися та увійти, після чого ви будете автоматично повернені на цю сторінку. Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо подавати заявку на кожну послугу. Перший запит на отримання токена надає безкоштовний ліміт, щоб ви могли безкоштовно спробувати; якщо ліміт вичерпано, ви можете поповнити загальний баланс в консолі.
📘 Повна документація: Gemini Chat Completion API →

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

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

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

Порада: gemini-3.x серії flash є моделями мислення, які спочатку споживають токени reasoning; будь ласка, встановіть max_tokens на 512 або більше, інакше може повернутися лише порожній вміст. gemini-3.6-flash є рекомендованою Flash моделлю, яка підтримує до 1 мільйона токенів контексту, вхід зображень, виклики інструментів та потокові відповіді; наразі викликається через інтерфейс Chat Completions.
Після виклику ми отримуємо наступний результат:
Повернений результат містить кілька полів, описаних нижче:
  • id, ID, що генерує цю задачу діалогу, використовується для унікальної ідентифікації цієї задачі діалогу.
  • model, вибрана модель з сайту Gemini.
  • choices, інформація про відповіді Gemini на запитання.
  • usage: статистична інформація про токени для цього запитання-відповіді.
Серед choices міститься інформація про відповіді Gemini, в якій choices є конкретною інформацією про відповідь Gemini, як показано на малюнку.

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

Розуміння зображень (мультимодальний вхід)

Gemini є рідною мультимодальною моделлю, яка може безпосередньо «бачити зображення». Щоб передати зображення, змініть content певного повідомлення з рядка на масив блоків вмісту, в якому одночасно містяться блоки text та image_url — це повністю сумісно з форматом OpenAI та офіційним форматом Gemini. image_url.url підтримує два способи запису:
  • base64 data: URI (рекомендується, найбільш стабільно): формат data:<тип медіа>;base64,<дані>, наприклад, data:image/jpeg;base64,/9j/4AAQ.... Тип медіа (MIME) вже вказано в префіксі data:, тому не потрібно, і не існує окремого поля media_type.
  • Публічно доступний URL зображення: наприклад, https://cdn.acedata.cloud/4hfydw.jpg.
Підтримувані типи зображень: png, jpeg, webp, heic, heif. Приклад коду виклику на Python (base64 data URI):
Також можна безпосередньо передати URL зображення, доступного для публічного перегляду:
💡 image_url приймає лише поле url (значення може бути URL зображення або base64 data: URI), а також необов’язкове поле detail. Не передавайте media_type — це поле зображення Anthropic Claude, яке не належить формату image_url OpenAI / Gemini.

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

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

Після зміни stream на true, API буде повертати відповідні JSON дані по рядках, і на рівні коду нам потрібно внести відповідні зміни, щоб отримати результати по рядках. Приклад коду виклику на Python:
Вихід виглядає наступним чином:
Як видно, у відповіді є багато data, в яких choices є останнім вмістом відповіді, що відповідає вищезгаданому змісту. choices — це новий вміст відповіді, який ви можете інтегрувати у вашу систему. Водночас закінчення потокової відповіді визначається за вмістом data, якщо вміст дорівнює [DONE], це означає, що відповідь у потоковому режимі завершена. Повернуті результати data мають кілька полів, описаних нижче:
  • id,генерація ID для цього діалогового завдання, що використовується для унікальної ідентифікації цього діалогового завдання.
  • model , вибраний модель з офіційного сайту Gemini.
  • choices, відповіді Gemini на запитання.
JavaScript також підтримується, наприклад, код для потокового виклику Node.js виглядає так:
Приклад коду на Java:
Інші мови можна переписати самостійно, принцип однаковий.

Багатократний діалог

Якщо ви хочете підключити функцію багатократного діалогу, потрібно завантажити кілька запитів у поле messages, приклади кількох запитів наведені на малюнку нижче:

Приклад коду на Python:
Завантаживши кілька запитів, ви можете легко реалізувати багатократний діалог, отримавши такі відповіді:
Як видно, інформація в choices відповідає основному вмісту, це містить конкретний зміст відповідей Gemini на кілька діалогів, що дозволяє відповідати на відповідні запитання на основі кількох діалогів.

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

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

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

gemini-3.1-pro-preview - це офіційний ідентифікатор моделі 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: Внутрішня помилка сервера, щось пішло не так на сервері.

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

Висновок

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