AI Inference

Um único gateway compatível com OpenAI, faturado por utilização.

Abra AI Inferenceno projeto atual. Esta API é separada da API HTTP da plataforma. As chaves da plataforma (nodion_…) gerem recursos. As chaves de inferência (nodion_ai_…) chamam modelos.

Separadores

Keys: crie uma chave. Só é mostrada uma vez. Data de expiração opcional e um limite de gastos diário. Uma chave usa o saldo pré-pago ou está associada a um plano de programação com IA; uma chave de plano também usa o saldo para modelos fora do plano e depois de esgotada uma janela de utilização, se o plano o permitir. Os administradores do projeto gerem todas as chaves; os outros membros só criam e veem chaves do plano que lhes foi atribuído.
Playground: experimente o chat (e outros modos, quando existirem modelos para eles). O tráfego do Playground é medido como qualquer outro pedido e é pago com o saldo pré-pago. Só para o proprietário e os administradores do projeto.
Models: catálogo e estado operacional.
Usage e Requests.
Billing: um saldo pré-pago, separado da fatura mensal da plataforma. Carregue-o com cartão ou PayPal.
Coding Plans: planos pré-pagos opcionais Go / Pro / Max com 2× a utilização de chat e ferramentas, um plano por programador. O proprietário do projeto compra os planos e atribui cada um a um membro do projeto; as chaves associadas a um plano usam esse plano. AI Coding Plans no site; faça a gestão em AI Inference → Coding Plans.
Settings: permita ou exclua fornecedores, defina uma lista opcional de regiões permitidas e opções de política como zero data retention. Esta política está sempre ativa nos modelos alojados pela Nodion; a opção do projeto aplica-se aos fornecedores para os quais encaminhamos pedidos.

Chamar a 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 os endpoints, incluindo embeddings, rerank, System One e OCR, com limites e códigos de erro, estão na referência da API de IA.

Liste os modelos com preço por token com GET https://api.nodion.ai/v1/models ou consulte o separador Models (incluindo OCR, voz para texto e texto para voz). Os preços também estão aí, não na tabela de preços da plataforma. Os gastos de IA saem do saldo ou de um plano de programação com IA, não da fatura da plataforma. Os modelos de voz e OCR não aparecem em /v1/models: use o catálogo do dashboard ou a lista pública /v2/public/ai/models. Os modelos marcados como Preview podem sair do catálogo com pouco aviso prévio. Não há data de descontinuação; continuam disponíveis até desaparecerem.

Voz para texto (speech-to-text)

POST /v1/audio/transcriptions é um pedido multipart no formato da OpenAI. O corpo completo do pedido tem de ficar abaixo de 25 MiB (ficheiro mais campos do formulário). Os próprios ficheiros estão limitados a 20 MiB. A duração é faturada ao 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 para voz (text-to-speech)

POST /v1/audio/speech devolve bytes de áudio. A entrada é faturada por carácter UTF-8 (ponto 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

Clonagem de voz

Os modelos com supports_voice_cloning aceitam, no parâmetro voice de POST /v1/audio/speech, o ID de uma voz clonada no projeto. Crie uma amostra com POST /v1/audio/voices (multipart name, consent=true e um file de 3 a 30 segundos). Dez vozes por projeto. Dez tentativas de criação por hora. As amostras ficam guardadas de forma cifrada até a voz ou o projeto ser eliminado; em cada síntese é enviada uma breve referência à Mistral. Tem de confirmar que a amostra é a sua própria voz ou que a pessoa gravada consentiu a clonagem.

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

Transcrição em tempo real

Os modelos em tempo real usam wss://api.nodion.ai/v1/audio/transcriptions/realtime?model=… com a mesma chave Bearer. O formato das mensagens é o dos frames JSON da Mistral (session.update, input_audio.append com PCM em base64), não a API realtime para agentes da OpenAI.

Geração de imagens

Os modelos de imagem usam a OpenAI Images API: POST https://api.nodion.ai/v1/images/generations. A resposta é apenas b64_json: url e a obtenção de imagens remotas são rejeitados. n é reservado e a cobrança é calculada por cada imagem devolvida. Os modelos de imagem aparecem no separador Models, não em 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"}'

Ferramentas

Pesquisa web, notícias, fetch, imagens, vídeos, locais, mapas, shopping e pesquisa inversa de imagens são faturados por chamada: do mesmo saldo, ou da utilização incluída quando a chave está associada a um coding plan. Estão listados no catálogo do AI Inference e são chamados com uma chave de inferência:

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 aceita o mesmo corpo com query, com obtenção opcional das páginas dos resultados através de fetch. POST /v1/tools/web_images, web_videos, web_places, web_maps e web_shopping usam o mesmo formato com query. web_maps também aceita um ll opcional (@lat,lng,zoomz). POST /v1/tools/web_lens recebe o url de uma imagem. POST /v1/tools/web_fetch recebe um url e devolve markdown por omissão. Os parâmetros opcionais location, language e freshness (day, week, month, year) filtram pesquisa, notícias, imagens e vídeos.

Os carregamentos de páginas (web_fetch e a obtenção de páginas por fetch em web_search) são feitos como NodionBot e respeitam o robots.txt, Content-Signal: ai-input=no e tdm-reservation. No web_fetch, só são reencaminhados os cabeçalhos de pedido Accept e Accept-Language; os outros cabeçalhos são descartados e indicados em warnings, e os URL com credenciais são rejeitados.

Um web_fetch recusado devolve 403 com blocked_by_robots, blocked_by_content_signal, blocked_by_tdm_reservation ou blocked_domain, ou 503 com robots_unavailable (não foi possível ler o robots.txt do site) ou fetch_unavailable; as chamadas recusadas não são faturadas, e pode repetir uma chamada que devolva 503 mais tarde. Se um resultado for recusado durante a obtenção de páginas por web_search, a pesquisa continua a devolver 200: o resultado aparece em warnings com o respetivo código e não é faturado; a pesquisa é faturada.

Privacidade

O DPA do AI Inference (acordo de tratamento de dados) abrange prompts e resultados apenas nos modelos alojados pela Nodion (catálogo serving: hosted). Os fornecedores para os quais encaminhamos pedidos, os AI Tools (pesquisa web, notícias, fetch) e a clonagem de voz ficam fora desse DPA. As amostras de voz permanecem cifradas até eliminar a voz ou o projeto; em cada síntese é enviada uma breve referência à Mistral.

Agentes que gerem a cloud

Para que o Cursor ou o Claude criem aplicações e bases de dados, use MCPcom uma chave pessoal da plataforma, não com uma chave de inferência.