Руководство по интеграции API Grok

Почему стоит использовать альтернативу API Grok без ограничений?

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

Корпоративные API часто меняют логику фильтрации без предупреждения. Это ломает downstream-приложения, которые полагаются на определённые типы контента. Выделенная нецензурируемая служба устраняет эту неопределённость. Ваши промпты возвращают ровно то, что генерирует модель.

Учитывайте разницу между интерфейсом чата и raw API. Интерфейс чата может скрывать нюансированные выводы. API раскрывает полный поток токенов. Эта прозрачность критична для разработчиков, создающих специализированные инструменты.

Наш сервис работает независимо. Мы не предоставляем Grok или любую другую модель вендора. Мы предоставляем отдельную uncensored большую языковую модель. Она работает на наших собственных серверах. Интерфейс остается знакомым для пользователей OpenAI.

Ключевые преимущества

• Отсутствие ежемесячных платежей за подписку.
• Прозрачная предоплаченная тарификация.
• Сырой вывод для законного контента для взрослых.
• Нет скрытых отказов для спорных тем.

Понимание структуры конечной точки API

Два эндпоинта обрабатывают все взаимодействия: POST /v1/chat/completions и GET /v1/models. Они следуют стандартной спецификации API OpenAI. Вы отправляете JSON полезную нагрузку с вашими системными и пользовательскими сообщениями. Сервер возвращает JSON ответ с сгенерированным текстом.

Конечная точка GET перечисляет доступные модели. Она подтверждает, что ваше подключение работает. Используйте это, чтобы проверить работоспособность вашего API ключа перед отправкой больших нагрузок. Он также показывает ID модели, который вы должны включить в свои запросы.

Наш базовый URL — HTTPS://api.isgrokunfiltered.com/v1. Это заменяет URL OpenAI по умолчанию в конфигурации вашего клиента. Идентификатор модели для отправки — "uncensored". Это гарантирует, что вы обращаетесь к правильному серверу.

Аутентификация использует Bearer-токен в заголовке Authorization. Включите ваш API-ключ напрямую. Сложные потоки OAuth не требуются. Эта простота значительно сокращает время интеграции.

Сводка по конечным точкам

Метод	Путь	Функция
POST	/v1/chat/completions	Генерирует текстовые ответы
GET	/v1/models	Список доступных моделей

Настройка вашего клиента для потоковой передачи

Включите потоковую передачу, установив параметр stream в true в теле запроса. Это возвращает события, отправляемые сервером (SSE), вместо одного объекта JSON. Каждое событие содержит частичный фрагмент ответа. Вы можете отображать текст пользователям в реальном времени.

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

Каждый чанк включает данные об использовании токенов в конечном событии. Вы можете точно отслеживать входные и выходные токены. Это помогает контролировать баланс предоплаченных кредитов. Ошибки во время стриминга все равно потребляют токены за обработанные данные.

Правильно обрабатывайте формат SSE. Разбирайте каждую строку, начинающуюся с "data: ". Игнорируйте финальное событие "[DONE]". Это гарантирует, что ваше приложение правильно обработает каждый токен.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.isgrokunfiltered.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Обработка вызовов функций в uncensored режиме

Вызов функций позволяет вашему приложению выполнять код на основе вывода модели. Отправьте список инструментов в запросе. Модель возвращает массив tool_calls вместо обычного текста. Ваш код выполняет функцию и отправляет результат обратно.

Это работает в связке с нашей моделью без цензуры. Модель не отказывается вызывать функции из-за типа контента. Она фокусируется на логической структуре запроса. Это идеально подходит для сложных задач извлечения данных.

Используйте режим JSON для принудительного применения строгих форматов вывода. Установите response_format в json_object. Модель возвращает только действительный JSON. Это снижает ошибки парсинга в вашем бэкенде. Это обеспечивает согласованные структуры данных.

Сочетайте вызов функций с потоковой передачей для динамического взаимодействия. Вы можете начать выполнение функций, пока модель все еще генерирует текст. Это создает высоко отзывчивое приложение. uncensored модель обрабатывает разнообразные определения инструментов без предвзятости.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.isgrokunfiltered.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Оптимизация затрат на токены для длинных контекстов

Окно контекста поддерживает до 100 000 токенов. Это включает как промпт, так и завершение. Более длинные контексты потребляют больше предоплаченного кредита. Отслеживайте использование токенов, чтобы избежать неожиданных расходов.

Входные токены стоят $0.15 за миллион. Выходные токены стоят $0.50 за миллион. Выходные токены значительно дороже. Оптимизируйте промпты, чтобы уменьшить объем входных данных. Используйте краткие системные инструкции. Избегайте отправки лишней истории.

Установите параметр max_tokens для контроля длины вывода. Значение по умолчанию составляет 2,048 токенов. Вы можете увеличить это значение до 16,000 токенов на запрос. Это предотвращает неконтролируемую генерацию, которая быстро сжигает кредит.

Ошибки и отказы бесплатны. Вы платите только за успешную генерацию токенов. Это защищает вас от бесполезных трат на неудачные запросы. Регулярно отслеживайте баланс, чтобы быть в курсе событий.

Детализация тарифов

• Вход: $0.15 / 1M токенов
• Вывод: $0.50 / 1M токенов
• Макс. вывод: 16 000 токенов
• Контекстное окно: 100 000 токенов

Настройки лимитов запросов и параллелизма

Каждый API-ключ позволяет выполнять 300 запросов в минуту. Это ограничение применяется глобально к вашему ключу. Приложения с высокой частотой запросов должны тщательно управлять частотой запросов. Превышение лимита возвращает ошибку 429 Too Many Requests.

Вы можете выполнять до 8 параллельных запросов на один ключ. Это позволяет параллельно обрабатывать независимые задачи. Управляйте параллелизмом, чтобы не превысить лимит частоты запросов. Распределяйте запросы во временных интервалах.

Максимальный размер тела запроса составляет 8 МБ. Большие полезная нагрузка с обширной историей могут превысить это ограничение. Сожмите ввод или обрежьте старые сообщения. Это гарантирует успешную обработку ваших запросов.

У вас может быть только один активный ключ на аккаунт. Если вы потеряете ключ, сгенерируйте новый. Старый ключ становится недействительным немедленно. Это упрощает управление безопасностью. Периодически меняйте ключи для дополнительной защиты.

Copycurl https://api.isgrokunfiltered.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of five unique Python script ideas."}]
  }'

Миграция существующих ключей API Grok

Миграция в наш API требует изменения базового URL и идентификатора модели. Структура существующего клиентского кода остается в значительной степени прежней. Обновите базовый URL до HTTPS://api.isgrokunfiltered.com/v1. Измените идентификатор модели на «uncensored».

Устранение распространенных ошибок интеграции

Ошибки 401 Unauthorized указывают на недействительный или истекший API-ключ. Проверьте ключ в панели управления. Убедитесь, что вы отправляете его в заголовке Authorization. Проверьте наличие пробелов в начале или опечаток.

429 Too Many Requests означает, что вы достигли лимита скорости. Уменьшите частоту запросов или увеличьте интервал между вызовами. Используйте экспоненциальное замедление для повторных попыток. Это предотвращает перегрузку сервера.

400 Bad Request часто возникает из-за некорректного JSON. Убедитесь, что ваш полезная нагрузка соответствует ожидаемой схеме. Проверьте наличие обязательных полей, таких как messages или model. Используйте GET-эндпоинт для проверки доступности модели.

Ошибки 500 Internal Server Errors редки, но возможны. Повторите запрос после небольшой задержки. Если проблема сохраняется, свяжитесь с поддержкой. Наши журналы помогут быстро выявить первопричину.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Следующие шаги: Тестирование вашей uncensored модели

Начните с простого запроса на генерацию текста. Отправьте короткий промпт и проверьте формат ответа. Убедитесь, что потоковая передача работает правильно. Убедитесь, что вызов функций плавно интегрируется с вашим кодом.

Отслеживайте использование токенов внимательно. Предоплаченная модель взимает плату только за фактические токены. Ошибки бесплатны. Это позволяет безопасно экспериментировать. Пополняйте кредит, используя криптовалюту, когда это необходимо.

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

Зарегистрируйтесь через Google или email. Получите API-ключ мгновенно. Номер телефона не требуется. Начните тестирование сразу с пробным кредитом $0.50. Это дает возможность оценить сервис без рисков.