Vereisten: SDK-configuratie
Installeer de officiële clientbibliotheek voor uw voorkeurstaal voordat u de verbinding configureert. De bibliotheek verwerkt JSON-serialisatie, retries en streamingprotocollen automatisch.
Voor Python installeer je het pakket via pip. Voor Node.js gebruik je npm of yarn om de afhankelijkheid aan je project toe te voegen.
Zorg ervoor dat je een recente versie van de SDK gebruikt om alle functies zoals function calling en JSON-modus te ondersteunen.
Configuratie: Base URL & Key
Wijs uw SDK-client naar onze specifieke basis-URL en geef de API-sleutel op die u hebt verkregen tijdens het aanmelden.
De basis-URL is HTTPS://api.claudellmapi.com/v1. Dit zorgt ervoor dat alle verzoeken naar onze ongecensureerde modelservers gaan in plaats van de standaard leverancier.
Stel de API-sleutel in als omgevingsvariabele of geef deze direct door aan de clientconstructor. Er zijn geen extra headers vereist.
Uw eerste verzoek verzenden
Stuur een eenvoudig chat-completieverzoek om de verbinding en de responskwaliteit te verifiëren. Gebruik de model-id 'uncensored' om toegang te krijgen tot het onbeperkte model.
De verzoekstructuur komt overeen met de standaard OpenAI-indeling, waardoor het eenvoudig is om bestaande integraties te vervangen.
Verwacht een tekstresponse met het antwoord van het model op uw prompt.
Stream-antwoorden verwerken
Schakel streaming in om tokens te ontvangen zodra ze gegenereerd worden, wat de waargenomen latentie voor lange outputs vermindert.
Stel de stream-parameter in op true in je request. De SDK levert tekstchunks op zodra deze beschikbaar zijn.
Dit is ideaal voor chatinterfaces waar gebruikers onmiddellijke feedback verwachten terwijl het model nog steeds denkt.
Functieaanroep implementeren
Definieer tools in je request om het model gestructureerde data te laten retourneren in plaats van platte tekst.
Specify the function schema and set tool_choice to 'auto' or a specific function name.
Het model reageert met een function call-object dat je in je code kunt uitvoeren. Dit werkt naadloos samen met ons uncensored model.
Fouthantering & Limieten
Verwerk veelvoorkomende HTTP-fouten soepel om een vlotte gebruikerservaring te waarborgen. Een 401-status geeft een ongeldige of ontbrekende API-sleutel aan. Een 402-status betekent dat je vooruitbetaalde tegoed op is. Een 429-status signaleert dat je de snelheidslimiet van 300 requests per minuut hebt overschreden.
Uw contextvenster is 100.000 tokens voor prompt en completion samen. Verzoeken die de 8 MB body-limiet overschrijden, zullen ook falen.
cURL
curl https://api.claudellmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What are the current rate limits for large context windows"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.claudellmapi.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.claudellmapi.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);Streaming
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)