ORYKSA AI Central de Ajuda

Usar a ORYKSA como a IA das suas automações no n8n

Onde um fluxo pede a OpenAI ou o OpenRouter, use a ORYKSA. O consumo sai das interações do seu plano.

Para que serve

As automações no n8n muitas vezes precisam 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 arquivo do Google Drive. Normalmente você pagaria à OpenAI ou ao OpenRouter por isso. Com a ORYKSA não precisa: a ORYKSA é o modelo e usa as interações do seu plano.

O seu n8n continua falando com YouTube, Instagram, LinkedIn, Drive ou Sheets com as suas contas. A ORYKSA só pensa e escreva.

O que você precisa

  • Uma conta ORYKSA.
  • Uma chave de API. Crie em developer.oryksa.com. Ela começa com oryk_live_. Guarde em privado, como uma senha.

Configurar no n8n

  1. No n8n, abra Credentials e crie uma credencial nova do tipo OpenAI.
  2. Em API Key, cole a sua chave ORYKSA.
  3. Em Base URL, escreva https://api.oryksa.com/v1
  4. Salve. O n8n testa a conexão sozinho.
  5. No seu fluxo, onde houver um OpenAI Chat Model (em um AI Agent, um Basic LLM Chain, um Information Extractor, um Text Classifier), escolha esta credencial e o modelo oryksa.
  6. A opção Use Responses API pode ficar ligada ou desligada: a ORYKSA responde nos dois formatos.

Um fluxo que você importou e que diz gpt-4o ou outro nome de modelo também funciona: a ORYKSA responde no lugar dele.

No Make, no Zapier e em outras ferramentas a ideia é a mesma: onde a ferramenta pede o endereço e a chave da OpenAI, use o endereço da ORYKSA e a sua chave ORYKSA.

Dois modelos

  • oryksa: o modelo geral. Faz o que o seu fluxo manda e não sabe nada da sua conta. Use este nas automações.
  • oryksa-assistant: o seu próprio assistente ORYKSA, com o conhecimento e os dados do seu negócio. Só responde.

O que gasta

Cada resposta do modelo gasta uma interação do seu plano. Um AI Agent que chama ferramentas recebe várias respostas seguidas, então gasta uma interação para cada uma. Quando as interações acabam, o fluxo recebe um erro avisando. Nada é cobrado além do seu plano.

Limites

Cada pedido pode levar até 32 000 caracteres de texto e cada resposta até 2 000 tokens. Para um documento longo, divida em partes no seu fluxo.

Se algo não funcionar

  • Chave inválida: confira se você colou a chave inteira e se ela não foi revogada.
  • O modelo não aparece: confira o Base URL. Ele precisa 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 (busca na web, busca em arquivos, interpretador de código) nem conversas salvas (previous_response_id): envie a conversa inteira em cada pedido. A mensagem de erro diz qual é o campo.
  • Pedido grande demais: o texto passa de 32 000 caracteres. Envie menos de cada vez.
  • Limite atingido: o seu plano não tem mais interações neste período.
Este artigo foi útil?
Obrigado pelo feedback.
Avalie este artigo
★ ★ ★ ★ ★
Sê o primeiro a avaliar.

Não encontraste o que precisa?

Abra um ticket de suporte e respondemos rapidamente.

Abrir ticket