OpenRouter Fusion Flash API: статус, настройка и исправление ошибок 400

Если вы ищете OpenRouter Fusion Flash API, скорее всего, вам нужен быстрый пресет Fusion или вы столкнулись с ошибкой HTTP 400. В официальной документации указан openrouter/fusion-flash, но в живом каталоге моделей этот идентификатор может отсутствовать. Поэтому перед интеграцией обязательно проверьте, доступен ли алиас в вашем аккаунте.

Действительно ли OpenRouter Fusion Flash доступен?

В официальной документации Fusion Router openrouter/fusion-flash указан как отдельный slug модели. Согласно описанию, это алиас Fusion с пресетом general-fast, выбранным по умолчанию. Пресет рассчитан на более быстрые агентские взаимодействия и использует панель моделей, подобранную для более однородной задержки.

В том же официальном руководстве стандартный Fusion описан как схема, в которой несколько моделей панели отвечают параллельно, аналитик сравнивает совпадения и расхождения, а внешняя модель формирует итоговый ответ. Fusion Flash — это быстрый пресет такого составного маршрутизатора, а не отдельная модель одного провайдера.

В живом каталоге моделей OpenRouter, полученном для этого материала 11 сентября 2026 года, присутствовал openrouter/fusion, но отдельной записи openrouter/fusion-flash не было. Один из пользователей описал в X ровно такую ситуацию:

«в документации сказано, что openrouter/fusion-flash — это отдельная модель с собственной записью в /api/v1/models, но сейчас API возвращает ошибку 400: fusion-flash — недопустимый ID модели». — @PeterDaveHello

Это пользовательский отчёт, а не подтверждение со стороны OpenRouter. Официальная документация OpenRouter описывает Fusion, однако на момент подготовки материала не удалось найти официального объявления, подтверждающего запуск или откат отдельного Fusion Flash. Самый осторожный вывод такой: модель описана в документации, но её доступность нужно проверять вживую перед интеграцией.

Что проверить до диагностики кода

Выполните запрос к каталогу моделей с тем же ключом и в том же окружении, которое использует приложение:

curl https://openrouter.ai/api/v1/models \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

Найдите в JSON точную строку openrouter/fusion-flash. Не делайте вывод о доступности по странице модели, автодополнению SDK или закэшированной интеграции. В документации OpenRouter по моделям именно каталог считается источником актуальных идентификаторов и поддерживаемых параметров.

Также стоит заглянуть на официальную страницу статуса. Но зелёный статус платформы не означает, что конкретный алиас маршрутизатора сейчас работает. Панель статуса показывает общие компоненты, например Chat API и Data API; при этом отдельная проблема с алиасом или конфигурацией может существовать даже тогда, когда общий Chat API функционирует нормально.

Минимальная настройка OpenRouter Fusion Flash API

Начните с самого простого запроса к Chat Completions. На первом этапе не добавляйте адаптеры SDK, схемы инструментов, потоковую передачу и пользовательские настройки Fusion.

export OPENROUTER_API_KEY="your-key"

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/fusion-flash",
    "messages": [
      {
        "role": "user",
        "content": "Reply with the word: ready"
      }
    ],
    "stream": false
  }'

В этом примере показаны endpoint и заголовки. На первом тесте оставьте stream: false, чтобы было проще прочитать полное тело ошибки.

Если алиас есть в /api/v1/models и минимальный запрос выполняется успешно, добавляйте поля из рабочего приложения по одному. Если алиаса нет, не тратьте время на бесконечные изменения промптов и повторные отправки того же запроса. Для диагностики проверьте документированный эквивалент:

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/fusion",
    "plugins": [
      {"id": "fusion", "preset": "general-fast"}
    ],
    "messages": [
      {"role": "user", "content": "Reply with the word: ready"}
    ],
    "stream": false
  }'

Такой fallback проверяет, доступен ли маршрут Fusion и быстрый пресет. Он не доказывает, что алиас и явная конфигурация во всех деталях обрабатываются одинаково на стороне backend.

Последовательная диагностика ошибок 400 в OpenRouter Fusion Flash API

Ошибка 400 обычно означает отклонение запроса или провайдера; точная причина определяется телом ответа. Это не то же самое, что сбой 500 или HTTP 200, внутри которого завершилась ошибкой операция Fusion. Идите по шагам ниже: каждый тест должен отвечать на один конкретный вопрос.

1. Прочитайте полное тело ошибки

Сохраните ответ целиком, а не выводите в лог только 400 Bad Request:

curl -i https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openrouter/fusion-flash","messages":[{"role":"user","content":"ready"}]}'

Ищите код ошибки, сообщение, имя провайдера, ID запроса или генерации и дополнительные метаданные. Сообщение «fusion-flash is not a valid model ID» указывает на рассинхронизацию каталога и выкладки. Формулировка «Provider returned error» означает, что запрос дошёл до маршрута провайдера, но был отклонён там. Если в ответе только общий 400 без деталей, проверьте запись в OpenRouter Activity, а не пытайтесь угадать причину.

2. Проверьте точный ID модели

Идентификаторы моделей — регистрозависимые строки. Сравните значение в запросе с актуальным ответом /api/v1/models, включая пунктуацию и слеш. Удалите устаревшие алиасы из конфигурации приложения и не подставляйте молча придуманное имя Gemini или другой Flash-модели.

Для диагностики удобно использовать такую матрицу:

3. Уберите неподдерживаемые поля

Оставьте только model, messages, stream: false и два обязательных заголовка. Затем возвращайте поля в таком порядке:

1. temperature или настройки reasoning.
2. plugins и пресет Fusion.
3. Пользовательские analysis_models или model аналитика.
4. tools и tool_choice.
5. Streaming и специфичные для фреймворка параметры ответа.

В руководстве OpenRouter по Fusion описаны analysis_models, model, preset, max_tool_calls, max_completion_tokens, reasoning и temperature. Но поле, документированное для одного endpoint или семейства моделей, не обязательно допустимо для любой upstream-модели. Проверяйте справочник моделей OpenRouter и метаданные поддерживаемых параметров конкретной модели.

4. Упростите инструменты и историю сообщений

Клиенты с поддержкой инструментов могут вызывать запутанные ошибки 400: итоговый payload иногда содержит некорректную JSON Schema, неподдерживаемый параметр инструмента или неполную последовательность сообщений assistant/tool. В публичном отчёте Hermes Agent описаны ошибки 400 OpenRouter в версии 0.10.0 при включённых инструментах на протестированных моделях; авторы предположили, что причиной могли быть стандартные 28 инструментов, но не приложили успешный контрольный тест без tools и не подтвердили корневую причину. Рассматривайте issue #13927 как зацепку для воспроизведения, а не как доказательство того, что любой 400 в Fusion Flash вызван инструментами.

Для изоляции проблемы выполните все три теста:

• Отправьте тот же промпт без tools.
• Передайте один минимальный инструмент с простой схемой объекта.
• Начните новый диалог без предыдущих вызовов инструментов и их результатов.

Если минимальный текстовый запрос и сокращённый запрос с инструментом работают, возвращайте инструменты по одному. Если длинная история использования tools завершается ошибкой, а новый запрос успешен, сначала сократите или суммируйте историю, и только потом проверяйте саму модель.

5. Разделите проблемы алиаса, маршрутизатора и провайдера

В Fusion могут участвовать модели панели, модель аналитика и внешняя модель, формирующая ответ. Поэтому сбой одного внутреннего вызова не всегда выглядит как обычная ошибка одиночной модели. Согласно документации OpenRouter, нужно изучать данные генерации и Activity, чтобы понять, что именно было запущено. Поле model в обычном ответе может показать конкретную внешнюю модель, но само по себе не доказывает, использовался Fusion или нет.

Для успешного запуска Fusion документированные метаданные генерации включают:

{
  "router": "openrouter/fusion"
}

Если вы задаёте собственные analysis_models, уберите их и повторите тест с пресетом. Если пресет работает, а одна пользовательская модель — нет, причина, вероятно, связана с параметрами этой модели, доступностью провайдера или ограничениями контекста. Если через SDK не работает ни одна модель, сравните фактический payload SDK с рабочим запросом cURL. OpenAI-совместимые клиенты могут добавлять tools, флаги streaming, форматы ответа или преобразования сообщений, которых не видно в коде приложения.

Когда пора прекращать повторные попытки

Автоматические ретраи не исправят недопустимый ID модели или детерминированную ошибку валидации схемы. Для 400 с пометкой non-retryable нужен понятный fallback:

• Алиас отсутствует в каталоге моделей: переключитесь на openrouter/fusion с general-fast или используйте известную обычную модель, продолжая следить за каталогом.
• 400 зависит от payload: сохраните минимальный запрос как регрессионный тест и исправьте первое поле, после добавления которого возникает ошибка.
• 400 связан с провайдером: удалите проблемную модель панели или используйте настроенный fallback; сохраните ответ провайдера.
• Общий инцидент Chat API: проверьте страницу статуса OpenRouter и приостановите выкладку вместо изменения логики приложения.
• HTTP 200 с внутренней ошибкой: записывайте сбои панелей в лог и решайте, допустим ли частичный результат; не классифицируйте такую ситуацию как ошибку аутентификации.

В официальной документации Fusion Router сказано, что панель по умолчанию из трёх моделей стоит примерно в 4–5 раз дороже одного completion; точная сумма зависит от внутренних вызовов. Поэтому fallback защищает не только надёжность, но и бюджет, пока статус алиаса остаётся неопределённым.

FAQ по OpenRouter Fusion Flash API

Какой ID модели OpenRouter Fusion Flash правильный?

В официальной документации указан openrouter/fusion-flash. Перед деплоем проверьте именно эту строку через GET /api/v1/models, поскольку документация и живой каталог могут временно расходиться.

Fusion Flash — это обычная быстрая модель?

Нет. В документации он описан как Fusion с пресетом general-fast. Внутри всё равно может выполняться несколько вызовов моделей, поэтому «Flash» обозначает цель по задержке пресета, а не выполнение одного запроса к одной модели.

Какой endpoint использовать?

Используйте https://openrouter.ai/api/v1/chat/completions, Bearer-аутентификацию и JSON-тело запроса. Не придумывайте отдельный URL-путь для Fusion.

Можно ли принудительно запустить Fusion?

Документация Fusion поддерживает tool_choice: "required". Если Fusion — единственный доступный инструмент, это фактически принуждает систему вызвать его. Если доступны и другие инструменты, required означает, что должен быть вызван какой-либо инструмент, но не обязательно Fusion.

Почему страница статуса OpenRouter зелёная, а Fusion Flash возвращает 400?

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

Fusion Flash бесплатен?

Не рассчитывайте на это автоматически. На странице модели Fusion OpenRouter поясняет, что внутренние вызовы панели и аналитика входят в расчёт стоимости, даже если для алиаса маршрутизатора не отображается отдельная цена за токены. Перед использованием в продакшене проверьте Activity и тарифы выбранных моделей.

Используйте быстрый пресет только тогда, когда данные живого каталога и минимальный запрос подтверждают друг друга. В противном случае переключитесь на стандартный Fusion или известную модель и сохраните проблемный payload вместо бездумных повторных попыток.