Перейти к содержанию

Часто задаваемые вопросы

Ответы на распространённые вопросы о ClaudeHub API.

Начало работы

Как получить API ключ?

Получите API ключ через наш Telegram бот. Процесс быстрый и простой:

  1. Запустите наш Telegram бот
  2. Используйте меню бота для создания API ключа
  3. Получите ключ мгновенно
  4. Начните использовать API

Есть ли бесплатная пробная версия?

Свяжитесь с нами через Telegram для обсуждения пробных опций для новых пользователей. Мы можем предложить пробные кредиты для оценки сервиса.

В чём разница между ClaudeHub и официальным Anthropic API?

ClaudeHub - это прокси-сервис, который предоставляет:

  • ✅ Конкурентные цены, оптимизированные для российского рынка
  • ✅ Варианты оплаты в рублях (ЮMoney, карты и т.д.)
  • ✅ Не нужны международные способы оплаты
  • ✅ Тот же формат API и модели
  • ✅ Локальная поддержка на русском языке

Какой формат API использовать?

Оба формата работают одинаково хорошо:

  • Формат Anthropic - Используйте, если знакомы с Claude API
  • Формат OpenAI - Используйте при миграции с OpenAI или использовании OpenAI-совместимых инструментов

Выбирайте на основе вашей существующей кодовой базы и инструментов.

Использование API

Какие модели доступны?

ClaudeHub поддерживает все основные модели Claude:

  • Claude Opus 4.6 - Самая продвинутая (контекст 200K)
  • Claude Opus 4 - Продвинутые рассуждения (контекст 200K)
  • Claude Sonnet 4 - Сбалансированная производительность (контекст 200K)
  • Claude Haiku 3.5 - Быстрые ответы (контекст 200K)

См. Справочник API для деталей.

Какой размер окна контекста?

Все модели поддерживают 200,000 токенов контекста (вход). Лимиты выхода различаются:

  • Opus: 32,000 токенов
  • Sonnet: 16,000 токенов
  • Haiku: 8,000 токенов

Поддерживает ли ClaudeHub streaming?

Да! Оба формата Anthropic и OpenAI поддерживают потоковые ответы. Установите stream: true в вашем запросе.

Могу ли я использовать vision/изображения на входе?

Да, все модели кроме Haiku поддерживают возможности vision. Отправляйте изображения в ваших сообщениях используя стандартный формат Anthropic.

Поддерживается ли вызов функций/инструментов?

Да, модели Claude поддерживают вызов функций и использование инструментов. Используйте стандартный формат инструментов Anthropic.

Какой лимит запросов?

В настоящее время нет жёстких лимитов запросов. Мы работаем по политике справедливого использования. Отслеживайте использование кредитов для контроля затрат.

Как проверить баланс?

Используйте endpoint баланса:

curl https://api.claudehub.fun/v1/system/balance \
  -H "x-api-key: sk-hub-YOUR_KEY"

Или проверьте через Telegram бот.

Биллинг и кредиты

Как работает кредитная система?

Кредиты списываются на основе:

  • Используемой модели - Разные модели имеют разную стоимость
  • Входных токенов - Токены в вашем промпте
  • Выходных токенов - Токены в ответе

См. Цены для подробных тарифов.

Сколько это стоит?

Цены различаются по моделям:

  • Haiku 3.5: 0.0056 кредитов за 1K входа, 0.0166 за 1K выхода
  • Sonnet 4: 0.022 кредитов за 1K входа, 0.066 за 1K выхода
  • Opus 4/4.6: 0.11 кредитов за 1K входа, 0.33 за 1K выхода

См. Цены для примеров и пакетов.

Истекают ли кредиты?

Нет, кредиты никогда не истекают. Используйте их в своём темпе.

Какие способы оплаты принимаются?

  • 💳 Банковские карты (Visa, Mastercard, Мир)
  • 💰 ЮMoney
  • 📱 Мобильные платежи
  • 🏦 Банковский перевод

Могу ли я получить возврат?

Да, неиспользованные кредиты могут быть возвращены в течение 7 дней после покупки. Свяжитесь с поддержкой через Telegram.

Что происходит, если у меня закончатся кредиты?

API запросы вернут ошибку 402 Payment Required. Пополните баланс для продолжения использования сервиса.

Есть ли скидки на объём?

Да! Большие пакеты кредитов предлагают лучшую цену за кредит. См. Цены.

Технические вопросы

Какой endpoint API?

Базовый URL: https://api.claudehub.fun

Endpoints: - Формат Anthropic: /v1/messages - Формат OpenAI: /v1/chat/completions - Cursor: /cursor/v1/chat/completions

Как аутентифицироваться?

Используйте заголовок x-api-key с вашим API ключом:

x-api-key: sk-hub-YOUR_KEY

Почему используется x-api-key вместо заголовка Authorization?

ClaudeHub использует x-api-key для аутентификации. Это распространённый паттерн для API прокси и работает с большинством инструментов.

Могу ли я использовать переменные окружения?

Да! Установите эти переменные:

export ANTHROPIC_API_KEY="sk-hub-YOUR_KEY"
export ANTHROPIC_BASE_URL="https://api.claudehub.fun/v1"

Работает ли с официальными SDK?

Да! Оба Python/JavaScript SDK от Anthropic и OpenAI работают отлично. Просто установите параметр base_url.

Что насчёт CORS для браузерных запросов?

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

Есть ли лимит размера запроса?

Максимальный размер запроса примерно 10MB. Этого достаточно для большинства случаев использования, включая изображения.

Какой таймаут для запросов?

  • Таймаут подключения: 10 секунд
  • Таймаут чтения: 180 секунд (3 минуты для streaming)

Долгие запросы поддерживаются через streaming.

Интеграция с IDE

Какие IDE поддерживаются?

ClaudeHub работает с любой IDE, которая поддерживает формат Anthropic или OpenAI API:

  • ✅ Cursor
  • ✅ Cline (VS Code)
  • ✅ Continue (VS Code/JetBrains)
  • ✅ Roo Code
  • ✅ Kilo Code
  • ✅ Любой Anthropic/OpenAI-совместимый инструмент

См. Интеграции для руководств по настройке.

Почему моя IDE не подключается?

Распространённые проблемы:

  1. Неправильный Base URL - Должен быть точно https://api.claudehub.fun/v1
  2. Неправильный API Key - Должен начинаться с sk-hub-
  3. Неправильный заголовок - Используйте x-api-key, не Authorization
  4. Firewall/Proxy - Проверьте настройки сети

Сначала протестируйте с cURL, чтобы проверить, что ваш ключ работает.

Могу ли я использовать несколько API ключей?

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

Требует ли Cursor специальный endpoint?

Да, Cursor использует /cursor/v1 вместо /v1. Это предоставляет расширенные функции для режима агента Cursor.

Безопасность и конфиденциальность

Безопасен ли мой API ключ?

Ваш API ключ зашифрован и хранится безопасно. Никогда не делитесь своим ключом и не добавляйте его в систему контроля версий.

Лучшие практики: - Используйте переменные окружения - Периодически меняйте ключи - Используйте разные ключи для dev/prod

Какие данные вы храните?

Мы храним: - Логи запросов (для биллинга и отладки) - Количество токенов и стоимость - Метаданные API ключей

Мы НЕ храним: - Ваши промпты или ответы (после обработки) - Персональные данные из разговоров

Могу ли я удалить свои данные?

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

Зашифровано ли соединение?

Да, все API запросы используют HTTPS (TLS 1.2+) для шифрования.

Делитесь ли вы данными с третьими лицами?

Нет, мы не делимся вашими данными с третьими лицами, кроме: - Anthropic (для API запросов) - Платёжных процессоров (для биллинга)

Решение проблем

Ошибка: 401 Unauthorized

Причина: Неверный или отсутствующий API ключ

Решение: - Проверьте правильность вашего API ключа - Убедитесь, что используете заголовок x-api-key - Проверьте, что ключ не истёк

Ошибка: 402 Payment Required

Причина: Недостаточно кредитов

Решение: - Проверьте баланс: GET /v1/system/balance - Пополните кредиты через Telegram бот

Ошибка: 404 Not Found

Причина: Неверный endpoint или модель

Решение: - Проверьте URL endpoint - Проверьте правильность имени модели - См. поддерживаемые модели

Ошибка: 429 Too Many Requests

Причина: Превышен лимит запросов

Решение: - Замедлите ваши запросы - Реализуйте экспоненциальную задержку - Свяжитесь с поддержкой, если нужны более высокие лимиты

Ошибка: 500 Internal Server Error

Причина: Ошибка сервера

Решение: - Повторите запрос - Проверьте нашу страницу статуса - Свяжитесь с поддержкой, если проблема сохраняется

Ошибка: 502 Bad Gateway

Причина: Ошибка upstream провайдера (Anthropic)

Решение: - Повторите через несколько секунд - Проверьте страницу статуса Anthropic - Свяжитесь с поддержкой, если проблема сохраняется

Streaming не работает

Причины: - Клиент не поддерживает SSE (Server-Sent Events) - Проблемы с буферизацией - Вмешательство сетевого прокси

Решения: - Используйте официальные SDK (они обрабатывают streaming) - Отключите буферизацию ответов - Протестируйте с простым cURL запросом

Медленные ответы

Причины: - Большой контекст (много токенов) - Сложные промпты - Выбор модели (Opus медленнее Haiku)

Решения: - Используйте streaming для лучшего UX - Уменьшите размер контекста - Используйте более быстрые модели (Haiku/Sonnet)

Лучшие практики

Как уменьшить затраты?

  1. Выбирайте правильную модель - Используйте Haiku для простых задач
  2. Устанавливайте подходящий max_tokens - Не запрашивайте больше, чем нужно
  3. Оптимизируйте промпты - Будьте лаконичны и ясны
  4. Кэшируйте ответы - Избегайте дублирующих запросов
  5. Используйте streaming - Останавливайте генерацию раньше при необходимости

См. Цены для дополнительных советов.

Как корректно обрабатывать ошибки?

Всегда реализуйте обработку ошибок:

try:
    message = client.messages.create(...)
except anthropic.APIError as e:
    if e.status_code == 402:
        print("Недостаточно кредитов")
    elif e.status_code == 401:
        print("Неверный API ключ")
    else:
        print(f"Ошибка API: {e}")
except Exception as e:
    print(f"Неожиданная ошибка: {e}")

Стоит ли использовать streaming?

Используйте streaming когда: - ✅ Генерируете длинные ответы - ✅ Создаёте чат-интерфейсы - ✅ Хотите показывать прогресс пользователям

Не используйте streaming когда: - ❌ Нужен полный ответ сразу - ❌ Обрабатываете ответы программно - ❌ Ваш клиент не поддерживает SSE

Как отслеживать использование?

  1. Регулярно проверяйте баланс - Используйте /v1/system/balance
  2. Настройте оповещения - Отслеживайте уровни кредитов
  3. Отслеживайте затраты - Логируйте использование токенов в вашем приложении
  4. Анализируйте паттерны использования - Оптимизируйте на основе данных

Поддержка

Как получить помощь?

  • 💬 Telegram - Самый быстрый ответ (рекомендуется)
  • 📖 Документация - Сначала проверьте этот сайт
  • 📧 Email - Для подробных запросов

Какую информацию предоставить для поддержки?

При обращении в поддержку включите:

  1. Префикс вашего API ключа (первые 10 символов)
  2. Сообщение об ошибке или код статуса
  3. Временную метку запроса
  4. Используемую модель и endpoint
  5. Шаги для воспроизведения проблемы

Есть ли страница статуса?

Свяжитесь с нами через Telegram для обновлений статуса сервиса.

Могу ли я запросить новые функции?

Да! Мы приветствуем запросы функций. Свяжитесь с нами через Telegram с вашими предложениями.

Миграция

Миграция с OpenAI

ClaudeHub поддерживает формат OpenAI. Просто измените:

# До (OpenAI)
client = OpenAI(api_key="sk-...")

# После (ClaudeHub)
client = OpenAI(
    api_key="sk-hub-YOUR_KEY",
    base_url="https://api.claudehub.fun/v1"
)

Используйте имена моделей Claude: claude-sonnet-4-20250514

Миграция с официального Anthropic API

Измените base URL:

# До
client = anthropic.Anthropic(api_key="sk-ant-...")

# После
client = anthropic.Anthropic(
    api_key="sk-hub-YOUR_KEY",
    base_url="https://api.claudehub.fun/v1"
)

Всё остальное остаётся прежним!

Остались вопросы?

Мы здесь, чтобы помочь! 🚀