Usar a ORYKSA como a IA das tuas automações no n8n
Onde um fluxo pede a OpenAI ou o OpenRouter, usa a ORYKSA. O consumo sai das interações do teu plano.
Para que serve
As automações no n8n precisam muitas vezes de um modelo de IA: para escrever um post a partir de um vídeo novo no YouTube, para classificar uma linha nova no Google Sheets, para resumir um ficheiro do Google Drive. Normalmente pagarias à OpenAI ou ao OpenRouter por isso. Com a ORYKSA não precisas: a ORYKSA é o modelo e usa as interações do teu plano.
O teu n8n continua a falar com o YouTube, Instagram, LinkedIn, Drive ou Sheets com as tuas contas. A ORYKSA só pensa e escreve.
O que precisas
- Uma conta ORYKSA.
- Uma chave de API. Cria-a em developer.oryksa.com. Começa por oryk_live_. Guarda-a em privado, como uma palavra-passe.
Configurar no n8n
- No n8n, abre Credentials e cria uma credencial nova do tipo OpenAI.
- Em API Key, cola a tua chave ORYKSA.
- Em Base URL, escreve https://api.oryksa.com/v1
- Guarda. O n8n testa a ligação sozinho.
- No teu fluxo, onde houver um OpenAI Chat Model (num AI Agent, num Basic LLM Chain, num Information Extractor, num Text Classifier), escolhe esta credencial e o modelo oryksa.
- A opção Use Responses API pode ficar ligada ou desligada: a ORYKSA responde nos dois formatos.
Um fluxo que importaste e que diz gpt-4o ou outro nome de modelo também funciona: a ORYKSA responde no lugar dele.
No Make, no Zapier e noutras ferramentas a ideia é a mesma: onde a ferramenta pede o endereço e a chave da OpenAI, usa o endereço da ORYKSA e a tua chave ORYKSA.
Dois modelos
- oryksa: o modelo geral. Faz o que o teu fluxo lhe diz e não sabe nada da tua conta. Usa este nas automações.
- oryksa-assistant: o teu próprio assistente ORYKSA, com o conhecimento e os dados do teu negócio. Só responde.
O que gasta
Cada resposta do modelo gasta uma interação do teu plano. Um AI Agent que chama ferramentas recebe várias respostas seguidas, por isso gasta uma interação por cada uma. Quando as interações acabam, o fluxo recebe um erro a dizê-lo. Nada é cobrado para além do teu plano.
Limites
Cada pedido pode levar até 32 000 caracteres de texto e cada resposta até 2 000 tokens. Para um documento longo, divide-o em partes no teu fluxo.
Se algo não funcionar
- Chave inválida: confirma que colaste a chave inteira e que não foi revogada.
- O modelo não aparece: confirma o Base URL. Tem de terminar em /v1.
- Erro com "Use Responses API" ligado: a ORYKSA aceita texto, ferramentas de função, saída em JSON e streaming nesse formato. Não aceita as ferramentas próprias da OpenAI (pesquisa na web, pesquisa em ficheiros, interpretador de código) nem conversas guardadas (
previous_response_id): envia a conversa inteira em cada pedido. A mensagem de erro diz qual é o campo. - Pedido demasiado grande: o texto passa dos 32 000 caracteres. Envia menos de cada vez.
- Limite atingido: o teu plano não tem mais interações neste período.
Centro de Ajuda