Плейграунд
Откройте плейграунд, чтобы попробовать модель из каталога до написания интеграционного кода. Доступные операции зависят от выбранной модели.
Первый запрос
- Войдите в MakuraConsole и выберите модель.
- Проверьте пространство под полем ввода. Сессия Console даёт доступ без ввода ключа; для организации нужны права владельца или администратора.
- Укажите текст или прикрепите исходный файл для выбранной операции и отправьте запрос.
Запросы через сессию оплачиваются из кошелька выбранного пространства. В настройках можно выбрать Мой API-ключ и указать ключ для генерации (sk-maku-); тогда используются кошелёк и ограничения этого ключа. Ключ для интеграции создаётся в кабинете или во время начала работы. Provisioning-ключ для генерации не подходит. Системная инструкция и параметры текстового чата настраиваются в панели настроек. Для интеграции откройте пример cURL рядом с полем сообщения; ключ в него не подставляется.
Доступные операции
- Чат: текстовые и мультимодальные ответы поступают по мере генерации.
- Изображения: создайте изображение по описанию или приложите исходные PNG/JPEG/WebP для редактирования — до четырёх файлов по 2 МБ. Если модель умеет оба варианта, наличие исходников выбирает редактирование. Моделям только для редактирования всегда нужен исходник.
- Синтез речи: введите текст до 4 096 символов и имя или ID голоса, который поддерживает модель. Готовое аудио можно прослушать и скачать. Инструкции для озвучки доступны у поддерживающих их моделей.
- Распознавание речи: прикрепите один аудиофайл до 10 МБ в формате MP3, MPGA, MPEG, MP4, M4A, WAV, WebM, OGG или FLAC. При необходимости укажите язык двухбуквенным кодом, например
ru, если модель поддерживает этот параметр. Результат появится в виде текста.
Работа с разговором
Вы можете начать новый чат, найти, переименовать или удалить существующий, скопировать ответ, повторить генерацию и выгрузить текстовую историю в JSON. Генерацию можно остановить; уже полученная часть ответа остаётся в разговоре. После ошибки можно повторить запрос.
К текстовому запросу можно приложить до четырёх файлов: текстовые и исходный код до 50 КБ каждый, PNG/JPEG/WebP до 2 МБ каждый. Для изображений нужна модель с входной модальностью изображения. В сценарии «Изображения» исходники доступны у моделей с поддержкой редактирования.
Хранение
История хранится локально в этом браузере и разделяется по аккаунтам и пространствам. Сохраняются до 50 разговоров, до 100 сообщений в каждом. Очистка данных браузера удаляет локальную историю. Чаты не синхронизируются между устройствами.
Доступ через сессию остаётся после перезагрузки, пока вы авторизованы. Дополнительный API-ключ хранится только в памяти страницы и очищается при перезагрузке, смене аккаунта или пространства. Временный ключ сессии BFF никогда не передаётся браузеру. Прикреплённые изображения и аудиофайлы, а также изображения и аудио в ответах не сохраняются в истории. Сохраните нужные результаты до ухода со страницы. Для повторного редактирования или распознавания после перезагрузки прикрепите исходный файл заново. Текст транскрипции и текстовые вложения входят в локальную историю.
Для дальнейшей интеграции используйте быстрый старт и справочник API.