Basis-URL en authenticatie
Onze API bevindt zich op https://api.huggingfacellmapi.com/v1. Je authenticeert met een Bearer-token dat wordt verzonden in de Authorization header. Genereer je sleutel direct via de API-sleutel ophalen pagina met Google of e-mail. Bewaar deze sleutel veilig; iedereen met deze sleutel kan uw voorbetaalde tegoed uitgeven. Als u hem kwijtraakt, genereert u een nieuwe om de oude actieve sleutel te vervangen. Er is geen telefoonnummer nodig om te beginnen.
Eerste verzoek met cURL
Stuur een ruwe JSON-payload om het eindpunt direct te testen. Gebruik de model-ID uncensored om standaardfilters te omzeilen. Het volgende cURL-commando demonstreert een basis tekstgeneratieverzoek.
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"}]
}'Dit retourneert een JSON-object met de gegenereerde tekst. Controleer de choices array voor de daadwerkelijke inhoud. Als je een 401-fout krijgt, controleer dan of je sleutel correct en actief is.
Python SDK Integratie
Gebruik de officiële openai Python-bibliotheek voor een schone interface. Wijs de client naar onze basis-URL en stel uw API-sleutel in. Deze aanpak behandelt automatisch retries en JSON-parsing.
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)Installeer het pakket via pip. Je kunt vervolgens het chat-completies-eindpunt aanroepen, net zoals je dat zou doen met OpenAI. Het responsobject geeft je toegang tot tokengebruik en beëindigingsredenen.
Node.js-clientinstelling
JavaScript-ontwikkelaars kunnen de openai Node-pakket. Configureer de client met onze specifieke basis-URL. Dit zorgt ervoor dat alle verzoeken via onze ongecensureerde servers worden gerouteerd.
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);Voer deze snippet uit in je Node-omgeving. Het demonstreert een eenvoudige synchronaanroep. Je kunt dit eenvoudig integreren in Express-routes of serverloze functies.
Streaming-responsen
Activeer streaming door stream: true. De server stuurt Server-Sent Events (SSE) met gedeeltelijke tokens. Dit vermindert de waargenomen latentie voor eindgebruikers.
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)Parseer elke chunk wanneer deze aankomt. De laatste chunk bevat het totale tokengebruik voor het verzoek. Dit is nuttig voor het bouwen van chatinterfaces die antwoorden in real-time uittypen.
Limieten, fouten en context
Het contextvenster is 100.000 tokens voor prompt en voltooiing samen. Je kunt tot 16.000 uitvoertokens aanvragen. Fouten zoals 401 geven een ongeldige sleutel aan, terwijl 402 betekent dat er onvoldoende krediet is. Snelheidslimieten beperken je tot 300 verzoeken per minuut. Verzoeken die groter zijn dan 8 MB worden afgewezen. Fouten tijdens verwerking verbruiken geen krediet.