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

Совместимость с OpenAI

Оставьте код для OpenAI, смените только базовый URL

SpicyAPI понимает формат chat completions от OpenAI. Направьте любой совместимый SDK, фреймворк или чат-приложение на наш базовый URL, укажите ID модели из каталога — и получайте ответы потоком, как обычно.

Что такое OpenAI-совместимый API?

Он принимает те же запросы, что и чат-API OpenAI. Любой инструмент для OpenAI заработает со SpicyAPI, если изменить три настройки.

  1. Ваше приложение или чат-клиентOpenAI SDK, LangChain, SillyTavern…
  2. SpicyAPIapi.spicyapi.ai/v1
  3. Чат-моделиМоделей: 26, один ключ
Ваш код по-прежнему шлёт запросы в формате OpenAI. Меняются только адрес, ключ и название модели.

Подходит для

  • Приложения на OpenAI SDKЗамените адрес и ключ. Остальной код остаётся прежним.
  • Ролевые игры и чатыSillyTavern, RisuAI и Agnai подключаются как свой OpenAI-эндпоинт.
  • Фреймворки для агентовLangChain, Vercel AI SDK и Aider работают через свои адаптеры OpenAI.

Подключение за три шага

  1. Шаг 1

    Создайте API-ключ

    Войдите и создайте ключ в консоли. Он начинается с sk-spicy-.

    header
    Authorization: Bearer sk-spicy-…
  2. Шаг 2

    Смените базовый URL

    Замените адрес OpenAI на https://api.spicyapi.ai/v1.

    base URL
    https://api.spicyapi.ai/v1
  3. Шаг 3

    Выберите ID модели

    Скопируйте ID чат-модели из списка ниже и отправьте первое сообщение.

    model
    xai/grok-4.7/chat

Меняются три значения

Большинство клиентов сами добавляют /chat/completions, поэтому базовый URL вводите только до /v1. Приложениям, которые просят полный эндпоинт, нужен https://api.spicyapi.ai/v1/chat/completions.

Настройка для вашего клиента

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

curl https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_CATALOG",
    "messages": [{ "role": "user", "content": "Write a two-line opening scene." }],
    "stream": true
  }'

Сторонние клиенты меняют формат конфигурации от версии к версии. Если сниппет здесь перестал подходить, ориентируйтесь на документацию самого клиента.

Доступные чат-модели

Копируйте ID точно как показано. Цены и лимиты контекста — на странице каждой модели.

Все чат-модели (26)

Частые ошибки и как их исправить

Почти все проблемы на старте — одна из этих трёх. На каждой карточке: что вы видите и что нужно изменить.

  • 401

    Нет авторизации

    Ключ не передан или это ключ OpenAI. Отправляйте ключ SpicyAPI: Authorization: Bearer sk-spicy-…

  • 404

    Не найдено

    Базовый URL указан с ошибкой в один уровень. Нужен https://api.spicyapi.ai/v1 — не голый домен и не с дважды добавленным /chat/completions.

  • модель

    Модель не найдена

    Названия OpenAI вроде gpt-4o здесь не псевдонимы. Используйте полный ID вида maker/model/chat.

Частые вопросы