FAQ

TokSpan — это универсальный AI API-шлюз, который предоставляет единую конечную точку, совместимую с OpenAI, для доступа к 200+ моделям от 50+ провайдеров — включая OpenAI, Anthropic, Google, Meta, DeepSeek и другие.

Вот как это работает: вы отправляете запросы к API TokSpan в стандартном формате OpenAI. TokSpan маршрутизирует ваш запрос к соответствующему upstream-провайдеру, при необходимости преобразует формат, обрабатывает ответ и возвращает его вам. С вашей точки зрения вы обращаетесь к одному API — TokSpan управляет маршрутизацией моделей, балансировкой нагрузки, лимитом запросов, автоматическим переключением и отслеживанием затрат за кулисами.

Вам нужен только аккаунт TokSpan. Мы управляем всеми отношениями с upstream-провайдерами от вашего имени — отдельные аккаунты у OpenAI, Anthropic или Google не требуются.

• Один ключ — все модели — Доступ к GPT-4o, Claude Opus, Gemini Pro и DeepSeek V3 с одним API-ключом. Никакого управления множеством биллинговых аккаунтов у разных провайдеров.
• Никакой привязки к вендору — Переключайте модели изменением одного параметра. Ваш код остаётся неизменным независимо от того, какой провайдер обслуживает запрос.
• Автоматическое переключение — Если провайдер недоступен, трафик автоматически направляется на резервную модель. Ноль ручного вмешательства.
• Глобальный охват — Глобальная пограничная сеть, обслуживающая разработчиков по всему миру.
• Прозрачность затрат — Единый биллинг и отслеживание использования в реальном времени по всем моделям и провайдерам в одной панели управления.

Начало работы занимает около 5 минут:

1. Зарегистрируйтесь на api.tokspan.com/register
2. Пополните баланс с помощью кредитной карты, PayPal или банковского перевода
3. Создайте API-ключ на странице Панель управления → API-ключи
4. Сделайте первый вызов — просто измените base_url на https://api.tokspan.com/v1 и используйте ваш новый ключ

Если вы уже используете OpenAI SDK, вы в 30 секундах от начала. См. руководство Quickstart для примеров кода на Python, TypeScript и curl.

Мы не предлагаем постоянный бесплатный тариф — вот почему это на самом деле хорошо для вас:

• Никакого субсидируемого ухудшения качества — Бесплатные тарифы в масштабе требуют экономии на инфраструктуре, поддержке или доступе к моделям. Мы инвестируем всё в надёжность и покрытие моделей.
• Платите только за то, что используете — Никаких минимальных обязательств. Пополняйте на любую сумму. Большинство разработчиков тратят менее $5 в первый месяц тестирования.
• Все модели, без ограничений — Ваш оплаченный баланс даёт немедленный доступ к каждой передовой модели на платформе — никаких ограничений «только для бесплатного тарифа».

Новые аккаунты могут время от времени получать промо-кредиты. Проверьте Панель управления после регистрации.

Мы предоставляем доступ к 200+ моделям по всем основным категориям: LLM (GPT-4o, Claude Opus 4.8, Gemini 2.5 Pro, DeepSeek V3, Llama 4, Mistral Large 3), Vision и мультимодальные, Embeddings и реранкинг, а также Speech и Audio (TTS + STT).

Ознакомьтесь с полным актуальным каталогом с текущими ценами за токен на api.tokspan.com/pricing. См. документацию по моделям для обзора категорий и сравнения возможностей.

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

Цена каждого токена модели (включая сервисную комиссию) видна в реальном времени в Model Hub до совершения вызова. Цена, которую вы видите — это цена, которую вы платите: никаких скрытых затрат, никаких неожиданных счетов.

Никакой ежемесячной подписки и минимальных обязательств. Пополните на любую сумму и сразу начинайте вызывать модели.

Мы поддерживаем несколько способов оплаты для клиентов по всему миру:

• Кредитные / дебетовые карты — Visa, Mastercard, American Express через Stripe. Применяются стандартные комиссии за обработку карт.
• PayPal — Доступен в 200+ странах и регионах.
• Банковский перевод (Wire) — Доступен для enterprise-аккаунтов (минимальный счёт: $500). Время обработки: 1–3 рабочих дня.

Все платежи номинированы в USD. Ваш баланс обновляется немедленно для платежей картой/PayPal; банковские переводы отображаются после подтверждения.

Да, со следующей политикой:

• Платежи кредитной картой / PayPal — Неиспользованные кредиты подлежат возврату в течение 7 дней с момента покупки. Платформенная сервисная комиссия (наценка сверх тарифов провайдера) не возвращается за уже потреблённые токены.
• Банковские переводы — Возврат обрабатывается в течение 5–10 рабочих дней за вычетом комиссий за перевод.

Чтобы запросить возврат, свяжитесь с support@tokspan.com, указав email аккаунта и детали платежа.

Да. Неиспользованные кредиты истекают через 12 месяцев после покупки. Эта политика позволяет нам управлять обязательствами перед провайдерами, сохраняя нашу сервисную комиссию как можно ниже. Вы получите email-уведомления за 30 дней и за 7 дней до истечения срока действия кредитов. Даты истечения видны в панели управления в разделе Биллинг → Кредиты.

Автопополнение гарантирует, что ваш баланс никогда не упадёт до нуля:

1. Перейдите в Панель управления → Биллинг → Автопополнение
2. Установите порог (например, $5 — когда баланс опускается ниже этой суммы, мы запускаем пополнение)
3. Установите сумму (например, $20 — сколько добавлять каждый раз)
4. Выберите способ оплаты

Вы будете получать email-квитанцию о каждом автопополнении. Вы можете отключить или изменить его в любое время. Рекомендуем включить его для продакшен-нагрузок, чтобы избежать прерываний с кодом 402.

У вас есть несколько уровней контроля расходов:

• Месячный бюджет на ключ — Установите жёсткий лимит расходов на каждый API-ключ. Когда ключ достигает лимита, запросы отклоняются, пока вы не повысите лимит или не начнётся новый цикл.
• Лимиты скорости на модель — Установите пользовательские лимиты RPM (запросов в минуту) и TPM (токенов в минуту) для каждого API-ключа.
• Белый список моделей — Ограничьте ключ только определёнными моделями (например, разрешите только дешёвые модели для ключей разработки).
• Белый список IP — Ограничьте использование ключа конкретными IP-адресами или диапазонами.
• Панель использования в реальном времени — Отслеживайте расходы по ключам, моделям и периодам в панели управления.

Все лимиты настраиваются в Панель управления → API-ключи при создании или редактировании ключа. См. Key Scoping для подробностей.

Токены подсчитываются точно так же, как их считает upstream-провайдер: токены промпта + токены завершения = общее количество оплачиваемых токенов. Мы используем токенизатор каждого провайдера, поэтому подсчёт совпадает с тем, что вы увидели бы при прямом обращении к провайдеру.

Для мультимодальных входных данных (изображения, аудио, видео): каждый провайдер имеет собственную формулу преобразования медиа в токен-эквиваленты. Мы используем расчёт провайдера — ваша панель управления показывает итоговое количество токенов и стоимость. Как правило: изображения высокого разрешения — ~85–170 токенов каждое (GPT-4o), аудио — ~50 токенов в секунду (Whisper).

Для моделей с кэшированием промптов (Claude, GPT-4o) кэшированные токены промпта оплачиваются по сниженному тарифу кэша провайдера. Ваша панель использования разделяет расходы на обычные и кэшированные токены.

Нет — мы не храним ваши промпты или ответы. Ваши данные проходят через нашу инфраструктуру в реальном времени и не сохраняются. Мы регистрируем только метаданные запроса (модель, количество токенов, временная метка, ID API-ключа) для точности биллинга и предотвращения злоупотреблений. Это необходимо для расчёта вашего использования и защиты платформы.

Мы никогда не используем ваши промпты или ответы для обучения моделей и никогда не продаём и не передаём ваши данные третьим лицам.

Если вам требуется нулевая видимость данных (т.е. вы не хотите, чтобы мы видели даже метаданные), TokSpan можно полностью развернуть самостоятельно — разверните за вашим брандмауэром с полным суверенитетом данных. См. Могу ли я самостоятельно развернуть? ниже.

Это зависит от провайдера и ваших настроек:

• OpenAI — Не обучается на вызовах API (с марта 2023 г.). Данные, отправленные через API, по умолчанию не используются для обучения моделей.
• Anthropic — Не обучается на данных API. Данные Claude API не используются для улучшения моделей, если вы явно не дали согласие.
• Google (Gemini) — Не обучается на платном использовании API. Использование в рамках бесплатного тарифа может регулироваться другими условиями.
• Другие провайдеры — Политики различаются. Проверяйте условия каждого провайдера. Мы рекомендуем ознакомиться с политикой использования данных провайдера, если это вызывает опасения.

Для максимального контроля разверните TokSpan самостоятельно и настройте ваши upstream API-ключи с провайдерами, имеющими чёткую политику отказа от обучения. Вы сохраняете полный контроль над тем, к каким провайдерам попадают ваши данные.

Все API-ключи зашифрованы при хранении (AES-256). Ключи отображаются только один раз при создании — мы не можем восстановить утерянный ключ (вы создаёте новый и отзываете старый). Весь API-трафик шифруется с помощью TLS 1.3 при передаче. Мы рекомендуем использовать API-ключи с IP-whitelisting, ограничением по моделям и месячными лимитами расходов для эшелонированной защиты. Ротируйте ключи каждые 90 дней в соответствии с лучшими практиками безопасности.

Безопасность — основа TokSpan. Наша инфраструктура построена вокруг следующих мер контроля:

• TLS 1.3 — все передаваемые данные зашифрованы сквозным шифрованием.
• AES-256 — API-ключи и учётные данные зашифрованы при хранении.
• MFA — многофакторная аутентификация поддерживается на всех аккаунтах.
• Практики, соответствующие GDPR — минимизация данных и раскрытие информации о конфиденциальности описаны в нашей Политике конфиденциальности.

Корпоративные клиенты могут запросить дополнительные сведения о нашей безопасности по адресу support@tokspan.com.

Да. Наш хостинговый сервис реализует требования GDPR и CCPA: минимизация данных (мы не храним ваши промпты и ответы), ограничение целей (метаданные используются только для биллинга и предотвращения злоупотреблений), удаление пользовательских данных по запросу и прозрачное раскрытие информации об обработке данных.

Для строгих требований к локализации данных и соблюдению нормативных требований самостоятельный хостинг даёт вам полный контроль — разверните TokSpan на собственной инфраструктуре в любом регионе, за вашим файрволом. Свяжитесь с support@tokspan.com для получения DPA (Соглашения об обработке данных).

Вы можете удалить аккаунт и все связанные данные через Dashboard → Settings → Account → Delete Account. Удаление аккаунта является окончательным и необратимым.

Относительно вашего баланса:

• Любые оставшиеся кредиты на момент удаления аннулируются. Мы рекомендуем использовать баланс или запросить возврат средств до начала удаления.
• Платёжные записи, требуемые по закону (квитанции об оплате, счета-фактуры), хранятся в течение установленного законом срока — обычно 7 лет.
• Все остальные данные аккаунта (API-ключи, логи использования, email, настройки) безвозвратно удаляются в течение 30 дней.

Да. DPA доступны для корпоративных и командных аккаунтов. Мы предоставляем стандартное DPA, которое охватывает обязательства обработчика данных по GDPR, раскрытие информации о субподрядчиках, гарантии трансграничной передачи данных (SCC) и обязательства по уведомлению об утечках. Свяжитесь с support@tokspan.com, указав требования вашей юридической команды — стандартный срок рассмотрения составляет 2–3 рабочих дня.

Да, на 100%. Измените base_url на https://api.tokspan.com/v1, и ваш существующий код с OpenAI SDK заработает мгновенно — Python, Node.js, Go, curl или любая библиотека, совместимая с OpenAI.

Поддерживаемые функции:

• Chat Completions — Полная поддержка, включая системные, пользовательские и ассистентские сообщения
• Streaming — SSE (Server-Sent Events) с stream: true
• Function / Tool Calling — Параллельные вызовы инструментов, строгий режим
• JSON Mode — Структурированный вывод с response_format
• Vision / Image Input — Изображения по URL и в base64
• Embeddings — Полная поддержка от множества провайдеров
• Audio — TTS (text-to-speech) и STT (speech-to-text / Whisper)
• Images — Генерация через DALL·E и совместимые модели
• Rerank — Полная поддержка
• Reasoning Effort — Управление глубиной рассуждения через суффиксы модели (см. ниже)

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

Если суффикс не указан, используется уровень рассуждения модели по умолчанию. Это позволяет вам находить компромисс между скоростью, стоимостью и качеством ответа для каждого запроса без изменения кода интеграции. Подробнее см. Models → Reasoning Effort.

Помимо суффиксов рассуждения, TokSpan поддерживает варианты, ориентированные на маршрутизацию, которые управляют тем, как ваш запрос направляется:

Комбинируйте суффиксы, где это поддерживается: например, gpt-5-high-fast для максимального рассуждения с маршрутизацией по наименьшей задержке. Совместимость суффиксов для каждой модели см. в документации по моделям.

Да. Prompt caching применяется автоматически, когда upstream-провайдер поддерживает эту функцию (Claude, GPT-4o, Gemini). Когда вы отправляете одинаковый префикс промпта в нескольких запросах, провайдер кеширует вычисления и взимает плату по сниженному тарифу за кешированную часть — обычно скидка 90% от полной стоимости токенов промпта.

Вам не нужно менять код. TokSpan передаёт статус кеша от провайдера, и ваша панель управления показывает использование кешированных и некешированных токенов. Для максимального попадания в кеш:

• Размещайте статический контент (системные промпты, контекстные документы) в начале промпта
• Размещайте динамический контент (сообщения пользователя, последние запросы) в конце
• Используйте один и тот же системный промпт в разных запросах

Прочитайте полное руководство по оптимизации: Prompt Caching.

Да. TokSpan поддерживает Bring Your Own Key — вы можете добавить собственные API-ключи OpenAI, Anthropic, Google или других провайдеров в панели управления. При настройке BYOK:

• Запросы к этому провайдеру направляются через ваш ключ, а не через пул TokSpan
• Вы платите провайдеру напрямую — TokSpan не взимает комиссию за BYOK-запросы
• Вы по-прежнему можете использовать единую конечную точку TokSpan, автоматическое переключение и отслеживание затрат
• Комбинируйте BYOK-ключи с пулом TokSpan: используйте свои ключи для основного провайдера и пул TokSpan для остальных

BYOK идеально подходит для команд с существующими отношениями с провайдерами, корпоративными скидками или строгими требованиями к разделению биллинга. Настройте в разделе Dashboard → Settings → Provider Keys.

TokSpan возвращает стандартные коды состояния HTTP:

Мы рекомендуем реализовать экспоненциальную задержку с jitter для ошибок 429 и 5xx. Полный справочник с телами ответов см. в разделе Error Codes.

Мы стремимся к доступности 99,99% для нашего хостингового API. Наша инфраструктура горизонтально масштабируется в нескольких зонах доступности без единой точки отказа. Для критически важных рабочих нагрузок развёртывание на собственных серверах даёт вам полный контроль над целевыми показателями доступности.

Корпоративные тарифы включают формальное SLA с обязательствами по доступности, штрафными санкциями и приоритетным реагированием на инциденты. Свяжитесь с support@tokspan.com для получения условий SLA.

TokSpan автоматически переключается на следующую предпочтительную модель. Наша система:

1. Обнаруживает недоступность провайдера (ошибки 5xx, тайм-ауты) в течение секунд
2. Пропускает провайдеров с недавними сбоями (30-секундное окно ожидания)
3. Направляет запрос к следующей модели в цепочке переключения (настраивается в Dashboard → Channels)

Правильно спроектированная цепочка (например, GPT-4o → Claude Opus → Gemini Pro) обеспечивает ноль потерянных запросов. Вы платите только за модель, которая в конечном итоге обслуживает запрос — неудачные попытки не тарифицируются. Инструкции по настройке см. в разделе Auto Failover.

TokSpan добавляет минимальные накладные расходы на маршрутизацию — обычно менее 100 мс для API-запросов. Основным фактором задержки является скорость генерации upstream-модели (время до первого токена и токенов в секунду), на которую маршрутизация через TokSpan не влияет.

Для приложений, чувствительных к задержке:

• Включите потоковую передачу (stream: true), чтобы пользователи видели токены по мере генерации
• Используйте суффикс модели -fast для автоматической маршрутизации к провайдеру с наименьшей задержкой
• Разверните собственный экземпляр в регионе вашего приложения для нулевых сетевых накладных расходов

Да. Проверьте страницу статуса API для отслеживания работоспособности сервиса в реальном времени, истории инцидентов и запланированных окон технического обслуживания. Подпишитесь на уведомления об инцидентах по email, Slack или Webhook — настройка описана в разделе Webhooks.

Войдите в панель управления, перейдите в раздел API Keys и нажмите + New Key. Дайте каждому ключу описательное имя (например, "production-backend", "mobile-app-dev", "staging-test"). Вы можете создавать неограниченное количество ключей.

Мы настоятельно рекомендуем создавать отдельные ключи для каждого окружения (development, staging, продакшен). Каждый ключ имеет независимый учёт использования, лимиты расходов и ограничение по моделям — что позволяет легко отслеживать затраты для каждого окружения или клиента. Если ключ разработки будет скомпрометирован, ваш продакшен-ключ останется незатронутым.

Немедленно отзовите его в панели управления — отзыв вступает в силу мгновенно (в течение 60 секунд). Создайте новый ключ и обновите приложение. Проверьте журналы использования на предмет подозрительной активности по старому ключу перед его удалением.

Лучшие практики предотвращения:

• Используйте IP-whitelisting для ограничения источников использования ключей
• Установите месячные лимиты расходов, чтобы ограничить ущерб в случае утечки ключа
• Ротируйте ключи каждые 90 дней
• Никогда не коммитьте ключи в систему контроля версий — используйте переменные окружения или менеджер секретов

Создайте отдельный API-ключ для каждого окружения в панели управления:

• Development — Жёсткий лимит расходов ($10/мес.), ограничение на более дешёвые модели, без IP-ограничений (для локальной разработки)
• Staging — Умеренный лимит ($50/мес.), те же модели, что и в продакшене, IP-ограничение на серверы staging
• Production — Более высокий лимит по необходимости, все модели, IP-ограничение на серверы продакшена

Каждый ключ имеет собственную панель использования, оповещения и журнал активности. Такая настройка даёт вам прозрачность затрат по окружениям и предотвращает ситуацию, когда ошибка на этапе разработки расходует ваш продакшен-бюджет. Полный справочник по настройке см. в разделе Key Scoping.

Да. TokSpan можно развернуть на собственной инфраструктуре через Docker, Docker Compose или Kubernetes. Самостоятельный хостинг даёт вам:

• Полный суверенитет данных — никакие данные не покидают вашу инфраструктуру
• Полный контроль логирования — вы решаете, что логируется и где хранится
• Нулевые накладные расходы на задержку — разверните в регионе вашего приложения
• Неограниченная кастомизация — адаптируйте платформу под свои нужды

См. наши руководства по развёртыванию или свяжитесь с support@tokspan.com для получения помощи.

Да. TokSpan поддерживает командные и корпоративные развёртывания с выделенными средствами управления:

• Командные рабочие пространства — подключи, роли и лимиты на ключ
• Консолидированный биллинг — один счёт по всем моделям и командам
• Индивидуальные лимиты запросов — масштабируются под вашу нагрузку

Для получения вариантов выделенного развёртывания свяжитесь с support@tokspan.com.

Да. Корпоративные тарифы включают:

• Выделенного менеджера по работе с клиентами — Единое контактное лицо для всех вопросов
• Приоритетную поддержку — Гарантированное время ответа (обычно до 2 часов для критических проблем)
• Индивидуальное SLA — Обязательства по доступности со штрафными санкциями, адаптированные под ваши нужды
• Консолидированное выставление счетов — Условия Net-30/60, заказы на покупку, мультивалютный биллинг
• Индивидуальные лимиты запросов — Лимиты RPM/TPM, масштабируемые под вашу нагрузку
• Помощь в развёртывании — Обзор архитектуры, кастомизация Helm-чартов, настройка на собственной инфраструктуре

Свяжитесь с support@tokspan.com, указав ваши требования — мы подготовим предложение в течение 1 рабочего дня.

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

Корпоративные клиенты также могут обсудить выделенное региональное развёртывание, управляемое нашей командой. Свяжитесь с support@tokspan.com для уточнения доступности в вашем целевом регионе.

Мы предлагаем несколько каналов поддержки:

• Email — support@tokspan.com для вопросов по биллингу, аккаунту и технических вопросов. Мы отвечаем в течение 24 часов; большинство вопросов решается в рамках одного обращения.
• Страница статуса — API Status для обновлений об инцидентах в реальном времени. Подпишитесь на уведомления во время сбоев.

Корпоративные клиенты получают выделенный Slack-канал с нашей инженерной командой для взаимодействия в реальном времени.