Базовый URL и аутентификация
Наше API соответствует стандарту OpenAI Chat Completions. Чтобы взаимодействовать с сервисом, направьте клиента на https://api.grokapikey.com/v1 и укажите ваш уникальный API-ключ в заголовке Authorization. Вы можете сгенерировать этот ключ сразу после регистрации, указав только адрес электронной почты и пароль. Ключ отображается один раз при создании, поэтому сохраните его в безопасном месте. Если вы его потеряете, вы можете сгенерировать новый ключ в панели управления, что мгновенно отзовет предыдущий. Для пробного аккаунта не нужно привязывать кредитную карту.
Ваш первый запрос
Начните с отправки простого текстового промпта для проверки подключения. Используйте стандартный эндпоинт chat/completions с идентификатором модели uncensored. Следующий пример демонстрирует базовую команду curl для тестирования подключения. Это подтверждает, что ваша аутентификация выполнена правильно и сервис отвечает. Затем вы можете адаптировать эту структуру для логики вашего конкретного приложения.
Замените YOUR_API_KEY на ваш фактический ключ перед запуском этой команды.
curl https://api.grokapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Интеграция Python SDK
Если вы разрабатываете приложение на Python, используйте официальную библиотеку openai. Настройте клиент на использование нашего базового URL и вашего API-ключа. Это позволяет использовать знакомые идиомы Python при доступе к модели без цензуры. Клиент автоматически обрабатывает сериализацию и потоковую передачу. Убедитесь, что в вашей среде установлена последняя версия библиотеки для лучшей совместимости с нашими эндпоинтами.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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)Интеграция Node.js SDK
Для проектов на JavaScript или TypeScript SDK OpenAI для Node.js работает сразу после установки. Установите свойства apiKey и baseURL в вашем конфигурационном объекте. Это гарантирует, что все последующие запросы будут маршрутизироваться через нашу инфраструктуру. Вы можете использовать стандартные паттерны async/await для обработки ответов. Этот подход идеален для серверных приложений или edge-функций, которым требуется прямой доступ к API без проксирования через OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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);Потоковая передача ответов
Для приложений, которым полезна генерация токенов в реальном времени, включите потоковую передачу, установив stream: true в теле запроса. API возвращает поток Server-Sent Events (SSE) с частичными ответами. Это снижает воспринимаемую задержку для пользователей и позволяет немедленно отображать сгенерированный текст. Каждый чанк содержит дельту ответа. Обрабатывайте эти события в коде клиента, чтобы постепенно обновлять пользовательский интерфейс. Потоковая передача потребляет токены в обычном режиме и не влияет на ценообразование.
stream = 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)Лимиты, ошибки и контекст
Каждый API-ключ ограничен 300 запросами в минуту и максимальным размером тела запроса 8 МБ. Если вы превысите лимит запросов, API вернет код статуса 429; подождите несколько секунд и повторите попытку. Ошибка 401 указывает на недействительный или отозванный ключ, а ошибка 402 означает, что ваш предоплаченный баланс исчерпан. Модель поддерживает контекстное окно на 100 000 токенов как для ввода, так и для вывода в сумме. Убедитесь, что ваши промпты укладываются в этот лимит, чтобы избежать усечения. Фильтры контента остаются минимальными, за исключением жесткого блока на контент сексуального характера с участием несовершеннолетних.
