n8n-nodes-commandos-image 0.1.4

package/README.md

@@ -0,0 +1,85 @@
+# Commandos Image (кастомная нода n8n)
+
+Кастомная нода для создания задач генерации изображений через Commandos API. Пользователь вводит лицензионный ключ (Credentials), выбирает модель и параметры. Нода формирует payload, отправляет задачу в API и возвращает `taskId`.
+
+## Где находится
+
+- Код ноды: `/root/sandbox/nodes/image`
+- Пакет: `n8n-nodes-commandos-image`
+
+## Требования
+
+- n8n (dev окружение)
+- Node.js 18+
+- Доступ к Commandos API
+
+## Подключение в n8n-dev
+
+В `docker-compose` уже настроено:
+
+- монтирование `/root/sandbox/nodes` в `/custom/commandos`
+- переменная `N8N_CUSTOM_EXTENSIONS=/custom/commandos`
+
+Если переносите в другое окружение, убедитесь, что путь задан корректно и n8n перезапущен.
+
+## Credentials
+
+Тип: `Commandos API`
+
+Поля:
+- `License Key` — передаётся как `X-License-Key`.
+
+## Операции
+
+### Create Task
+
+Создаёт задачу в API (`POST /tasks`, `process_type=IMAGE_GENERATION`). Нода сама формирует:
+
+- `url` для генерации
+- `body` для выбранной модели
+
+Входные поля:
+- `Model`: Flux Pro, GPT-4o Image, Nano Banana, Nano Banana Pro, Seedream, Midjourney
+- `Prompt`
+- `Ratio`: `1:1`, `2:3`, `3:2`, `4:5`, `16:9`, `9:16`
+- `References`: до 2 URL (опционально)
+
+Выход:
+- `taskId`, `status`, `pollUrl`
+
+### Check Status
+
+Запрашивает статус по `taskId` (`GET /tasks/:taskId`).
+
+## Базовый URL API
+
+Нода всегда использует `https://api.comandos.ai`.
+
+## Переменные окружения (URL генерации)
+
+Нода берёт URL генерации из переменных окружения:
+
+- `COMMANDOS_IMAGE_URL_DEFAULT`
+- `COMMANDOS_IMAGE_URL_GPT4O` (опционально)
+- `COMMANDOS_IMAGE_URL_MJ` (опционально)
+
+Если специальные URL не заданы, используется `COMMANDOS_IMAGE_URL_DEFAULT`.
+
+## Пример workflow
+
+1. **Commandos Image** → `Create Task`
+2. **Wait** (20–60 секунд)
+3. **Commandos Image** → `Check Status` (`{{$json.taskId}}`)
+
+## Сборка
+
+```bash
+npm install
+npm run build
+```
+
+После изменений всегда пересобирайте `dist` и перезапускайте n8n.
+
+## Иконка
+
+Файл иконки: `Image.png` (копируется в `dist/nodes` при сборке).

package/credentials/CommandosApi.credentials.ts

@@ -0,0 +1,19 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+
+export class CommandosApi implements ICredentialType {
+  name = 'commandosApi';
+  displayName = 'Commandos API';
+  documentationUrl = 'https://api.comandos.ai';
+  properties: INodeProperties[] = [
+    {
+      displayName: 'License Key',
+      name: 'licenseKey',
+      type: 'string',
+      default: '',
+      required: true,
+      typeOptions: {
+        password: true,
+      },
+    },
+  ];
+}

package/dist/credentials/CommandosApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class CommandosApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/CommandosApi.credentials.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandosApi = void 0;
+class CommandosApi {
+    constructor() {
+        this.name = 'commandosApi';
+        this.displayName = 'Commandos API';
+        this.documentationUrl = 'https://api.comandos.ai';
+        this.properties = [
+            {
+                displayName: 'License Key',
+                name: 'licenseKey',
+                type: 'string',
+                default: '',
+                required: true,
+                typeOptions: {
+                    password: true,
+                },
+            },
+        ];
+    }
+}
+exports.CommandosApi = CommandosApi;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { CommandosImage } from './nodes/CommandosImage.node';
+import { CommandosApi } from './credentials/CommandosApi.credentials';
+export { CommandosImage, CommandosApi };

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandosApi = exports.CommandosImage = void 0;
+const CommandosImage_node_1 = require("./nodes/CommandosImage.node");
+Object.defineProperty(exports, "CommandosImage", { enumerable: true, get: function () { return CommandosImage_node_1.CommandosImage; } });
+const CommandosApi_credentials_1 = require("./credentials/CommandosApi.credentials");
+Object.defineProperty(exports, "CommandosApi", { enumerable: true, get: function () { return CommandosApi_credentials_1.CommandosApi; } });

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

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class CommandosImage implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/CommandosImage.node.js

@@ -0,0 +1,335 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandosImage = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const COMMANDOS_API_URL = 'https://api.comandos.ai';
+const GENERATION_URL_DEFAULT = String(process.env.COMMANDOS_IMAGE_URL_DEFAULT || '').trim();
+const GENERATION_URL_GPT4O = String(process.env.COMMANDOS_IMAGE_URL_GPT4O || '').trim();
+const GENERATION_URL_MJ = String(process.env.COMMANDOS_IMAGE_URL_MJ || '').trim();
+const resolveGenerationUrl = (resolvedModel) => {
+    if (resolvedModel === 'gpt4o-image') {
+        return GENERATION_URL_GPT4O || GENERATION_URL_DEFAULT;
+    }
+    if (resolvedModel === 'midjourney') {
+        return GENERATION_URL_MJ || GENERATION_URL_DEFAULT;
+    }
+    return GENERATION_URL_DEFAULT;
+};
+const buildGenerationRequest = ({ model, prompt, ratio, references }) => {
+    const hasReferences = references.length > 0;
+    const requestedModel = model;
+    let resolvedModel = model;
+    if (requestedModel === 'flux-pro') {
+        resolvedModel = hasReferences ? 'flux-2/pro-image-to-image' : 'flux-2/pro-text-to-image';
+    }
+    else if (requestedModel === 'nano-banana') {
+        resolvedModel = hasReferences ? 'google/nano-banana-edit' : 'google/nano-banana';
+    }
+    else if (requestedModel === 'nano-banana-pro') {
+        resolvedModel = 'nano-banana-pro';
+    }
+    else if (requestedModel === 'seedream') {
+        resolvedModel = 'bytedance/seedream-v4-edit';
+    }
+    if (!hasReferences && (requestedModel === 'seedream' || requestedModel === 'midjourney')) {
+        if (requestedModel !== 'midjourney') {
+            resolvedModel = 'gpt4o-image';
+        }
+    }
+    let body = {};
+    if (resolvedModel === 'gpt4o-image') {
+        body = {
+            filesUrl: references,
+            prompt,
+            size: ratio,
+            callBackUrl: 'https://your-callback-url.com/callback',
+            fallbackModel: 'FLUX_MAX',
+        };
+    }
+    else if (resolvedModel.includes('flux-2/')) {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: ratio,
+                resolution: '1K',
+                ...(hasReferences ? { input_urls: references } : {}),
+            },
+        };
+    }
+    else if (resolvedModel === 'nano-banana-pro') {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: ratio,
+                resolution: '1K',
+                output_format: 'png',
+                ...(hasReferences ? { image_input: references } : {}),
+            },
+        };
+    }
+    else if (resolvedModel.includes('google/nano-banana')) {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                image_size: ratio,
+                output_format: 'png',
+                ...(hasReferences ? { image_urls: references } : {}),
+            },
+        };
+    }
+    else if (resolvedModel === 'midjourney') {
+        body = {
+            taskType: hasReferences ? 'mj_img2img' : 'mj_txt2img',
+            speed: 'fast',
+            prompt,
+            fileUrls: references,
+            aspectRatio: ratio,
+            enableTranslation: true,
+        };
+    }
+    else {
+        body = {
+            model: 'bytedance/seedream-v4-edit',
+            input: {
+                image_urls: references,
+                prompt,
+                image_size: ratio === '2:3' ? 'portrait_3_2' : ratio,
+                image_resolution: '1K',
+            },
+        };
+    }
+    return {
+        url: resolveGenerationUrl(resolvedModel),
+        body,
+        requestedModel,
+        resolvedModel,
+        ratio,
+        references,
+        hasReferences,
+    };
+};
+const extractReferences = (raw) => {
+    if (!raw || typeof raw !== 'object') {
+        return [];
+    }
+    const collection = raw;
+    const items = Array.isArray(collection.reference) ? collection.reference : [];
+    return items
+        .map((entry) => String((entry === null || entry === void 0 ? void 0 : entry.url) || '').trim())
+        .filter((value) => value.length > 0 && /^https?:\/\//i.test(value))
+        .slice(0, 2);
+};
+class CommandosImage {
+    constructor() {
+        this.description = {
+            displayName: 'Commandos Image',
+            name: 'commandosImage',
+            group: ['transform'],
+            version: 1,
+            description: 'Create image tasks in Commandos API',
+            defaults: {
+                name: 'Commandos Image',
+            },
+            icon: 'file:Image.png',
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'commandosApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Create Task',
+                            value: 'create',
+                        },
+                        {
+                            name: 'Check Status',
+                            value: 'status',
+                        },
+                    ],
+                    default: 'create',
+                },
+                {
+                    displayName: 'Model',
+                    name: 'model',
+                    type: 'options',
+                    options: [
+                        { name: 'Flux Pro', value: 'flux-pro' },
+                        { name: 'GPT-4o Image', value: 'gpt4o-image' },
+                        { name: 'Nano Banana', value: 'nano-banana' },
+                        { name: 'Nano Banana Pro', value: 'nano-banana-pro' },
+                        { name: 'Seedream', value: 'seedream' },
+                        { name: 'Midjourney', value: 'midjourney' },
+                    ],
+                    default: 'flux-pro',
+                    displayOptions: {
+                        show: {
+                            operation: ['create'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Prompt',
+                    name: 'prompt',
+                    type: 'string',
+                    default: '',
+                    typeOptions: {
+                        rows: 4,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['create'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Ratio',
+                    name: 'ratio',
+                    type: 'options',
+                    options: [
+                        { name: '1:1', value: '1:1' },
+                        { name: '2:3', value: '2:3' },
+                        { name: '3:2', value: '3:2' },
+                        { name: '4:5', value: '4:5' },
+                        { name: '16:9', value: '16:9' },
+                        { name: '9:16', value: '9:16' },
+                    ],
+                    default: '2:3',
+                    displayOptions: {
+                        show: {
+                            operation: ['create'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'References',
+                    name: 'references',
+                    type: 'fixedCollection',
+                    default: {},
+                    typeOptions: {
+                        multipleValues: true,
+                    },
+                    options: [
+                        {
+                            name: 'reference',
+                            displayName: 'Reference',
+                            values: [
+                                {
+                                    displayName: 'Reference URL',
+                                    name: 'url',
+                                    type: 'string',
+                                    default: '',
+                                },
+                            ],
+                        },
+                    ],
+                    displayOptions: {
+                        show: {
+                            operation: ['create'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Task ID',
+                    name: 'taskId',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            operation: ['status'],
+                        },
+                    },
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const operation = this.getNodeParameter('operation', 0);
+        const credentials = await this.getCredentials('commandosApi');
+        const licenseKey = String(credentials.licenseKey || '').trim();
+        if (!licenseKey) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'License key is required');
+        }
+        const results = [];
+        for (let i = 0; i < items.length; i += 1) {
+            try {
+                if (operation === 'create') {
+                    const model = String(this.getNodeParameter('model', i));
+                    const prompt = String(this.getNodeParameter('prompt', i) || '').trim();
+                    const ratio = String(this.getNodeParameter('ratio', i));
+                    const references = extractReferences(this.getNodeParameter('references', i, {}));
+                    if (!prompt) {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Prompt is required', { itemIndex: i });
+                    }
+                    const request = buildGenerationRequest({ model, prompt, ratio, references });
+                    if (!request.url) {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'URL генерации не настроен. Проверь переменные окружения COMMANDOS_IMAGE_URL_DEFAULT/COMMANDOS_IMAGE_URL_GPT4O/COMMANDOS_IMAGE_URL_MJ', { itemIndex: i });
+                    }
+                    const payload = {
+                        url: request.url,
+                        body: request.body,
+                        requestedModel: request.requestedModel,
+                        resolvedModel: request.resolvedModel,
+                        ratio: request.ratio,
+                        references: request.references,
+                        hasReferences: request.hasReferences,
+                    };
+                    const response = await this.helpers.request({
+                        method: 'POST',
+                        url: `${COMMANDOS_API_URL}/tasks`,
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'X-License-Key': licenseKey,
+                        },
+                        body: {
+                            process_type: 'IMAGE_GENERATION',
+                            payload,
+                        },
+                        json: true,
+                    });
+                    results.push({ json: response });
+                }
+                else if (operation === 'status') {
+                    const taskId = String(this.getNodeParameter('taskId', i) || '').trim();
+                    if (!taskId) {
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Task ID is required', { itemIndex: i });
+                    }
+                    const response = await this.helpers.request({
+                        method: 'GET',
+                        url: `${COMMANDOS_API_URL}/tasks/${encodeURIComponent(taskId)}`,
+                        headers: {
+                            'X-License-Key': licenseKey,
+                        },
+                        json: true,
+                    });
+                    results.push({ json: response });
+                }
+                else {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`, {
+                        itemIndex: i,
+                    });
+                }
+            }
+            catch (error) {
+                if (error instanceof n8n_workflow_1.NodeOperationError) {
+                    throw error;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Request failed', { itemIndex: i });
+            }
+        }
+        return [results];
+    }
+}
+exports.CommandosImage = CommandosImage;