> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# В чём разница между официальным релеем и API с обратной инженерией?

> APIYI по умолчанию использует официальный релей. Сравните официальный релей и API с обратной инженерией по стабильности, совместимости протоколов, кэшированию, параллельным запросам и долгосрочной устойчивости, а также узнайте, как выбрать между группами Claude_Reverse, Codex_Reverse, Gemini_Reverse и официального релея.

## Краткий ответ

**Официальный релей** — это ресурсы, перенаправляемые через официальный API поставщика или официальный облачный маркетплейс. **Ресурсы с обратной разработкой (реверсные)** — это доступ, полученный через неофициальные интерфейсы. Если оба маршрута вызывают одну и ту же модель, ответы в рамках одного запроса могут быть очень похожими. Реальные различия заключаются в **стабильности, совместимости протокола, полноте функций, эффективности кэширования, параллельных запросах и долгосрочной устойчивости**.

* **APIYI по умолчанию использует официальный релей.** Реверсные группы являются дополнительным вариантом для самостоятельного обучения, чувствительных к стоимости нагрузок и некритичных задач.
* Для рабочих нагрузок в продакшене, агентов для программирования и корпоративных клиентов предпочтителен официальный релей.
* Для самостоятельного обучения, простого общения, перевода и суммаризации, а также чувствительных к стоимости нагрузок можно использовать реверсные группы.
* В APIYI в настоящее время есть ровно три реверсные группы для текста и программирования: `Claude_Reverse`, `Codex_Reverse` и `Gemini_Reverse`. Текстовые модели других поставщиков по умолчанию используют группы официального релея `Default` / `SVIP`.
* Модели для генерации изображений `-all` / `-vip` относятся к отдельной реверсной линии и в основном обслуживаются через `Default`; некоторые модели, которым требуется вывод в виде URL, используют `image2_OSS`. Точное соответствие проверяйте в консоли. Они не входят в состав этих трёх групп.
* APIYI указывает источник в названиях групп и документации. Реверсные группы никогда не представляются как официальные прямые подключения.

> [!NOTE]
>
> Это типичные сценарии, а не утверждение, что каждый канал официального релея лучше каждого реверсного канала. Официальный релей также сталкивается с ограничениями пропускной способности поставщиков, а качественный пул реверсных ресурсов может временно превосходить его по скорости, параллельным запросам или стабильности для некоторых нагрузок. Оценивайте конкретный канал, временной интервал и результаты собственных тестов.

Эта статья посвящена группам APIYI в целом, а не какой-либо одной конкретной модели. Для различий на уровне моделей ознакомьтесь с документацией по модели и проведите собственные тесты.

## Официальный релей и обратные группы в APIYI

Отделяйте **группу** от **модели**: группа — это канал для token, а модель — это поле `model` в запросе. APIYI использует группы для организации источников и вариантов использования, но общая группа может содержать как модели официального релея, так и обратные модели изображений.

**APIYI по умолчанию использует официальный релей.** К группам, в которых преимущественно используется официальный релей, относятся `Default`, `SVIP`, `ClaudeCode`, `Claude_Enterprise`, `CodexResponses`, `image2Enterprise` и `NB-Enterprise`, а также видеогруппы `SeeDance2` и `Wan&HappyHorse`. Полный список, сведения о скидках и поддерживаемых моделях см. в разделе [Группы](https://docs.apiyi.com/ru/groups.md).

### Обратные группы (дополнение)

| Обратная группа | Охват | Коэффициент | Оптимально для |
| - | - | - | - |
| `Claude_Reverse` | 24 модели Claude, за исключением более новых релизов, таких как `claude-fable-5-2` и `claude-haiku-5-5` | 0.5 | Личное обучение, непроизводственное использование |
| `Codex_Reverse` | 9 моделей, включая `gpt-5.6-*`, `gpt-6-*` и `gpt-6.1-*` | 0.5 | Экономичное использование Codex, непроизводственное использование |
| `Gemini_Reverse` | 11 моделей от Gemini 2.5 до 3.8, за исключением Gemini 4 | 0.5 | Gemini CLI, обучение, непроизводственное использование |

Обратные группы являются дополнением и не гарантируют такой же SLA, параллельные запросы или полноту функций, как официальный релей.

> [!NOTE]
>
> `Default` / `SVIP` преимущественно используют официальный релей, но также содержат обратные модели изображений, такие как `gpt-image-2-all`, `gpt-image-2.6-all` и серия `-vip`. Проверяйте и группу, и модель, а не только название группы.

## Основные различия: дело не только в интеллектуальности модели

### Стабильность и производительность

| Параметр | Официальный релей | Реверс | Влияние на бизнес |
| - | - | - | - |
| Поведение модели | Нативное, стабильное | В основном близкое, с периодическими различиями | Ответы в рамках одного запроса обычно мало различаются |
| Подлинность модели | Проверяемый источник | Зависит от прозрачности поставщика | Проверяйте с помощью фиксированного набора тестов |
| Первый токен | Меньшая задержка и предсказуемость | Может добавляться прокси или очередь | Влияет на интерфейс потоковой передачи в реальном времени |
| Общая скорость | Зависит от официальной нагрузки | Зависит от пула ресурсов | Оставляйте запас для повторных попыток и тайм-аутов при пакетной обработке |
| Параллельные запросы и пиковые нагрузки | Явные RPM / TPM или квота | Зависит от пула аккаунтов и планирования | При пиковых нагрузках выше вероятность получить 429 или попасть в очередь |
| Кэширование | Полный официальный механизм кэширования | Параметры управления кэшем могут не передаваться | Длительные разговоры и фиксированные префиксы обходятся дороже |

### Протокол и функции

| Параметр | Официальный релей | Реверс | Влияние на бизнес |
| - | - | - | - |
| Совместимость параметров | Полный набор официальных параметров и структур | Некоторые параметры могут быть несовместимы или игнорироваться | Проводите регрессионное тестирование сложных вызовов |
| Потоковая передача | Нативная и стандартизированная | Обычно поддерживается, но возможны буферизация или различия формата | Настраивайте интерфейс первого токена и тайм-ауты клиента |
| Вызов инструментов / MCP | Нативный и надёжный | Выше вероятность проблем со структурой или порядком | Снижается доля успешного выполнения задач агентом |
| Структурированный JSON | Схема гарантируется официальной функцией | Строгое соблюдение схемы может не обеспечиваться | При последующем разборе необходима устойчивость к отклонениям |
| Мультимодальность | Полная официальная поддержка | Изображения, аудио или видео могут отсутствовать | Проверяйте мультимодальные рабочие нагрузки на небольшом объёме трафика |
| Длина контекста | Официальный лимит с чёткими ограничениями | Может ограничиваться цепочкой реверса | Проводите стресс-тестирование длинных документов и разговоров |
| Управление рассуждением | Официальные параметры рассуждения и формат ответа | Полное воспроизведение может быть невозможно | Это влияет на бюджеты рассуждения и обработку цепочек |
| Использование и коды ошибок | Официальный учёт и понятные типы ошибок | Могут оцениваться приблизительно или сопоставляться неверно | Для сверки тарификации и повторных попыток необходима устойчивость к отклонениям |

### Версии, соответствие требованиям и устойчивость

| Параметр | Официальный релей | Реверс | Влияние на бизнес |
| - | - | - | - |
| Обновления версий моделей | Следуют официальному жизненному циклу | Могут задерживаться или изменяться без уведомления | Поддерживайте план отката для зафиксированных версий |
| SLA и устранение неполадок | Официальные каналы поддержки | Зависит от поддержки поставщика реверса | Предприятиям следует уделять основное внимание гарантиям |
| Ресурсы и контроль рисков | Относительно контролируемые при использовании в соответствии с требованиями | Пулы аккаунтов вышестоящего поставщика, контроль рисков и изменения интерфейса | Поддерживайте резервный канал для критически важных рабочих нагрузок |
| Коммерческое соответствие требованиям | Охватывается условиями поставщика для коммерческого API | Не подпадает под официальные условия поставщика для API | Оценивайте соответствие требованиям до использования в корпоративной среде |
| Цена и долгосрочная стоимость | Прозрачная; возможны скидки при закупках | Может быть ниже, но скрытые операционные расходы выше | Рассчитывайте общую стоимость, а не только цену единицы |
| Долгосрочная устойчивость | Относительно выше | Зависит от доступности неофициальных каналов | Для долгосрочных проектов отдавайте предпочтение официальному релею |

> [!NOTE]
>
> Ресурсы реверса находятся за пределами официальных условий поставщика для коммерческого API. Эта статья представляет собой техническое разъяснение, а не юридическую консультацию. Оцените соответствие требованиям для собственных корпоративных закупок и использования в рабочей среде.

## Почему агентам по-прежнему следует отдавать предпочтение официальному релею, если качество однократных ответов близко

Успешность работы агента, выполняющего задачи программирования, определяется не ответами на один запрос. Один некорректно сформированный аргумент вызова инструмента, одно пропущенное поле JSON или один прерванный поток могут привести к сбою и перезапуску всей задачи. Качество однократного ответа может выглядеть одинаково, тогда как показатели успешности при работе с несколькими запросами могут различаться.

В рабочих нагрузках агентов усиливаются три проблемы:

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

> [!TIP]
>
> Для рабочих процессов Claude Code, Codex, Gemini CLI и OpenClaw по умолчанию отдавайте предпочтение официальному релею. Используйте обратные группы только как дополнение для снижения затрат или для некритичных задач.

## Когда предпочитать официальный релей и когда допустим обратный прокси

| Сценарий | Рекомендация | Почему |
| - | - | - |
| Агенты программирования (Claude Code / Codex / Gemini CLI) | Предпочитайте официальный релей | Вызовы инструментов и многоэтапные задачи требуют согласованности протокола |
| Длинный контекст и сложный многоэтапный чат | Предпочитайте официальный релей | Префиксы кэша и передача контекста реализованы более полно |
| Простой чат, перевод, суммаризация | Обратный прокси допустим | Качество в рамках одного запроса близко, а стоимость ниже |
| Вызовы инструментов / рабочие процессы MCP | Предпочитайте официальный релей | Структуры параметров, порядок и коды ошибок более надёжны |
| Пакетная генерация с большим числом параллельных запросов | Предпочитайте официальный релей; протестируйте обратный прокси в условиях высокой нагрузки | Параллельные запросы зависят от официальной квоты или пула ресурсов обратного прокси |
| Генерация изображений | Официальный релей / корпоративные группы; протестируйте зрелые варианты обратного прокси | Формат вывода, процент успешных запросов и стабильность 4K значительно различаются |
| Корпоративное использование в рабочей среде | Официальный релей | Соответствие требованиям, SLA и устранение неполадок реализованы более полно |
| Крайне высокая чувствительность к цене | Сначала сравните общую стоимость | Необходимо учитывать повторные попытки, затраты на неудачную работу и эксплуатационные расходы |

## Кэширование — это больше, чем доля попаданий в кэш

Официальное кэширование Claude поддерживает явное сопоставление префиксов, маркеры `cache_control` и время жизни 5 минут / 1 час. Поля `cache_creation_input_tokens` и `cache_read_input_tokens` напрямую показывают операции записи и чтения. OpenAI использует автоматическое кэширование префиксов, а Gemini — неявное кэширование с умеренной долей попаданий в кэш.

Если обратная цепочка только пересылает запросы и не может полностью передавать параметры cache-control, доля попаданий в кэш снижается. Длинные диалоги, фиксированные системные промпты и большие определения инструментов усиливают разницу в стоимости. При выборе канала не ограничивайтесь вопросом о наличии кэширования — измеряйте фактическую долю чтений из кэша для одного и того же префикса.

См. раздел [Поддерживает ли APIYI тарификацию кэширования?](https://docs.apiyi.com/ru/faq/cache-billing.md), посвящённый механике и тарификации кэширования, а также раздел [Кэширование промптов Claude](https://docs.apiyi.com/ru/api-capabilities/claude-prompt-caching.md), посвящённый параметрам Claude.

## Как оценить канал: пять метрик

Если вам нужно выбрать между официальным релеем и обратным каналом, запустите фиксированный набор тестов и зафиксируйте эти пять показателей:

| Метрика | Как рассчитать | На что обратить внимание |
| - | - | - |
| Доля успешных запросов | Успешные запросы ÷ (общее количество запросов − клиентские ошибки 4xx) | Исключите собственные ошибки в параметрах |
| Эффективная доля попаданий в кэш | Токены, прочитанные из кэша ÷ входные токены | Одна и та же модель, один и тот же префикс, одна и та же группа |
| Задержка P95 | Отдельно измеряйте время до первого токена и общую продолжительность | Не полагайтесь на средние значения |
| Доля выполнения задач агентом | Доля фиксированных задач, которые в итоге были выполнены | Ближе к реальному использованию, чем качество одного хода |
| Стоимость успешной задачи | (Стоимость запроса + стоимость повторных попыток + стоимость невыполненной работы) ÷ успешные задачи | Учитывайте сбои |

Поля кэша различаются у разных поставщиков: Claude предоставляет `cache_read_input_tokens`, а OpenAI использует такие поля, как `prompt_tokens_details.cached_tokens`. Читайте поле из фактического ответа.

> [!TIP]
>
> Бенчмарки одного хода показывают только, может ли модель ответить. Эти пять метрик показывают, способен ли канал поддерживать работу бизнеса.

## Принципы каналов APIYI

* **Официальный релей по умолчанию**: APIYI по умолчанию использует официальные API поставщиков и официальные облачные торговые площадки. Реверс — это способ снизить расходы, а не канал по умолчанию.
* **Указывайте источник**: `Claude_Reverse`, `Codex_Reverse` и `Gemini_Reverse` обозначены как реверс в названиях групп и документации. Они никогда не описываются как официальные прямые подключения.
* **Для рабочей среды предпочтителен официальный релей**: `Default`, `SVIP`, `Claude_Enterprise`, `CodexResponses`, `image2Enterprise` и `NB-Enterprise` обрабатывают рабочий трафик. Для моделей изображений выбирайте источник в зависимости от конкретной модели.
* **Официальный релей для сложных агентов**: вызовы инструментов, многошаговые задачи и большой контекст требуют согласованности протокола.
* **Реверс для обучения и оптимизации расходов**: реверс-группы не гарантируют такой же SLA, параллельные запросы или полноту функций, как официальный релей.
* **Корпоративные клиенты**: используйте `Claude_Enterprise`, `image2Enterprise` или `NB-Enterprise`, если важны гарантии. Обратитесь в службу поддержки по вопросам SLA и вариантов закупки.
* **Каналы могут изменяться**: ресурсы вышестоящих поставщиков, версии моделей и коэффициенты тарифа групп могут измениться. Ориентируйтесь на консоль и [актуальные обновления](https://docs.apiyi.com/en/live.md).

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

## Связанная документация

> [card] [Группы](https://docs.apiyi.com/ru/groups.md)
>
> Все группы, коэффициенты тарифов, скидки и рекомендации по выбору для поставщиков и моделей

> [card] [Токены и группы](https://docs.apiyi.com/ru/faq/token-and-groups.md)
>
> Создание токенов и настройка основных и резервных групп

> [card] [Что такое группа?](https://docs.apiyi.com/ru/faq/groups-explained.md)
>
> Группы пользователей и группы токенов

> [card] [Тарификация кэша](https://docs.apiyi.com/ru/faq/cache-billing.md)
>
> Поведение кэша и тарификация для Claude, OpenAI и Gemini

> [card] [GPT Image: официальный и обратный](https://docs.apiyi.com/ru/api-capabilities/gpt-image-2/vs-gpt-image-2-all.md)
>
> Различия в параметрах, цене и качестве моделей для генерации изображений

> [card] [Цены на модели](https://docs.apiyi.com/ru/models/index.md)
>
> Цены и характеристики всех моделей


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.