n8n-nodes-apexapi 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# n8n-nodes-apexapi
+
+An [n8n](https://n8n.io) community node for [ApexApi](https://apexapi.dev) — call 14 AI providers
+(OpenAI, Anthropic, Google, Mistral, DeepSeek, Groq, and more) through one OpenAI-compatible API
+key. Switch any model from a single dropdown.
+
+## Installation
+
+**n8n (self-hosted):** Settings → Community Nodes → Install → `n8n-nodes-apexapi`.
+
+(n8n Cloud support requires verification — in progress.)
+
+## Credentials
+
+Create an ApexApi key at https://apexapi.dev/keys (starts with `ak-`). Add an **ApexApi account**
+credential in n8n and paste the key. The connection is tested against `GET /v1/models`.
+
+## Operations
+
+- **Chat → Message a Model** — send a prompt/messages to any chat model.
+- **Image → Generate Image** — generate images.
+- **Video → Generate Video** — generate a video (waits for completion by default) and **Get Result**
+  to poll a job by id.
+
+Each resource's **Model** dropdown is populated live from your account's available models.
+
+## Templates
+
+See the `templates/` folder for ready-to-import workflows (news → caption → post, prompt → image →
+post, and an AI Agent using ApexApi as its model).
+
+## License
+
+MIT

package/dist/credentials/ApexApiApi.credentials.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApexApiApi = void 0;
+const constants_1 = require("../shared/constants");
+class ApexApiApi {
+    constructor() {
+        this.name = 'apexApiApi';
+        this.displayName = 'ApexApi API';
+        this.documentationUrl = 'https://apexapi.dev/keys';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your ApexApi key (starts with "ak-"). Create one at apexapi.dev/keys.',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: constants_1.DEFAULT_BASE_URL,
+                description: 'ApexApi API base URL. Change only for self-hosted or staging.',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/models',
+            },
+        };
+    }
+}
+exports.ApexApiApi = ApexApiApi;

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/nodes/ApexApi/ApexApi.node.js

@@ -0,0 +1,262 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApexApi = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const chat_1 = require("../../shared/chat");
+const image_1 = require("../../shared/image");
+const video_1 = require("../../shared/video");
+const transport_1 = require("../../shared/transport");
+const loadOptions_1 = require("../../shared/loadOptions");
+class ApexApi {
+    constructor() {
+        this.description = {
+            displayName: 'ApexApi',
+            name: 'apexApi',
+            icon: 'file:apexapi.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Call 14 AI providers through one OpenAI-compatible ApexApi key',
+            defaults: { name: 'ApexApi' },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [{ name: 'apexApiApi', required: true }],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        { name: 'Chat', value: 'chat' },
+                        { name: 'Image', value: 'image' },
+                        { name: 'Video', value: 'video' },
+                    ],
+                    default: 'chat',
+                },
+                // ---- Chat ----
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ['chat'] } },
+                    options: [{ name: 'Message a Model', value: 'message', action: 'Message a model' }],
+                    default: 'message',
+                },
+                {
+                    displayName: 'Model Name or ID',
+                    name: 'model',
+                    type: 'options',
+                    description: 'Choose from the list of ApexApi chat models. Choose from the list, or specify an ID using an expression.',
+                    typeOptions: { loadOptionsMethod: 'getChatModels' },
+                    displayOptions: { show: { resource: ['chat'] } },
+                    default: '',
+                    required: true,
+                },
+                {
+                    displayName: 'Prompt',
+                    name: 'prompt',
+                    type: 'string',
+                    typeOptions: { rows: 4 },
+                    displayOptions: { show: { resource: ['chat'] } },
+                    default: '',
+                    description: 'The user message to send to the model',
+                },
+                {
+                    displayName: 'Options',
+                    name: 'options',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    displayOptions: { show: { resource: ['chat'] } },
+                    default: {},
+                    options: [
+                        { displayName: 'System Prompt', name: 'systemPrompt', type: 'string', default: '' },
+                        {
+                            displayName: 'Temperature',
+                            name: 'temperature',
+                            type: 'number',
+                            typeOptions: { minValue: 0, maxValue: 2, numberPrecision: 2 },
+                            default: 0.7,
+                        },
+                        { displayName: 'Max Tokens', name: 'maxTokens', type: 'number', default: 1024 },
+                    ],
+                },
+                // ---- Image ----
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ['image'] } },
+                    options: [{ name: 'Generate Image', value: 'generate', action: 'Generate an image' }],
+                    default: 'generate',
+                },
+                {
+                    displayName: 'Model Name or ID',
+                    name: 'model',
+                    type: 'options',
+                    description: 'Choose from the list of ApexApi image models. Choose from the list, or specify an ID using an expression.',
+                    typeOptions: { loadOptionsMethod: 'getImageModels' },
+                    displayOptions: { show: { resource: ['image'] } },
+                    default: '',
+                    required: true,
+                },
+                {
+                    displayName: 'Prompt',
+                    name: 'prompt',
+                    type: 'string',
+                    typeOptions: { rows: 3 },
+                    displayOptions: { show: { resource: ['image'] } },
+                    default: '',
+                    required: true,
+                },
+                {
+                    displayName: 'Options',
+                    name: 'options',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    displayOptions: { show: { resource: ['image'] } },
+                    default: {},
+                    options: [
+                        { displayName: 'Size', name: 'size', type: 'string', default: '1024x1024' },
+                        { displayName: 'Number of Images', name: 'n', type: 'number', default: 1 },
+                    ],
+                },
+                // ---- Video ----
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ['video'] } },
+                    options: [
+                        { name: 'Generate Video', value: 'generate', action: 'Generate a video' },
+                        { name: 'Get Result', value: 'getResult', action: 'Get a video job result' },
+                    ],
+                    default: 'generate',
+                },
+                {
+                    displayName: 'Model Name or ID',
+                    name: 'model',
+                    type: 'options',
+                    description: 'Choose from the list of ApexApi video models. Choose from the list, or specify an ID using an expression.',
+                    typeOptions: { loadOptionsMethod: 'getVideoModels' },
+                    displayOptions: { show: { resource: ['video'], operation: ['generate'] } },
+                    default: '',
+                    required: true,
+                },
+                {
+                    displayName: 'Prompt',
+                    name: 'prompt',
+                    type: 'string',
+                    typeOptions: { rows: 3 },
+                    displayOptions: { show: { resource: ['video'], operation: ['generate'] } },
+                    default: '',
+                    required: true,
+                },
+                {
+                    displayName: 'Job ID',
+                    name: 'jobId',
+                    type: 'string',
+                    displayOptions: { show: { resource: ['video'], operation: ['getResult'] } },
+                    default: '',
+                    required: true,
+                    description: 'The id returned by a previous Generate Video call',
+                },
+                {
+                    displayName: 'Options',
+                    name: 'options',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    displayOptions: { show: { resource: ['video'], operation: ['generate'] } },
+                    default: {},
+                    options: [
+                        { displayName: 'Wait for Completion', name: 'waitForCompletion', type: 'boolean', default: true },
+                        { displayName: 'Max Poll Seconds', name: 'maxPollSeconds', type: 'number', default: 300 },
+                        { displayName: 'Poll Interval Seconds', name: 'pollIntervalSeconds', type: 'number', default: 5 },
+                    ],
+                },
+            ],
+        };
+        this.methods = {
+            loadOptions: {
+                async getChatModels() {
+                    return (0, loadOptions_1.loadModels)(this, 'text');
+                },
+                async getImageModels() {
+                    return (0, loadOptions_1.loadModels)(this, 'image');
+                },
+                async getVideoModels() {
+                    return (0, loadOptions_1.loadModels)(this, 'video');
+                },
+            },
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        const ctx = this;
+        for (let i = 0; i < items.length; i++) {
+            try {
+                let json;
+                if (resource === 'chat') {
+                    const options = this.getNodeParameter('options', i, {});
+                    const body = (0, chat_1.buildChatBody)({
+                        model: this.getNodeParameter('model', i),
+                        prompt: this.getNodeParameter('prompt', i, ''),
+                        systemPrompt: options.systemPrompt,
+                        temperature: options.temperature,
+                        maxTokens: options.maxTokens,
+                    });
+                    const resp = await (0, transport_1.apexApiRequest)(ctx, 'POST', '/chat/completions', body);
+                    const parsed = (0, chat_1.parseChatResponse)(resp);
+                    json = { content: parsed.content, response: parsed.raw };
+                }
+                else if (resource === 'image') {
+                    const options = this.getNodeParameter('options', i, {});
+                    const body = (0, image_1.buildImageBody)({
+                        model: this.getNodeParameter('model', i),
+                        prompt: this.getNodeParameter('prompt', i),
+                        size: options.size,
+                        n: options.n,
+                    });
+                    const resp = await (0, transport_1.apexApiRequest)(ctx, 'POST', '/images/generations', body);
+                    const parsed = (0, image_1.parseImageResponse)(resp);
+                    json = { urls: parsed.urls, response: parsed.raw };
+                }
+                else {
+                    // video
+                    if (operation === 'getResult') {
+                        const jobId = this.getNodeParameter('jobId', i);
+                        json = (await (0, transport_1.apexApiRequest)(ctx, 'GET', `/videos/generations/${jobId}`));
+                    }
+                    else {
+                        const options = this.getNodeParameter('options', i, {});
+                        const body = (0, video_1.buildVideoBody)({
+                            model: this.getNodeParameter('model', i),
+                            prompt: this.getNodeParameter('prompt', i),
+                        });
+                        json = (await (0, transport_1.generateVideo)(ctx, body, {
+                            waitForCompletion: options.waitForCompletion ?? true,
+                            maxPollSeconds: options.maxPollSeconds ?? 300,
+                            pollIntervalSeconds: options.pollIntervalSeconds ?? 5,
+                        }));
+                    }
+                }
+                returnData.push({ json, pairedItem: { item: i } });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error instanceof Error ? error.message : String(error) }, pairedItem: { item: i } });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
+            }
+        }
+        return [returnData];
+    }
+}
+exports.ApexApi = ApexApi;

package/dist/nodes/ApexApi/apexapi.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect width="64" height="64" rx="12" fill="#0B0B0F"/>
+  <path d="M20 44 32 20 44 44" fill="none" stroke="#5B8CFF" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+  <line x1="25" y1="36" x2="39" y2="36" stroke="#5B8CFF" stroke-width="4" stroke-linecap="round"/>
+</svg>

package/dist/shared/chat.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildChatBody = buildChatBody;
+exports.parseChatResponse = parseChatResponse;
+function buildChatBody(params) {
+    const messages = [];
+    if (params.systemPrompt)
+        messages.push({ role: 'system', content: params.systemPrompt });
+    if (params.messages && params.messages.length > 0) {
+        messages.push(...params.messages);
+    }
+    else if (params.prompt) {
+        messages.push({ role: 'user', content: params.prompt });
+    }
+    const body = { model: params.model, messages, stream: false };
+    if (params.temperature !== undefined)
+        body.temperature = params.temperature;
+    if (params.maxTokens !== undefined)
+        body.max_tokens = params.maxTokens;
+    return body;
+}
+function parseChatResponse(resp) {
+    const r = resp;
+    const content = r?.choices?.[0]?.message?.content ?? '';
+    return { content, raw: resp };
+}

package/dist/shared/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CREDENTIAL_NAME = exports.DEFAULT_BASE_URL = void 0;
+exports.DEFAULT_BASE_URL = 'https://api.apexapi.dev/v1';
+exports.CREDENTIAL_NAME = 'apexApiApi';

package/dist/shared/image.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildImageBody = buildImageBody;
+exports.parseImageResponse = parseImageResponse;
+function buildImageBody(params) {
+    const body = { model: params.model, prompt: params.prompt };
+    if (params.size)
+        body.size = params.size;
+    if (params.n !== undefined)
+        body.n = params.n;
+    return body;
+}
+function parseImageResponse(resp) {
+    const r = resp;
+    const data = Array.isArray(r?.data) ? r.data : [];
+    const urls = data
+        .map((d) => d?.url)
+        .filter((u) => typeof u === 'string');
+    return { urls, raw: resp };
+}

package/dist/shared/loadOptions.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadModels = loadModels;
+const transport_1 = require("./transport");
+const models_1 = require("./models");
+async function loadModels(ctx, modelType) {
+    const resp = await (0, transport_1.apexApiRequest)(ctx, 'GET', '/models');
+    const data = Array.isArray(resp?.data) ? resp.data : [];
+    return (0, models_1.mapModelsToOptions)(data, modelType);
+}

package/dist/shared/models.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapModelsToOptions = mapModelsToOptions;
+/**
+ * Map the `/v1/models` `data` array to n8n dropdown options. When `modelType`
+ * is given, keep only models of that type (text/image/video); if that leaves
+ * nothing, fall back to all models rather than showing an empty dropdown.
+ */
+function mapModelsToOptions(models, modelType) {
+    const filtered = modelType ? models.filter((m) => m.type === modelType) : models;
+    const list = filtered.length > 0 ? filtered : models;
+    return list
+        .map((m) => ({
+        name: m.display_name ? `${m.display_name} (${m.id})` : m.id,
+        value: m.id,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}

package/dist/shared/transport.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apexApiRequest = apexApiRequest;
+exports.generateVideo = generateVideo;
+const constants_1 = require("./constants");
+const video_1 = require("./video");
+async function apexApiRequest(ctx, method, path, body) {
+    const creds = await ctx.getCredentials(constants_1.CREDENTIAL_NAME);
+    const baseUrl = String(creds.baseUrl || constants_1.DEFAULT_BASE_URL).replace(/\/+$/, '');
+    const options = { method, url: `${baseUrl}${path}`, json: true };
+    if (body !== undefined)
+        options.body = body;
+    return ctx.helpers.httpRequestWithAuthentication.call(ctx, constants_1.CREDENTIAL_NAME, options);
+}
+const defaultDeps = {
+    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+    now: () => Date.now(),
+};
+async function generateVideo(ctx, body, opts, deps = defaultDeps) {
+    const submit = await apexApiRequest(ctx, 'POST', '/videos/generations', body);
+    const jobId = submit?.id;
+    if (!opts.waitForCompletion || !jobId)
+        return submit;
+    const deadline = deps.now() + opts.maxPollSeconds * 1000;
+    let last = submit;
+    while (deps.now() < deadline) {
+        await deps.sleep(opts.pollIntervalSeconds * 1000);
+        last = await apexApiRequest(ctx, 'GET', `/videos/generations/${jobId}`);
+        if (typeof last?.status === 'string' && (0, video_1.isTerminalVideoStatus)(last.status)) {
+            return last;
+        }
+    }
+    return last;
+}

package/dist/shared/video.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildVideoBody = buildVideoBody;
+exports.isTerminalVideoStatus = isTerminalVideoStatus;
+function buildVideoBody(params) {
+    return { model: params.model, prompt: params.prompt };
+}
+const TERMINAL_STATUSES = new Set(['completed', 'failed']);
+function isTerminalVideoStatus(status) {
+    return TERMINAL_STATUSES.has(status);
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "n8n-nodes-apexapi",
+  "version": "0.1.0",
+  "description": "n8n community node for ApexApi — call 14 AI providers (OpenAI, Anthropic, Google, Mistral, and more) through one OpenAI-compatible API.",
+  "keywords": ["n8n-community-node-package", "apexapi", "ai", "llm", "openai", "anthropic", "gemini"],
+  "license": "MIT",
+  "homepage": "https://apexapi.dev",
+  "author": { "name": "ApexApi", "email": "support@apexapi.dev" },
+  "repository": { "type": "git", "url": "git+https://github.com/apexapi/apexapi.git" },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc && node scripts/build-icons.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "pnpm build"
+  },
+  "files": ["dist"],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": ["dist/credentials/ApexApiApi.credentials.js"],
+    "nodes": ["dist/nodes/ApexApi/ApexApi.node.js"]
+  },
+  "peerDependencies": { "n8n-workflow": "*" },
+  "devDependencies": {
+    "n8n-workflow": "^1.82.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}