Playground

Playground — встроенный в консоль инструмент для тестирования моделей. В нем можно опробовать модели для диалога, генерации изображений и синтеза речи без написания кода. Используйте его, чтобы сравнивать модели, настраивать параметры и запросы перед интеграцией.

#Перед началом работы

• Сервис LLM API активирован, и на вашем аккаунте есть квота.
• У вас есть хотя бы один включенный ключ API. Playground автоматически отправляет запросы с одним из включенных ключей, отдавая предпочтение ключу из группы по умолчанию. Если подходящего ключа нет, на странице появится сообщение Сначала создайте ключ API. Создайте его в разделе LLM API → API-токены.

#Открытие Playground

В левом меню выберите LLM API → Playground (/llm/playground). Панель Настройки расположена слева; вкладки Режим переключают между Диалог, Генерация изображений и Речь. Соответствующая рабочая область находится справа.

#Диалог

1. В разделе Режим выберите Диалог.
2. Выберите модель из раскрывающегося списка Модель. Для поиска можно ввести текст.
3. Необязательно: задайте роль и поведение ассистента в поле Системный промпт. Значение по умолчанию — «Вы — полезный помощник.».
4. Необязательно: параметр Потоковый вывод включен по умолчанию, поэтому ответы появляются по мере генерации. Отключите его, чтобы получать ответ целиком.
5. Введите сообщение в поле справа. Нажмите Enter, чтобы отправить его, или Shift+Enter для переноса строки.

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

Отдельные сообщения можно копировать, генерировать заново или удалять. Нажмите Очистить, чтобы очистить диалог.

#Изображение

1. В разделе Режим выберите Генерация изображений.
2. Выберите модель генерации изображений и опишите нужное изображение.
3. Если модель поддерживает эти параметры, задайте Размер (1024x1024, 1024x1792, 1792x1024, 512x512 или 256x256), Качество (Стандартный — Стандартное или HD) и Стиль (Выразительный — Яркий или Естественный — Естественный).
4. Отправьте запрос и дождитесь результата. Созданные изображения можно скачать.

#Аудио (синтез речи)

1. В разделе Режим выберите Речь, затем Синтез речи (TTS).
2. Выберите модель, например tts-1 или tts-1-hd, и Голос: Alloy, Echo, Fable, Nova, Onyx или Shimmer.
3. Ползунком задайте Скорость от 0.25x до 4x. По умолчанию — 1x.
4. Введите текст и отправьте запрос. Созданную аудиозапись можно воспроизвести в браузере или скачать.

#От Playground к коду

Когда подберете подходящие настройки, передайте те же параметры через API. Например, приведенным выше настройкам диалога соответствует такой запрос:

curl https://llm.yeap.cloud/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello"}
    ],
    "temperature": 0.7,
    "max_tokens": 2000,
    "top_p": 1
  }'

Для синтеза речи используется POST /v1/audio/speech (параметры model, input, voice и speed). Для генерации изображений — POST /v1/images/generations.

#Устранение неполадок

• Модель из списка возвращает ошибку: Playground показывает модели платформы, но не все они доступны группе вашего ключа. Попробуйте другую модель или проверьте страницу Модели и измените группу ключа.
• Недостаточно квоты: переведите квоту на аккаунт или проверьте ограничение квоты ключа, используемого Playground.
• Тестирование с определенным ключом: Playground выбирает ключ автоматически. Чтобы протестировать ключ с определенной группой или лимитами, вызовите API напрямую с помощью curl или SDK. См. Быстрый старт.