NL ▾
API-sleutel aanvragen

GLM API-integratiegids voor bots en backends

Een GLM API-integratie komt neer op waar de sleutel leeft, hoeveel verzoeken je tegelijk laat lopen en wat er gebeurt als de API om wachten vraagt. Deze gids behandelt die keuzes voor backends, bots en workflowtools, met code die je kunt aanpassen.

Bijgewerkt

Gateway-kubus die items ontvangt van app-, chat- en automatiseringsblokken, die API-integratie voorstelt

Belangrijkste punten

  • Houd de sleutel op een server die je beheert en laat apps je backend aanroepen, nooit de API direct vanuit een browser.
  • Beperk het aantal lopende verzoeken aan de limiet van de sleutel: 8 voor een volledige sleutel, 2 voor een proefsleutel.
  • Plan het budget op basis van tokens: bij $0,15 en $0,50 per 1M kost een typisch botbericht een fractie van een cent.
  • Elke tool met een OpenAI-compatibele optie en een veld voor een aangepaste base URL kan https://api.glmapikey.com/v1 gebruiken.

Kies eerst het integratiepatroon

De meeste GLM API-integraties vallen onder een van vier vormen, en de keuze beïnvloedt alles: waar geheimen leven, hoe je pieken afhandelt en hoe een fout er voor de gebruiker uitziet.

PatroonGeschikt voorHoofdrisico
Backend proxyWebapps en mobiele apps met eigen gebruikersOpen endpoint dat iedereen kan leegtrekken
Queue workerBots, batchtaken, bulktekstverwerkingWachtrij als verzoeken de limieten overtreffen
ChatbotDiscord-, Telegram- of Matrixpersonages en -gezellenLange geschiedenissen die de kosten opjagen
AutomatiseringstoolWorkflows in tools die een HTTP- of OpenAI-node biedenStille fouten als een stap faalt

Alle vier gebruiken dezelfde aanroep onderliggend: POST /v1/chat/completions op https://api.glmapikey.com/v1 met een bearer key en het model uncensored. De API is OpenAI-compatibel, dus je kunt elke OpenAI SDK gebruiken, of raw HTTP als je stack geen SDK heeft. Het is één open-weight model dat wordt beheerd door een onafhankelijke provider, niet de officiële API van een leverancier en geen router, dus bouw voor het gedrag van één model. Alleen tekst: als je product ook afbeeldingen of embeddings nodig heeft, plan dan een tweede provider voor die onderdelen.

De documentatiepagina geeft endpoints en headers weer, en het GLM-sleutelartikel legt uit hoe je een sleutel verkrijgt.

Backend proxy: houd de sleutel buiten de client

Alles wat in een browser of een app-bundel draait, kan worden geïnspecteerd. Als de sleutel daar wordt meegeleverd, kan iedereen hem kopiëren en je tegoed uitgeven. De oplossing is een dunne serverroute die de sleutel vasthoudt, je eigen regels toepast en het verzoek doorstuurt.

from fastapi import FastAPI
from fastapi.responses import StreamingResponse
from openai import AsyncOpenAI
from pydantic import BaseModel

app = FastAPI()
client = AsyncOpenAI(
    base_url="https://api.glmapikey.com/v1",
    api_key="YOUR_KEY",
)

class Ask(BaseModel):
    prompt: str

@app.post("/ask")
async def ask(body: Ask):
    async def gen():
        stream = await client.chat.completions.create(
            model="uncensored",
            messages=[{"role": "user", "content": body.prompt[:4000]}],
            max_tokens=600,
            stream=True,
        )
        async for chunk in stream:
            if chunk.choices and chunk.choices[0].delta.content:
                yield chunk.choices[0].delta.content
    return StreamingResponse(gen(), media_type="text/plain")

De route knipt de prompt af en begrenst het antwoord, wat het minimum is. Voeg echte controles toe voor de lancering: gebruikersauthenticatie, een dagelijks tokenbudget per gebruiker en een limiet voor het verzoektempo per IP of account. De API retourneert het verbruik bij elke aanroep, dus je kunt tokens per gebruiker in je database tellen en verzoeken weigeren die hun aandeel overschrijden.

Streaming via een proxy vereist één controle: bevestig dat je reverse proxy antwoorden niet buffert, anders komt de tekst in één blok aan het einde in plaats van woord voor woord.

Queue worker: respecteer de limiet voor gelijktijdige verzoeken

De limieten zijn per sleutel. Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe. Een proefsleutel staat 2 en 60 toe. Voor een gestage stroom van taken is de limiet voor gelijktijdige verzoeken vaak de beperkende factor, omdat elk verzoek een plaats bezet tot het voltooid is, en een gestreamd verzoek tot de stream eindigt.

Een worker pool die is afgestemd op de limiet is de schone oplossing. Taken wachten in je wachtrij in plaats van te falen met 429:

import asyncio
from openai import AsyncOpenAI, RateLimitError

client = AsyncOpenAI(
    base_url="https://api.glmapikey.com/v1",
    api_key="YOUR_KEY",
    max_retries=0,
)
WORKERS = 8  # use 2 on a trial key

async def run_job(prompt: str) -> str:
    for attempt in range(5):
        try:
            r = await client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
                max_tokens=500,
            )
            return r.choices[0].message.content
        except RateLimitError as e:
            delay = float(e.response.headers.get("retry-after", 2 * (attempt + 1)))
            await asyncio.sleep(delay)
    raise RuntimeError("gave up after repeated 429 responses")

async def worker(queue: asyncio.Queue, results: list):
    while True:
        prompt = await queue.get()
        try:
            results.append(await run_job(prompt))
        finally:
            queue.task_done()

async def main(prompts):
    queue, results = asyncio.Queue(), []
    for p in prompts:
        queue.put_nowait(p)
    tasks = [asyncio.create_task(worker(queue, results)) for _ in range(WORKERS)]
    await queue.join()
    for t in tasks:
        t.cancel()
    return results

De foutcode in de 429-body vertelt je waarom je werd gestopt: rate_limited voor verzoeken per minuut, concurrency voor te veel tegelijk, en een gewone 429 met Retry-After: 5 voor een korte overbelasting. De header respecteren is eenvoudiger dan een vertraging raden. Mislukte en geweigerde verzoeken worden niet in rekening gebracht, dus de herhaalde pogingen kosten niets.

Bots en personages

Een chatbot is de gebruikelijke plek waar kostenverrassingen optreden, omdat een bot die geschiedenis bewaart, deze bij elk bericht opnieuw verstuurt. Beslis vroeg hoeveel berichten van geschiedenis je wilt bewaren en sla de geschiedenis zelf op, aangezien de API geen status bewaart tussen aanroepen.

Een budgetvoorbeeld maakt het punt duidelijk. Stel een bot heeft 500 actieve gebruikers die elk 20 berichten per dag sturen. Elk bericht bevat 1.500 input tokens (persona, een korte geschiedenis en de nieuwe regel) en retourneert 250 tokens:

  • Per bericht: 1.500 / 1.000.000 x $0,15 = $0,000225 in, plus 250 / 1.000.000 x $0,50 = $0,000125 out, dus $0,00035
  • Per dag: 500 x 20 = 10.000 berichten, dus $3,50
  • Per 30 dagen: $105

Als je de geschiedenis laat groeien tot een contextvenster van 12.000 tokens, stijgt de invoer per bericht met een factor acht naar 12.000 tokens, of $0,0018 alleen al voor de invoer, en het maandbedrag klimt dienovereenkomstig. Een rolling window plus een korte samenvatting van eerdere gebeurtenissen houdt de persona consistent tegen een lagere prijs.

Voor companion- en roleplaybots, houd de productregels in je eigen laag. Het model is afgestemd om zonder inhoudelijke weigeringen te antwoorden voor legaal gebruik door volwassenen, en de enige harde limiet is seksuele inhoud met minderjarigen, wat de dienst weigert. Als je bot in een openbare server werkt, voeg dan leeftijdscontrole en kanaalregels toe die passen bij het platform waarop je hem draait.

Automatiseringstools en no-code workflows

Workflowtools die een OpenAI-achtige node bieden met een configureerbare base URL kunnen deze API gebruiken door drie velden te wijzigen: de URL naar https://api.glmapikey.com/v1, de sleutel en de modelnaam naar uncensored. Tools die alleen een generiek HTTP-verzoek-node hebben, kunnen het ruwe verzoek zelf versturen:

curl https://api.glmapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Classify this ticket: printer offline"}], "response_format": {"type": "json_object"}}'

Voor workflowstappen die een andere stap voeden, is JSON-modus de moeite waard, zodat de volgende node parseerbare tekst ontvangt. Voeg een error-tak toe voor elke stap die de API aanroept, omdat 429- en 5xx-antwoorden af en toe zullen gebeuren en een stille fout in het midden van een workflow later moeilijk te vinden is. Stel een retry in met een korte wachttijd op die node en zorg ervoor dat parallelle takken het aantal gelijktijdige verzoeken dat je sleutel toestaat, niet overschrijden.

Wat je gebruikers zien als er iets misgaat

Elke integratie heeft een plan nodig voor het ongelukkige pad, en het gebruikersgerichte deel is net zo belangrijk als de retry-code. Drie situaties doen zich in de praktijk voor.

De eerste is een korte overbelasting: een 429 met Retry-After: 5. Probeer stilletjes opnieuw, en toon een typ-indicator ondertussen, zodat de gebruiker een iets langzamer antwoord ziet in plaats van een fout. De tweede is je eigen pool-limiet bereiken. Als alle acht slots bezet zijn, zet het bericht in de wachtrij en vertel de gebruiker dat het wacht, wat beter is dan een leeg scherm. De derde is op raken van tegoed, wat geen retry oplost. Houd de balansheader in de gaten, waarschuw jezelf bij een drempelwaarde en houd een vervangbericht klaar voor de dag dat het onopgemerkt op raakt.

Toon geen ruwe API-fouten aan eindgebruikers. Log ze met de request ID en toon een eenvoudige zin die vertelt wat er gebeurde en wat de volgende stap is. Neem nooit de sleutel, de base URL of stacktraces op in iets dat een gebruiker kan lezen.

Geld, monitoring en lanceercontroles

Facturatie is prepaid. Je laadt een willekeurig bedrag van $20 tot $500 op, met +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Credit vervalt niet, en er is geen abonnement. Betaal met crypto (USDT op TRC20, USDC op Base). Nieuwe gebruikers kunnen $0,50 aan prepaid tegoed claimen met één klik op de API-sleutelpagina, geldig voor 7 dagen, zodat je een integratie kunt testen voordat je tegoed opwaardeert. Zie de prijzenpagina voor de tarieven.

Wat te monitoren in productie:

  • Saldo. Lees X-Balance-USD uit responsen en geef een waarschuwing wanneer het onder een door jou gekozen drempelwaarde daalt.
  • Request-IDs. Sla X-Request-Id op bij elke taak, zodat je een fout kunt traceren.
  • Tokenverbruik. Tel usage per gebruiker en per functie om te zien waar het geld naartoe gaat.
  • 429-rate. Een stijgend aantal betekent dat je pool groter is dan de limieten van de sleutel.

Een korte startlijst: voer één echt verzoek uit vanaf de productiemachine, test een geforceerde 429 in staging, bevestig dat een gebruiker de API niet kan bereiken zonder jouw authenticatie, en noteer wat je service toont als de API onbereikbaar is. Prompts worden niet gebruikt voor training, wat je aan je eigen gebruikers kunt doorgeven, maar vermeld in je eigen privacybeleid dat hun tekst wordt verstuurd naar een externe provider om antwoorden te genereren.

Vragen en antwoorden

Moet ik de API vanuit de browser aanroepen?

Nee. Houd de sleutel op je server en laat de browser je backend aanroepen, omdat een sleutel in clientcode gekopieerd kan worden en het tegoed door iedereen kan worden uitgegeven.

Hoeveel verzoeken kunnen tegelijk lopen?

Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 per minuut toe. Een proefsleutel staat 2 gelijktijdige en 60 per minuut toe.

Wat moet mijn code doen bij een 429?

Lees de foutcode en wacht daarna. Gebruik de Retry-After-waarde als die aanwezig is, wat 5 seconden is bij een tijdelijke overbelasting, en probeer het opnieuw. Mislukte verzoeken worden niet in rekening gebracht.

Wordt de status bewaard tussen verzoeken?

Nee. Je stuurt elke keer het hele gesprek, tot 100.000 tokens voor prompt en antwoord samen, en je betaalt voor de invoertokens bij elke aanroep.

Kan ik het gebruiken vanuit no-code tools?

Ja, als het hulpmiddel je toelaat een basis-URL in te stellen op zijn OpenAI-node of een aangepast HTTP-verzoek te sturen naar https://api.glmapikey.com/v1/chat/completions met een Bearer-sleutel.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel aanvragen