Базова URL-адреса та аутентифікація
Наш API знаходиться за адресою https://api.huggingfacellmapi.com/v1. Ви автентифікуєтесь за допомогою Bearer-токена, надісланого в Authorization header. Згенеруйте свій ключ миттєво через Отримати API-ключ сторінку через Google або електронну пошту. Зберігайте цей ключ у безпеці: будь-хто, хто ним володіє, може витрачати ваші попередньо оплачені кредити. Якщо ви його втратите, згенеруйте новий, щоб замінити старий активний ключ. Для початку не потрібен номер телефону.
Перший запит через cURL
Надішліть сирій JSON-корисне навантаження для миттєвого тестування кінцевого пункту. Використовуйте ідентифікатор моделі uncensored для обходу стандартних фільтрів. Наступна команда cURL демонструє базовий запит на генерацію тексту.
curl https://api.huggingfacellmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize the release notes for version three point zero five"}]
}'Це повертає об'єкт JSON, що містить згенерований текст. Перевірте choices масив для фактичного вмісту. Якщо ви отримуєте помилку 401, перевірте, чи правильний і активний ваш ключ.
Інтеграція SDK Python
Використовуйте офіційний openai Python-бібліотека для чистого інтерфейсу. Вкажіть клієнту нашу базову URL-адресу та встановіть свій API-ключ. Цей підхід автоматично обробляє повторні спроби та парсинг JSON.
from openai import OpenAI
client = OpenAI(base_url="https://api.huggingfacellmapi.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)Встановіть пакет через pip. Після цього ви можете викликати кінцеву точку chat completions так само, як ви робите це з OpenAI. Об'єкт відповіді надає вам доступ до використання токенів та причин завершення.
Налаштування клієнта Node.js
Розробники JavaScript можуть використовувати openai Пакет Node. Налаштуйте клієнта з нашим конкретним базовим URL. Це гарантує, що всі запити маршрутизуються через наші сервери без цензури.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.huggingfacellmapi.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);Запустіть цей фрагмент коду в середовищі Node. Він демонструє простий синхронний виклик. Ви можете легко інтегрувати його в маршрути Express або серверні функції.
Потокові відповіді
Увімкніть потокову передачу, встановивши stream: true. Сервер надсилає події, надіслані сервером (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)Парсуйте кожен чанк по мірі надходження. Останній чанк містить загальне використання токенів для запиту. Це корисно для створення чат-інтерфейсів, які друкують відповіді в реальному часі.
Ліміти, помилки та контекст
Розмір контекстного вікна становить 100 000 токенів для запиту та відповіді разом. Ви можете запитувати до 16 000 токенів відповіді. Помилки 401 вказують на недійсний ключ, а 402 — на недостатній баланс. Ліміти швидкості обмежують вас 300 запитами на хвилину. Запити розміром більше 8 МБ будуть відхилені. Помилки під час обробки не споживають ваші кредити.
