AI Inference

Jedna bramka AI zgodna z OpenAI, rozliczana według zużycia.

Otwórz AI Inferencew bieżącym projekcie. To osobne API, niezależne od HTTP API platformy. Klucze platformy (nodion_…) zarządzają zasobami. Klucze inferencji (nodion_ai_…) wywołują modele.

Zakładki

Keys: utwórz klucz. Zobaczysz go tylko raz. Możesz ustawić datę wygaśnięcia i dzienny limit wydatków. Klucz korzysta z salda przedpłaconego albo jest przypisany do planu AI do kodowania; klucz planu korzysta z salda także przy modelach spoza planu oraz po wyczerpaniu limitu w danym oknie, jeśli plan na to pozwala. Administratorzy projektu zarządzają wszystkimi kluczami; pozostali członkowie tworzą i widzą tylko klucze do przypisanego im planu.
Playground: wypróbuj czat (i inne tryby, jeśli są dla nich modele). Żądania z Playground są mierzone jak wszystkie inne i rozliczane z salda przedpłaconego. Dostęp mają tylko właściciel i administratorzy projektu.
Models: katalog i gotowość modeli.
Usage i Requests.
Billing: saldo przedpłacone, oddzielne od miesięcznej faktury za platformę. Doładujesz je kartą lub przez PayPal.
Coding Plans: opcjonalne przedpłacone plany Go / Pro / Max z 2× większą pulą na czat i narzędzia, jeden plan na programistę. Właściciel projektu kupuje plany i przypisuje każdy z nich członkowi projektu; klucze przypisane do planu z niego korzystają. Więcej o AI Coding Plans; zarządzasz nimi w AI Inference → Coding Plans.
Settings: zezwalaj na wybranych dostawców lub ich wykluczaj, ustaw opcjonalną listę dozwolonych regionów (allowlist) i przełączniki zasad, takie jak zero data retention. Zero data retention jest zawsze włączone dla modeli hostowanych przez Nodion; przełącznik projektu dotyczy dostawców, do których przekazujemy żądania.

Wywołanie API

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"}]}'

Każdy endpoint, w tym embeddingi, rerank, System One i OCR, wraz z limitami i kodami błędów, znajdziesz w dokumentacji API AI.

Listę modeli rozliczanych za tokeny pobierzesz przez GET https://api.nodion.ai/v1/models albo przejrzysz w zakładce Models (łącznie z OCR, zamianą mowy na tekst i tekstu na mowę). Tam też znajdziesz ceny, których nie ma w cenniku platformy. Wydatki na AI są pokrywane z salda lub z planu AI do kodowania, a nie z faktury za platformę. Modeli mowy i OCR nie ma w /v1/models: użyj katalogu w dashboardzie lub publicznej listy /v2/public/ai/models. Modele oznaczone jako Preview mogą w krótkim terminie zniknąć z katalogu. Nie ma daty wycofania (deprecation); można je wywoływać, dopóki nie znikną.

Mowa na tekst (speech-to-text)

POST /v1/audio/transcriptions to żądanie multipart w formacie OpenAI. Całe ciało żądania musi mieć mniej niż 25 MiB (plik plus pola formularza). Same pliki są ograniczone do 20 MiB. Czas trwania jest rozliczany co do sekundy.

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 na mowę (text-to-speech)

POST /v1/audio/speech zwraca bajty audio. Dane wejściowe są rozliczane za każdy znak UTF-8 (punkt kodowy Unicode).

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

Klonowanie głosu

Modele z supports_voice_cloning przyjmują w polu voice żądania POST /v1/audio/speech identyfikator głosu sklonowanego w projekcie. Próbkę utworzysz przez POST /v1/audio/voices (multipart name, consent=true i file o długości 3-30 sekund). Dziesięć głosów na projekt. Dziesięć prób utworzenia na godzinę. Próbki są przechowywane w postaci zaszyfrowanej do czasu usunięcia głosu lub projektu; przy każdej syntezie do Mistral trafia krótki fragment referencyjny. Musisz potwierdzić, że próbka to Twój własny głos albo że osoba mówiąca zgodziła się na klonowanie.

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

Transkrypcja w czasie rzeczywistym

Modele działające w czasie rzeczywistym używają wss://api.nodion.ai/v1/audio/transcriptions/realtime?model=… z tym samym kluczem Bearer. Format przesyłanych danych to ramki JSON Mistrala (session.update, input_audio.append z PCM w base64), a nie realtime API OpenAI dla agentów.

Generowanie obrazów

Modele obrazów korzystają z OpenAI Images API: POST https://api.nodion.ai/v1/images/generations. Odpowiedź to wyłącznie b64_json: url i pobieranie zdalnych obrazów są odrzucane. Liczba obrazów określona przez n jest rezerwowana z góry, a rozliczenie następuje za każdy zwrócony obraz. Modele obrazów są wymienione w zakładce Models, a nie w 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"}'

Narzędzia

Wyszukiwanie w sieci, wiadomości (news), fetch, obrazy, wideo, miejsca, mapy, zakupy (shopping) i wyszukiwanie obrazem (reverse image search) są rozliczane za wywołanie: z tego samego salda albo z użycia wliczonego w plan, gdy klucz jest przypisany do planu AI do kodowania. Są wymienione w katalogu AI Inference i wywołuje się je kluczem inferencji:

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 przyjmuje to samo ciało z query, z opcjonalnym pobieraniem treści wyników (fetch hydration). POST /v1/tools/web_images, web_videos, web_places, web_maps i web_shopping używają tego samego formatu z query. web_maps przyjmuje też opcjonalne ll (@lat,lng,zoomz). POST /v1/tools/web_lens przyjmuje url obrazu. POST /v1/tools/web_fetch przyjmuje url i domyślnie zwraca markdown. Opcjonalne location, language i freshness (day, week, month, year) filtrują wyszukiwanie, wiadomości, obrazy i wideo.

Ładowanie stron (web_fetch i pobieranie treści wyników web_search) działa jako NodionBot i respektuje robots.txt, Content-Signal: ai-input=no oraz tdm-reservation. W web_fetch przekazywane są tylko nagłówki żądania Accept i Accept-Language; inne nagłówki są pomijane i wymieniane w warnings, a adresy URL z danymi logowania są odrzucane.

Odrzucone wywołanie web_fetch zwraca 403 z blocked_by_robots, blocked_by_content_signal, blocked_by_tdm_reservation lub blocked_domain albo 503 z robots_unavailable (nie udało się odczytać robots.txt strony) lub fetch_unavailable; odrzucone wywołania nie są rozliczane, a po 503 można spróbować ponownie później. Podczas pobierania treści wyników w web_search odrzucony wynik nie zmienia statusu wyszukiwania (200): trafia do warnings ze swoim kodem i nie jest rozliczany, natomiast samo wyszukiwanie jest.

Prywatność

DPA dla AI Inference (umowa powierzenia przetwarzania danych) obejmuje prompty i odpowiedzi wyłącznie w przypadku modeli hostowanych przez Nodion (w katalogu serving: hosted). Dostawcy, do których przekazujemy żądania, AI Tools (wyszukiwanie w sieci, wiadomości, fetch) i klonowanie głosu są poza zakresem tej umowy DPA. Próbki głosu pozostają zaszyfrowane, dopóki nie usuniesz głosu lub projektu; przy każdej syntezie do Mistral trafia krótki fragment referencyjny.

Agenci zarządzający chmurą

Aby Cursor lub Claude mogły tworzyć aplikacje i bazy danych, użyj MCPz osobistym kluczem platformy, a nie z kluczem inferencji.