Частые вопросы о BazaarLink
Основные ответы об AI API, моделях, оплате, безопасности и интеграции для разработчиков.
Чем BazaarLink отличается от OpenRouter?
Оба сервиса дают OpenAI-совместимый API. BazaarLink добавляет оплату и электронные инвойсы Тайваня, поддержку на китайском и цены в тайваньских долларах.
Как перейти с OpenRouter или OpenAI API?
Замените base_url и API-ключ, проверьте полный ID модели, затем протестируйте streaming, tool calling и обработку ошибок.
Какая оплата даёт тайваньский электронный инвойс?
Выберите способ TWD с явной отметкой о возможности инвойса и заполните данные компании до оплаты.
Поддерживаются ли OpenAI SDK, Cursor и Claude Code?
Поддерживаются OpenAI-совместимые инструменты со своим endpoint; для Claude Code есть endpoint Anthropic Messages.
Для каких задач предназначен BazaarLink?
Для команд, которым нужны разные поставщики моделей, тайваньский биллинг, китайская поддержка или публичные данные Probe.
Как рассчитывается стоимость моделей?
Инференс рассчитывается по актуальным единицам на странице модели; сборы за пополнение, оплату, обмен или налоги показываются отдельно.
Что проверить до оплаты, если нужен тайваньский электронный инвойс?
Тайваньский электронный инвойс доступен только через фактически предлагаемый способ, отмеченный как подходящий при оформлении платежа, либо по подтверждённому корпоративному соглашению. Проверьте актуальные условия до оплаты или заранее свяжитесь с отделом продаж, если нужны налоговый номер, предложение или ежемесячный расчёт.
Нужна ли карта для бесплатного API-ключа?
Аккаунт и ключ можно создать без карты. Доступные бесплатные модели и текущие ограничения указаны на странице бесплатного API.
Что будет после исчерпания бесплатной квоты?
При наличии баланса запросы могут продолжиться по обычному тарифу; иначе дождитесь сброса или пополните счёт. Фиксированная квота не обещается.
Какие форматы и функции API поддерживаются?
Доступны Chat Completions, Responses, Embeddings, медиафункции и Anthropic Messages API; возможности зависят от модели.
Где узнать ID модели, цену и context window?
Используйте полный ID из /api/v1/models или каталога и проверяйте актуальные параметры на странице модели.
Какие действуют rate limits?
Ограничения зависят от аккаунта, плана и модели. При HTTP 429 учитывайте Retry-After или применяйте backoff.
Хранит ли BazaarLink prompts и ответы?
Для успешных запросов в основном хранятся операционные и платёжные данные, а не полные prompts и ответы как стандартные записи.
Как защищены API-ключи и BYOK?
Ключи BazaarLink хранятся как необратимый hash, данные BYOK шифруются, а передача защищена TLS.
Что происходит при сбое upstream-поставщика?
Если возможно, routing пробует следующего поставщика или модель; при полном сбое API возвращает понятную ошибку.
Можно ли задать лимит каждому API-ключу?
Да. У каждого ключа отдельные лимит и статус; сначала установите и проверьте новый ключ, затем отзовите старый.
Что означают HTTP 402, 429, 502 и 503?
402 обычно связан с балансом или бюджетом, 429 — с rate limit, 502 — с ошибкой upstream, 503 — с временно недоступным route.
Как обратиться в поддержку?
Отправьте время, request ID, ID модели и безопасные детали ошибки через поддержку или support@bazaarlink.ai, но не полный ключ.
Что такое ключ ZDR (нулевое хранение данных) и как его включить?
Запросы API-ключа с ZDR отправляются только upstream-поставщикам, заявившим нулевое хранение данных; их жёстко задаёт BazaarLink, возврата на обычные маршруты нет. BazaarLink также не хранит промпты и ответы этого ключа и по умолчанию не отправляет содержимое во внешний сервис модерации. Личные ключи включаются в /keys, администраторы организации могут потребовать ZDR для всех ключей в настройках организации. Сейчас поддерживаются чат-эндпоинты (chat completions, messages, responses); модель без ZDR-маршрута возвращает 400 (zdr_route_unavailable), а не тихо идёт другим маршрутом.
Можно ли использовать ключ ZDR с BYOK, BYOC или виртуальными моделями?
Нет. Ключ ZDR игнорирует ваши ключи поставщиков BYOK/BYOC и всегда работает через ZDR-маршруты BazaarLink по цене платформы; модели с префиксом byok-custom/ или byoc/ возвращают 400 (zdr_route_unavailable). Виртуальные модели (vm/), автоматическая маршрутизация (auto), суффиксы :free и :online и резервный список models с ZDR не поддерживаются и возвращают 400 (zdr_endpoint_unsupported). Чтобы использовать собственные ключи поставщиков, возьмите ключ без ZDR.
Почему модель с рассуждением вернула пустой ответ, но списала оплату?
Модели с рассуждением (reasoning) сначала генерируют токены рассуждения, а потом ответ. Если max_tokens слишком мал, рассуждение может израсходовать весь лимит: ответ завершается с finish_reason length и без видимого содержимого. Эти токены рассуждения действительно были сгенерированы, поэтому оплачиваются по использованию, как и у OpenAI. Увеличьте max_tokens или снизьте reasoning effort, чтобы этого избежать. На странице журналов такие запросы помечаются «Рассуждение исчерпало max_tokens, вывода нет».
Может ли ИИ-агент зарегистрировать аккаунт BazaarLink?
Когда функция включена, агент может вызвать POST /api/v1/agents/register с name, необязательными description и referral_code и создать неоплаченный аккаунт. Ответ 201 содержит API-ключ, кредиты, claim token со сроком семь дней и связанные поля аккаунта. Неоплаченные агенты используют существующий механизм бесплатной модели, но для бесплатного веб-поиска нужен подтверждённый email, поэтому он недоступен.