Beam 1.0 API
reflection/beam-1.0/chatРабочая область
Отправить запрос
Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.
SDK и интеграцииhttps://api.spicyapi.ai/v1/chat/completionsАутентификация API
Храните API-ключ в серверной переменной окружения SPICY_API_KEY. Используйте Bearer-аутентификацию и Content-Type: application/json для JSON-запросов.
Authorization: Bearer $SPICY_API_KEYcurl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "reflection/beam-1.0/chat",
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'Определения параметров недоступны. Повторите попытку позже.
Для одного логического запроса сохраняйте один Idempotency-Key. После обрыва сети не отправляйте запрос автоматически с новым ключом. Сохраните request_id для проверки уже принятого запроса. Предыдущий поток чата повторно не воспроизводится.
Входные параметры
Определения параметров недоступны. Повторите попытку позже.
Прочитать результат
При stream: false запрос сразу возвращает полный ответ чата. Читайте choices[].message; опрашивать задачу не нужно. Если клиент поддерживает Server-Sent Events, можно указать stream: true.
{
"id": "chatcmpl_example",
"object": "chat.completion",
"created": 1788652800,
"model": "reflection/beam-1.0/chat",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Here is a concise summary of the release notes."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 32,
"completion_tokens": 14,
"total_tokens": 46
}
}Ответ приведён для примера структуры. usage содержит число токенов; фактический расход и стоимость зависят от запроса.
SDK и интеграции
Используйте SpicyAPI в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.
Это чат-модель, поэтому она работает везде, где работает chat API от OpenAI: клиент оставьте свой, поменяйте базовый URL и укажите идентификатор этой модели.
export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"
aider --model openai/reflection/beam-1.0/chatВсе инструменты, поддерживающие OpenAI chat API, подключаются одинаково: SDK, Vercel AI SDK, LangChain, aider и Cline. Сервер MCP и CLI spicyapi работают с асинхронными задачами обработки медиа. Настройка каждого инструмента описана в разделе для разработчиков.
Использование в SillyTavern и приложениях для ролевых игр
В SillyTavern, RisuAI, Agnai или любом приложении с OpenAI-совместимой настройкой вставьте базовый URL ниже и свой API-ключ, а в качестве модели выберите reflection/beam-1.0/chat. Вызовы прямо из браузера разрешены, а ползунки, которые эта модель не поддерживает, игнорируются, а не вызывают ошибку.
Base URL: https://api.spicyapi.ai/v1
Model: reflection/beam-1.0/chatИспользование в ComfyUI
Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и выберите reflection/beam-1.0/chat в узле SpicyAPI Chat, чтобы использовать эту модель внутри графа ComfyUI.
cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapiВстроенная панель читает ту же схему, что и эта страница, поэтому не может разойтись с API. Если содержимое должно индексироваться поиском по документации, возьмите JSON из /api/embed/models/ и отрисуйте его самостоятельно.
<iframe src="https://spicyapi.ai/embed/ru/models/reflection-beam-1-0/api?model=reflection%2Fbeam-1.0%2Fchat" width="100%" height="560" loading="lazy" title="Пример запроса" style="border:1px solid rgba(0,0,0,.12)"></iframe>