Ligar as suas aplicações ao ProxyIA

O ProxyIA expõe um endpoint único, compatível com a API da OpenAI. Configure-o uma vez no AnythingLLM, no Jan, no Visual Studio Code ou no seu próprio código — e passe a falar com os modelos da UBI e do IA.edu sem nunca ter de guardar uma chave de API na aplicação.

Endpoint https://proxyia.ubi.pt/api

A sua API Key pessoal do ProxyIA é criada automaticamente ao entrar pela primeira vez, e fica disponível na sua área pessoal.

Alguns clientes só deixam configurar o domínio e acrescentam /v1/... por conta própria, sem espaço para o /api do endpoint acima. Nesses casos use antes https://proxyia.ubi.pt — o proxy responde da mesma forma em /v1/models, /v1/chat/completions e /v1/messages.

Ligar as suas aplicações

Em todos os casos os valores são os mesmos: o endpoint acima, a sua API Key do ProxyIA e o nome do modelo tal como aparece no seu painel.

AnythingLLM

Settings → LLM Preference → Generic OpenAI

Base URL: https://proxyia.ubi.pt/api
API Key: a sua API Key do ProxyIA
Chat Model Name: o nome do modelo/perfil
Token context window: o do modelo escolhido

Jan

Settings → Model Providers → OpenAI-compatible

Base URL: https://proxyia.ubi.pt/api
API Key: a sua API Key do ProxyIA
Modelo: adicione um modelo com o nome do perfil

O Jan lê a lista de /v1/models, por isso os seus perfis aparecem no dropdown assim que o provider ficar guardado.

Visual Studio Code

Extensão Continue → Add Chat Model → provider OpenAI

API Base: https://proxyia.ubi.pt/api
API Key: a sua API Key do ProxyIA
Model: o nome do modelo/perfil

A extensão Continue fala o mesmo formato de API da OpenAI, por isso os perfis do ProxyIA funcionam sem qualquer adaptador.

Código / cURL

Qualquer SDK da OpenAI serve — basta trocar o base_url.

curl -s \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"NOME_DO_MODELO","stream":true,"messages":[{"role":"user","content":"Olá!"}]}' \
  --no-buffer \
  https://proxyia.ubi.pt/api/v1/chat/completions

Para ver os modelos a que tem acesso: GET https://proxyia.ubi.pt/api/v1/models

Escolher o nível de raciocínio

A maioria dos clientes só deixa escolher o modelo, não o esforço de raciocínio. Por isso, quando um modelo suporta reasoning, ele aparece na lista também nas suas variantes — basta escolher a variante no dropdown:

gpt-oss
gpt-oss:low
gpt-oss:medium
gpt-oss:high

Os níveis dependem do modelo: um servidor Qwen3 expõe :think e :nothink em vez de níveis de esforço, e um agente IA.edu não expõe nenhum. A lista devolvida por /v1/models é sempre a verdade — só anuncia variantes que realmente fazem alguma coisa.

Pronto a começar?

Entre com as suas credenciais da UBI — a API Key é criada no momento.

Entrar com credenciais UBI