Download the PHP package tigusigalpa/gigachat-php without Composer

On this page you can find all versions of the php package tigusigalpa/gigachat-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of tigusigalpa/gigachat-php

Informations about the package gigachat-php

GigaChat PHP SDK

GigaChat PHP SDK

PHP SDK для Sber GigaChat API с поддержкой Laravel. Streaming и обычные запросы.

Latest Version PHP Version License

Язык: Русский | English

Другие версии: Golang SDK

Возможности

Установка

Из Packagist

Через Composer:

Laravel

Пакет регистрируется автоматически. Опубликуйте конфиг:

Настройка

1. Получение ключей

  1. Зарегистрируйтесь в Sber AI
  2. Создайте проект, получите Client ID и Client Secret
  3. Сгенерируйте Authorization Key (Base64 от "Client ID:Client Secret")

См.: Создание проекта и получение ключей

2. Окружение

Добавьте в .env:

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

Без Laravel

С Laravel

Используйте Facade:

Диалоги

Streaming

Eloquent Trait

Модели

Актуальный список: официальная документация

Генерация текста

Модель Описание Использование
GigaChat-2 Базовая модель второго поколения Общие задачи, диалоги
GigaChat-2-Pro Продвинутая модель с улучшенными возможностями Сложные задачи, креативное письмо
GigaChat-2-Max Максимальная модель для самых сложных задач Профессиональные задачи, анализ

Эмбеддинги

Модель Описание Использование
Embeddings Базовая модель для векторного представления Поиск по смыслу, кластеризация
EmbeddingsGigaR Улучшенная модель для создания эмбеддингов Точный поиск, семантический анализ

Константы моделей

Параметры генерации

php

Стилизация

php $result = $client->createImage("Нарисуй футуристический город", [ 'system_message' => 'Ты — архитектор будущего' ]);

// $result: content (base64), file_id, response file_put_contents('city.jpg', base64_decode($result['content']));

Laravel

Методы изображений

Метод Описание Возвращает
generateImage($prompt, $options) Генерация, ответ API array
downloadImage($fileId) Скачать по ID string (base64)
createImage($prompt, $options) Генерация + скачивание array
drawImage($description, $options) Laravel: добавляет "Нарисуй" array
drawImageInStyle($description, $style, $options) Laravel: со стилем художника array
extractImageId($content) Извлечь ID из HTML string\|null

Ошибки изображений

Важно: Промпт должен содержать "нарисуй". API вызывает text2image при function_call: auto.

Обработка ошибок

Исключения:

Коды ошибок

Авторизация (400-401)

Код HTTP Описание Решение
1 400 scope data format invalid Проверьте формат поля scope
4 401 Can't decode 'Authorization' header Проверьте корректность ключа авторизации
5 400 scope is empty Укажите scope: GIGACHAT_API_PERS, GIGACHAT_API_B2B или GIGACHAT_API_CORP
6 401 credentials doesn't match db data Перевыпустите ключ авторизации в личном кабинете
7 401 scope from db not fully includes consumed scope Укажите корректную версию API в scope

Лимиты (402-403)

HTTP Описание Причина Решение
402 Payment Required Закончились токены модели Проверьте лимит токенов в личном кабинете
403 Permission denied Нет доступа к методу Проверьте тарифный план (например, GET /balance недоступен для pay-as-you-go)

Размер данных (413)

HTTP Описание Причина Решение
413 Payload too large Превышен размер входных данных Уменьшите размер промпта или файлов

Параметры (422)

HTTP Описание Причина Решение
422 Requested model does not support functions Модель не поддерживает функции Используйте другую модель или отключите функции
422 system message must be the first message Неверный порядок сообщений Системное сообщение должно быть первым
422 Unprocessable Entity Файл превышает размер контекста Разделите или сократите файл

Rate Limit (429)

HTTP Описание Причина Решение
429 Too Many Requests Превышен лимит одновременных запросов Уменьшите частоту запросов, добавьте задержки

Сервер (500)

HTTP Описание Причина Решение
500 Internal Server Error Ошибка сервиса GigaChat Обратитесь в службу поддержки

Retry-обработчик

Отладка

См.: Ошибки GigaChat API

Artisan-команды

Rate Limiting

Тестирование

Запуск

Интеграционные тесты

Для запуска интеграционных тестов с реальным API:

Покрытие

См. tests/README.md

Примеры

Чат-бот

Генерация контента

Streaming

Laravel-тесты

FAQ

Как получить Client ID и Client Secret?
Зарегистрируйтесь в Sber AI и создайте проект.

Ошибка "Invalid token response"?
Проверьте Client ID/Secret и доступность сервиса авторизации.

SSL-сертификаты?
Установите GIGACHAT_CERT_PATH в путь к сертификату или false.

Production?
Да. Настройте SSL и rate limiting.

Тарифы?
Официальная документация

SSL-ошибки

Очистите кэш после изменений:

Полная конфигурация

config/gigachat.php:

Требования

Лицензия

MIT. См. LICENSE.

Ссылки

Поддержка

Участие

  1. Форкните репозиторий
  2. Создайте ветку (git checkout -b feature/name)
  3. Зафиксируйте изменения (git commit -m 'Add feature')
  4. Отправьте (git push origin feature/name)
  5. Откройте Pull Request

Следуйте PSR-12, добавляйте тесты, обновляйте документацию.

Безопасность

Уязвимости отправляйте на [email protected] (не в публичные issues).

Laravel 12

Полная совместимость:

Roadmap

All versions of gigachat-php with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
guzzlehttp/guzzle Version ^7.8.2
illuminate/support Version ^8|^9|^10|^11|^12|^13
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tigusigalpa/gigachat-php contains the following files

Loading the files please wait ...