GroqAiApiПосібник зі швидкого старту API Нецензурована LLM
Посібник зі швидкого старту API Нецензурована LLM
Цей посібник показує розробникам, як інтегрувати наш uncensored LLM API, використовуючи стандартні OpenAI-сумісні бібліотеки. Ви навчитеся автентифікуватися, надсилати запити та обробляти потокове передавання даних через наш прямий ендпоінт.
Передумови: Ваш API-ключ та базовий URL
Почніть із генерації вашого groq ai api key через сторінку Отримати API-ключ. Ви можете увійти через Google або використати електронну пошту та пароль, щоб миттєво отримати свої облікові дані. Для цього процесу не потрібен номер телефону.
Встановіть вашу базову URL-адресу на https://api.groqaiapikey.com/v1 у вашій конфігурації клієнта. Ця кінцева точка підтримує стандартні SDK OpenAI, що дозволяє змінювати постачальників без переписування логіки інтеграції. Вам потрібен лише один активний ключ на обліковий запис, оскільки генерація нового миттєво замінює попередній ключ.
Перший запит: Надсилання запиту до /v1/chat/completions
Надішліть POST-запит на /v1/chat/completions за допомогою вашого ключа в Authorization header. Ідентифікатор моделі — це просто uncensored, що обробляє текстові вводи та повертає текстові виводи без відмов за змістом для законного дорослого використання.
Переконайтеся, що ви встановлюєте Content-Type header правильно, щоб уникнути поширених помилок 404. Наш API не підтримує вбудовування (embeddings), генерацію зображень або обробку аудіо, тому зосередьте свої запити на завершенні чату. Цей прямий підхід забезпечує прозору ціну за токени без накладних витрат проксі-серверів кількох постачальників.
Встановіть SDK: сумісні з OpenAI бібліотеки
Встановіть офіційний пакет OpenAI для Python для взаємодії з нашим кінцевим пунктом за допомогою знайомих методів. Ця бібліотека автоматично обробляє автентифікацію та серіалізацію JSON, коли ви вказуєте нашу базову URL-адресу. Ви можете використовувати ту саму структуру коду, що й для GPT-4, але з нашою uncensored моделлю.
Для розробників JavaScript встановіть openai Пакет Node.js. Обидва середовища дозволяють легко перевизначити базовий URL. Ця сумісність означає, що ви можете перемикатися між різними постачальниками LLM, змінивши лише два рядки конфігурації у своєму коді.
Обробка потокової передачі: SSE та використання токенів
Увімкніть потокову передачу, встановивши stream: true у параметрах запиту. API повертає події Server-Sent Events (SSE), які доставляють токени інкрементально по мірі їх генерації. Це зменшує сприйняту затримку для користувачів, які чекають на довгі відповіді.
Статистика використання токенів включена лише в кінцевий чанк потоку. Вам потрібно акумулявати ці дельти, щоб розрахувати загальну кількість спожитих токенів для цілей розрахунків. Помилки та відмови не нараховують збори, тому ви можете безпечно використовувати потоковий режим, не хвилюючись про несподівані витрати за невдалі запити.
Розширені параметри: Temperature, JSON-режим та інструменти
Використовувати temperature та top_p для контролю випадковості та креативності у ваших відповідях. Встановіть response_format до {"type": "json_object"} щоб забезпечити структурований вивід у форматі JSON для надійного парсингу у ваших додатках. Це суттєво для створення надійних API чатботів NSFW або інструментів видобутку даних.
Увімкнути виклик функцій, надавши 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?
Так, наш ендпоінт відповідає протоколу chat completions OpenAI. Ви можете використовувати офіційні бібліотеки Python та Node.js OpenAI, просто змінивши базовий URL на адресу нашого API. Це дозволяє використовувати стандартні параметри, такі як temperature та stream.
Що станеться, якщо я отримую помилку 402?
Помилка 402 означає, що ваш попередньо оплачений кредит вичерпано. Ви можете поповнити баланс за допомогою USDT на мережі TRC20 або USDC на мережі Base через панель керування. Поповнення починаються від $20, і ви отримуєте бонусний кредит залежно від суми депозиту.
Отримайте свій API-ключ
Зареєструйтеся, отримайте ключ і оновіть свій базовий URL. Це все, що потрібно для конфігурації.