Documentation Index
Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
Use this file to discover all available pages before exploring further.
Введение
Gemini CLI — официальный инструмент командной строки от Google, позволяющий разработчикам взаимодействовать с AI-моделями Gemini из терминала. После настройки API APIMart вы можете использовать в Gemini CLI продвинутые модели APIMart — GPT, Claude и Gemini.Предварительные требования
Перед началом:-
Установлены Node.js и npm
Скачайте и установите с сайта Node.js (рекомендуется v16 или новее) -
Есть 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):2.2 Постоянные переменные окружения (рекомендуется)
Сохраните конфигурацию, чтобы новые сессии подхватывали её автоматически. Windows (PowerShell):- Запустите PowerShell от администратора
- Установите переменные окружения пользователя:
- Перезапустите PowerShell или перезагрузите переменные:
- Отредактируйте rc-файл вашего шелла:
- Добавьте:
- Перезагрузите:
2.3 Использование файла .env
Создайте .env в вашем проекте:
Важно: - Замените
sk-xxxxxxxxxxxx на ваш реальный ключ из консоли APIMart - Установите GEMINI_BASE_URL равным https://api.apimart.ai/v1, чтобы Gemini CLI обращался к APIMart - Добавьте .env в .gitignore, чтобы ключи не попадали в коммиты2.4 Проверьте конфигурацию
macOS/Linux:Шаг 3: Используйте Gemini CLI
3.1 Базовый чат
Интерактивная сессия:3.2 Выбор модели
3.3 Чтение промптов из файла
3.4 Сохранение вывода в файл
Шаг 4: Вызов APIMart из кода
4.1 Python SDK
4.2 JavaScript / TypeScript
4.3 cURL
Шаг 5: Выберите модель
Рекомендуемые модели
APIMart поддерживает много моделей; выбирайте по задаче и бюджету. Gemini| Имя модели | ID модели | Особенности | Подходит для |
|---|---|---|---|
| Gemini 2.0 Flash | gemini-2.0-flash-exp | Быстрая, мультимодальная | Быстрые ответы, vision + текст |
| Gemini 2.5 Pro | gemini-2.5-pro | Сильные возможности | Сложные задачи, анализ |
| Gemini 2.5 Flash | gemini-2.5-flash | Очень отзывчивая | Чат в реальном времени, пакетные задачи |
| Имя модели | ID модели | Особенности | Подходит для |
|---|---|---|---|
| GPT-5 | gpt-5 | Топовая | Рассуждения, креативный текст |
| GPT-4o | gpt-4o | Высокое качество | Общий чат, контент |
| GPT-4o Mini | gpt-4o-mini | Выгодная | Простые задачи, высокий объём |
| Имя модели | ID модели | Особенности | Подходит для |
|---|---|---|---|
| Claude Sonnet 4.5 | claude-sonnet-4-5-20250929 | Сильное рассуждение | Код, логика |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 | Очень быстрая | Q&R, чат с низкой задержкой |
Расширенные возможности
Мультимодальность (изображения)
С мультимодальной моделью, такой как Gemini 2.0 Flash:Стриминг
Получайте токены по мере поступления:Настройка параметров
Контроль случайности и длины:Часто задаваемые вопросы
Q1: «Invalid API key» или ошибки аутентификации
-
Формат ключа
- Должен начинаться с
sk- - Без лишних пробелов при вставке
- Должен начинаться с
-
Переменные окружения
-
Статус ключа
- Проверьте ключ в консоли APIMart
- Убедитесь, что на аккаунте есть баланс
Q2: Как проверить настройку API?
Q3: Какие языки поддерживаются?
Любой язык, способный отправлять HTTP-запросы, работает с APIMart:- ✅ Python — рекомендуется OpenAI SDK
- ✅ JavaScript / TypeScript — Node или браузер
- ✅ Java — HTTP-клиент
- ✅ Go — stdlib или библиотеки
- ✅ PHP — cURL или Guzzle
- ✅ Ruby — HTTP gems
- ✅ C# / .NET —
HttpClient - ✅ Swift —
URLSession - ✅ Другие — что угодно с HTTP
Q4: Где посмотреть использование и биллинг?
В консоли APIMart:- 📊 Статистика вызовов в реальном времени
- 💰 Расходы и счета
- 📈 Тенденции использования
- 🔍 Логи запросов
- ⚙️ Управление API-ключами
Q5: Распространённые ошибки API
| Ошибка | Вероятная причина | Что делать |
|---|---|---|
401 Unauthorized | Неверный или отозванный ключ | Исправьте ключ в env / консоли |
429 Too Many Requests | Лимит запросов | Замедлите или повысьте план |
500 Internal Server Error | Временная проблема сервера | Повторите позже; если сохраняется — поддержка |
insufficient_quota | Низкий баланс | Пополните в консоли |
Лучшие практики
1. Повторы и backoff
2. Контроль затрат
3. Системные промпты
Возможности
С Google AI Studio и APIMart вы получаете:- 🤖 Много моделей — GPT, Claude, Gemini и другие
- 🌍 OpenAI-совместимость — знакомая форма запросов/ответов
- ⚡ Производительность — низкая задержка, высокая параллельность
- 💰 Прозрачное ценообразование — оплата по факту
- 📊 Наблюдаемость — мониторинг вызовов в реальном времени
- 🔒 Безопасность — корпоративные меры защиты
- 🚀 Быстрая интеграция — простые HTTP / SDK вызовы
- 📚 Документация — руководства и примеры
Поддержка
- 📚 Документация APIMart
- 📚 Документация Google AI Studio
- 💬 Discord
- 🐦 Twitter @APIMart_
- 📧 zhihong@apimart.ai
Начните с APIMart
Создайте аккаунт, получите API-ключ и используйте несколько AI-моделей из рабочих процессов Google AI Studio и не только.