Чек-лист для продакшена ключа Claude api key
Переход с ключа API Claude включает навигацию по различным моделям ценообразования и альтернативным моделям без цензуры для неограниченной генерации текста. Наша конечная точка, совместимая с OpenAI, предлагает единственную мощную модель без цензуры с прозрачной предоплаченной тарификацией на токены и без ежемесячных платежей. В этом руководстве подробно описано, как мигрировать вашу интеграцию, избегая распространенных проблем с лимитами частоты запросов и контекстным окном.
Последнее обновление
Почему стоит перейти с ключа API Claude?
Наш API обеспечивает прямую нецензурированную альтернативу для разработчиков, которым нужна генерация контента без ограничений без сложной маршрутизации моделей. Хотя ключ API Claude служит специфическим корпоративным нуждам, наш подход с одной моделью упрощает интеграцию и снижает операционные издержки. Вы получаете стабильное качество вывода для тем для взрослых, художественных или дискуссионных тем без неожиданных отказов.
Базовый URL HTTPS://api.gemmaapikey.com/v1 работает с любым клиентом, совместимым с OpenAI. Это означает, что вы меняете только base_url и API-ключ в своем существующем коде. Новые SDK или сложные потоки аутентификации не требуются.
Мы не заявляем, что заменяем все варианты использования. Если вам нужны эмбеддинги или генерация изображений, оставайтесь у текущего поставщика. Но для чистой генерации текста наша прозрачная предоплаченная тарификация и отсутствие ежемесячных платежей делают ее прагматичным выбором.
Понимание стоимости токенов
Наша система ценообразования прозрачна: $0.15 за 1M входных токенов и $0.50 за 1M выходных токенов. Ошибки и отказы не тарифицируются, поэтому вы платите только за реальное потребление токенов. Эта предоплаченная модель гарантирует предсказуемость расходов без сюрпризов, связанных с подпиской.
Пополнения обрабатываются только через криптовалюту. Вы можете внести любую целую сумму от $20 до $500, используя USDT (TRC20) или USDC (Base). Бонусные кредиты применяются автоматически: +5% от $50, +10% от $100 и +15% от $200. Платные кредиты не имеют срока действия, поэтому вы можете пополнить счет один раз и использовать средства со временем.
Новые аккаунты получают пробный кредит на $0.50, действительный в течение 7 дней. Это позволяет проверить интеграцию перед тем, как внести крупный депозит.
Основы интеграции
Начните с отправки POST-запроса на /v1/chat/completions. Используйте идентификатор модели "uncensored" для доступа к нашей единственной модели с открытым весом. Она настроена для ответов без отказов в контенте для законного использования взрослыми. Модель не является GPT, Claude, Gemini или какой-либо другой моделью вендора.
Окно контекста поддерживает до 100 000 токенов суммарно для промпта и завершения. Максимальный объем вывода — 16 000 токенов за запрос или 2 048, если параметр max_tokens не задан. Такое большое окно позволяет сохранять обширный контекст в длинных диалогах.
Поддерживаемые параметры включают temperature, top_p, stop, seed, presence_penalty и frequency_penalty. Они позволяют тонко настраивать стиль ответа и детерминированность без необходимости использования дополнительных конечных точек.
Потоковые ответы
Включите потоковую передачу, установив stream в true в запросе. Ответы поступают как Server-Sent Events (SSE). Каждый чанк содержит частичный текст, позволяя вашему приложению отображать вывод в реальном времени.
Последний чанк включает детали использования токенов. Это позволяет точно отслеживать расходы во время сеансов потоковой передачи. Вам не нужно ждать полного ответа, чтобы узнать примерное использование.
Стриминг работает со всеми стандартными SDK OpenAI. Просто обновите base_url на HTTPS://api.gemmaapikey.com/v1. SDK автоматически обрабатывает парсинг SSE. Это значительно сокращает объем шаблонного кода по сравнению с ручной обработкой стрима.
Function Calling
Наш API поддерживает вызов функций через параметр tools. Определите свои функции в запросе, и модель выдаст структурированный JSON для использования инструментов. Это позволяет реализовать сложные рабочие процессы, такие как извлечение данных или запуск действий.
Установите tool_choice в "auto" или укажите конкретную функцию. Модель уважает эти ограничения и выводит корректный JSON. Используйте response_format со значением json_object для строгого соответствия JSON.
Вызов функций идеален для создания помощников, взаимодействующих с внешними системами. Он бесшовно работает с uncensored моделью. Вам не нужен отдельный слой маршрутизации для включения инструментов. Одна и та же конечная точка обрабатывает как чат, так и вызовы функций.
Обработка ошибок
Ошибки возвращают стандартные коды состояния HTTP. Распространённые ошибки включают 429 для лимитов частоты запросов и 400 для недействительных параметров. Проверьте сообщение об ошибке для получения подробностей. Отказы из-за политик контента редки, но возможны для контента с участием несовершеннолетних.
Реализуйте логику повторных попыток для ошибок 429. Наш лимит скорости позволяет 300 запросов в минуту на ключ. Лимиты на всплески позволяют 8 одновременных запросов. Превышение этих лимитов приводит к ответу 429. Подождите немного перед повторной попыткой.
Ошибки не расходуют токены. Если запрос завершается ошибкой, вы не оплачиваете его. Это защищает ваш предоплаченный кредит от потраченных впустую вызовов API. Всегда проверяйте параметры перед отправкой больших полезной нагрузки.
Лимиты запросов
Каждый API-ключ позволяет выполнять 300 запросов в минуту. Одновременно может обрабатываться 8 параллельных запросов. Максимальный размер тела запроса составляет 8 МБ. Эти лимиты обеспечивают стабильную работу для большинства сценариев использования.
На один аккаунт допускается один активный ключ. Генерация нового ключа немедленно заменяет старый. Используйте это для ротации ключей при необходимости. У каждого ключа есть свой счётчик лимитов.
Отслеживайте использование через количество токенов в потоковом ответе. Это помогает оставаться в пределах лимитов. Если вы получите ошибку 429, снизьте частоту запросов или распределите нагрузку между несколькими ключами. Лимиты применяются на ключ, а не на аккаунт.
Рекомендации по безопасности
Храните ваш API-ключ в безопасности. Он отображается сразу после регистрации. Сохраняйте его в переменных окружения, а не в клиентском коде. Используйте HTTPS для всех запросов. Наш API использует стандартные заголовки аутентификации.
Для безопасности аккаунта требуется только адрес электронной почты. Зарегистрируйтесь через Google или по электронной почте и паролю. Номер телефона не нужен. Промпты не используются для обучения. Ваши данные остаются конфиденциальными.
Действует жесткое ограничение на контент: запрещен сексуальный контент с участием несовершеннолетних. Запросы с таким контентом отклоняются. Это единственный строгий фильтр. Весь остальной законный контент для взрослых разрешен. Проверьте версию вашей клиентской библиотеки для оптимальных заголовков безопасности.
Частые вопросы
Является ли uncensored-модель такой же, как Claude?
Нет. Наша модель — это модель с открытым весом, запущенная на наших собственных серверах. Она настроена для неограниченного вывода, но не является Claude, GPT или моделью какого-либо другого вендора'. Она использует тот же формат API для легкой миграции.
Как пополнить кредиты?
Пополнения возможны только криптовалютой. Внесите USDT (TRC20) или USDC (Base) в размере от $20 до $500. Бонусные средства начисляются автоматически за крупные депозиты. Кредиты не истекают.
Включает ли потоковая передача использование токенов?
Да. Последний чанк SSE содержит детали использования токенов. Это позволяет точно отслеживать затраты во время потоковых сессий, не дожидаясь завершения всего ответа.
Что произойдет, если я попаду под ограничение частоты запросов?
Вы получаете ошибку 429. Запросы не расходуют токены. Реализуйте логику повторных попыток с экспоненциальной задержкой. Вы также можете ротировать API-ключи для распределения нагрузки, так как каждый ключ имеет свой лимит 300 запросов в минуту.
Ключ готов через мгновение
Зарегистрируйтесь, скопируйте токен, обновите конечную точку. Это всё, что нужно.
