# AI Horde API key: очередь, kudos и сроки результата

Source: https://provod.ai/ru/blog/api150-a137-ai-horde

Когда разработчик получает AI Horde API key, он на самом деле получает позицию в очереди добровольных мощностей, а не гарантию времени ответа. Кнопка «сгенерировать» в интерфейсе выглядит так же, как у платного вендора, но за ней стоит другой контракт: смарт-очередь FIFO поверх машин случайных участников сети, чьё состояние меняется от запроса к запросу. Если продукт обещает пользователю фиксированный срок поверх этой инфраструктуры, он обещает то, что документация проекта прямо не подтверждает.

Тезис конкретный: пока официальная механика AI Horde не публикует формулу перевода приоритета в часы или минуты, представлять его как предсказуемый API нельзя. Дальше показываю, как это доказывается по документации: что делает ключ, зачем нужны kudos, как читается статус задачи и в каких сценариях очередь работает, а в каких ломает продукт.

Уточню дисциплину источников сразу. Всё, что касается механики ключа, kudos, опроса статуса и условий использования, это внешние факты из официальной документации проекта, проверенные 2026-07-18. Классификация сценариев на подходящие и неподходящие, как и рекомендация не обещать SLA поверх волонтёрской сети, это уже моё рассуждение поверх этих фактов, а не заявление самого AI Horde. Раздельность этих двух слоёв принципиальна: смешать их значит повторить ту ошибку, которую и разбирает статья.

[Платите в рублях за AI-модели без наценки на токены через provod.ai](/ru)

## Почему очередь нельзя спрятать за обычной кнопкой?

Дефолт, который стоит признать ошибкой: показывать очередь добровольцев тем же спиннером, что и у платного API. Визуально одинаково, по сути разные контракты. У платного вендора за спиннером выделенная мощность и объявленное время ответа. У AI Horde за ним смарт-очередь FIFO, где позиция и время меняются вместе с тем, сколько людей сейчас в сети и сколько kudos у соседних запросов.

Низкий порог входа (можно начать вовсе без регистрации) создаёт соблазн отнестись к сервису как к готовому предсказуемому продукту. Это ошибка в логике: низкий вход не создаёт SLA, это два независимых свойства инфраструктуры, и одно не следует из другого.

Если сценарию нужен маршрут с понятной оплатой из России и без волонтёрской неопределённости, есть отдельный вариант: [provod.ai (российский аналог OpenRouter)](/ru). Это другой класс сервиса, он не воспроизводит и не обещает ту же механику очереди; к сравнению вернусь ниже.

## Что делает API key и при чём тут kudos?

Ключ в AI Horde определяет положение в очереди, а не доступ к дополнительной мощности. По [странице регистрации AI Horde](https://stablehorde.net/register) есть фиксированный анонимный ключ `0000000000`, которым можно слать запросы вовсе без регистрации. Но у анонимных запросов документированно самый низкий приоритет, когда нагрузка высокая. Регистрация через OAuth2 или просто по имени пользователя выдаёт персональный ключ, который нельзя восстановить при потере и который привязан к балансу kudos.

Kudos легко прочитать неправильно, поэтому стоит процитировать точно. По [терминологии проекта](https://github.com/Haidra-Org/AI-Horde/wiki/Terminology) kudos определены как «механизм приоритизации, а не валюта»: их нельзя купить или продать, их зарабатывают, запуская собственного воркера, или получают в подарок. Горд ведёт умную очередь по принципу «первым пришёл, первым вышел», и запросы с большим числом kudos извлекаются из неё быстрее.

Здесь и находится центральный разрыв доказательной базы. Больше kudos дают статистически лучшую позицию в очереди, но ни один официальный источник не публикует формулу или историческое среднее, переводящее kudos и глубину очереди в конкретные минуты на часах. Рычаг на порядок дежурства есть, функции «столько kudos равно столько секунд» нет, и это стоит держать как открытую неизвестность, а не заполнять придуманным числом ожидания.

Вопрос AI Horde API key на практике сводится к одному: что даёт ключ и чего он не даёт. Ключ и накопленные kudos двигают позицию в очереди, но не покупают фиксированное время результата, и это единственное точное определение, которым стоит пользоваться при выборе инфраструктуры.

![Схема приоритета: анонимный ключ, персональный ключ и kudos двигают позицию в FIFO-очереди, но не задают время на часах](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/02-283.png)

## Как узнать, где запрос в очереди?

Пуш-уведомлений о готовности в AI Horde нет. По [интеграционному руководству проекта](https://github.com/Haidra-Org/AI-Horde/blob/main/README_integration.md) прогресс получают клиентским опросом статус-эндпоинта: клиент сам обращается к чему-то вроде `/v2/generate/status/{id}` и получает живой снимок на момент вызова, сколько подзадач запроса ещё ждёт, сколько обрабатывается и сколько уже готово. Снимок описывает текущее состояние, а не контракт на время завершения; спросить «как дела сейчас» можно, спросить «когда точно будет» нельзя.

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

```python
import requests, time

# анонимный ключ: работает, но приоритет самый низкий
API_KEY = "0000000000"

start = requests.post(
    "https://stablehorde.net/api/v2/generate/async",
    headers={"apikey": API_KEY},
    json={"prompt": "a red fox in snow", "params": {"n": 1}},
)
req_id = start.json()["id"]

# опрос статуса: живой снимок, не гарантия времени
while True:
    snap = requests.get(
        f"https://stablehorde.net/api/v2/generate/status/{req_id}"
    ).json()
    if snap.get("done"):
        break
    time.sleep(5)
```

В этом коде намеренно нет расчёта ETA, который можно было бы показать пользователю как обещание. Точные названия полей вроде оценки времени ожидания я не привожу: официальный Swagger отдаётся через JavaScript и на момент проверки 2026-07-18 не читался как сырой HTML, поэтому статья держится того уровня детализации, который документирует интеграционный гайд: ждёт, обрабатывается, готово. Для решения этого достаточно, доспецифицировать неподтверждённое напрямую не стоит.

Для сравнения. У маршрута, совместимого с протоколами OpenAI и Anthropic, интеграция устроена иначе: клиент меняет `api_key` и `base_url` и получает синхронный ответ без опроса статуса и без волонтёрской очереди. У [provod.ai](/ru) это работает именно так: поддерживаемый клиент подключается заменой `base_url` и ключа, а вызывается модель из текущего каталога платформы.

```python
from openai import OpenAI

client = OpenAI(
    api_key="provod-...",
    base_url="https://api.provod.ai/v1",
)
resp = client.chat.completions.create(
    model="claude-opus-4-8",
    messages=[{"role": "user", "content": "..."}],
)
```

Это не значит, что один маршрут лучше другого по всем осям. Распределённый доступ AI Horde снижает барьер входа и для запрашивающего стоит ноль, но не даёт тот же контроль срока. Совместимый по протоколу маршрут даёт предсказуемую синхронность ответа, но это другая экономика запроса. Выбор зависит от того, что критично для конкретного сценария: цена входа или контроль времени и данных.

![Схема опроса: клиент отправляет async-запрос, получает id и циклически опрашивает статус до состояния «готово»; push-уведомлений нет](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/03-283.png)

## Когда volunteer-очередь не подходит?

Дальше к решению. Есть карта из четырёх колонок: задача, очередь, срок, риск данных, и она отсекает сценарии не по вкусу, а по проверяемым свойствам сети.

Первое свойство: срок. В официальном [FAQ проекта](https://github.com/Haidra-Org/AI-Horde/blob/main/FAQ.md) нет SLA, там прямо сказано, что при высоком спросе доставка медленнее, как у любого сервиса на очереди, без обязательства по максимальному или среднему времени ожидания. [Условия использования](https://stablehorde.net/terms/) подкрепляют это юридически: совокупная ответственность AI Horde и Haidra-Org ограничена 100 евро, а сам проект оформлен как некоммерческий сервис без покупаемого тарифа. Это инфраструктура добровольцев, а не продукт с вендорской гарантией, и сценарий с жёстким дедлайном на конкретный запрос сюда не встраивается.

Второе свойство: данные. Здесь два факта, и оба стоит читать точно. Первый: AI Horde не хранит присланные промпты и результаты, по тому же FAQ данные генерации держатся только в памяти и удаляются вскоре после доставки или отмены, долговременно хранится лишь идентификатор аккаунта для входа. Второй: FAQ сам предупреждает, что программа-воркер работает на машинах добровольцев и открыта как исходный код, поэтому воркер в принципе можно модифицировать так, чтобы он видел или сохранял проходящие через него промпты и изображения, хотя штатный воркер не видит ни ID аккаунта запрашивающего, ни его IP. Задокументированная рекомендация проекта звучит буквально: отправлять запросы так, как будто постишь на публичном форуме.

Это раскрытый самим проектом риск, а не зафиксированный инцидент утечки, и превращать честное предупреждение в заявление о взломе не стоит. Для решения этого достаточно: если данные не предназначены для публичного форума, эта очередь для них не подходит.

![Матрица решения 2x2: подходит только сочетание публичных данных и гибкого срока; фиксированный срок и чувствительные данные отсекают сценарий](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/04-281.png)

| Сценарий | Срок критичен? | Данные чувствительны? | Вердикт |
| --- | --- | --- | --- |
| Пет-проект, галерея артов, эксперименты с промптами | Нет | Нет | Подходит: гибкий срок и публичный характер данных совпадают с моделью очереди |
| Фоновая пакетная генерация, где ожидание допустимо | Нет | Нет | Подходит: обрабатывай длинное ожидание как норму, а не как сбой |
| Интерактивная фича с обещанным ответом за N секунд | Да | Нет | Не подходит: нужен SLA, а очередь его не даёт |
| Генерация по персональным или коммерческим данным | Нет | Да | Не подходит: риск воркер-видимости, слать «как на публичный форум» нельзя |
| Прод с дедлайном и закрытыми данными | Да | Да | Не подходит по обеим осям: выбери иной маршрут |

Критерий отказа читается прямо из правой колонки: нужен гарантированный срок, значит эта инфраструктура не подходит; данные не для очереди, значит тоже не подходит; механика не проверена под конкретный кейс, значит сначала проверяешь, потом решаешь. Цену этого решения стоит проговорить прямо: сознательно не обещаешь пользователю фиксированный срок на непредсказуемой очереди. Это ограничение, а не поражение.

## Чего это не решает

AI Horde не становится предсказуемым API от того, что у разработчика есть ключ и запас kudos. Kudos двигают позицию в очереди, но не покупают время, официальной формулы перевода в секунды не существует, и придумывать её нельзя. SLA и ответственность вендорского уровня сервис тоже не берёт на себя: потолок в 100 евро по условиям использования это прямо фиксирует. Приватность за разработчика он тоже не решает целиком: данные не хранятся постоянно, но канал проходит через чужие машины, а значит управление риском остаётся на стороне того, кто отправляет запрос.

![Дот-плот ограничений: фиксированный срок, ответственность вендора и приватность канала остаются вне покрытия ключа и kudos](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/05-253.png)

## Что делать дальше

Собери карту своего сценария по двум осям, срок и риск данных, до того как дать пользователю первое обещание. Если по любой оси загорается красный сигнал, для этого случая не выбирай волонтёрскую инфраструктуру: используй её для нечувствительных задач с гибким сроком или бери другой маршрут. Это решение принимается один раз и определяет весь UX: очередь стоит делать видимой частью интерфейса, а не прятать за спиннером, который обещает скорость, которой нет.

![provod.ai как рублёвый маршрут к моделям: один совместимый API, оплата из России, командные пространства и защищённый контур](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/06-236.png)

## provod.ai — отдельное пространство для задач компании

**Рабочие запросы, доступы и расходы не должны жить в личных аккаунтах сотрудников:** корпоративное пространство объединяет команду и помогает сохранять управляемый контур использования AI.

**В одном каталоге — актуальные модели для текста и медиа:** GPT от OpenAI, Claude от Anthropic, Gemini от Google, Grok от xAI, DeepSeek, Qwen, GLM, Kimi и MiniMax; для изображений — Nano Banana 2 Pro и GPT Image; для видео — последние версии Seedance, Kling, Veo и Google Omni. Также доступны модели для reasoning, поиска, документов, эмбеддингов, музыки и аудио.

**Компания получает единый тарифный принцип:** цены 1:1 с официальными поставщиками и нулевая собственная наценка provod.ai.

**Создайте рабочее пространство команды:** [форма регистрации](https://app.provod.ai/register) · [цены на модели](https://app.provod.ai/models) · [защита данных по 152-ФЗ](https://provod.ai/legal/152-fz) · [политика обработки данных](https://provod.ai/legal/privacy)

### Источники

- AI Horde (Haidra-Org), API и регистрация: [stablehorde.net/api](https://stablehorde.net/api/), [stablehorde.net/register](https://stablehorde.net/register). Анонимный ключ и приоритет очереди. Проверено 2026-07-18.
- AI-Horde FAQ (GitHub, Haidra-Org): [github.com/Haidra-Org/AI-Horde/FAQ.md](https://github.com/Haidra-Org/AI-Horde/blob/main/FAQ.md). Определение kudos, отсутствие SLA, in-memory обработка данных, предупреждение о видимости на стороне воркера. Проверено 2026-07-18.
- AI-Horde Terminology (GitHub Wiki): [github.com/Haidra-Org/AI-Horde/wiki/Terminology](https://github.com/Haidra-Org/AI-Horde/wiki/Terminology). Kudos как механизм приоритизации. Проверено 2026-07-18.
- AI-Horde README\_integration (GitHub): [github.com/Haidra-Org/AI-Horde/README\_integration.md](https://github.com/Haidra-Org/AI-Horde/blob/main/README_integration.md). Опрос статус-эндпоинта, отсутствие push. Проверено 2026-07-18.
- AI Horde Privacy и Terms: [stablehorde.net/privacy](https://stablehorde.net/privacy/), [stablehorde.net/terms](https://stablehorde.net/terms/). Непостоянное хранение данных, потолок ответственности 100 EUR. Проверено 2026-07-18 (страницы отдаются через JS, рекомендуется ручная перепроверка в браузере перед публикацией).

## FAQ

### Что такое provod.ai?

provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md).

### У provod.ai самые низкие цены среди российских провайдеров?

Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md).

### Можно ли обещать отсутствие наценки?

Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения.

### Насколько стабилен сервис?

provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора.

### Почему provod.ai подходит для юридически оформленной работы в России?

provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента.

### provod.ai работает без VPN?

Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге.

### Какие протоколы и интеграции доступны?

Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели.

### Есть изображения и видео?

Платформа поддерживает работу с изображениями и видео. Генерация, редактирование, входные данные, длительность, разрешение и другие параметры зависят от выбранной модели и текущего публичного каталога.

### Какие источники считать актуальными?

Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).
