Authenticatie
Authenticatie verloopt via een enkele API-sleutel. Je kunt je aanmelden met Google of een e-mailwachtwoord op de API-sleutel ophalen-pagina. De sleutel wordt direct weergegeven en is gekoppeld aan je prepaid tegoed. In tegenstelling tot grote leveranciers zijn er geen maandelijkse abonnementen of creditcards nodig voor de proefversie. Gebruik de header Authorization: Bearer YOUR_API_KEY voor alle verzoeken. Je sleutel is de enige actieve referentie per account; het genereren van een nieuwe sleutel maakt de vorige ongeldig.
Basis voltooiing
Stuur een standaard chat-completion-verzoek naar de OpenAI-compatibele endpoint. De modelidentifier is uncensored. Dit model is open-weight en afgestemd op antwoorden zonder inhoudsweigeringen voor wettelijk volwassen gebruik. Het is geen GPT, Claude of een ander model van een andere leverancier. De basis-URL voor deze service staat hieronder.
curl https://api.ornith.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Vervang YOUR_API_KEY door je sleutel uit het dashboard. De respons bevat de gegenereerde tekst in choices[0].message.content. Fouten zoals 401 duiden op een ongeldige sleutel, terwijl 402 betekent dat je prepaid tegoed op is.
Python SDK
Gebruik de officiële openai Python-pakket. Wijs het naar de Ornith-basis-URL en geef je API-sleutel op. Dit zorgt voor compatibiliteit met de standaard OpenAI-clientstructuur. Je kunt berichten doorgeven als een lijst met dictionaries met role en content. De client verwerkt de HTTP-verzoeken automatisch. Deze aanpak werkt voor zowel eenvoudige tekstgeneratie als complexere interacties met behulp van tools of JSON-modus.
from openai import OpenAI
client = OpenAI(base_url="https://api.ornith.top/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)Het responsobject spiegelt de standaard OpenAI-structuur. Je kunt de gegenereerde tekst direct uit het responsobject ophalen. Deze methode is ideaal voor backend-services of scripts waar je programmatische toegang nodig hebt tot de uitvoer van het model.
Node SDK
Installeer het openai npm-pakket. Initialiseer de client met de Ornith-basis-URL en je API-sleutel. De structuur van het verzoek is identiek aan de Python SDK. Gebruik de chat.completions.create-methode. Dit is geschikt voor JavaScript-omgevingen, of je nu een webbackend of een CLI-tool bouwt. De client verwerkt de serialisatie en deserialisatie van de respons.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ornith.top/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);Verwerk fouten op de juiste manier. Netwerkfouten of API-fouten veroorzaken uitzonderingen. Controleer de statuscode om onderscheid te maken tussen authenticatiefouten, rate limits of serverfouten. De respons bevat de voltooiingsdetails in hetzelfde formaat als de Python SDK.
Streaming-antwoorden
Schakel streaming in door stream: true in je verzoek in te stellen. Dit retourneert een stream van tokens terwijl ze worden gegenereerd. Gebruik dit voor realtime UI-updates of progressieve tekstweergave. De stream eindigt met een laatste chunk die het totale tokengebruik bevat. Hiermee kun je kosten in realtime bijhouden zonder te wachten op de volledige respons. Dit is efficiënt voor lange contexten waarbij je voortgang wilt tonen.
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)Itereer over de stream om elke chunk te verwerken. De laatste chunk bevat het veld usage. Dit is nuttig voor transparantie in facturatie. Zorg ervoor dat je client de stream correct verwerkt om geheugenproblemen bij grote responsen te voorkomen.
Limieten, fouten & context
Het contextvenster is 100.000 tokens voor prompt en completion samen. De maximale uitvoer per verzoek is 32.000 tokens (2.048 als max_tokens niet is ingesteld). Je bent beperkt tot 300 verzoeken per minuut en 8 gelijktijdige verzoeken per sleutel. Verzoeklichamen moeten kleiner zijn dan 8 MB. Als je de rate limit overschrijdt, ontvang je een 429-fout. Weigeringen voor inhoud met betrekking tot minderjarigen zijn hard-coded en gelden altijd. Fouten verbruiken geen tegoed. Het tegoed is prepaid en verloopt nooit.
