Перейти к основному контенту

Рабочая область

Отправить запрос

Быстрый старт

Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.

SDK и интеграции
POSThttps://api.spicyapi.ai/v1/chat/completions

Аутентификация API

Храните API-ключ в серверной переменной окружения SPICY_API_KEY. Используйте Bearer-аутентификацию и Content-Type: application/json для JSON-запросов.

Authorization: Bearer $SPICY_API_KEY
curl --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": "anthropic/claude-sonnet-5.5/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "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'

Пример построен по входной схеме этой модели — той же, по которой API проверяет каждый запрос.

Для одного логического запроса сохраняйте один Idempotency-Key. После обрыва сети не отправляйте запрос автоматически с новым ключом. Сохраните request_id для проверки уже принятого запроса. Предыдущий поток чата повторно не воспроизводится.

Входные параметры

Параметры модели находятся на одном уровне с model в теле JSON. Этот эндпоинт не использует объект-обёртку input.

messagesarray<object>Обязательно

Реплики диалога по порядку, от старых к новым. Роли: system, developer, user, assistant и tool; сообщения system и developer становятся инструкциями модели. Содержимое — строка или массив частей text и image_url. Результат инструмента передаётся сообщением с ролью tool и его tool_call_id.

По умолчанию
Не задано
Ограничения
minItems:1
tool_choicestringНеобязательно

auto или none. Sonnet 5.5 не принимает принудительный выбор инструмента: чтобы получить конкретный вызов, назовите инструмент в промпте и оставьте здесь auto.

По умолчанию
Не задано
Допустимые значения
"auto""none"
parallel_tool_callsbooleanНеобязательно

По умолчанию true. Если поставить false, модель вызывает не больше одного инструмента за ход, что подходит для цепочек, где каждый вызов зависит от результата предыдущего. Имеет значение только при переданных tools; при tool_choice none инструменты не вызываются ни с одним из значений.

По умолчанию
true
toolsarray<object>Необязательно

До 128 определений функций на запрос в формате OpenAI function: для каждой — name, description и параметры в виде JSON-схемы.

По умолчанию
Не задано
Ограничения
maxItems:128
stopstring | arrayНеобязательно

До 4 последовательностей, строкой или массивом. Ответ обрывается, как только модель напишет одну из них, а сама совпавшая строка в ответ не попадает. Значения по умолчанию нет. Тариф не меняется: оборванный ответ оплачивается только за произведённые токены.

По умолчанию
Не задано
Ограничения
minLength:1
minItems:1
maxItems:4
reasoning_effortstringНеобязательно

none, low, medium, high, xhigh или max; по умолчанию medium. none просит модель не размышлять перед ответом (режим between_tools у Anthropic), хотя в длинных диалогах она всё же может ненадолго задуматься; каждый уровень выше допускает больше размышления. Собственное значение Anthropic для этой модели — high; medium следует их совету начинать чат и задачи, чувствительные к задержке, с medium или low. На цену за токен не влияет.

По умолчанию
"medium"
Допустимые значения
"none""low""medium""high""xhigh""max"
max_tokensintegerНеобязательно

Ограничивает ответ значением до 128 000; по умолчанию 4 096. Размышление входит в тот же бюджет, поэтому малый предел может уйти на рассуждения, не дойдя до конца видимого ответа, — оставляйте реальный запас, особенно на high, xhigh и max. Даже при reasoning_effort none в длинных диалогах она может ненадолго задуматься, поэтому и здесь оставляйте не меньше 4 000 токенов.

По умолчанию
4096
Ограничения
minimum:1
maximum:128000

Прочитать результат

При stream: false запрос сразу возвращает полный ответ чата. Читайте choices[].message; опрашивать задачу не нужно. Если клиент поддерживает Server-Sent Events, можно указать stream: true.

Пример ответа после завершения
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "anthropic/claude-sonnet-5.5/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 в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.

Использование в SillyTavern и приложениях для ролевых игр

В SillyTavern, RisuAI, Agnai или любом приложении с OpenAI-совместимой настройкой вставьте базовый URL ниже и свой API-ключ, а в качестве модели выберите anthropic/claude-sonnet-5.5/chat. Вызовы прямо из браузера разрешены, а ползунки, которые эта модель не поддерживает, игнорируются, а не вызывают ошибку.

Base URL: https://api.spicyapi.ai/v1
Model: anthropic/claude-sonnet-5.5/chat

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

Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и выберите anthropic/claude-sonnet-5.5/chat в узле SpicyAPI Chat, чтобы использовать эту модель внутри графа ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi