@comandosai/n8n-nodes-media 0.1.2

package/README.md

@@ -0,0 +1,86 @@
+# Comandos Media (кастомная нода n8n)
+
+Кастомная нода для создания задач генерации изображений и видео через Commandos API.
+
+## Где находится
+
+- Код ноды: `/root/sandbox/nodes/image`
+- Пакет: `@comandosai/n8n-nodes-media`
+
+
+## Требования
+
+- 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/ComandosApi.credentials.ts

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

package/dist/credentials/ComandosApi.credentials.d.ts

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

package/dist/credentials/ComandosApi.credentials.js

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

package/dist/index.d.ts

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

package/dist/index.js

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

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

@@ -0,0 +1,9 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class ComandosImage implements INodeType {
+    displayName: 'Comandos Media';
+    name: 'comandosMedia';
+    group: ['transform'];
+    version: 1;
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/ComandosImage.node.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComandosImage = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const COMANDOS_API_URL = String(process.env.COMANDOS_API_BASE_URL || process.env.COMMANDOS_API_BASE_URL || "https://api.comandos.ai").trim();
+const GENERATION_URL_DEFAULT = String(process.env.COMANDOS_IMAGE_URL_DEFAULT || process.env.COMMANDOS_IMAGE_URL_DEFAULT || "").trim();
+const GENERATION_URL_MJ = String(process.env.COMANDOS_IMAGE_URL_MJ || process.env.COMMANDOS_IMAGE_URL_MJ || "").trim();
+const resolveGenerationUrl = (resolvedModel) => {
+    if (resolvedModel === 'midjourney') {
+        return GENERATION_URL_MJ || GENERATION_URL_DEFAULT;
+    }
+    return GENERATION_URL_DEFAULT;
+};
+const mapRatio = (model, ratio) => {
+    const isSeedream = model.includes('seedream');
+    if (isSeedream) {
+        if (ratio === '2:3')
+            return 'portrait_3_2';
+        if (ratio === '3:2')
+            return 'landscape_2_3';
+    }
+    return ratio;
+};
+const buildGenerationRequest = ({ model, prompt, ratio, references, quality = 'basic', resolution = '1K', }) => {
+    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 = hasReferences ? 'seedream/4.5-edit' : 'seedream/4.5';
+    }
+    if (!hasReferences && (requestedModel === 'seedream' || requestedModel === 'midjourney')) {
+        if (requestedModel === 'midjourney') {
+            resolvedModel = 'midjourney';
+        }
+    }
+    let body = {};
+    if (resolvedModel.includes('flux-2/')) {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: ratio,
+                resolution,
+                output_format: 'jpeg', // Force lightweight
+                ...(hasReferences ? { input_urls: references } : {}),
+            },
+        };
+    }
+    else if (resolvedModel === 'seedream/4.5' || resolvedModel === 'seedream/4.5-edit') {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: mapRatio(resolvedModel, ratio),
+                quality,
+                output_format: 'jpeg', // Force lightweight
+                ...(hasReferences ? { image_urls: references } : {}),
+            },
+        };
+    }
+    else if (resolvedModel === 'nano-banana-pro') {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: ratio,
+                resolution,
+                output_format: 'jpg', // Force lightweight
+                ...(hasReferences ? { image_input: references } : {}),
+            },
+        };
+    }
+    else if (resolvedModel.includes('google/nano-banana')) {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                image_size: ratio,
+                output_format: 'jpeg', // Force lightweight
+                ...(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: mapRatio('seedream', ratio),
+                output_format: 'jpeg',
+            },
+        };
+    }
+    return {
+        url: resolveGenerationUrl(resolvedModel),
+        body,
+        requestedModel,
+        resolvedModel,
+        ratio,
+        references,
+        hasReferences,
+    };
+};
+const extractReferences = (raw, model) => {
+    if (!raw || typeof raw !== 'object')
+        return [];
+    const collection = raw;
+    const items = Array.isArray(collection.reference) ? collection.reference : [];
+    let limit = 8;
+    if (model === 'seedream')
+        limit = 14;
+    if (model.includes('nano-banana'))
+        limit = 10;
+    return items.map((entry) => String((entry === null || entry === void 0 ? void 0 : entry.url) || '').trim()).filter((v) => v.length > 0 && /^https?:\/\//i.test(v)).slice(0, limit);
+};
+class ComandosImage {
+    constructor() {
+        this.description = {
+            displayName: 'Comandos Media',
+            name: 'comandosMedia',
+            group: ['transform'],
+            version: 1,
+            description: 'Create image or video tasks in Comandos API',
+            defaults: { name: 'Comandos Image' },
+            icon: 'file:Image.png',
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [{ name: 'comandosApi', 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: 'Seedream 4.5', value: 'seedream' },
+                        { name: 'Flux Pro', value: 'flux-pro' },
+                        { name: 'Nano Banana', value: 'nano-banana' },
+                        { name: 'Nano Banana Pro', value: 'nano-banana-pro' },
+                        { name: 'Midjourney', value: 'midjourney' },
+                    ],
+                    default: 'seedream',
+                    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' },
+                        { name: '4:3', value: '4:3' },
+                        { name: '3:4', value: '3:4' },
+                        { name: '21:9', value: '21:9' },
+                    ],
+                    default: '2:3',
+                    displayOptions: {
+                        show: { operation: ['create'] },
+                    },
+                },
+                {
+                    displayName: 'Quality',
+                    name: 'quality',
+                    type: 'options',
+                    options: [
+                        { name: 'Basic (2K)', value: 'basic' },
+                        { name: 'High (4K)', value: 'high' },
+                        { name: 'Medium (Balanced)', value: 'medium' },
+                    ],
+                    default: 'basic',
+                    displayOptions: {
+                        show: { operation: ['create'], model: ['seedream', 'flux-pro'] },
+                    },
+                },
+                {
+                    displayName: 'Resolution',
+                    name: 'resolution',
+                    type: 'options',
+                    options: [
+                        { name: '1K', value: '1K' },
+                        { name: '2K', value: '2K' },
+                        { name: '4K', value: '4K' },
+                    ],
+                    default: '1K',
+                    displayOptions: {
+                        show: { operation: ['create'], model: ['flux-pro', 'nano-banana-pro'] },
+                    },
+                },
+                {
+                    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('comandosApi');
+        const licenseKey = String(credentials.licenseKey || '').trim();
+        const kieApiKey = String(credentials.kieApiKey || '').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, {}), model);
+                    const quality = ['seedream', 'flux-pro'].includes(model) ? String(this.getNodeParameter('quality', i, 'basic')) : 'basic';
+                    const resolution = ['flux-pro', 'nano-banana-pro'].includes(model) ? String(this.getNodeParameter('resolution', i, '1K')) : '1K';
+                    if (!prompt)
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Prompt is required', { itemIndex: i });
+                    const request = buildGenerationRequest({ model, prompt, ratio, references, quality, resolution });
+                    const payload = { ...request, licenseKey, _v: '0.1.0' };
+                    const response = await this.helpers.request({
+                        method: 'POST',
+                        url: `${COMANDOS_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: `${COMANDOS_API_URL}/tasks/${encodeURIComponent(taskId)}`,
+                        headers: { 'X-License-Key': licenseKey },
+                        json: true,
+                    });
+                    results.push({ json: response });
+                }
+            }
+            catch (error) {
+                if (error instanceof n8n_workflow_1.NodeOperationError)
+                    throw error;
+                const message = error instanceof Error ? error.message : 'Request failed';
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), message, { itemIndex: i });
+            }
+        }
+        return [results];
+    }
+}
+exports.ComandosImage = ComandosImage;

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

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

package/dist/nodes/ComandosMedia.node.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComandosMedia = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const COMANDOS_API_URL = String(process.env.COMANDOS_API_BASE_URL || process.env.COMMANDOS_API_BASE_URL || "https://api.comandos.ai").trim();
+const GENERATION_URL_DEFAULT = String(process.env.COMANDOS_IMAGE_URL_DEFAULT || process.env.COMMANDOS_IMAGE_URL_DEFAULT || "").trim();
+const GENERATION_URL_MJ = String(process.env.COMANDOS_IMAGE_URL_MJ || process.env.COMMANDOS_IMAGE_URL_MJ || "").trim();
+const resolveGenerationUrl = (resolvedModel) => {
+    if (resolvedModel === 'midjourney') {
+        return GENERATION_URL_MJ || GENERATION_URL_DEFAULT;
+    }
+    return GENERATION_URL_DEFAULT;
+};
+const mapRatio = (model, ratio) => {
+    const isSeedream = model.includes('seedream');
+    if (isSeedream) {
+        if (ratio === '2:3')
+            return 'portrait_3_2';
+        if (ratio === '3:2')
+            return 'landscape_2_3';
+    }
+    return ratio;
+};
+const buildGenerationRequest = ({ model, prompt, ratio, references, quality = 'basic', resolution = '1K', }) => {
+    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 = hasReferences ? 'seedream/4.5-edit' : 'seedream/4.5';
+    }
+    if (!hasReferences && (requestedModel === 'seedream' || requestedModel === 'midjourney')) {
+        if (requestedModel === 'midjourney') {
+            resolvedModel = 'midjourney';
+        }
+    }
+    let body = {};
+    if (resolvedModel.includes('flux-2/')) {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: ratio,
+                resolution,
+                output_format: 'jpeg', // Force lightweight
+                ...(hasReferences ? { input_urls: references } : {}),
+            },
+        };
+    }
+    else if (resolvedModel === 'seedream/4.5' || resolvedModel === 'seedream/4.5-edit') {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: mapRatio(resolvedModel, ratio),
+                quality,
+                output_format: 'jpeg', // Force lightweight
+                ...(hasReferences ? { image_urls: references } : {}),
+            },
+        };
+    }
+    else if (resolvedModel === 'nano-banana-pro') {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: ratio,
+                resolution,
+                output_format: 'jpg', // Force lightweight
+                ...(hasReferences ? { image_input: references } : {}),
+            },
+        };
+    }
+    else if (resolvedModel.includes('google/nano-banana')) {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                image_size: ratio,
+                output_format: 'jpeg', // Force lightweight
+                ...(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: mapRatio('seedream', ratio),
+                output_format: 'jpeg',
+            },
+        };
+    }
+    return {
+        url: resolveGenerationUrl(resolvedModel),
+        body,
+        requestedModel,
+        resolvedModel,
+        ratio,
+        references,
+        hasReferences,
+    };
+};
+const extractReferences = (raw, model) => {
+    if (!raw || typeof raw !== 'object')
+        return [];
+    const collection = raw;
+    const items = Array.isArray(collection.reference) ? collection.reference : [];
+    let limit = 8;
+    if (model === 'seedream')
+        limit = 14;
+    if (model.includes('nano-banana'))
+        limit = 10;
+    return items.map((entry) => String((entry === null || entry === void 0 ? void 0 : entry.url) || '').trim()).filter((v) => v.length > 0 && /^https?:\/\//i.test(v)).slice(0, limit);
+};
+class ComandosMedia {
+    constructor() {
+        this.description = {
+            displayName: 'Comandos Media',
+            name: 'comandosMedia',
+            group: ['transform'],
+            version: 1,
+            description: 'Create image or video tasks in Comandos API',
+            defaults: { name: 'Comandos Media' },
+            icon: 'file:Media.png',
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [{ name: 'comandosApi', 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: 'Seedream 4.5', value: 'seedream' },
+                        { name: 'Flux Pro', value: 'flux-pro' },
+                        { name: 'Nano Banana', value: 'nano-banana' },
+                        { name: 'Nano Banana Pro', value: 'nano-banana-pro' },
+                        { name: 'Midjourney', value: 'midjourney' },
+                    ],
+                    default: 'seedream',
+                    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' },
+                        { name: '4:3', value: '4:3' },
+                        { name: '3:4', value: '3:4' },
+                        { name: '21:9', value: '21:9' },
+                    ],
+                    default: '2:3',
+                    displayOptions: {
+                        show: { operation: ['create'] },
+                    },
+                },
+                {
+                    displayName: 'Quality',
+                    name: 'quality',
+                    type: 'options',
+                    options: [
+                        { name: 'Basic (2K)', value: 'basic' },
+                        { name: 'High (4K)', value: 'high' },
+                        { name: 'Medium (Balanced)', value: 'medium' },
+                    ],
+                    default: 'basic',
+                    displayOptions: {
+                        show: { operation: ['create'], model: ['seedream', 'flux-pro'] },
+                    },
+                },
+                {
+                    displayName: 'Resolution',
+                    name: 'resolution',
+                    type: 'options',
+                    options: [
+                        { name: '1K', value: '1K' },
+                        { name: '2K', value: '2K' },
+                        { name: '4K', value: '4K' },
+                    ],
+                    default: '1K',
+                    displayOptions: {
+                        show: { operation: ['create'], model: ['flux-pro', 'nano-banana-pro'] },
+                    },
+                },
+                {
+                    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('comandosApi');
+        const licenseKey = String(credentials.licenseKey || '').trim();
+        const kieApiKey = String(credentials.kieApiKey || '').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, {}), model);
+                    const quality = ['seedream', 'flux-pro'].includes(model) ? String(this.getNodeParameter('quality', i, 'basic')) : 'basic';
+                    const resolution = ['flux-pro', 'nano-banana-pro'].includes(model) ? String(this.getNodeParameter('resolution', i, '1K')) : '1K';
+                    if (!prompt)
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Prompt is required', { itemIndex: i });
+                    const request = buildGenerationRequest({ model, prompt, ratio, references, quality, resolution });
+                    const payload = { ...request, licenseKey, kieApiKey, _v: '0.1.0' };
+                    const response = await this.helpers.request({
+                        method: 'POST',
+                        url: `${COMANDOS_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: `${COMANDOS_API_URL}/tasks/${encodeURIComponent(taskId)}`,
+                        headers: { 'X-License-Key': licenseKey },
+                        json: true,
+                    });
+                    results.push({ json: response });
+                }
+            }
+            catch (error) {
+                if (error instanceof n8n_workflow_1.NodeOperationError)
+                    throw error;
+                const message = error instanceof Error ? error.message : 'Request failed';
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), message, { itemIndex: i });
+            }
+        }
+        return [results];
+    }
+}
+exports.ComandosMedia = ComandosMedia;

package/image-payload.json

@@ -0,0 +1,3 @@
+{
+  "note": "Example payload template for Commandos Image."
+}

package/index.ts

@@ -0,0 +1,4 @@
+import { ComandosMedia } from './nodes/ComandosMedia.node';
+import { ComandosApi } from './credentials/ComandosApi.credentials';
+
+export { ComandosMedia, ComandosApi };

package/nodes/ComandosMedia.node.ts

@@ -0,0 +1,334 @@
+import type {
+    IDataObject,
+    IExecuteFunctions,
+    INodeExecutionData,
+    INodeType,
+    INodeTypeDescription,
+} from 'n8n-workflow';
+import { NodeOperationError } from 'n8n-workflow';
+
+const COMANDOS_API_URL = String(process.env.COMANDOS_API_BASE_URL || process.env.COMMANDOS_API_BASE_URL || "https://api.comandos.ai").trim();
+const GENERATION_URL_DEFAULT = String(process.env.COMANDOS_IMAGE_URL_DEFAULT || process.env.COMMANDOS_IMAGE_URL_DEFAULT || "").trim();
+const GENERATION_URL_MJ = String(process.env.COMANDOS_IMAGE_URL_MJ || process.env.COMMANDOS_IMAGE_URL_MJ || "").trim();
+
+type BuildParams = {
+    model: string;
+    prompt: string;
+    ratio: string;
+    references: string[];
+    quality?: string;
+    resolution?: string;
+};
+
+type BuildResult = {
+    url: string;
+    body: Record<string, unknown>;
+    requestedModel: string;
+    resolvedModel: string;
+    ratio: string;
+    references: string[];
+    hasReferences: boolean;
+};
+
+const resolveGenerationUrl = (resolvedModel: string): string => {
+    if (resolvedModel === 'midjourney') {
+        return GENERATION_URL_MJ || GENERATION_URL_DEFAULT;
+    }
+    return GENERATION_URL_DEFAULT;
+};
+
+const mapRatio = (model: string, ratio: string): string => {
+    const isSeedream = model.includes('seedream');
+
+    if (isSeedream) {
+        if (ratio === '2:3') return 'portrait_3_2';
+        if (ratio === '3:2') return 'landscape_2_3';
+    }
+
+    return ratio;
+};
+
+const buildGenerationRequest = ({
+    model,
+    prompt,
+    ratio,
+    references,
+    quality = 'basic',
+    resolution = '1K',
+}: BuildParams): BuildResult => {
+    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 = hasReferences ? 'seedream/4.5-edit' : 'seedream/4.5';
+    }
+
+    if (!hasReferences && (requestedModel === 'seedream' || requestedModel === 'midjourney')) {
+        if (requestedModel === 'midjourney') {
+            resolvedModel = 'midjourney';
+        }
+    }
+
+    let body: Record<string, unknown> = {};
+
+    if (resolvedModel.includes('flux-2/')) {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: ratio,
+                resolution,
+                output_format: 'jpeg', // Force lightweight
+                ...(hasReferences ? { input_urls: references } : {}),
+            },
+        };
+    } else if (resolvedModel === 'seedream/4.5' || resolvedModel === 'seedream/4.5-edit') {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: mapRatio(resolvedModel, ratio),
+                quality,
+                output_format: 'jpeg', // Force lightweight
+                ...(hasReferences ? { image_urls: references } : {}),
+            },
+        };
+    } else if (resolvedModel === 'nano-banana-pro') {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                aspect_ratio: ratio,
+                resolution,
+                output_format: 'jpg', // Force lightweight
+                ...(hasReferences ? { image_input: references } : {}),
+            },
+        };
+    } else if (resolvedModel.includes('google/nano-banana')) {
+        body = {
+            model: resolvedModel,
+            input: {
+                prompt,
+                image_size: ratio,
+                output_format: 'jpeg', // Force lightweight
+                ...(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: mapRatio('seedream', ratio),
+                output_format: 'jpeg',
+            },
+        };
+    }
+
+    return {
+        url: resolveGenerationUrl(resolvedModel),
+        body,
+        requestedModel,
+        resolvedModel,
+        ratio,
+        references,
+        hasReferences,
+    };
+};
+
+const extractReferences = (raw: unknown, model: string): string[] => {
+    if (!raw || typeof raw !== 'object') return [];
+    const collection = raw as { reference?: Array<{ url?: string }> };
+    const items = Array.isArray(collection.reference) ? collection.reference : [];
+    let limit = 8;
+    if (model === 'seedream') limit = 14;
+    if (model.includes('nano-banana')) limit = 10;
+    return items.map((entry) => String(entry?.url || '').trim()).filter((v) => v.length > 0 && /^https?:\/\//i.test(v)).slice(0, limit);
+};
+
+export class ComandosMedia implements INodeType {
+    description: INodeTypeDescription = {
+        displayName: 'Comandos Media',
+        name: 'comandosMedia',
+        group: ['transform'],
+        version: 1,
+        description: 'Create image or video tasks in Comandos API',
+        defaults: { name: 'Comandos Media' },
+        icon: 'file:Media.png',
+        inputs: ['main'],
+        outputs: ['main'],
+        credentials: [{ name: 'comandosApi', 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: 'Seedream 4.5', value: 'seedream' },
+                    { name: 'Flux Pro', value: 'flux-pro' },
+                    { name: 'Nano Banana', value: 'nano-banana' },
+                    { name: 'Nano Banana Pro', value: 'nano-banana-pro' },
+                    { name: 'Midjourney', value: 'midjourney' },
+                ],
+                default: 'seedream',
+                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' },
+                    { name: '4:3', value: '4:3' },
+                    { name: '3:4', value: '3:4' },
+                    { name: '21:9', value: '21:9' },
+                ],
+                default: '2:3',
+                displayOptions: {
+                    show: { operation: ['create'] },
+                },
+            },
+            {
+                displayName: 'Quality',
+                name: 'quality',
+                type: 'options',
+                options: [
+                    { name: 'Basic (2K)', value: 'basic' },
+                    { name: 'High (4K)', value: 'high' },
+                    { name: 'Medium (Balanced)', value: 'medium' },
+                ],
+                default: 'basic',
+                displayOptions: {
+                    show: { operation: ['create'], model: ['seedream', 'flux-pro'] },
+                },
+            },
+            {
+                displayName: 'Resolution',
+                name: 'resolution',
+                type: 'options',
+                options: [
+                    { name: '1K', value: '1K' },
+                    { name: '2K', value: '2K' },
+                    { name: '4K', value: '4K' },
+                ],
+                default: '1K',
+                displayOptions: {
+                    show: { operation: ['create'], model: ['flux-pro', 'nano-banana-pro'] },
+                },
+            },
+            {
+                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(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+        const items = this.getInputData();
+        const operation = this.getNodeParameter('operation', 0) as string;
+        const credentials = await this.getCredentials('comandosApi');
+        const licenseKey = String(credentials.licenseKey || '').trim();
+        const kieApiKey = String(credentials.kieApiKey || '').trim();
+        if (!licenseKey) throw new NodeOperationError(this.getNode(), 'License key is required');
+        const results: INodeExecutionData[] = [];
+        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, {}), model);
+                    const quality = ['seedream', 'flux-pro'].includes(model) ? String(this.getNodeParameter('quality', i, 'basic')) : 'basic';
+                    const resolution = ['flux-pro', 'nano-banana-pro'].includes(model) ? String(this.getNodeParameter('resolution', i, '1K')) : '1K';
+
+                    if (!prompt) throw new NodeOperationError(this.getNode(), 'Prompt is required', { itemIndex: i });
+
+                    const request = buildGenerationRequest({ model, prompt, ratio, references, quality, resolution });
+                    const payload = { ...request, licenseKey, kieApiKey, _v: '0.1.0' };
+                    const response = await this.helpers.request({
+                        method: 'POST',
+                        url: `${COMANDOS_API_URL}/tasks`,
+                        headers: { 'Content-Type': 'application/json', 'X-License-Key': licenseKey },
+                        body: { process_type: 'IMAGE_GENERATION', payload },
+                        json: true,
+                    });
+                    results.push({ json: response as IDataObject });
+                } else if (operation === 'status') {
+                    const taskId = String(this.getNodeParameter('taskId', i) || '').trim();
+                    if (!taskId) throw new NodeOperationError(this.getNode(), 'Task ID is required', { itemIndex: i });
+                    const response = await this.helpers.request({
+                        method: 'GET',
+                        url: `${COMANDOS_API_URL}/tasks/${encodeURIComponent(taskId)}`,
+                        headers: { 'X-License-Key': licenseKey },
+                        json: true,
+                    });
+                    results.push({ json: response as IDataObject });
+                }
+            } catch (error) {
+                if (error instanceof NodeOperationError) throw error;
+                const message = error instanceof Error ? error.message : 'Request failed';
+                throw new NodeOperationError(this.getNode(), message, { itemIndex: i });
+            }
+        }
+        return [results];
+    }
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@comandosai/n8n-nodes-media",
+  "version": "0.1.2",
+  "description": "Comandos Media Generator custom node (Image/Video)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && mkdir -p dist/nodes && cp -f Media.png dist/nodes/"
+  },
+  "dependencies": {
+    "n8n-workflow": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.19.0",
+    "typescript": "^5.4.5"
+  },
+  "n8n": {
+    "nodes": [
+      "dist/nodes/ComandosMedia.node.js"
+    ],
+    "credentials": [
+      "dist/credentials/ComandosApi.credentials.js"
+    ]
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2019",
+    "module": "CommonJS",
+    "lib": ["ES2019"],
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true
+  },
+  "include": ["nodes/**/*.ts", "credentials/**/*.ts", "index.ts"]
+}