GroqAiApiUncensored LLM API: Руководство по быстрому старту
Uncensored LLM API: Руководство по быстрому старту
Это руководство показывает разработчикам, как интегрировать наш uncensored LLM API, используя стандартные OpenAI-compatible библиотеки. Вы научитесь аутентифицироваться, отправлять запросы и обрабатывать потоковую передачу данных через наш прямой endpoint.
Предварительные требования: Ваш API-ключ и базовый URL
Начните с генерации вашего groq ai api key через страницу Get API key. Вы можете войти через Google или использовать электронную почту и пароль, чтобы мгновенно получить учетные данные. Для этого процесса не требуется номер телефона.
Установите базовый URL в https://api.groqaiapikey.com/v1 в конфигурации вашего клиента. Этот endpoint поддерживает стандартные SDK OpenAI, позволяя менять провайдеров без переписывания логики интеграции. Вам нужен только один активный ключ на аккаунт, так как генерация нового немедленно заменяет предыдущий ключ.
Первый запрос: отправка промпта на /v1/chat/completions
Отправьте POST-запрос на /v1/chat/completions с использованием вашего ключа в Authorization header. Идентификатор модели — это просто uncensored, что обрабатывает текстовые вводы и возвращает текстовые выводы без отказов по содержанию для законного использования для взрослых.
Убедитесь, что вы устанавливаете Content-Type header правильно, чтобы избежать распространенных ошибок 404. Наш API не поддерживает эмбеддинги, генерацию изображений или обработку аудио, поэтому держите ваши полезные нагрузки сфокусированными на завершении чата. Такой прямой подход гарантирует прозрачное ценообразование токенов без наценки прокси-провайдеров.
Установите SDK: совместимые с OpenAI библиотеки
Установите официальный пакет OpenAI для взаимодействия с нашим конечным пунктом с использованием знакомых методов. Эта библиотека автоматически обрабатывает аутентификацию и сериализацию JSON, когда вы указываете наш базовый URL. Вы можете использовать ту же структуру кода, что и для GPT-4, но с нашей uncensored моделью.
Для разработчиков JavaScript установите openai Пакет Node.js. Обе среды позволяют легко переопределять базовый URL. Эта совместимость означает, что вы можете переключаться между различными поставщиками LLM, изменив всего две строки конфигурации в коде.
Обработка потоковой передачи: SSE и использование токенов
Включите потоковую передачу, установив stream: true в параметрах запроса. API возвращает события серверных событий (SSE), которые доставляют токены инкрементально по мере их генерации. Это снижает воспринимаемую задержку для пользователей, ожидающих длинные ответы.
Статистика использования токенов включена только в финальный чанк потока. Вы должны накапливать эти дельты, чтобы рассчитать общее количество потребленных токенов для биллинга. Ошибки и отказы не влекут за собой расходов, поэтому вы можете безопасно использовать потоковую передачу, не беспокоясь о неожиданных расходах за неудачные запросы.
Расширенные параметры: Temperature, JSON-режим и инструменты
Использовать temperature и top_p для контроля случайности и креативности в ваших ответах. Установите response_format для {"type": "json_object"} чтобы обеспечить структурированный вывод JSON для надежного парсинга в ваших приложениях. Это необходимо для создания надежных API чат-ботов для контента 18+ или инструментов извлечения данных.
Включите вызов функций, предоставив tools массив. Модель поддерживает стандартные определения инструментов и может выбирать вызов функций на основе контекста вашего промпта. Вы также можете установить max_tokens to 16,000, which is the maximum output per request. The context window supports 100,000 tokens total, including both prompt and completion.
Лимиты, ошибки и особенности биллинга
Ожидайте ошибку 401, если ваш ключ недействителен, ошибку 402, если у вас недостаточно предоплаченного кредита, и ошибку 429, если вы превысите лимит скорости. Вы ограничены 300 запросами в минуту и 8 одновременными запросами на ключ. Тело запроса должно оставаться менее 8 МБ.
Цены составляют $0.15 за 1M входных токенов и $0.50 за 1M выходных токенов. Пополнение только через криптовалюту (USDT на TRC20 или USDC на Base) от $20 до $500. Вы получаете бонус 5% на $50, 10% на $100 и 15% на $200. Ваш предоплаченный кредит не истекает, поэтому вы можете использовать его, когда вам это нужно.
cURL
curl https://api.groqaiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the current API rate limit?"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.groqaiapikey.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.groqaiapikey.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 = 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-ключ groq AI?
Перейдите на страницу получения API-ключа и войдите через Google или по электронной почте. Ваш ключ отображается сразу после регистрации, без необходимости указания номера телефона. Вы можете сгенерировать новый ключ в любое время, чтобы заменить старый.
Это API совместимо с SDK OpenAI?
Да, наш эндпоинт следует протоколу завершения чата OpenAI. Вы можете использовать официальные библиотеки OpenAI для Python и Node.js, просто изменив базовый URL на адрес нашего API. Это позволяет использовать стандартные параметры, такие как temperature и stream.
Что произойдет, если я получу ошибку 402?
Ошибка 402 означает, что ваш предоплаченный баланс исчерпан. Вы можете пополнить его с помощью USDT (TRC20) или USDC (Base) через панель управления. Минимальная сумма пополнения — $20, и в зависимости от суммы вы получаете бонусный кредит.
Obtain your API key
Зарегистрируйтесь, получите ключ и обновите базовый URL. Это всё, что требуется для конфигурации.