Base URL og autentificering
Vores API leveres på https://api.huggingfacellmapi.com/v1. Du autentificerer ved hjælp af en Bearer-token sendt i Authorization header. Generer din nøgle øjeblikkeligt via Få API-nøgle side ved hjælp af Google eller e-mail. Opbevar denne nøgle sikkert; alle, der har den, kan bruge dine forudbetalede kreditter. Hvis du mister den, skal du generere en ny til at erstatte den gamle aktive nøgle. Der kræves ikke telefonnummer for at starte.
Første anmodning med cURL
Send et rå JSON-payload for at teste endpointet straks. Brug model-ID'et uncensored til at omgå standardfiltre. Følgende cURL-kommando demonstrerer en grundlæggende tekstgenereringsanmodning.
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"}]
}'Dette returnerer et JSON-objekt, der indeholder den genererede tekst. Tjek den choices array til det faktiske indhold. Hvis du modtager en 401-fejl, skal du verificere, at din nøgle er korrekt og aktiv.
Python SDK-integration
Brug den officielle openai Python-bibliotek til en ren interface. Ret klienten mod vores base URL og indstil din API-nøgle. Denne tilgang håndterer automatisk retries og 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)Installer pakken via pip. Du kan derefter kalde chat-completions-endpointet præcis som du ville med OpenAI. Response-objektet giver dig adgang til token-forbrug og finish-årsager.
Node.js-klientopsætning
JavaScript-udviklere kan bruge openai Node-pakke. Konfigurer klienten med vores specifikke base-URL. Dette sikrer, at alle anmodninger routes gennem vores uncensurerede servere.
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);Kør dette uddrag i dit Node-miljø. Det demonstrerer et simpelt synchront opkald. Du kan nemt integrere dette i Express-ruter eller serverless-funktioner.
Streaming-svar
Aktivér streaming ved at indstille stream: true. Serveren sender Server-Sent Events (SSE) indeholdende delvise tokens. Dette reducerer den opfattede latens for slutbrugere.
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)Parser hver chunk, når den ankommer. Den sidste chunk indeholder den samlede tokenforbrug for anmodningen. Dette er nyttigt til at bygge chatgrænseflader, der skriver svar ud i realtid.
Begrænsninger, fejl og kontekst
Kontekstvinduet er 100.000 tokens for prompt og completion tilsammen. Du kan anmode om op til 16.000 outputtokens. Fejl som 401 indikerer en ugyldig nøgle, mens 402 betyder utilstrækkelig kredit. Rate limits begrænser dig til 300 anmodninger i minuttet. Anmodninger, der overstiger 8 MB i størrelse, afvises. Fejl under processering forbruger ikke din kredit.