Частые вопросы

Аккаунт, безопасность, тарификация, совместимость, устранение неполадок. Сначала загляните сюда — 90% вопросов решаются за минуту.

Обновлено 2026-04-17

Аккаунт и ключи

Можно ли восстановить потерянный API-ключ?

Нет. Ключ показывается открытым лишь один раз при создании; затем в базе хранится только хеш. Если потеряли — просто отзовите старый ключ → создайте новый в консоли, всего два шага.

Сколько ключей можно создать в одном аккаунте?

По умолчанию 20; можно запросить больше. Советуем разделять по назначению: cursor-mac, claude-code-work, ci-prod и т. д. — удобнее для аудита и отзыва.

Как ограничить расход конкретного ключа?

В консоли API Keys → Изменить для каждого ключа можно задать:

Дневной лимит (USD)
Месячный лимит (USD)
Список разрешённых моделей

При превышении ключ автоматически приостанавливается, не затрагивая остальные.

Можно ли удалить аккаунт?

Да. Настройки → Безопасность аккаунта → Удалить аккаунт в консоли; мягкое удаление обратимо 30 дней, после чего данные физически удаляются по процедуре GDPR. См. Политику конфиденциальности.

Тарификация

Как считается стоимость?

Оплата по факту = (входные токены × цена ввода + выходные токены × цена вывода) × коэффициент модели. Коэффициенты от 0,3× до 0,4×, ниже официальных. См. страницу цен.

Сколько внести при первом пополнении?

От $1. Советуем сначала $2–10 для проверки интеграции, затем пополнять крупнее, когда инструменты заработают.

Выдаёте ли вы счета-фактуры?

Мы не выставляем китайские НДС-счета (ни обычные, ни специальные). При реальной необходимости можем по запросу предоставить зарубежный проформа-инвойс; проформа-инвойс не является китайским налоговым документом и не может использоваться для вычета НДС или отчётности на территории Китая.

Каковы правила возврата?

Баланс: возврат без причины не предусмотрен (включая неизрасходованную часть)
Использованная часть: не возвращается
Пассивный возврат: только по требованию закона или при крупном сбое платформы (см. Политику возврата)
Убытки из-за проблем платформы: компенсируются на баланс по заявке (правила открыты)

См. Политику возврата и Правила компенсации как продукта.

Совместимость

Поддерживаете ли вы OpenAI SDK?

Да. Все эндпоинты OpenAI — /v1/chat/completions, /v1/embeddings и др. — полностью совместимы; просто задайте base_url = "https://api.staging.cosmos-router.com/v1".

Поддерживаете ли вы официальный Anthropic SDK?

Да. SDK anthropic для Python / Node работает после смены двух переменных окружения:

export ANTHROPIC_BASE_URL="https://api.staging.cosmos-router.com"
export ANTHROPIC_API_KEY="sk-xxxxx"

Поддерживаете ли вы function calling / tool use?

Да. Параметр tools у OpenAI и tools у Anthropic передаются вышестоящему провайдеру без изменений.

Поддерживаете ли вы стриминг / SSE?

Да. stream: true ведёт себя как в официальных API.

Поддерживаете ли вы prompt cache?

Да. Автоматическое кэширование OpenAI и явный cache_control Anthropic тарифицируются по официальным ставкам (попадание в кэш = 10%–50% цены ввода).

Устранение неполадок

Вызов возвращает 401 Unauthorized

Проверьте, что ключ начинается с sk- (не официальный sk-ant-)
Проверьте, что ключ не отозван (статус на странице API Keys в консоли)
Проверьте формат заголовка: Authorization: Bearer sk-xxxxx (после Bearer есть пробел)

Вызов возвращает 402 Insufficient Quota

Недостаточно средств, либо ключ достиг дневного/месячного лимита. Пополните в консоли или повысьте лимит.

Вызов возвращает 429 Rate Limit

Лимит по умолчанию 600 RPM / 300k TPM
Клиент должен повторять с экспоненциальной задержкой (заголовок Retry-After даёт секунды)
Для высокочастотных сценариев запросите повышение лимита в консоли

Вызовы медленные или с таймаутом

Проверьте страницу статуса (/ru/status) — нет ли активного переключения
1–3 секунды до первого токена у больших моделей Claude / GPT — это нормально
Если стабильно > 10 секунд, посмотрите время ответа вышестоящего для этого запроса в последних вызовах консоли — возможно, очередь на стороне вышестоящего

Ответ отличается от официального

ZetaAPI передаёт запросы и ответы дословно — без переписывания промптов и фильтрации результатов. Если видите разницу, это почти всегда:

Несовпадение версии модели (у gpt-4o несколько снапшотов)
Разные temperature / top_p и т. п.
Случайность (зафиксируйте seed для воспроизводимости)

Если всё ещё подозреваете проблему прокси, откройте тикет с ID запроса (заголовок ответа x-request-id).

Безопасность

Сохраняются ли мои запросы и ответы?

Метаданные (имя модели, число токенов, задержка, код статуса) хранятся для тарификации и мониторинга 90 дней
Содержимое запросов и ответов по умолчанию не сохраняется; только если вы сами включите «отладочные логи», оно хранится 7 дней
У сотрудников нет доступа к содержимому пользователей, журнал аудита публичен

Шифруется ли трафик?

Сквозной TLS 1.3 — HTTPS обязателен и к клиенту, и к вышестоящему.

Что делать, если ключ утёк?

Немедленно отзовите ключ на странице API Keys в консоли (вступает в силу мгновенно, глобально недействителен в течение 10 секунд). Платформа также отслеживает ключи, попавшие на GitHub, и сама уведомляет вас.

Так и не нашли ответ?

Полистайте Справочник API для технических деталей
Загляните в Changelog — нет ли недавнего изменения
Откройте тикет в правом нижнем углу консоли; отвечаем в течение 2 рабочих часов