Startpagina/Agents
OpenAI-compatibele API-tester: controleer elk endpoint

Je hebt geen speciale openai-compatibele api-tester nodig om een endpoint te controleren. Vier verzoeken en een kort Python-script vertellen je of een base URL zich echt gedraagt als de OpenAI API.
Bijgewerkt
Belangrijkste punten
- Begin met GET /v1/models, gevolgd door een minimale chatvoltooiing.
- Test streaming en lees het verbruik aan het einde van de stream.
- Stuur opzettelijk slechte verzoeken om te zien hoe fouten eruitzien.
- Eén script kan alle checks uitvoeren en pass of fail afdrukken.
De vier checks die er toe doen
Veel diensten zeggen dat ze OpenAI-compatibel zijn. Sommigen kopiëren alleen de chat route, anderen wijzigen het foutformaat, weer anderen laten streaming details weg. Een tester moet bevestigen wat je client code nodig heeft:
- Authenticatie en ontdekking:
GET /v1/modelsmet een Bearer-sleutel. - Een minimale chatcompletie:
POST /v1/chat/completions. - Streaming: dezelfde aanroep met
stream: true. - Fouten: wat terugkomt voor een ongeldige sleutel, een verkeerde modelnaam en een slecht gevormde requestbody.
De onderstaande voorbeelden gebruiken het endpoint van deze site, https://api.uncensoredapis.com/v1, en het model uncensored. Vervang de basis-URL en het model door degene van wat je test. Als je nog geen sleutel hebt, maak er hier een aan; nieuwe accounts kunnen een proeftegoed van $0,50 claimen zonder kaart.
Check 1: lijst de modellen op met curl
export API_KEY="sk-your-key"
curl -s -w "\nHTTP %{http_code}\n" \
https://api.uncensoredapis.com/v1/models \
-H "Authorization: Bearer $API_KEY"
Verwacht HTTP 200 en een JSON-object met een data-array. Elk item heeft een id. Hier is het ID dat je overal zult gebruiken uncensored. Deze ene aanroep controleert DNS, TLS, de padvoorvoegsel en de sleutel, dus als dit faalt is het geen punt om iets anders te testen. De gebruikelijke oorzaken zijn een ontbrekende /v1 in de basis-URL, een extra trailing slash, of een sleutel die met een regeleinde is geplakt.
Check 2: één minimaal chatverzoek
curl -s https://api.uncensoredapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ok."}]}'
Controleer in het antwoord choices[0].message.content, finish_reason en het usage-object met prompt- en completion-tokenaantallen. Gebruik ook de headers: voeg -i toe en zoek naar X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests en X-RateLimit-Limit-Concurrency. Ze zijn handig voor loggen en voor kostenopsporing later. Dezelfde service accepteert ook POST /v1/responses, wat de API-referentie uitleg behandelt.
Check 3: een Python-script dat alles test
Curl is prima voor een eerste blik, maar een script dat je na elke wijziging opnieuw kunt uitvoeren is beter. Deze gebruikt het officiële openai-pakket en rapporteert elke check.
import sys
from openai import OpenAI, AuthenticationError, NotFoundError, RateLimitError
BASE = "https://api.uncensoredapis.com/v1"
MODEL = "uncensored"
client = OpenAI(base_url=BASE, api_key=sys.argv[1])
def check(name, fn):
try:
print("PASS", name, "-", fn())
except Exception as e:
print("FAIL", name, "-", type(e).__name__, e)
def models():
ids = [m.id for m in client.models.list().data]
assert MODEL in ids, ids
return ids
def chat():
r = client.chat.completions.create(
model=MODEL, messages=[{"role": "user", "content": "Say ok."}])
assert r.choices[0].message.content
return r.usage.total_tokens
def stream():
parts, usage = [], None
for c in client.chat.completions.create(
model=MODEL, stream=True,
messages=[{"role": "user", "content": "Count to five."}]):
if c.choices and c.choices[0].delta.content:
parts.append(c.choices[0].delta.content)
usage = getattr(c, "usage", None) or usage
assert parts
return f"{len(parts)} chunks, usage={usage}"
def bad_model():
try:
client.chat.completions.create(
model="no-such-model", messages=[{"role": "user", "content": "hi"}])
except NotFoundError as e:
return "NotFoundError " + str(e.status_code)
except Exception as e:
return type(e).__name__
raise AssertionError("bad model name was accepted")
for n, f in [("models", models), ("chat", chat), ("stream", stream), ("bad model", bad_model)]:
check(n, f)
Voer het uit met python tester.py sk-your-key. De check voor een verkeerd model registreert welke foutklasse je SDK gooit, wat op zichzelf nuttige informatie is. Als de service een onbekende modelnaam accepteert, routet of aliasert hij deze waarschijnlijk, en moet je uitzoeken hoe.
Check 4: foutafhandeling
Je applicatie zal fouten zien, dus bekijk ze opzettelijk.
- Ongeldige sleutel: verander één teken in de sleutel. Verwacht HTTP 401 en een JSON-foutlichaam, geen HTML-pagina.
- Slecht gevormd lichaam: stuur
{"model":"uncensored"}zonder berichten. Verwacht een 4xx met een leesbaar bericht. - Rate limits: deze API retourneert 429 met de code
rate_limitedvoor requests per minute enconcurrencyvoor te veel gelijktijdige requests. Een tijdelijke overload retourneert ook 429, metRetry-After: 5.
Een goede client behandelt 429 als een signaal om te wachten en opnieuw te proberen, en 4xx anders dan 429 als een bug om op te lossen. Schrijf de retry-regel één keer en test deze door tien verzoeken tegelijk te lanceren. Limieten per sleuteltype staan op de pagina voor fouten en rate limits.
Compatibiliteitsgaten om op te letten
De vier checks slagen is een goed begin. Dit zijn de plekken waar clones het vaakst verschillen, dus test ze als je app erop leunt:
- Parameters: stuur
temperature,top_p,stop,seeden de straffen. Sommige servers negeren ze stilletjes. Voer dezelfde prompt drie keer uit met een vasteseeden een lage temperatuur en vergelijk de outputs. - Berichtrollen: probeer eerst een
system-bericht, gevolgd door een lange multi-turn-geschiedenis. Controleer of het system-bericht het gedrag daadwerkelijk verandert. - Tool calls: vraag om een aanroep van een functie die je definieert, en stuur het resultaat terug als een
role: "tool"-bericht. In streaming-modus komentool_callsin stukken aan die je moet concateneren. - JSON mode: zet
response_formatop{"type":"json_object"}en parse 20 replies. - Lichaamsgrootte: deze API accepteert lichamen tot 8 MB. Een verzoek boven de limiet moet falen met een duidelijke 4xx, niet hangen.
Schrijf elk gat dat je vindt op en beslis of je code eromheen kan werken. Bewaar de notities naast het script, want de volgende keer dat de provider een update uitbrengt wil je dezelfde checks opnieuw uitvoeren en vergelijken. Als je meerdere providers test, voer dan hetzelfde script uit tegen elk en bewaar de uitvoer in een tabel, zodat de verschillen in één oogopslag zichtbaar zijn in plaats van verstopt in geheugen. Een missende parameter is meestal onschuldig. Een ander foutformaat of gebroken streaming is meestal niet.
Wat slagen voor de tests niet bewijst
Een groene run toont protocolcompatibiliteit. Het zegt niets over antwoordkwaliteit, snelheid onder belasting of prijs. Die vereisen aparte tests op je eigen prompts. Twee snelle toevoegingen zijn het waard: een verzoek met een lange prompt die dicht bij je werkelijke grootte ligt (dit endpoint heeft een contextvenster van 100.000 tokens), en een tool-calling-verzoek als je app agents gebruikt.
Houd ook in gedachten tegen wat je test. Deze service host één open-weight model, getuned om te antwoorden zonder inhoudweigeringen voor wettelijk volwassen gebruik. Het is alleen tekst en is niet de officiële API van enige modelleverancier. Prijzen zijn $0,15 per 1M input tokens en $0,50 per 1M output tokens, vermeld op de prijslijst, en mislukte verzoeken worden niet gefactureerd, dus herhaalde testruns kosten zeer weinig. De docs vermelden elke ondersteunde parameter.
Meer handleidingen
Vragen en antwoorden
Is er een online tool om een OpenAI-compatibel endpoint te testen?
Elke HTTP-client werkt: curl, Postman of een kort script met de OpenAI SDK. Het voordeel van een script is dat je het na elke wijziging opnieuw kunt uitvoeren.
Welke base URL moet ik in de SDK zetten?
Gebruik de volledige URL inclusief /v1, bijvoorbeeld https://api.uncensoredapis.com/v1. Voeg /chat/completions niet toe, omdat de SDK het aan het eind toevoegt.
Waarom krijg ik een 404 op een verzoek dat er juist uitziet?
De meest voorkomende oorzaak is een basis-URL zonder /v1 of met een verdubbelde pad. Controleer dit eerst met een GET naar /v1/models.
Hoe controleer ik mijn resterende saldo tijdens het testen?
Lees de X-Balance-USD koptekst op elke response, of roep GET /v1/balance aan.
Je sleutel is nog maar één formulier verwijderd
Maak een account aan, kopieer de sleutel, pas de basis-URL aan. Dat is de hele configuratie.