Utiliser ORYKSA comme l’IA de vos automatisations n8n

À quoi cela sert

Les automatisations dans n8n ont souvent besoin d’un modèle d’IA : pour rédiger un post à partir d’une nouvelle vidéo YouTube, pour classer une nouvelle ligne dans Google Sheets, pour résumer un fichier depuis Google Drive. Normalement, vous paieriez OpenAI ou OpenRouter pour cela. Avec ORYKSA, vous n’en avez pas besoin : ORYKSA est le modèle, et il utilise les interactions de votre forfait.

Votre n8n continue de communiquer avec YouTube, Instagram, LinkedIn, Drive ou Sheets via vos propres comptes. ORYKSA s’occupe uniquement de la réflexion et de la rédaction.

Ce qu’il vous faut

• Un compte ORYKSA.
• Une clé API. Créez-la sur developer.oryksa.com. Elle commence par oryk_live_. Gardez-la privée, comme un mot de passe.

Configuration dans n8n

1. Dans n8n, ouvrez Credentials et créez un nouveau credential de type OpenAI.
2. Dans API Key, collez votre clé ORYKSA.
3. Dans Base URL, écrivez https://api.oryksa.com/v1
4. Enregistrez. n8n teste la connexion automatiquement.
5. Dans votre flux, partout où il y a un OpenAI Chat Model (dans un AI Agent, un Basic LLM Chain, un Information Extractor, un Text Classifier), choisissez ce credential et sélectionnez le modèle oryksa.
6. L’option Use Responses API peut être activée ou non : ORYKSA répond dans les deux formats.

Un flux importé qui indique gpt-4o ou un autre nom de modèle fonctionne aussi : ORYKSA répond à sa place.

Dans Make, Zapier et d’autres outils, le principe est le même : là où l’outil demande l’adresse OpenAI et la clé, utilisez l’adresse ORYKSA et votre clé ORYKSA.

Deux modèles

• oryksa : le modèle général. Il exécute ce que votre flux lui demande et ne connaît rien de votre compte. Utilisez celui-ci pour les automatisations.
• oryksa-assistant : votre assistant ORYKSA personnel, avec la connaissance et les données de votre entreprise. Il ne fait que répondre.

Ce que cela consomme

Chaque réponse du modèle utilise une interaction de votre forfait. Un AI Agent qui appelle des outils reçoit plusieurs réponses à la suite, donc il utilise une interaction pour chacune. Lorsque vos interactions sont épuisées, le flux reçoit une erreur qui l’indique. Rien n’est facturé au-delà de votre forfait.

Limites

Chaque requête peut contenir jusqu’à 32 000 caractères de texte et chaque réponse jusqu’à 2 000 tokens. Pour un document long, découpez-le en parties dans votre flux.

Si quelque chose ne fonctionne pas

• Invalid key: vérifiez que vous avez collé la clé entière et qu’elle n’a pas été révoquée.
• The model does not appear: vérifiez le Base URL. Il doit se terminer par /v1.
• Error with "Use Responses API" on: ORYKSA accepte le texte, les outils fonction, la sortie JSON et le streaming dans ce format. Il n’accepte pas les outils propres à OpenAI (web search, file search, code interpreter) ni les conversations stockées (previous_response_id) : envoyez toute la conversation à chaque requête. Le message d’erreur indique le champ concerné.
• Request too large: le texte dépasse 32 000 caractères. Envoyez-en moins à la fois.
• Limit reached: votre forfait n’a plus d’interactions disponibles pour cette période.