URL de bază și autentificare
API-ul nostru se află la https://api.huggingfacellmapi.com/v1. Te autentifici folosind un token Bearer trimis în Authorization header. Generează-ți cheia instantaneu prin Obține cheie API pagina folosind Google sau email. Păstrează această cheie în siguranță; oricine o deține poate cheltui creditul tău preplătit. Dacă o pierzi, generează una nouă pentru a înlocui cheia activă veche. Nu este necesar un număr de telefon pentru a începe.
Prima cerere cu cURL
Trimiteți un payload JSON brut pentru a testa endpoint-ul imediat. Utilizați ID-ul modelului uncensored pentru a ocoli filtrele standard. Următoarea comandă cURL demonstrează o solicitare de generare de text de bază.
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"}]
}'Acesta returnează un obiect JSON care conține textul generat. Verificați choices array pentru conținutul efectiv. Dacă primești o eroare 401, verifică dacă cheia este corectă și activă.
Integrare SDK Python
Folosește oficial openai Bibliotecă Python pentru o interfață curată. Indreaptă clientul către URL-ul nostru de bază și setează cheia API. Această abordare gestionează automat reîncercările și analizarea 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)Instalează pachetul prin pip. Apoi poți apela endpoint-ul de completări chat exact așa cum ai face cu OpenAI. Obiectul de răspuns îți oferă acces la utilizarea tokenilor și motivele de finalizare.
Configurare client Node.js
Dezvoltatorii JavaScript pot utiliza openai Pachetul Node. Configurează clientul cu URL-ul nostru specific de bază. Acest lucru asigură că toate cererile sunt rutate prin serverele noastre uncensored.
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);Executați acest fragment în mediul Node. Demonstrează un apel sincron simplu. Puteți integra ușor acest lucru în rutele Express sau funcțiile serverless.
Răspunsuri în streaming
Activați streaming-ul setând stream: true. Serverul trimite Server-Sent Events (SSE) conținând tokeni parțiali. Acest lucru reduce latența percepută pentru utilizatorii finali.
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)Analizați fiecare fragment pe măsură ce ajunge. Fragmentul final conține utilizarea totală de tokeni pentru solicitare. Acest lucru este util pentru interfețe de chat care afișează răspunsurile în timp real.
Limitări, Erori și Context
Fereastra de context este de 100.000 de tokeni, combinând promptul și completarea. Poți solicita până la 16.000 de tokeni de output. Erorile de tip 401 indică o cheie invalidă, în timp ce 402 înseamnă credit insuficient. Limitele de rată te limitează la 300 de solicitări pe minut. Solicitățile care depășesc 8 MB ca dimensiune vor fi respinse. Erorile în timpul procesării nu consumă creditele tale.