AI Inference

Un unico gateway compatibile con OpenAI, a consumo.

Apri AI Inferencenel progetto corrente. È un'API separata dall'API HTTP della piattaforma. Le chiavi della piattaforma (nodion_…) gestiscono le risorse. Le chiavi di inferenza (nodion_ai_…) chiamano i modelli.

Schede

Keys: crea una chiave. Viene mostrata una sola volta. Scadenza facoltativa e un limite di spesa giornaliero. Una chiave usa il credito prepagato oppure è legata a un coding plan; una chiave di un piano usa il credito anche per i modelli fuori dal piano e quando la finestra di utilizzo è esaurita, se il piano lo consente. Gli admin del progetto gestiscono tutte le chiavi; gli altri membri creano e vedono solo le chiavi del piano assegnato a loro.
Playground: prova la chat (e le altre modalità, se ci sono modelli). Il traffico del Playground viene misurato come qualsiasi altra richiesta e usa il credito prepagato. Solo per owner e admin del progetto.
Models: catalogo e stato operativo dei modelli.
Usage e Requests.
Billing: un credito prepagato, separato dalla fattura mensile della piattaforma. Ricarica con carta o PayPal.
Coding Plans: piani prepagati facoltativi Go / Pro / Max con 2× l'utilizzo di chat e tool, un piano per sviluppatore. L'owner del progetto acquista i piani e assegna ciascuno a un membro del progetto; le chiavi legate a un piano lo usano. AI Coding Plans sul sito; li gestisci in AI Inference → Coding Plans.
Settings: consenti o escludi provider, imposta un elenco facoltativo di regioni consentite e opzioni come la zero data retention. La zero data retention è sempre attiva per i modelli ospitati da Nodion; l'opzione del progetto vale per i provider instradati.

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

Tutti gli endpoint, compresi embeddings, rerank, System One e OCR, con limiti e codici di errore, sono nel riferimento dell'API AI.

Elenca i modelli con prezzo a token con GET https://api.nodion.ai/v1/models oppure sfoglia la scheda Models (che include anche OCR, speech-to-text e text-to-speech). Lì trovi anche i prezzi, che non sono nel listino della piattaforma. La spesa AI viene dal credito o da un coding plan, non dalla fattura della piattaforma. I modelli vocali e OCR non sono elencati su /v1/models: usa il catalogo della dashboard o l'elenco pubblico /v2/public/ai/models. I modelli contrassegnati come Preview possono uscire dal catalogo con poco preavviso. Non c'è una data di deprecazione; puoi chiamarli finché restano nel catalogo.

Da voce a testo

POST /v1/audio/transcriptions è un multipart in stile OpenAI. L'intero body della richiesta deve restare sotto i 25 MiB (file più campi del form). I file da soli hanno un limite di 20 MiB. La durata viene addebitata al secondo.

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

Da testo a voce

POST /v1/audio/speech restituisce i byte dell'audio. L'input viene addebitato per carattere UTF-8 (code point 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

Clonazione vocale

I modelli con supports_voice_cloning accettano in voice, su POST /v1/audio/speech, l'id di una voce clonata nel progetto. Crea un campione con POST /v1/audio/voices (multipart name, consent=true e un file da 3 a 30 secondi). Dieci voci per progetto. Dieci tentativi di creazione all'ora. I campioni restano salvati cifrati finché la voce o il progetto non vengono eliminati; per ogni sintesi un breve riferimento viene inviato a Mistral. Devi confermare che il campione è la tua voce o che la persona che parla ha acconsentito alla clonazione.

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

Trascrizione in tempo reale

I modelli in tempo reale usano wss://api.nodion.ai/v1/audio/transcriptions/realtime?model=… con la stessa chiave bearer. Il formato dei messaggi è quello dei frame JSON di Mistral (session.update, input_audio.append con PCM in base64), non l'API in tempo reale per agenti di OpenAI.

Generazione di immagini

I modelli per immagini usano l'API Images di OpenAI: POST https://api.nodion.ai/v1/images/generations. La risposta è solo b64_json: url e il recupero di immagini remote vengono rifiutati. n viene riservato in anticipo e addebitato per ogni immagine restituita. I modelli per immagini sono elencati nella scheda Models, non su 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"}'

Tool

Ricerca web, notizie, fetch, immagini, video, luoghi, mappe, shopping e ricerca inversa per immagini vengono addebitati per chiamata: dallo stesso credito oppure dall'utilizzo incluso, se la chiave è legata a un coding plan. Sono elencati nel catalogo AI Inference e si chiamano con una chiave di inferenza:

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 accetta lo stesso body con query e può anche scaricare le pagine dei risultati (fetch hydration). POST /v1/tools/web_images, web_videos, web_places, web_maps e web_shopping usano la stessa forma con query. web_maps accetta anche un ll facoltativo (@lat,lng,zoomz). POST /v1/tools/web_lens accetta come url l'indirizzo di un'immagine. POST /v1/tools/web_fetch accetta un url e restituisce Markdown per impostazione predefinita. I parametri facoltativi location, language e freshness (day, week, month, year) filtrano ricerca, notizie, immagini e video.

Il caricamento delle pagine (web_fetch e la fetch hydration di web_search) avviene come NodionBot e rispetta robots.txt, Content-Signal: ai-input=no e tdm-reservation. Su web_fetch vengono inoltrati solo gli header di richiesta Accept e Accept-Language; gli altri header vengono scartati e indicati in warnings, e gli URL con credenziali vengono rifiutati.

Un web_fetch rifiutato restituisce 403 con blocked_by_robots, blocked_by_content_signal, blocked_by_tdm_reservation o blocked_domain, oppure 503 con robots_unavailable (non è stato possibile leggere il robots.txt del sito) o fetch_unavailable; le chiamate rifiutate non vengono addebitate e in caso di 503 puoi riprovare più tardi. Durante la fetch hydration di web_search, un risultato rifiutato non cambia lo stato 200 della ricerca: compare in warnings con il suo codice e non viene addebitato, mentre la ricerca sì.

Privacy

Il DPA di AI Inference copre prompt e output solo sui modelli ospitati da Nodion (catalogo serving: hosted). I provider instradati, gli AI Tools (ricerca web, notizie, fetch) e la clonazione vocale sono esclusi da questo DPA. I campioni vocali restano cifrati finché non elimini la voce o il progetto; per ogni sintesi un breve riferimento viene inviato a Mistral.

Agenti che gestiscono il cloud

Per permettere a Cursor o Claude di creare app e database, usa MCPcon una chiave personale della piattaforma, non con una chiave di inferenza.