Перейти к основному содержанию

​
Начало работы

SpeShu.AI — это сервис с единым API для доступа к LLM-моделям. Модели нескольких провайдеров собраны под одним ключом, одним балансом и одним интерфейсом. Каталог текстовых моделей отдаёт GET /api/v1/models, медиа-моделей — GET /api/v1/media/models.
  1. Создайте аккаунт на speshu.ai. 2. Пополните баланс в профиле или проведите оплату по счёту. 3. Создайте API-ключ в разделе API-ключи на speshu.ai/profile. 4. Подключитесь к API через любой OpenAI-совместимый SDK. Пошаговая инструкция — на странице Быстрый старт.
Ключ создаётся в разделе API-ключи на speshu.ai/profile и начинается с sk-, после которого идёт UUID: 019b…. Полное значение показывается ровно один раз — сохраните его сразу. Передавайте ключ заголовком Authorization: Bearer (для Anthropic SDK — X-Api-Key). Подробности на странице Аутентификация.
Да. Возьмите официальную библиотеку openai для Python или Node.js и поменяйте base_url на https://speshu.ai/api/v1, а ключ передайте как api_key. Формат запросов и ответов совпадает с OpenAI Chat Completions, поэтому код менять не нужно. Детали — в Введении в API.
Текстовые модели тарифицируются за токены: цена за миллион входных и выходных токенов опубликована в GET /api/v1/models в полях cost_context и cost_completion. Генерация изображений, видео, аудио и музыки тарифицируется отдельно — цена в поле pricing ответа GET /api/v1/media/models. Разбор — на странице Тарификация и оплата.

​
Модели и провайдеры

Актуальный состав отдаёт GET /api/v1/models — идентификатор, контекстное окно и цены каждой модели. Не зашивайте список в код: модель могла быть переименована или отключена, и запрос начнёт падать с 404 model_not_found. Формат ответа — в Каталоге моделей, как выбирать — на странице Модели и цены.
API совместим со спецификацией OpenAI, поэтому с сервисом работают любые SDK, поддерживающие OpenAI, включая официальные библиотеки для Python и Node.js. Для Anthropic-совместимых сценариев есть отдельный эндпоинт /api/v1/messages, который читает ключ из заголовка X-Api-Key.
В каждой записи GET /api/v1/models есть поле owned_by — провайдер модели. Читайте его оттуда: список провайдеров меняется вместе с каталогом, и своя таблица в коде рано или поздно устареет. Медиа-модели идут в GET /api/v1/media/models.

​
Технические вопросы

Основные маршруты с базовым путём /api/v1:
  • POST /api/v1/chat/completions — генерация текста
  • POST /api/v1/responses — современный интерфейс с элементами вывода
  • POST /api/v1/messages — формат Anthropic
  • GET /api/v1/models — каталог текстовых моделей
  • GET /api/v1/media/models — каталог медиа-моделей
  • POST /api/v1/async/media/tasks — запуск генерации изображения, видео, аудио или музыки
  • GET /api/v1/async/media/tasks — список задач
  • POST /api/v1/storage/upload — загрузка файла
  • GET /api/v1/balance — баланс аккаунта
Полный список — в Введении в API.
Каждый кадр приходит в поле data: безымянного события. Поле event: сервер не пишет — клиенты, которые разбирают поток по event:, работать не будут. Читайте строки, начинающиеся с data:, и завершайте цикл на [DONE]. Разбор — на странице Запрос чату и в гайде Потоковая передача.
Это два разных пространства имён. Поле state объекта задачи принимает три значения: waiting, success и fail. Фильтр status в GET /api/v1/async/media/tasks использует длинную форму: pending/processing, completed, failed/cancelled. Фильтр status=completed вернёт задачи, у которых state равен success. Полная таблица соответствия — на странице Статус задачи.
404 на медиа-эндпоинтах означает сразу два случая: «объекта нет» и «объект не ваш». Задача чужого аккаунта отвечает 404, а не 403 — так по коду ответа нельзя проверить существование чужого объекта. Различить ситуации нельзя, и строить логику на их различении не нужно.
Да. Для мультимодальных моделей поддерживаются текст, изображения и PDF — в формате URL или base64. Ссылка в image_url.url должна быть публично доступна без авторизации: её скачивает провайдер. Файл из хранилища подходит — загрузите его через POST /api/v1/storage/upload и подставьте полученный url.
Потоковая передача работает через Server-Sent Events (SSE). Чтобы получать ответ частями, добавьте в запрос stream: true. Стоимость приходит в последнем кадре вместе с usage — этот кадр приходит всегда, даже если вы не задавали stream_options.
В каждом ответе текстовой модели есть поле usage.cost.total_cost — сумма в рублях, списанная с кошелька именно за этот запрос, и ничего больше. Общая картина по счёту — в личном кабинете и через GET /api/v1/balance. Подробности — на странице Тарификация и оплата.
Ветвитесь по полю error.code, а не по тексту error.message — текст меняется. На медиа-эндпоинтах формат другой: конверт с code и msg, а не объект error. Полная таблица кодов и того, что можно повторять, а что нельзя, — на странице Ошибки.

​
Конфиденциальность и данные

По умолчанию мы не сохраняем содержимое запросов и ответов. Сохраняются технические метаданные: время, используемая модель и количество токенов — они нужны для расчётов и аналитики. Подробно — в разделе Конфиденциальность.
Запрос уходит провайдеру модели, и условия обработки данных у провайдеров различаются: от режима без хранения до временного хранения. Категории провайдеров и их особенности перечислены в разделе Конфиденциальность — сверяйтесь с ним перед работой с чувствительными данными.

​
Оплата и баланс

Баланс пополняется в рублях — вручную или автоматически, когда остаток опускается ниже заданного порога. Запросы к платным моделям при нулевом остатке отклоняются с 402 insufficient_quota — до обращения к модели, поэтому за отказ деньги не списываются.
Мы принимаем банковские карты, оплату через СБП и оплату на расчётный счёт для бизнеса.
Условия возврата зависят от способа оплаты. Обратитесь в службу поддержки — там подскажут по вашему случаю.
По каждому запросу сумма списания приходит в ответе API, в usage.cost.total_cost. Сводная картина по счёту доступна на speshu.ai/profile и через GET /api/v1/balance. Формат поля — в Тарификации и оплате.
Индивидуальные условия для крупных клиентов возможны. Свяжитесь с нами, чтобы обсудить формат сотрудничества — контакты на странице Поддержка.

​
Управление аккаунтом

Для удаления аккаунта обратитесь в службу поддержки через почту: support@speshu.ai — или в Телеграме: https://t.me/sprt_speshu_ai. Неиспользованные средства при удалении аккаунта будут потеряны.
Связаться с нами можно через почту: support@speshu.ai — или в Телеграме: https://t.me/sprt_speshu_ai.

Подключить API

Первый запрос — за три шага