Handleidingen

Snelstart

Roep RunAPI-taalmodellen aan via een ondersteund synchroon of streaming protocol.

RunAPI stelt taalmodellen beschikbaar via vertrouwde openbare protocolvormen. Wijs een bestaande compatibele client naar https://runapi.ai, gebruik een RunAPI-modelidentificator en authenticeer met een standaard API-sleutel.

Een protocol kiezen

OpenAI-compatibele Chat Completions gebruikt POST /v1/chat/completions.
OpenAI-compatibele Responses gebruikt POST /v1/responses.
Anthropic-compatibele Messages gebruikt POST /v1/messages.
Gemini-compatibele inhoudsgeneratie gebruikt /v1beta/models/{model}:generateContent of :streamGenerateContent.

Kies het protocol dat het beste past bij uw bestaande client en applicatiestroom. De modelcatalogus geeft aan welke publieke protocollen elk model ondersteunt.

Een verzoek sturen

Dit Chat Completions-verzoek retourneert één synchroon antwoord:

SHELL

curl "https://runapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "Summarize why idempotency matters."}]
  }'

Houd de aanvraag en het antwoord in de geselecteerde protocolindeling. Gebruik de API-referentie van de bewerking voor exacte velden, tool-aanroepen, gestructureerde uitvoer en modelspecifieke beperkingen.

Uitvoer streamen

Stel de streamingoptie van het protocol in en verwerk de geretourneerde server-sent events incrementeel. Voeg voor Chat Completions "stream": true toe; gebruik voor Gemini-compatibele aanroepen de bewerking :streamGenerateContent. Sluit de stream wanneer uw client het terminale event van het protocol ontvangt.

Leveringsgetrouwheid inspecteren

Elke geaccepteerde LLM-respons bevat X-RunAPI-Fidelity. Een waarde van full betekent dat het verzoek zonder weglating is afgeleverd. Een waarde van lossy betekent dat RunAPI optionele besturingselementen heeft weggelaten om het verzoek te voltooien; X-RunAPI-Omitted-Fields bevat de kommagescheiden veldnamen. Verzoeken waarvan de vereiste levenscyclus-, voortzettings-, tool- of getypeerde-itemsemantiek niet behouden kan worden, worden afgewezen voordat een taak wordt aangemaakt.

Beide headers zijn beschikbaar via CORS, zodat browsercliënten ze kunnen inspecteren. Log ze samen met de verzoekidentifier wanneer het exacte afleveringsgedrag relevant is voor de applicatie.

Fouten en gebruik afhandelen

Behandel 401 als een authenticatiefout, 4xx-antwoorden als verzoek- of beleidsproblemen, en probeer alleen tijdelijke server- of netwerkfouten opnieuw. Lees het tokengebruik uit het uiteindelijke antwoord of het eindstreaminggebeurtenis in de geselecteerde protocolindeling, en bewaar verzoekidentificatoren in applicatielogboeken voor ondersteuning.