Codex API-sleutel uitgelegd voor ontwikkelaars

De API-sleutelindeling begrijpen

Wanneer je je aanmeldt bij een service die een codex api key biedt, ontvang je een unieke alfanumerieke string. Deze sleutel fungeert als je authenticatie-credential voor elk verzoek dat naar de backend wordt gestuurd. De indeling volgt doorgaans een standaardpatroon, zoals sk-... of vergelijkbare prefixes, afhankelijk van de implementatie van de provider. Omdat je echter een onafhankelijke proxy gebruikt, kan de exacte prefix variëren. De cruciale factor is niet het formaat zelf, maar ervoor zorgen dat de sleutel correct wordt doorgegeven in de HTTP Authorization-header als Bearer <your_key>.

Je API-sleutel is gekoppeld aan een specifiek account en gebruiksniveau. In tegenstelling tot sommige diensten die meerdere sleutels genereren voor verschillende omgevingen (dev vs. prod), is onze opzet eenvoudig: één account, één sleutel. Als je je sleutel kwijtraakt of vermoedt dat deze is gecompromitteerd, kun je deze onmiddellijk opnieuw genereren via je dashboard. Hierdoor wordt de oude sleutel direct ingetrokken, zodat er geen ongeautoriseerde toegang meer mogelijk is. Vergeet niet je omgevingsvariabelen of configuratiebestanden bij te werken telkens wanneer je sleutels draait.

Beste praktijken voor beveiliging

• Sla je sleutel op in omgevingsvariabelen, niet in je broncode.
• Commit je codex api key nooit aan openbare repositories.
• Gebruik de functie om te regenereren als je blootstelling vermoedt.

Veelvoorkomende fout: 401 Unauthorized

Een 401 Unauthorized-fout is het meest voorkomende probleem bij het integreren van een nieuwe API-sleutel. Het geeft aan dat de server je authenticatie-credentials heeft afgewezen. In de context van een claude code proxy of elk OpenAI-compatible endpoint betekent dit bijna altijd dat de sleutel ontbreekt, onjuist is of verlopen is.

Om dit op te lossen, controleer eerst of je de sleutel exact zoals verstrekt kopieert. Sleutels zijn vaak case-sensitive en kunnen spaties bevatten als ze onjuist worden gekopieerd. Zorg ervoor dat je de juiste base URL gebruikt voor je regio of service tier. Als je onlangs je sleutel hebt geregeneerd, zorg er dan voor dat je client de nieuwe waarde gebruikt. Een 401-fout heeft niets te maken met je usage balance of rate limits; het is puur een authenticatiefout.

Checklist voor oplossing

1. Bevestig dat de API-sleutel string exact overeenkomt met die in het dashboard.
2. Verifieer het Authorization header formaat: Authorization: Bearer YOUR_KEY.
3. Controleer of de base URL correct is voor je accounttype.
4. Zorg dat er geen extra spaties zijn toegevoegd tijdens het kopieer-plakken.

Rate limit overschreden: 429-fouten

Wanneer je je toegestane verzoekvolume overschrijdt, retourneert de API een 429 Too Many Requests fout. Voor onze service is de limiet ingesteld op 300 verzoeken per minuut per sleutel. Deze limiet wordt afgedwongen om eerlijk gebruik te waarborgen en lage latency voor alle gebruikers te behouden. Als je high-volume coding sessies uitvoert, kun je deze limiet snel bereiken, vooral als je code meerdere interne verzoeken triggerd.

Wanneer een 429-fout optreedt, bevat de response meestal een Retry-After header die aangeeft hoeveel seconden je moet wachten voordat je opnieuw probeert. Het implementeren van exponential backoff in je client code is de standaard manier om deze fouten gracieus af te handelen. In plaats van direct opnieuw te proberen, wacht een korte periode en verdubbel vervolgens de wachttijd voor volgende pogingen. Dit voorkomt dat je applicatie de server overbelast met verzoeken terwijl de limiet wordt gereset.

Het is belangrijk op te merken dat rate limits per sleutel zijn, niet per account. Als je meerdere apparaten of processen hebt die dezelfde sleutel gebruiken, delen ze het budget van 300 verzoeken/minuut. Overweeg aparte sleutels te gebruiken voor verschillende omgevingen als je een hogere aggregate throughput nodig hebt.

Base URL correct configureren

De base URL is de basis van elke API-integratie. Voor een OpenAI-compatible service bepaalt de base URL waar je verzoeken naartoe worden gestuurd. Onze base URL is https://api.claudecodeapikey.com/v1. Deze URL moet worden geconfigureerd in je client library of SDK voordat je verzoeken doet. Als je de verkeerde base URL gebruikt, ontvang je verbindingsfouten of onverwachte responses.

Veel ontwikkelaars gebruiken de officiële OpenAI SDK voor Python, Node.js of andere talen. Om over te schakelen naar onze proxy, pas je simpelweg de base URL-configuratie aan. In Python stel je bijvoorbeeld base_url='https://api.claudecodeapikey.com/v1' in. Zorg ervoor dat het protocol (https) en het pad (/v1) correct zijn. Het weglaten van het /v1 pad is een veelgemaakte fout die leidt tot 404-fouten.

Controleer altijd of je client verzoeken naar het juiste endpoint stuurt. Je kunt dit doen door je network logs te controleren of een tool zoals curl te gebruiken om de verbinding te testen. Een succesvolle verbinding met de base URL bevestigt dat je configuratie correct is.

Streaming-responses afhandelen

Streaming-responses stellen je in staat om delen van de API-response te ontvangen terwijl ze worden gegenereerd, in plaats van te wachten tot de volledige response klaar is. Dit is cruciaal voor coding agents die code snippets in real-time weergeven. Onze API ondersteunt streaming via Server-Sent Events (SSE). Wanneer je streaming inschakelt in je client, ontvang je een stream van chunks, elk met een gedeeltelijke response.

Om streaming in te schakelen, stel je de stream parameter in op true in je verzoek. De client library behandelt het SSE-protocol dan automatisch. Je kunt elke chunk verwerken zodra deze aankomt, je UI bijwerken of de voortgang loggen. Dit biedt een betere user experience, vooral bij lange code generaties.

Streaming verandert het onderliggende model of de mogelijkheden ervan niet. Het is puur een transportmechanisme. Het model verwerkt nog steeds de volledige prompt en genereert het volledige antwoord; het verschil zit hem in hoe de output aan je client wordt geleverd.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.claudecodeapikey.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)

Problemen met tool calling-configuratie

Tool calling (of function calling) stelt de LLM in staat om specifieke acties aan te vragen, zoals het uitvoeren van een codesnippet of het opvragen van een database. Onze API ondersteunt tool calling, wat betekent dat je functies kunt definiëren in je verzoek en gestructureerde JSON-antwoorden van het model kunt ontvangen. Dit is essentieel voor geavanceerde coding agents die met externe systemen moeten interageren.

Om tool calling te configureren, moet je een lijst met functiedefinities opgeven in de parameter tools. Elke tool moet een naam, beschrijving en parameterschema hebben. Het model beslist vervolgens wanneer het een tool moet aanroepen op basis van de prompt. Als het model besluit een tool aan te roepen, bevat de response een tool_calls-array met de functienaam en argumenten.

Veelvoorkomende problemen ontstaan door onjuiste JSON schema definities. Zorg ervoor dat je parameter types en required fields nauwkeurig zijn gespecificeerd. Als het schema ongeldig is, kan het model de tool mogelijk niet correct aanroepen. Test je tool definitions met eenvoudige prompts om te verifiëren dat het model het verwachte gedrag begrijpt.

Contextvensterlimieten

Het contextvenster definieert de maximale hoeveelheid tekst die het model in één verzoek kan verwerken, inclusief zowel de prompt (input) als de completion (output). Ons model heeft een contextvenster van 100.000 tokens. Dit is een aanzienlijke hoeveelheid tekst, maar het is niet oneindig. Als je prompt plus de verwachte output deze limiet overschrijdt, retourneert de API een fout.

Om context efficiënt te beheren, monitor je token usage van je prompts. Lange bestanden of uitgebreide conversation histories kunnen snel de beschikbare tokens verbruiken. Als je de limiet nadert, overweeg dan oudere berichten in te korten of eerdere interacties samen te vatten. Sommige clients handelen dit automatisch af door het venster te verschuiven, maar het is het beste om je bewust te zijn van de limiet om onverwachte fouten te vermijden.

Onthoud dat het contextvenster alle tokens omvat die naar het model worden gestuurd, inclusief system messages, user messages en assistant messages. Plan je token budget dienovereenkomstig om een vlotte werking te garanderen tijdens lange coding sessies.

Je sleutel regenereren

Het opnieuw genereren van je API-sleutel is een eenvoudig proces dat de veiligheid waarborgt. Als je vermoedt dat je sleutel is gelekt of je wilt je referenties periodiek vernieuwen, kun je een nieuwe sleutel genereren via je dashboard. De oude sleutel wordt onmiddellijk ongeldig gemaakt, dus lopende verzoeken met de oude sleutel zullen falen.

Als je een sleutel opnieuw genereert, zorg er dan voor dat je alle clients en configuraties bijwerkt met de nieuwe waarde. Dit omvat omgevingsvariabelen, configuratiebestanden en alle hard gecodeerde waarden in je code. Als je niet alle locaties bijwerkt, kunnen er authenticatiefouten optreden voor onderdelen van je applicatie.

Onze dienst staat ongelimiteerd sleutelvernieuwingen toe. Er zijn geen kosten verbonden aan het vaak vernieuwen van je sleutel. Dit is een goede praktijk voor het behouden van veiligheid, vooral in gedeelde omgevingen of wanneer je sleutels verdeelt onder teamleden.

Copycurl https://api.claudecodeapikey.com/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."}]
  }'