@miskokodi/n8n-nodes-kie-ai 0.1.0

package/README.md

@@ -0,0 +1,76 @@
+# @miskokodi/n8n-nodes-kie-ai
+
+n8n community node that adds a **KIE.ai Chat Model** — use [KIE.ai](https://kie.ai)'s discounted LLM APIs (Gemini, GPT, Claude, DeepSeek, Grok) as the language model provider for **AI Agent**, chains, and any other LangChain root node, exactly like the built-in OpenRouter / OpenAI chat model nodes.
+
+## Why
+
+KIE routes each LLM through its own OpenAI-compatible endpoint path
+(`https://api.kie.ai/{model}/v1/chat/completions`) and has no `/models`
+listing endpoint — which breaks n8n's stock OpenAI node (credential test
+and model dropdown both fail). This node handles the path-based routing
+internally and ships a model dropdown, so it Just Works.
+
+## Install
+
+Self-hosted n8n → **Settings → Community Nodes → Install** → enter:
+
+```
+@miskokodi/n8n-nodes-kie-ai
+```
+
+(Requires `N8N_COMMUNITY_PACKAGES_ENABLED=true`, which is the default on self-hosted.)
+
+## Use
+
+1. Create a **KIE.ai API** credential with your API key (kie.ai → Dashboard → API Keys). The credential test validates the key against KIE's credit endpoint.
+2. Add **KIE.ai Chat Model** as the language model of your AI Agent / chain.
+3. Pick a model from the dropdown, or switch the field to an expression and pass any KIE model slug directly.
+
+### Options
+
+Temperature, top-p, penalties, max tokens, retries, timeout — same surface as the built-in OpenAI chat model node. A **Base URL Override** option (with `{model}` placeholder) is included in case KIE changes its gateway layout.
+
+## Model list
+
+KIE has no public models-list API, so the dropdown is a curated list in
+`nodes/LmChatKieAi/LmChatKieAi.node.ts` (`KIE_MODELS`). PRs welcome when
+KIE adds/renames models; the dropdown is wired through `loadOptions`, so a
+remote fetch can be dropped in later without a schema change.
+
+## Development
+
+```bash
+npm install
+npm run build       # tsc + copy icon to dist
+```
+
+Local testing without publishing:
+
+```bash
+# in this repo
+npm run build && npm pack        # produces miskokodi-n8n-nodes-kie-ai-0.1.0.tgz
+
+# on your n8n host
+cd ~/.n8n/nodes                  # create if missing
+npm install /path/to/miskokodi-n8n-nodes-kie-ai-0.1.0.tgz
+# restart n8n
+```
+
+## Publish
+
+```bash
+npm login
+npm publish --access public
+```
+
+Then optionally submit for n8n's verified community node listing:
+https://docs.n8n.io/integrations/creating-nodes/deploy/submit-community-nodes/
+
+## Notes
+
+- Function calling / tools are supported (KIE's chat endpoints accept the standard `tools` param), so AI Agent tool use works. Behavior fidelity varies per underlying model, as with any aggregator.
+- The `model` field in the request body is effectively ignored by KIE's gateway — the URL path decides the model. The node sets both consistently.
+
+## License
+
+MIT

package/dist/credentials/KieAiApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class KieAiApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/KieAiApi.credentials.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KieAiApi = void 0;
+class KieAiApi {
+    name = 'kieAiApi';
+    displayName = 'KIE.ai API';
+    documentationUrl = 'https://docs.kie.ai/';
+    properties = [
+        {
+            displayName: 'API Key',
+            name: 'apiKey',
+            type: 'string',
+            typeOptions: { password: true },
+            required: true,
+            default: '',
+            description: 'Your KIE.ai API key. Get it at https://kie.ai → Dashboard → API Keys.',
+        },
+    ];
+    authenticate = {
+        type: 'generic',
+        properties: {
+            headers: {
+                Authorization: '=Bearer {{$credentials.apiKey}}',
+            },
+        },
+    };
+    // KIE has no /models endpoint, so we validate the key against the
+    // account credit endpoint instead — it exists for every account and
+    // returns 401 on a bad key.
+    test = {
+        request: {
+            baseURL: 'https://api.kie.ai',
+            url: '/api/v1/chat/credit',
+            method: 'GET',
+        },
+    };
+}
+exports.KieAiApi = KieAiApi;

package/dist/nodes/LmChatKieAi/LmChatKieAi.node.d.ts

@@ -0,0 +1,10 @@
+import { type ILoadOptionsFunctions, type INodePropertyOptions, type INodeType, type INodeTypeDescription, type ISupplyDataFunctions, type SupplyData } from 'n8n-workflow';
+export declare class LmChatKieAi implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getModels(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    supplyData(this: ISupplyDataFunctions, itemIndex: number): Promise<SupplyData>;
+}

package/dist/nodes/LmChatKieAi/LmChatKieAi.node.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LmChatKieAi = void 0;
+const openai_1 = require("@langchain/openai");
+const n8n_workflow_1 = require("n8n-workflow");
+/**
+ * KIE routes LLM traffic per-model via the URL path:
+ *   POST https://api.kie.ai/{model-slug}/v1/chat/completions
+ * The `model` field in the request body is ignored by the gateway —
+ * the path segment is the source of truth. Each endpoint is
+ * OpenAI-chat-completions compatible (messages, tools, streaming).
+ *
+ * There is currently no public /models listing endpoint, so the
+ * dropdown is a curated list of the LLM slugs KIE exposes. Update
+ * KIE_MODELS below when KIE adds models, or use an expression to
+ * pass any slug directly.
+ */
+const KIE_MODELS = [
+    // Google
+    { name: 'Gemini 3.1 Pro', value: 'gemini-3-1-pro' },
+    { name: 'Gemini 3 Pro', value: 'gemini-3-pro' },
+    { name: 'Gemini 3 Flash', value: 'gemini-3-flash' },
+    { name: 'Gemini 2.5 Pro', value: 'gemini-2-5-pro' },
+    { name: 'Gemini 2.5 Flash', value: 'gemini-2-5-flash' },
+    // OpenAI
+    { name: 'GPT-5.5', value: 'gpt-5-5' },
+    { name: 'GPT-5.4 Mini', value: 'gpt-5-4-mini' },
+    { name: 'GPT-5.2', value: 'gpt-5-2' },
+    // Anthropic
+    { name: 'Claude Opus 4.7', value: 'claude-opus-4-7' },
+    { name: 'Claude Sonnet 4.6', value: 'claude-sonnet-4-6' },
+    { name: 'Claude Haiku 4.5', value: 'claude-haiku-4-5' },
+    // DeepSeek
+    { name: 'DeepSeek Chat (V3)', value: 'deepseek-chat' },
+    { name: 'DeepSeek Reasoner (R1)', value: 'deepseek-reasoner' },
+    // xAI
+    { name: 'Grok 4.3', value: 'grok-4-3' },
+    { name: 'Grok 4.2 Fast', value: 'grok-4-2-fast' },
+];
+class LmChatKieAi {
+    description = {
+        displayName: 'KIE.ai Chat Model',
+        name: 'lmChatKieAi',
+        icon: 'file:kieai.svg',
+        group: ['transform'],
+        version: 1,
+        description: 'Use KIE.ai discounted LLM APIs (Gemini, GPT, Claude, DeepSeek, Grok) as the language model for AI Agents and chains',
+        defaults: {
+            name: 'KIE.ai Chat Model',
+        },
+        codex: {
+            categories: ['AI'],
+            subcategories: {
+                AI: ['Language Models', 'Root Nodes'],
+                'Language Models': ['Chat Models (Recommended)'],
+            },
+            resources: {
+                primaryDocumentation: [
+                    {
+                        url: 'https://docs.kie.ai/',
+                    },
+                ],
+            },
+        },
+        // Sub-node: no main input, supplies an ai_languageModel connection
+        inputs: [],
+        outputs: [n8n_workflow_1.NodeConnectionTypes.AiLanguageModel],
+        outputNames: ['Model'],
+        credentials: [
+            {
+                name: 'kieAiApi',
+                required: true,
+            },
+        ],
+        properties: [
+            {
+                displayName: 'KIE routes each model via its own endpoint path. Pick a model from the list, or switch the field to an expression to pass any KIE model slug (e.g. "gemini-3-flash").',
+                name: 'notice',
+                type: 'notice',
+                default: '',
+            },
+            {
+                displayName: 'Model',
+                name: 'model',
+                type: 'options',
+                description: 'The KIE.ai model to use. Choose from the list, or specify a slug using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                typeOptions: {
+                    loadOptionsMethod: 'getModels',
+                },
+                default: 'gemini-3-flash',
+                required: true,
+            },
+            {
+                displayName: 'Options',
+                name: 'options',
+                type: 'collection',
+                placeholder: 'Add Option',
+                default: {},
+                options: [
+                    {
+                        displayName: 'Base URL Override',
+                        name: 'baseURL',
+                        type: 'string',
+                        default: '',
+                        placeholder: 'https://api.kie.ai/{model}/v1',
+                        description: 'Override the endpoint base URL. Use {model} as a placeholder for the model slug. Leave empty for the default KIE gateway.',
+                    },
+                    {
+                        displayName: 'Frequency Penalty',
+                        name: 'frequencyPenalty',
+                        type: 'number',
+                        typeOptions: { minValue: -2, maxValue: 2, numberPrecision: 1 },
+                        default: 0,
+                        description: 'Positive values penalize tokens based on their existing frequency, decreasing repetition',
+                    },
+                    {
+                        displayName: 'Maximum Number of Tokens',
+                        name: 'maxTokens',
+                        type: 'number',
+                        default: -1,
+                        description: 'Maximum tokens to generate in the completion. -1 lets the provider decide.',
+                        typeOptions: { maxValue: 128000 },
+                    },
+                    {
+                        displayName: 'Max Retries',
+                        name: 'maxRetries',
+                        type: 'number',
+                        default: 2,
+                        description: 'Maximum number of retries on failed requests',
+                    },
+                    {
+                        displayName: 'Presence Penalty',
+                        name: 'presencePenalty',
+                        type: 'number',
+                        typeOptions: { minValue: -2, maxValue: 2, numberPrecision: 1 },
+                        default: 0,
+                        description: 'Positive values penalize tokens that already appeared, increasing topic diversity',
+                    },
+                    {
+                        displayName: 'Sampling Temperature',
+                        name: 'temperature',
+                        type: 'number',
+                        typeOptions: { minValue: 0, maxValue: 2, numberPrecision: 1 },
+                        default: 0.7,
+                        description: 'Controls randomness. Lower is more deterministic, higher more creative.',
+                    },
+                    {
+                        displayName: 'Timeout (Ms)',
+                        name: 'timeout',
+                        type: 'number',
+                        default: 300000,
+                        description: 'Maximum request time in milliseconds',
+                    },
+                    {
+                        displayName: 'Top P',
+                        name: 'topP',
+                        type: 'number',
+                        typeOptions: { minValue: 0, maxValue: 1, numberPrecision: 1 },
+                        default: 1,
+                        description: 'Nucleus sampling: consider only tokens within this cumulative probability mass',
+                    },
+                ],
+            },
+        ],
+    };
+    methods = {
+        loadOptions: {
+            async getModels() {
+                // No public models-list endpoint on KIE yet — serve the curated
+                // list. Kept as a loadOptions method so a remote fetch can be
+                // dropped in here later without changing the node schema.
+                return KIE_MODELS.map(({ name, value }) => ({ name, value }));
+            },
+        },
+    };
+    async supplyData(itemIndex) {
+        const credentials = await this.getCredentials('kieAiApi');
+        const modelSlug = this.getNodeParameter('model', itemIndex);
+        const options = this.getNodeParameter('options', itemIndex, {});
+        const baseURL = (options.baseURL && options.baseURL.trim() !== ''
+            ? options.baseURL
+            : 'https://api.kie.ai/{model}/v1').replace('{model}', modelSlug);
+        const model = new openai_1.ChatOpenAI({
+            apiKey: credentials.apiKey,
+            model: modelSlug,
+            temperature: options.temperature,
+            topP: options.topP,
+            frequencyPenalty: options.frequencyPenalty,
+            presencePenalty: options.presencePenalty,
+            maxRetries: options.maxRetries ?? 2,
+            timeout: options.timeout ?? 300000,
+            ...(options.maxTokens && options.maxTokens > 0
+                ? { maxTokens: options.maxTokens }
+                : {}),
+            configuration: {
+                baseURL,
+            },
+        });
+        return {
+            response: model,
+        };
+    }
+}
+exports.LmChatKieAi = LmChatKieAi;

package/dist/nodes/LmChatKieAi/kieai.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60">
+  <rect width="60" height="60" rx="12" fill="#0F0F14"/>
+  <path d="M16 14v32h7V33.5l4-4.4L38.5 46H47L32 27.8 45.5 14h-8.9L23 28.6V14z" fill="#7C5CFF"/>
+  <circle cx="47" cy="15" r="5" fill="#00E5A0"/>
+</svg>

package/index.js

@@ -0,0 +1 @@
+module.exports = {};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@miskokodi/n8n-nodes-kie-ai",
+  "version": "0.1.0",
+  "description": "n8n community node: KIE.ai Chat Model — use KIE's discounted LLM APIs (Gemini, GPT, Claude, DeepSeek, Grok) as a language model provider for AI Agents and chains, just like the OpenRouter node.",
+  "keywords": [
+    "n8n-community-node-package",
+    "kie",
+    "kie.ai",
+    "llm",
+    "ai",
+    "langchain",
+    "chat-model"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Martin",
+    "email": "mconqueror17@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YOUR_GH_USER/n8n-nodes-kie-ai.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && npm run copy:assets",
+    "copy:assets": "node scripts/copy-assets.js",
+    "dev": "tsc --watch",
+    "lint": "eslint nodes credentials --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/KieAiApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/LmChatKieAi/LmChatKieAi.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "n8n-workflow": "^1.70.0",
+    "typescript": "^5.6.0"
+  },
+  "dependencies": {
+    "@langchain/openai": "^0.3.14"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}