Integratiegids voor ontwikkelaars

Authenticatie en basis-URL-instelling

Genereer eerst uw API-sleutel op het dashboard. De basis-URL is HTTPS://api.apiaicheap.com/v1. Stuur uw sleutel in de Authorization-header als bearer-token.

• Klik op "API-sleutel ophalen" en log in met Google of e-mail.
• Kopieer de sleutel direct; deze wordt maar één keer getoond.

Deze sleutel verifieert alle verzoeken aan het chat-completions-eindpunt.

Voorbeeldkoptekst

Autorisatie: Bearer YOUR_API_KEY

Eerste verzoek met cURL

Stuur een basis chat-completie om je setup te testen. Gebruik het POST /v1/chat/completies-eindpunt met het model "uncensored".

Dit bevestigt je kredietbalance en latentie.

• Stel de role in op "user".
• Houd het bericht eenvoudig voor de eerste test.

Controleer de response op een veld met gegenereerde tekst.

• Zoek naar de waarde "content".

Als je een 200 OK krijgt, werkt je integratie.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Python SDK integratie

Gebruik de officiële OpenAI Python-bibliotheek voor eenvoudige integratie. Wijs deze naar onze basis-URL en stel je API-sleutel in.

Deze aanpak behandelt retries en JSON-parsing automatisch.

• Installeer de bibliotheek via pip.
• Stel de base_url-parameter in op ons eindpunt.

Roep de methode chat.completions.create aan.

Voer uw berichtenlijst in als argument.

• Voeg de modelnaam "uncensored" toe.

Toegang tot de respons tekst via de attributen van het object.

Deze methode is schoon en leesbaar voor productiescripts.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apiaicheap.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 SDK-instelling

De Node.js SDK werkt vergelijkbaar met de Python-versie. Initialiseer de client met je sleutel en onze basis-URL.

Dit stelt je in staat om vertrouwde async/await patronen te gebruiken.

• Importeer het OpenAI-pakket.
• Configureer de basis-URL in de constructor.

Maak een completion-verzoek aan met je berichten.

Verwerk de belofte om het resultaat te krijgen.

• Haal de berichtinhoud op uit het antwoord.

Log de uitvoer om te verifiëren dat het model correct reageert.

Deze opstelling is ideaal voor web servers en backend-diensten.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiaicheap.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);

Streamingresponsen met SSE

Schakel streamen in door stream in te stellen op true in uw verzoek. De API retourneert chunks zodra deze worden gegenereerd via Server-Sent Events.

Dit vermindert de waargenomen latentie voor gebruikers in chat-apps.

• Stel stream: true in in het payload.
• Verwerk elke chunk zoals deze aankomt.

Combineer de chunks tot de definitieve respons.

Tokenverbruiksgegevens verschijnen in de laatste chunk.

• Controleer het "usage"-veld in de laatste chunk.

Deze aanpak houdt de gebruikersinterface responsief tijdens lange generaties.

Copystream = 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)

Limieten, fouten en contextvenster

Je account heeft een limiet van 300 verzoeken per minuut per sleutel. Het contextvenster ondersteunt 100.000 tokens in totaal voor prompt en completion.

Fouten worden afgehandeld met standaard HTTP-statuscodes.

• 401 geeft een ongeldige of ontbrekende API-sleutel aan.
• 402 betekent dat je vooruitbetaalde tegoed op is.
• 429 signaleert dat je de limiet hebt overschreden.

Weigeringen kosten geen tegoed. Fouten zijn ook gratis.

Max output is 16.000 tokens per verzoek. Stel max_tokens in als je minder nodig hebt.

Deze structuur zorgt voor voorspelbare facturering en prestaties.