AI Inference

Eén OpenAI-compatibele gateway, betalen naar gebruik.

Open AI Inferencein het huidige project. Dit is een andere API dan de HTTP-API van het platform. Platformsleutels (nodion_…) beheren resources. Inference-sleutels (nodion_ai_…) roepen modellen aan.

Tabbladen

• Keys: maak een sleutel aan. Die wordt één keer getoond. Optioneel een vervaldatum en een dagelijkse uitgavenlimiet. Een sleutel gebruikt het prepaid tegoed of is gekoppeld aan een coding plan; een plansleutel gebruikt het tegoed ook voor modellen buiten het plan en na een volledig benut gebruiksvenster, als het plan dat toestaat. Projectbeheerders beheren alle sleutels; andere leden maken en zien alleen sleutels voor het plan dat aan hen is toegewezen.
• Playground: probeer chat uit (en andere modi als daar modellen voor zijn). Playground-verkeer wordt net als elk ander request gemeten en loopt via het prepaid tegoed. Alleen voor de projecteigenaar en beheerders.
• Models: catalogus en beschikbaarheid.
• Usage en Requests.
• Billing: een prepaid tegoed, los van de maandelijkse platformfactuur. Opwaarderen met kaart of PayPal.
• Coding Plans: optionele prepaid plannen Go / Pro / Max voor 2× chat- en toolgebruik, één plan per ontwikkelaar. De projecteigenaar koopt plannen en wijst elk plan toe aan een projectlid; sleutels die aan een plan gekoppeld zijn, gebruiken dat plan. AI Coding Plans op de website; beheer ze onder AI Inference → Coding Plans.
• Settings: aanbieders toestaan of uitsluiten, een optionele allowlist voor regio's en beleidsschakelaars zoals zero data retention. Zero data retention staat altijd aan voor modellen die Nodion host; de projectschakelaar geldt voor aanbieders waarnaar we requests doorsturen.

De API aanroepen

bashcurl https://api.nodion.ai/v1/chat/completions \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "<model>", "messages": [{"role": "user", "content": "Hello"}]}'

Elk endpoint, inclusief embeddings, rerank, System One en OCR, met limieten en foutcodes, staat in de AI-API-referentie.

Bekijk de modellen met tokenprijzen via GET https://api.nodion.ai/v1/models of in het tabblad Models (inclusief OCR, spraak naar tekst en tekst naar spraak). De prijzen vind je daar, niet in het prijsoverzicht van het platform. AI-gebruik betaal je uit je tegoed of via een coding plan, niet via de platformfactuur. Spraak- en OCR-modellen staan niet op /v1/models: gebruik de catalogus in het dashboard of de openbare lijst /v2/public/ai/models. Modellen met het label Preview kunnen op korte termijn uit de catalogus verdwijnen. Er is geen datum voor uitfasering; ze blijven aanroepbaar tot ze verdwijnen.

Spraak naar tekst

POST /v1/audio/transcriptions is multipart in OpenAI-formaat. De hele request-body moet onder 25 MiB blijven (bestand plus formuliervelden). Bestanden zelf zijn beperkt tot 20 MiB. De duur wordt per seconde gefactureerd.

bashcurl https://api.nodion.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -F model="mistral/voxtral-mini-transcribe" \
  -F file="@speech.wav"

Tekst naar spraak

POST /v1/audio/speech geeft audiobytes terug. Input wordt per UTF-8-teken (Unicode-codepoint) gefactureerd.

bashcurl https://api.nodion.ai/v1/audio/speech \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "mistral/voxtral-mini-tts", "input": "Hello from Nodion", "voice": "en-US"}' \
  --output speech.mp3

Voice cloning

Modellen met supports_voice_cloning accepteren in voice op POST /v1/audio/speech een voice-ID die in het project is gekloond. Maak een sample met POST /v1/audio/voices (multipart name, consent=true en een file van 3-30 seconden). Tien stemmen per project. Tien aanmaakpogingen per uur. Samples worden versleuteld opgeslagen tot de stem of het project wordt verwijderd; bij elke synthese gaat een korte referentie naar Mistral. Je moet bevestigen dat het sample je eigen stem is of dat de spreker heeft ingestemd met het klonen.

bashcurl https://api.nodion.ai/v1/audio/voices \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -F name="Studio" \
  -F consent="true" \
  -F file="@clip.wav"

curl https://api.nodion.ai/v1/audio/speech \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "mistral/voxtral-mini-tts", "input": "Hello from Nodion", "voice": "<voice-id>"}' \
  --output cloned.mp3

Realtime-transcriptie

Realtime-modellen gebruiken wss://api.nodion.ai/v1/audio/transcriptions/realtime?model=… met dezelfde bearer-sleutel. Het uitwisselingsformaat bestaat uit de JSON-frames van Mistral (session.update, input_audio.append met base64-PCM), niet de agent-realtime-API van OpenAI.

Beeldgeneratie

Beeldmodellen gebruiken de OpenAI Images API: POST https://api.nodion.ai/v1/images/generations. Het antwoord is alleen b64_json: url en het ophalen van externe afbeeldingen worden geweigerd. n wordt vooraf gereserveerd en per teruggegeven afbeelding afgerekend. Beeldmodellen staan in het tabblad Models, niet op GET /v1/models.

bashcurl https://api.nodion.ai/v1/images/generations \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "<image-model>", "prompt": "a red cube", "n": 1, "size": "1024x1024"}'

Tools

Web search, nieuws, fetch, afbeeldingen, video's, plaatsen, kaarten, shopping en reverse image search worden per call gefactureerd: van hetzelfde tegoed, of van het inbegrepen gebruik als de sleutel aan een coding plan gekoppeld is. Ze staan in de AI Inference-catalogus en je roept ze aan met een inference-sleutel:

bashcurl https://api.nodion.ai/v1/tools/web_news \
  -H "Authorization: Bearer $NODION_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "EU cloud regulation", "limit": 5}'

POST /v1/tools/web_search neemt dezelfde query-body, met optionele fetch-hydration van de resultaten. POST /v1/tools/web_images, web_videos, web_places, web_maps en web_shopping gebruiken dezelfde query-vorm. web_maps accepteert ook een optionele ll (@lat,lng,zoomz). POST /v1/tools/web_lens neemt de url van een afbeelding. POST /v1/tools/web_fetch neemt een url en geeft standaard markdown terug. Optionele location, language en freshness (day, week, month, year) filteren zoeken, nieuws, afbeeldingen en video's.

Het laden van pagina's (web_fetch en de fetch hydration van web_search) gebeurt als NodionBot en respecteert robots.txt, Content-Signal: ai-input=no en tdm-reservation. Bij web_fetch worden alleen de request-headers Accept en Accept-Language doorgestuurd; andere headers worden genegeerd en in warnings genoemd, en URL's met inloggegevens worden geweigerd.

Een geweigerde web_fetch geeft 403 met blocked_by_robots, blocked_by_content_signal, blocked_by_tdm_reservation of blocked_domain, of 503 met robots_unavailable (de robots.txt van de site kon niet worden gelezen) of fetch_unavailable; geweigerde calls worden niet gefactureerd, en bij een 503 kun je het later opnieuw proberen. Tijdens de fetch-hydration van web_search geeft de zoekopdracht bij een geweigerd resultaat nog steeds status 200: het resultaat staat in warnings met zijn code en wordt niet gefactureerd, de zoekopdracht zelf wel.

Privacy

De DPA van AI Inference (verwerkersovereenkomst) dekt prompts en output alleen bij door Nodion gehoste modellen (catalogus serving: hosted). Aanbieders waarnaar we requests doorsturen, AI Tools (web search, nieuws, fetch) en voice cloning vallen buiten die DPA. Voice-samples blijven versleuteld tot je de stem of het project verwijdert; bij elke synthese gaat een korte referentie naar Mistral.

Coding agents die de cloud beheren

Wil je Cursor of Claude apps en databases laten aanmaken, gebruik dan MCPmet een persoonlijke platformsleutel, geen inference-sleutel.