AI Inference

Un único gateway compatible con OpenAI, con pago por uso.

Abre AI Inferenceen el proyecto actual. Es una API distinta de la API HTTP de la plataforma. Las claves de la plataforma (nodion_…) gestionan recursos. Las claves de inferencia (nodion_ai_…) llaman a los modelos.

Pestañas

Keys: crea una clave. Se muestra una sola vez. Caducidad opcional y un límite de gasto diario. Una clave usa el saldo prepago o está vinculada a un coding plan; una clave de un plan también usa el saldo para los modelos que no incluye el plan y cuando la ventana de uso se ha agotado, si el plan lo permite. Los admins del proyecto gestionan todas las claves; los demás miembros solo crean y ven las claves del plan que tienen asignado.
Playground: prueba el chat (y otros modos, si hay modelos para ellos). El tráfico del Playground se mide como cualquier otra petición y se paga con el saldo prepago. Solo para el propietario y los admins del proyecto.
Models: catálogo y disponibilidad de los modelos.
Usage y Requests.
Billing: un saldo prepago, separado de la factura mensual de la plataforma. Recarga con tarjeta o PayPal.
Coding Plans: planes prepago opcionales Go / Pro / Max con 2× el uso de chat y herramientas, un plan por desarrollador. El propietario del proyecto compra los planes y asigna cada uno a un miembro del proyecto; las claves vinculadas a un plan lo usan. AI Coding Plans en la web; los gestionas en AI Inference → Coding Plans.
Settings: permite o excluye proveedores, define una lista opcional de regiones permitidas y activa opciones de política como zero data retention. Zero data retention está siempre activo en los modelos alojados en Nodion; la opción del proyecto se aplica a los proveedores enrutados.

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

Todos los endpoints, incluidos embeddings, rerank, System One y OCR, con sus límites y códigos de error, están en la referencia de la API de IA.

Consulta los modelos con precio por token mediante GET https://api.nodion.ai/v1/models o consulta la pestaña Models (que incluye también OCR, voz a texto y texto a voz). Ahí están también los precios, que no figuran en la lista de precios de la plataforma. El gasto de IA sale del saldo o de un coding plan, no de la factura de la plataforma. Los modelos de voz y OCR no aparecen en /v1/models: usa el catálogo del dashboard o la lista pública /v2/public/ai/models. Los modelos marcados como Preview pueden salir del catálogo con poco preaviso. No tienen fecha de retirada; puedes llamarlos hasta que desaparezcan.

Voz a texto

POST /v1/audio/transcriptions es multipart con el formato de OpenAI. El cuerpo completo de la petición debe quedarse por debajo de 25 MiB (archivo más campos del formulario). Los archivos en sí tienen un límite de 20 MiB. La duración se factura por segundo.

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

Texto a voz

POST /v1/audio/speech devuelve los bytes del audio. La entrada se factura por carácter UTF-8 (punto de código 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

Clonación de voz

Los modelos con supports_voice_cloning aceptan en voice, en POST /v1/audio/speech, el ID de una voz clonada en el proyecto. Crea una muestra con POST /v1/audio/voices (multipart name, consent=true y un file de 3 a 30 segundos). Diez voces por proyecto. Diez intentos de creación por hora. Las muestras se guardan cifradas hasta que se elimina la voz o el proyecto; en cada síntesis se envía una breve referencia a Mistral. Debes confirmar que la muestra es tu propia voz o que la persona que habla ha dado su consentimiento para la clonación.

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

Transcripción en tiempo real

Los modelos en tiempo real usan wss://api.nodion.ai/v1/audio/transcriptions/realtime?model=… con la misma clave bearer. El formato de los mensajes es el de las tramas JSON de Mistral (session.update, input_audio.append con PCM en base64), no la API realtime para agentes de OpenAI.

Generación de imágenes

Los modelos de imagen usan la Images API de OpenAI: POST https://api.nodion.ai/v1/images/generations. La respuesta es solo b64_json: url y la descarga de imágenes remotas se rechazan. n se reserva por adelantado y se liquida por cada imagen devuelta. Los modelos de imagen aparecen en la pestaña Models, no en 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"}'

Herramientas

Las herramientas de búsqueda web, noticias, fetch, imágenes, vídeos, lugares, mapas, shopping y búsqueda inversa de imágenes se facturan por llamada: del mismo saldo o del uso incluido si la clave está vinculada a un coding plan. Aparecen en el catálogo de AI Inference y se invocan con una clave de inferencia:

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 acepta el mismo cuerpo con query y permite descargar, de forma opcional, las páginas de los resultados. POST /v1/tools/web_images, web_videos, web_places, web_maps y web_shopping usan el mismo formato de petición con query. web_maps también acepta un ll opcional (@lat,lng,zoomz). POST /v1/tools/web_lens acepta como url la dirección de una imagen. POST /v1/tools/web_fetch acepta una url y devuelve Markdown por defecto. Los parámetros opcionales location, language y freshness (day, week, month, year) filtran búsqueda, noticias, imágenes y vídeos.

Las descargas de páginas (web_fetch y la descarga de resultados de web_search) se ejecutan como NodionBot y respetan robots.txt, Content-Signal: ai-input=no y tdm-reservation. En web_fetch solo se reenvían las cabeceras de petición Accept y Accept-Language; las demás cabeceras se descartan y se indican en warnings, y las URL con credenciales se rechazan.

Un web_fetch rechazado devuelve 403 con blocked_by_robots, blocked_by_content_signal, blocked_by_tdm_reservation o blocked_domain, o 503 con robots_unavailable (no se pudo leer el robots.txt del sitio) o fetch_unavailable; las llamadas rechazadas no se facturan y un 503 se puede reintentar más tarde. Durante la descarga de páginas de web_search, un resultado rechazado no cambia el 200 de la búsqueda: aparece en warnings con su código y no se factura, aunque la búsqueda sí se factura.

Privacidad

El DPA de AI Inference (contrato de encargo del tratamiento) cubre prompts y resultados solo en los modelos alojados en Nodion (catálogo serving: hosted). Los proveedores enrutados, AI Tools (búsqueda web, noticias, fetch) y la clonación de voz quedan fuera de ese DPA. Las muestras de voz permanecen cifradas hasta que eliminas la voz o el proyecto; en cada síntesis se envía una breve referencia a Mistral.

Agentes que gestionan tu cloud

Para que Cursor o Claude creen apps y bases de datos, usa MCPcon una clave personal de la plataforma, no con una clave de inferencia.