Skip to main content

Введение

Gemini CLI — официальный инструмент командной строки от Google, позволяющий разработчикам взаимодействовать с AI-моделями Gemini из терминала. После настройки API APIMart вы можете использовать в Gemini CLI продвинутые модели APIMart — GPT, Claude и Gemini.

Предварительные требования

Перед началом:
  1. Установлены Node.js и npm
    Скачайте и установите с сайта Node.js (рекомендуется v16 или новее)
  2. Есть API-ключ APIMart
    Войдите в консоль APIMart и скопируйте API-ключ (начинается с sk-)
Совет: если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на APIMart и создайте API-ключ.

Шаг 1: Установите Gemini CLI

1.1 Глобальная установка

Установите Gemini CLI глобально через npm:

1.2 Проверка установки

Проверьте, что CLI доступен:
Если выводится номер версии, установка прошла успешно.
Совет: если команда не найдена, перезапустите терминал или проверьте настройку глобального PATH npm.

Шаг 2: Настройте API APIMart

2.1 Временные переменные окружения

Для тестирования или разового использования; значения теряются при закрытии терминала. Windows (PowerShell):
macOS/Linux (Bash):

2.2 Постоянные переменные окружения (рекомендуется)

Сохраните конфигурацию, чтобы новые сессии подхватывали её автоматически. Windows (PowerShell):
  1. Запустите PowerShell от администратора
  2. Установите переменные окружения пользователя:
  1. Перезапустите PowerShell или перезагрузите переменные:
macOS/Linux (Bash):
  1. Отредактируйте rc-файл вашего шелла:
  1. Добавьте:
  1. Перезагрузите:

2.3 Использование файла .env

Создайте .env в вашем проекте:
Загрузите переменные перед запуском Gemini: macOS/Linux:
Windows (PowerShell):
Важно: - Замените sk-xxxxxxxxxxxx на ваш реальный ключ из консоли APIMart - Установите GEMINI_BASE_URL равным https://api.apimart.ai/v1, чтобы Gemini CLI обращался к APIMart - Добавьте .env в .gitignore, чтобы ключи не попадали в коммиты

2.4 Проверьте конфигурацию

macOS/Linux:
Windows (PowerShell):
Если значения корректные, конфигурация настроена.

Шаг 3: Используйте Gemini CLI

3.1 Базовый чат

Интерактивная сессия:
Разовый промпт:

3.2 Выбор модели

Или:

3.3 Чтение промптов из файла

Или через pipe:

3.4 Сохранение вывода в файл

Шаг 4: Вызов APIMart из кода

4.1 Python SDK

4.2 JavaScript / TypeScript

4.3 cURL

Шаг 5: Выберите модель

Рекомендуемые модели

APIMart поддерживает много моделей; выбирайте по задаче и бюджету. Gemini GPT Claude
Быстрый выбор: - 🚀 Стек Google-стиля: gemini-2.0-flash-exp, gemini-2.5-pro - 💡 Кодинг: claude-sonnet-4-5-20250929, gpt-5 - 💰 Экономия: gpt-4o-mini, claude-haiku-4-5-20251001 - ⚡ Скорость: gemini-2.0-flash-exp, gpt-4o-mini

Расширенные возможности

Мультимодальность (изображения)

С мультимодальной моделью, такой как Gemini 2.0 Flash:

Стриминг

Получайте токены по мере поступления:

Настройка параметров

Контроль случайности и длины:

Часто задаваемые вопросы

Q1: «Invalid API key» или ошибки аутентификации

  1. Формат ключа
    • Должен начинаться с sk-
    • Без лишних пробелов при вставке
  2. Переменные окружения
  3. Статус ключа
    • Проверьте ключ в консоли APIMart
    • Убедитесь, что на аккаунте есть баланс

Q2: Как проверить настройку API?

Q3: Какие языки поддерживаются?

Любой язык, способный отправлять HTTP-запросы, работает с APIMart:
  • Python — рекомендуется OpenAI SDK
  • JavaScript / TypeScript — Node или браузер
  • Java — HTTP-клиент
  • Go — stdlib или библиотеки
  • PHP — cURL или Guzzle
  • Ruby — HTTP gems
  • C# / .NETHttpClient
  • SwiftURLSession
  • Другие — что угодно с HTTP

Q4: Где посмотреть использование и биллинг?

В консоли APIMart:
  • 📊 Статистика вызовов в реальном времени
  • 💰 Расходы и счета
  • 📈 Тенденции использования
  • 🔍 Логи запросов
  • ⚙️ Управление API-ключами

Q5: Распространённые ошибки API

Лучшие практики

1. Повторы и backoff

2. Контроль затрат

3. Системные промпты

Возможности

С Google AI Studio и APIMart вы получаете:
  • 🤖 Много моделей — GPT, Claude, Gemini и другие
  • 🌍 OpenAI-совместимость — знакомая форма запросов/ответов
  • Производительность — низкая задержка, высокая параллельность
  • 💰 Прозрачное ценообразование — оплата по факту
  • 📊 Наблюдаемость — мониторинг вызовов в реальном времени
  • 🔒 Безопасность — корпоративные меры защиты
  • 🚀 Быстрая интеграция — простые HTTP / SDK вызовы
  • 📚 Документация — руководства и примеры

Поддержка


Начните с APIMart

Создайте аккаунт, получите API-ключ и используйте несколько AI-моделей из рабочих процессов Google AI Studio и не только.