From 8e88139a81e61f8ddd715d6749a8f96ac07967e0 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 12:34:30 +0800 Subject: [PATCH 1/5] i18n(es): translate troubleshooting, desktop, comfy-cli and development pages (batch 1) --- es/agent-tools/cli.mdx | 26 +-- es/comfy-cli/getting-started.mdx | 64 +++--- es/development/cloud/overview.mdx | 49 ++-- .../comfyui-server/api-key-integration.mdx | 19 +- .../comfyui-server/startup-flags.mdx | 212 +++++++++--------- es/development/serverless/overview.mdx | 83 +++---- es/installation/desktop/usage/manage.mdx | 27 +-- es/installation/desktop/usage/migrate.mdx | 23 +- es/specs/workflow_json.mdx | 10 +- es/troubleshooting/custom-node-issues.mdx | 207 ++++++++--------- es/troubleshooting/model-issues.mdx | 74 +++--- es/troubleshooting/overview.mdx | 161 ++++++------- 12 files changed, 483 insertions(+), 472 deletions(-) diff --git a/es/agent-tools/cli.mdx b/es/agent-tools/cli.mdx index e9e7b0332f..8006d29110 100644 --- a/es/agent-tools/cli.mdx +++ b/es/agent-tools/cli.mdx @@ -3,15 +3,17 @@ title: "Comfy CLI: ejecuta ComfyUI desde la terminal" description: "Controla Comfy desde la terminal: ComfyUI local, llamadas de generación de socios y flujos de trabajo completos en Comfy Cloud. Complementa MCP para scripts, CI y automatización." sidebarTitle: "Comfy CLI" icon: "terminal" -translationSourceHash: 99bc3bd2 +translationSourceHash: bc3e7c14 translationFrom: agent-tools/cli.mdx translationBlockHashes: "_intro": cb162cdd "How it fits with MCP": a452f8fb "What the CLI does": 3c8cfc5f + "Install and set up": 4c281b95 "Prerequisites for `comfy generate`": 66aa291a "Your first generation": b4f2ff1a "Available models": 7275a9fe + "Usage examples": f6768bfe "Beyond `comfy generate`": 8e75f6a8 "Agent skills": 5cfcfe55 "Related resources": d4e97516 @@ -38,14 +40,14 @@ import GenerateVideoAsync from "/snippets/es/comfy-cli/generate-video-async.mdx" -## Cómo encaja con MCP +## Cómo se integra con MCP | | Comfy MCP (cloud) | Comfy CLI | |---|---|---| | **Interfaz** | Chat con un cliente MCP (Claude Code, Claude Desktop, …) | Comandos de terminal y scripts | | **Ideal para** | Flujos de trabajo interactivos con agentes en el chat | Automatización, ejecuciones por lote, CI, canalizaciones de shell | | **Autenticación** | OAuth en clientes MCP, o clave API (sin interfaz) | `comfy cloud login` (OAuth) o clave API (CI) | -| **Salida** | Devuelta en la sesión de chat | Guardada en disco (`--download`) o en JSON (`--json`) | +| **Salida** | Se devuelve en la sesión de chat | Se guarda en disco (`--download`) o en JSON (`--json`) | Para la configuración de MCP, la instalación, las listas de herramientas y los métodos de autenticación, consulta [Comfy MCP](/es/agent-tools/mcp). @@ -65,7 +67,7 @@ Para la configuración de MCP, la instalación, las listas de herramientas y los comfy setup ``` -Pasa `-y` para instalaciones no interactivas en CI o scripts. Consulta [Primeros pasos con Comfy CLI](/es/comfy-cli/getting-started#configuración-rápida-recomendado) para ver la tabla completa de flags de `comfy setup`. +Usa `-y` para instalaciones no interactivas en CI o scripts. Consulta [Primeros pasos de Comfy CLI](/es/comfy-cli/getting-started#configuración-rápida-recomendado) para ver la tabla completa de opciones de `comfy setup`. Inicia sesión en Comfy Cloud: @@ -73,7 +75,6 @@ Inicia sesión en Comfy Cloud: comfy cloud login comfy cloud whoami ``` - ## Requisitos previos para `comfy generate` @@ -84,7 +85,7 @@ comfy cloud whoami ## Modelos disponibles -`comfy generate` abarca modelos de socios para imagen y video. Descubre qué hay disponible en tu versión de la CLI: +`comfy generate` cubre modelos de socios para imagen y video. Descubre qué hay disponible en tu versión de CLI: ```bash comfy generate list # todos los modelos @@ -127,15 +128,14 @@ comfy generate nano-banana \ ```bash comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url' ``` - ## Más allá de `comfy generate` Todo lo anterior es el resumen enfocado en agentes. La guía completa recorre cada comando en profundidad: - `comfy run`, `comfy jobs` y `comfy validate` para flujos de trabajo completos -- `comfy templates` y la edición de slots de `comfy workflow` -- Descubrimiento con `comfy nodes` / `comfy models` -- Sobres `--json` y `comfy --json discover` para agentes +- Edición de slots con `comfy templates` y `comfy workflow` +- Descubrimiento de `comfy nodes` / `comfy models` +- Sobres JSON de `--json` y `comfy --json discover` para agentes → [Primeros pasos de Comfy CLI](/es/comfy-cli/getting-started) (documentación completa) @@ -147,12 +147,12 @@ Todo lo anterior es el resumen enfocado en agentes. La guía completa recorre ca | Recurso | Para qué sirve | |---|---| -| [Primeros pasos con Comfy CLI](/es/comfy-cli/getting-started) | Guía de instalación **completa** y recorrido por los comandos | +| [Primeros pasos de Comfy CLI](/es/comfy-cli/getting-started) | Guía de instalación **completa** y recorrido por los comandos | | [Referencia de Comfy CLI](/es/comfy-cli/reference) | Comandos, flags y alias de modelos | | [Comfy MCP](/es/agent-tools/mcp) | Conecta agentes mediante MCP para generar desde el chat | -| [comfy-cli en GitHub](https://github.com/Comfy-Org/comfy-cli) | Repositorio fuente, problemas y el comportamiento más reciente | +| [comfy-cli en GitHub](https://github.com/Comfy-Org/comfy-cli) | Repositorio fuente, problemas y comportamiento más reciente | ## Retroalimentación -- **GitHub**: [problemas de comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues) +- **GitHub**: [Problemas de comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues) - **Discord**: [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R) diff --git a/es/comfy-cli/getting-started.mdx b/es/comfy-cli/getting-started.mdx index fd71313b77..b15b6de78a 100644 --- a/es/comfy-cli/getting-started.mdx +++ b/es/comfy-cli/getting-started.mdx @@ -2,7 +2,7 @@ title: "Empezar con Comfy CLI" sidebarTitle: "Empezar" description: "Instala comfy-cli, configura el enrutamiento local o en la nube, genera con Nodos asociados y ejecuta flujos de trabajo desde la terminal." -translationSourceHash: b900dd1f +translationSourceHash: 843f41c2 translationFrom: comfy-cli/getting-started.mdx translationBlockHashes: "_intro": fe779f6e @@ -10,12 +10,17 @@ translationBlockHashes: "Install CLI": ba7f2317 "Quick Setup (Recommended)": d38c5eb6 "Install ComfyUI (Local)": fd282ff2 + "Run ComfyUI (Local)": 962395ce "Comfy Cloud": 50dc06e8 "Generate with Partner Nodes": c1ee8203 "Run Workflows {#comfy run}": 653c16e1 "Start from a Template": 0a2858ac + "Edit Workflows In Place": 29dc5cfc + "Discover Nodes and Models": 1e48149f "Upload and Download Files": 683ee497 "Manage Custom Nodes": 7498a89e + "Manage Models (Local)": cad0a47b + "JSON Output for Scripts and Agents": c0089a69 "Agent Skills": e16537cf "Contributing": 2ca91c9b "Analytics": 8ee20c3e @@ -41,7 +46,7 @@ import GenerateVideoAsync from "/snippets/es/comfy-cli/generate-video-async.mdx" Cumple tres funciones principales: -1. **Administrar una instalación local de ComfyUI**: instalar, iniciar, actualizar, crear instantáneas y bisecar ComfyUI y los Nodos personalizados. +1. **Administrar una instalación local de ComfyUI**: instalar, iniciar, actualizar, crear instantáneas y bisecar ComfyUI y los Nodos Personalizados. 2. **Acceder a los Nodos asociados alojados**: generar imágenes, video, audio y 3D con proveedores como Seedance, Nano Banana (Gemini), Grok, Flux, Ideogram, DALL·E, Recraft, Stability, Kling, Luma, Runway, Pika, Vidu, Hailuo, Moonvalley y otros, con un solo comando. 3. **Ejecutar flujos de trabajo completos en Comfy Cloud**: enviar grafos de flujo de trabajo, explorar la galería de plantillas seleccionadas, editar los slots de los flujos de trabajo y seguir las tareas hasta que terminen, sin necesidad de una GPU local. @@ -78,7 +83,6 @@ Comprueba qué espacio de trabajo está seleccionado y qué está instalado: comfy which comfy env ``` - ## Comfy Cloud @@ -87,7 +91,7 @@ comfy env -La forma más rápida de llamar a los [nodos asociados](/es/tutorials/partner-nodes/overview) de Comfy desde una terminal o un script. Usa los mismos endpoints alojados que los flujos de trabajo de ComfyUI, pero como llamadas individuales de la CLI. Es ideal para trabajos por lotes, experimentos rápidos y automatización donde un gráfico completo de ComfyUI no es necesario. +La forma más rápida de llamar a los [nodos asociados](/es/tutorials/partner-nodes/overview) de Comfy desde una terminal o un script. Usa los mismos endpoints alojados que los flujos de trabajo de ComfyUI, pero como llamadas individuales de CLI. Es ideal para trabajos por lote, experimentos rápidos y automatización donde no hace falta un gráfico completo de ComfyUI. ### Requisitos previos @@ -98,7 +102,7 @@ La forma más rápida de llamar a los [nodos asociados](/es/tutorials/partner-no - Descubre primero los parámetros reales de un modelo. Los nombres de las flags varían según el modelo (por ejemplo, `flux-ultra` acepta `--width`/`--height`; `seedance` acepta `--ratio`/`--resolution`/`--duration`). Verifica siempre antes de crear un script: + Descubre primero los parámetros reales de un modelo. Los nombres de los flags varían según el modelo (por ejemplo, `flux-ultra` usa `--width`/`--height`; `seedance` usa `--ratio`/`--resolution`/`--duration`). Verifica siempre antes de escribir un script: ```bash comfy generate schema flux-ultra @@ -130,7 +134,7 @@ comfy generate schema flux-kontext # ver los parámetros de un model ### Salida JSON para scripts -Emite las respuestas sin procesar de la API para integrarlas en pipelines: +Emite respuestas sin procesar de la API para integrarlas en tu pipeline: ```bash comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url' @@ -140,14 +144,14 @@ Consulta la [referencia](/es/comfy-cli/reference) para ver la lista completa de ## Ejecutar flujos de trabajo {#comfy run} -Más allá de las llamadas individuales a socios, `comfy run` envía un gráfico de flujo de trabajo completo de ComfyUI. Acepta JSON tanto en formato API como en formato UI exportado (los flujos de trabajo de UI se convierten a formato API en el lado del cliente) y enruta a local o a la nube como cualquier otro comando. Es **asíncrono de forma predeterminada**. Devuelve un `prompt_id` en milisegundos mientras un proceso de vigilancia en segundo plano sigue el progreso. Usa `--wait` si prefieres bloquear. +Más allá de las llamadas individuales a socios, `comfy run` envía un gráfico de flujo de trabajo completo de ComfyUI. Acepta JSON en formato API y JSON exportado en formato UI (los flujos de trabajo de UI se convierten a formato API en el lado del cliente), y se dirige a local o a la nube como cualquier otro comando. Es **asíncrono por defecto**. Devuelve un `prompt_id` en milisegundos mientras un vigilante en segundo plano hace seguimiento del progreso. Pasa `--wait` para bloquear en su lugar. ```bash -# Envía; devuelve de inmediato un prompt_id +# Envía; devuelve de inmediato con un prompt_id RES=$(comfy --json run --workflow my_workflow.json) PROMPT_ID=$(echo "$RES" | jq -r .data.prompt_id) -# Vigila hasta el estado terminal y luego recopila las salidas +# Observa hasta el estado terminal y luego recopila las salidas comfy --json jobs watch "$PROMPT_ID" | comfy download ``` @@ -157,38 +161,38 @@ comfy --json jobs watch "$PROMPT_ID" | comfy download comfy run --workflow my_workflow.json --wait | comfy download ``` -Sigue y administra las tareas: +Haz seguimiento y administra las tareas: ```bash comfy jobs ls # envíos asíncronos locales + cola/historial del servidor -comfy jobs status # una sola tarea +comfy jobs status # una tarea comfy jobs wait # bloquea hasta que TODAS lleguen a un estado terminal comfy jobs cancel # idempotente ``` - Valida antes de enviar. Detecta nodos desconocidos, modelos faltantes y conexiones incorrectas antes de consumir cómputo en la nube: + Valida antes de enviar. Detecta nodos desconocidos, modelos faltantes y conexiones incorrectas antes de gastar cómputo en la nube: ```bash comfy validate --workflow my_workflow.json ``` -## Comenzar desde una plantilla +## Iniciar desde una plantilla -La galería curada `Comfy-Org/workflow_templates` es la forma más rápida de obtener un flujo de trabajo que ya funciona para una tarea determinada. No necesitas construirlo desde cero. +La galería seleccionada `Comfy-Org/workflow_templates` es la forma más rápida de obtener un flujo de trabajo confiable para una tarea determinada. No necesitas construirlo desde cero. ```bash comfy templates ls --type image --tag "Text to Image" # explorar comfy templates show # metadatos completos -comfy templates fetch --out my.json # obtén el JSON del flujo de trabajo +comfy templates fetch --out my.json # obtener el JSON del flujo de trabajo ``` -El JSON descargado está en formato del frontend. `comfy run --where cloud` lo convierte automáticamente a formato API al enviarlo. +El JSON descargado está en formato de frontend. `comfy run --where cloud` lo convierte automáticamente a formato API al enviarlo. ## Editar flujos de trabajo en su lugar -`comfy workflow` expone los slots editables por el agente en cualquier flujo de trabajo en formato frontend y te permite sobrescribirlos. Sin cirugía manual de JSON. +`comfy workflow` expone las ranuras que un agente puede modificar en cualquier flujo de trabajo en formato de frontend y te permite sobrescribirlas. Sin cirugía manual del JSON. ```bash comfy workflow slots my.json # list addressable slots @@ -207,16 +211,15 @@ comfy workflow save my.json --name "My Flow" comfy workflow delete ``` -Para canalizaciones complejas de varios pasos, combina fragmentos pequeños y reutilizables en un solo gráfico: +Para pipelines complejos de varios pasos, compón fragmentos pequeños y reutilizables en un solo gráfico: ```bash comfy workflow compose blueprints/my_pipeline.yaml -o workflows/my_pipeline.json comfy workflow decompose my.json # inverse: project a workflow into a fragment ``` - ## Descubrir nodos y modelos -Inspecciona todo lo que esté disponible en el backend resuelto. +Inspecciona todo lo disponible en el backend resuelto. **Nodos:** @@ -234,22 +237,21 @@ comfy models list-folders # every model folder comfy models search --text "wan2.2" --type lora comfy models show wan2.2_vae.safetensors # full metadata ``` - ## Subir y descargar archivos ```bash -comfy upload photo.png video.mp4 # → directorio de entrada del servidor +comfy upload photo.png video.mp4 # → server input directory comfy download # → ./outputs/ ``` - **La tubería idiomática:** + **El pipe idiomático:** ```bash comfy run --workflow flux.json --wait | comfy download ``` - `comfy download` lee el prompt_id y las URLs de salida desde el stdin canalizado de forma automática. Sin extracción manual de claves, sin `jq`. + `comfy download` lee el prompt_id y las URLs de salida desde stdin canalizado automáticamente. Sin extracción manual de claves, sin `jq`. ## Administrar nodos personalizados @@ -267,10 +269,9 @@ Descarga modelos fácilmente: ```bash comfy model download --url --relative-path models/checkpoints ``` - ## Salida JSON para scripts y agentes -Todos los comandos aceptan `--json` y emiten la misma estructura de envoltura, lo que hace que la CLI se pueda usar por completo en scripts y sea cómoda para los agentes: +Todos los comandos aceptan `--json` y emiten la misma forma de envoltura, lo que hace que la CLI sea totalmente compatible con scripts y fácil de usar para agentes: ```json { @@ -289,19 +290,18 @@ Cuando `error` está presente, lee el `hint` y actúa en consecuencia: comfy --json run --workflow my.json | jq '.error.hint' ``` -La superficie orientada a agentes se describe a sí misma por completo. Vuelca todo el árbol de comandos, los esquemas de salida y los códigos de error: +La superficie orientada a agentes es completamente autodescriptiva. Vuelca todo el árbol de comandos, los esquemas de salida y los códigos de error: ```bash comfy --json discover ``` - -## Habilidades de agente +## Habilidades de agentes ## Contribuir -Las contribuciones son bienvenidas. Abre un problema o envía un pull request en el [repositorio de GitHub de comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues). Consulta la [Guía para desarrolladores](https://github.com/Comfy-Org/comfy-cli/blob/main/CONTRIBUTING.md) para más detalles. +Las contribuciones son bienvenidas. Abre problemas o envía pull requests en el [repositorio de GitHub de comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues). Consulta la [Guía para desarrolladores](https://github.com/Comfy-Org/comfy-cli/blob/main/CONTRIBUTING.md) para más detalles. ## Analítica @@ -311,10 +311,10 @@ El seguimiento de uso ayuda a mejorar la CLI. Desactívalo con: comfy tracking disable ``` -Vuelve a activar el seguimiento: +Vuelve a activar el seguimiento con: ```bash comfy tracking enable ``` -También puedes optar por desactivarlo de forma definitiva mediante las variables de entorno `DO_NOT_TRACK` o `COMFY_NO_TELEMETRY`. +También puedes desactivarlo por completo mediante las variables de entorno `DO_NOT_TRACK` o `COMFY_NO_TELEMETRY`. diff --git a/es/development/cloud/overview.mdx b/es/development/cloud/overview.mdx index 7aefccf879..0fc2f51430 100644 --- a/es/development/cloud/overview.mdx +++ b/es/development/cloud/overview.mdx @@ -2,25 +2,27 @@ title: "Descripción general de la API de Cloud v1" sidebarTitle: "Descripción general" description: "La superficie obsoleta de la API de Cloud v1: autenticación y los endpoints propios de Cloud que Comfy API v2 no expone" -translationSourceHash: 8fb7c441 +translationSourceHash: 23159573 translationFrom: development/cloud/overview.mdx translationBlockHashes: "_intro": d3b303f7 + "Base URL": 8f28d98b "Authentication": f8beff52 "What the SDKs Don't Cover Yet": 3552c4fe "Available Endpoints": 5492fb80 "Error Handling": f5e3c80a "Next Steps": 962d77bb --- + - **Obsoleto:** La API de Cloud v1 está obsoleta en favor de [Comfy API v2](/es/api-reference/v2/overview). Sigue disponible para las integraciones existentes y para las capacidades de Cloud que v2 aún no expone, pero los endpoints y el comportamiento pueden cambiar sin previo aviso. + **Obsoleto:** La API v1 de Cloud está obsoleta en favor de [Comfy API v2](/es/api-reference/v2/overview). Sigue disponible para las integraciones existentes y para las capacidades de Cloud que v2 aún no expone, pero los endpoints y el comportamiento pueden cambiar sin previo aviso. -La API de Cloud v1 proporciona acceso programático a [Comfy Cloud](/es/development/deploy/cloud), el servicio administrado de Comfy para ejecutar flujos de trabajo en infraestructura en la nube. +La API v1 de Cloud proporciona acceso programático a [Comfy Cloud](/es/development/deploy/cloud), el servicio administrado de Comfy para ejecutar flujos de trabajo en infraestructura en la nube. -Comfy Cloud es una aplicación con estado. Tu cuenta mantiene un estado que persiste entre tareas: créditos y nivel de suscripción, recursos subidos y salidas generadas, la cola de trabajos y el conjunto de modelos y nodos instalados. La API v1 abarca toda esa aplicación, así que incluye funcionalidad que la portable [Comfy API v2](/es/api-reference/v2/overview) no admite, como la gestión de la cola, la exploración de modelos, las definiciones de nodos y los endpoints de cuenta. Usa v2 (o los SDK que la envuelven) para enviar flujos de trabajo y obtener resultados de una forma que también funcione con despliegues de Comfy API y con ComfyUI autoalojado. Usa v1 para las capacidades específicas de Cloud a su alrededor. +Comfy Cloud es una aplicación con estado. Tu cuenta mantiene un estado que persiste entre tareas: créditos y nivel de suscripción, recursos subidos y salidas generadas, la cola de trabajos y el conjunto de modelos y nodos instalados. La API v1 es la interfaz de toda esa aplicación, así que incluye funcionalidad que la versión portátil de [Comfy API v2](/es/api-reference/v2/overview) no admite, como la gestión de la cola, la exploración de modelos, las definiciones de nodos y los endpoints de cuenta. Usa v2 (o los SDK que la envuelven) para enviar flujos de trabajo y obtener resultados de una forma que también funcione con despliegues de Comfy API y con ComfyUI autoalojado. Usa v1 para las capacidades específicas de Cloud que la rodean. -Para ejecutar flujos de trabajo, empieza con la [Guía de inicio rápido de Comfy Cloud](/es/development/deploy/cloud) y los [SDK de Comfy](/es/development/api-development/sdks). Los créditos y los límites de concurrencia se tratan en [Uso y límites](/es/development/deploy/cloud-usage); los ejemplos ejecutables de v1 están en la [Referencia de la API de Cloud](/es/development/cloud/api-reference). Esta página cubre la superficie específica de v1: la autenticación y los endpoints que v2 no expone. +Para ejecutar flujos de trabajo, empieza con la [Guía de inicio rápido de Comfy Cloud](/es/development/deploy/cloud) y los [SDK de Comfy](/es/development/api-development/sdks). Los créditos y los límites de concurrencia se tratan en [Uso y límites](/es/development/deploy/cloud-usage); los ejemplos ejecutables de v1 están en la [Referencia de la API de Cloud](/es/development/cloud/api-reference). Esta página cubre lo específico de v1: la autenticación y los endpoints que v2 no expone. **Suscripción requerida:** El acceso a la API requiere una suscripción de pago a Comfy Cloud; el nivel Gratis no lo incluye. Consulta los [planes de precios](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api). @@ -31,10 +33,9 @@ Para ejecutar flujos de trabajo, empieza con la [Guía de inicio rápido de Comf ``` https://cloud.comfy.org ``` - ## Autenticación -Todas las solicitudes v1 requieren una clave API enviada en el encabezado `X-API-Key`: +Todas las solicitudes a la v1 requieren una clave API enviada en el encabezado `X-API-Key`: ```bash curl -X GET "https://cloud.comfy.org/api/user" \ @@ -43,33 +44,33 @@ curl -X GET "https://cloud.comfy.org/api/user" \ Consulta [Obtener una clave API](/es/development/api-development/getting-an-api-key) para ver las instrucciones sobre cómo crear y administrar claves. Una clave inválida o faltante devuelve `401`. Una clave con una suscripción inactiva devuelve `429`. -La misma clave se usa para los [Nodos asociados](/es/tutorials/partner-nodes/overview). Por HTTP, la vuelves a pasar en `extra_data.api_key_comfy_org`; consulta [Usar Nodos asociados](/es/development/cloud/api-reference#usar-nodos-asociados) para ver ejemplos. +Esta clave también se usa para los [Nodos asociados](/es/tutorials/partner-nodes/overview). Por HTTP la vuelves a pasar en `extra_data.api_key_comfy_org`; consulta [Uso de los Nodos asociados](/es/development/cloud/api-reference#usar-nodos-asociados) para ver ejemplos. ## Lo que los SDK aún no cubren -Los SDK cubren cómo ejecutar un flujo de trabajo, obtener los resultados y cancelar una tarea. El resto de la superficie de Cloud solo está disponible por HTTP, así que llama directamente a estos endpoints aunque uses un SDK para la ejecución. +Los SDK cubren la ejecución de un flujo de trabajo, la obtención de los resultados y la cancelación de una tarea. Al resto de la superficie de Cloud solo se llega por HTTP, así que llama a estos endpoints directamente incluso si usas un SDK para la ejecución. | Capacidad | Endpoint | Referencia | |---|---|---| | Estado de la cola, tareas en ejecución y pendientes | `GET /api/queue` | [Gestión de la cola](/es/development/cloud/api-reference#gestión-de-la-cola) | | Interrumpir la ejecución actual | `POST /api/interrupt` | [Gestión de la cola](/es/development/cloud/api-reference#gestión-de-la-cola) | | Definiciones de nodos y especificaciones de entradas | `GET /api/object_info` | [Información de objetos](/es/development/cloud/api-reference#información-de-objetos) | -| Explorar modelos disponibles | Endpoints de modelos | [Especificación OpenAPI](/es/development/cloud/openapi) | +| Explorar los modelos disponibles | Endpoints de modelos | [Especificación OpenAPI](/es/development/cloud/openapi) | | Información de la cuenta y del usuario | `GET /api/user` | [Especificación OpenAPI](/es/development/cloud/openapi) | -| Subidas de máscaras que hacen referencia a una imagen existente | `POST /api/upload/mask` | [Subir entradas](/es/development/cloud/api-reference#subir-entradas) | +| Subir máscaras que hacen referencia a una imagen existente | `POST /api/upload/mask` | [Subir entradas](/es/development/cloud/api-reference#subir-entradas) | -Cancelar una tarea lo cubren ambos: los SDK cancelan una tarea de la que tienes un identificador, y `POST /api/queue` cancela por ID. +Cancelar una tarea está cubierto por ambos: los SDK cancelan una tarea sobre la que tienes un handle, y `POST /api/queue` cancela por ID. -## Endpoints disponibles {#available-endpoints} +## Endpoints disponibles | Categoría | Descripción | |----------|-------------| -| [Flujos de trabajo](/es/development/cloud/api-reference#ejecutar-flujos-de-trabajo) | Envía flujos de trabajo y consulta su estado | -| [Tareas](/es/development/cloud/api-reference#comprobar-el-estado-de-la-tarea) | Supervisa el estado y la cola de las tareas | -| [Entradas](/es/development/cloud/api-reference#subir-entradas) | Sube imágenes, máscaras y otras entradas | -| [Salidas](/es/development/cloud/api-reference#downloading-outputs) | Descarga el contenido generado | +| [Flujos de trabajo](/es/development/cloud/api-reference#ejecutar-flujos-de-trabajo) | Enviar flujos de trabajo, consultar el estado | +| [Tareas](/es/development/cloud/api-reference#comprobar-el-estado-de-la-tarea) | Monitorear el estado y la cola de tareas | +| [Entradas](/es/development/cloud/api-reference#subir-entradas) | Subir imágenes, máscaras y otras entradas | +| [Salidas](/es/development/cloud/api-reference#downloading-outputs) | Descargar el contenido generado | | [WebSocket](/es/development/cloud/api-reference#websocket-para-el-progreso-en-tiempo-real) | Actualizaciones de progreso en tiempo real | -| [Información de objetos](/es/development/cloud/api-reference#información-de-objetos) | Nodos disponibles y sus definiciones | +| [Información de objeto](/es/development/cloud/api-reference#información-de-objetos) | Nodos disponibles y sus definiciones | ## Manejo de errores @@ -83,14 +84,14 @@ Los endpoints REST devuelven códigos de estado HTTP estándar: | `429` | Suscripción inactiva | | `500` | Error interno del servidor | -En su lugar, los SDK lanzan estas situaciones como excepciones tipadas, incluidas `Unauthorized`, `InvalidWorkflow`, `InsufficientCredits`, `QueueFull` y `JobFailed`, todas las cuales extienden `ComfyError`. +En su lugar, los SDK lanzan estos casos como excepciones tipadas, entre ellas `Unauthorized`, `InvalidWorkflow`, `InsufficientCredits`, `QueueFull` y `JobFailed`, todas heredando de `ComfyError`. -Las fallas de ejecución son independientes de los errores HTTP. Consulta [Manejo de errores](/es/development/cloud/api-reference#manejo-de-errores) para conocer los valores de `exception_type` que se entregan durante la ejecución. +Las fallas de ejecución son independientes de los errores HTTP. Consulta [Manejo de errores](/es/development/cloud/api-reference#manejo-de-errores) para ver los valores de `exception_type` que se entregan durante la ejecución. ## Próximos pasos - + Ejecuta un flujo de trabajo desde Python o TypeScript. @@ -100,9 +101,9 @@ Las fallas de ejecución son independientes de los errores HTTP. Consulta [Manej Documentación completa de los endpoints con ejemplos en curl, Python y TypeScript. - La API HTTP versionada que sustenta ambos SDK. Úsala desde cualquier idioma. + La API HTTP versionada que hay debajo de ambos SDK. Úsala desde cualquier idioma. - - Especificación de API legible por máquina para generar código. + + Especificación de la API legible por máquina para generar código. diff --git a/es/development/comfyui-server/api-key-integration.mdx b/es/development/comfyui-server/api-key-integration.mdx index bea65d01b8..708ab13361 100644 --- a/es/development/comfyui-server/api-key-integration.mdx +++ b/es/development/comfyui-server/api-key-integration.mdx @@ -3,23 +3,25 @@ title: "Integración de la clave API de la cuenta de ComfyUI" description: "Usa la clave API de tu cuenta de ComfyUI para llamar a nodos asociados de pago en modo headless." sidebarTitle: "Integración de clave API" icon: 'puzzle-piece' -translationSourceHash: 8ac971d0 +translationSourceHash: 2b021cc8 translationFrom: development/comfyui-server/api-key-integration.mdx translationBlockHashes: "_intro": af70c76b "Prerequisites": a15cafa5 + "Python Example": 56268ba8 "Related Documentation": 3596104a --- -A partir de [PR #8041](https://github.com/Comfy-Org/ComfyUI/pull/8041), ComfyUI permite usar directamente los Nodos asociados de pago integrados mediante la Clave API de tu cuenta de ComfyUI, sin necesidad de una interfaz de frontend específica (incluso puedes ejecutarlo sin frontend). + +A partir de [PR #8041](https://github.com/Comfy-Org/ComfyUI/pull/8041), ComfyUI permite usar directamente los Nodos asociados de pago integrados mediante la Clave API de tu cuenta de ComfyUI, sin necesidad de una interfaz de frontend específica (incluso puedes ejecutarlo sin ningún frontend). Esto significa que puedes crear flujos de trabajo que combinen: -- modelos locales del sistema operativo +- modelos OS locales - herramientas de la comunidad de nodos personalizados - modelos de pago populares -Y luego ejecutar todo junto simplemente enviando el prompt a la API del servidor web de Comfy, dejando que se encargue de toda la orquestación. +Luego puedes ejecutar todo junto simplemente enviando el prompt a la API del servidor web de Comfy, y dejar que se encargue de toda la orquestación. -Esto es útil para los usuarios que quieren usar Comfy como servicio backend, mediante la línea de comandos, con su propio frontend, etc. +Esto es útil para quienes quieren usar Comfy como servicio backend, mediante la línea de comandos, con su propio frontend, etc. ## Requisitos previos @@ -36,12 +38,12 @@ Para usar tu Clave API de la cuenta de ComfyUI y llamar a los Nodos asociados de Debes asegurarte de que tu cuenta de ComfyUI tenga créditos suficientes para probar las funciones correspondientes. -Consulta la sección Créditos para aprender a Comprar créditos para tu cuenta +Consulta la sección Créditos para saber cómo comprar créditos para tu cuenta -## Ejemplo en Python +## Ejemplo de Python -Aquí tienes un ejemplo de cómo enviar un flujo de trabajo que contiene Nodos asociados a la API de ComfyUI usando código Python: +Aquí tienes un ejemplo de cómo enviar un flujo de trabajo que contiene Nodos asociados a la API de ComfyUI usando código de Python: ```python """Using Partner Nodes when running ComfyUI headless or with alternative frontend @@ -120,7 +122,6 @@ req = request.Request(f"{SERVER_URL}/prompt", data=data) request.urlopen(req) ``` - ## Documentación relacionada - [Descripción general de los Nodos asociados](https://docs.comfy.org/tutorials/partner-nodes/overview) diff --git a/es/development/comfyui-server/startup-flags.mdx b/es/development/comfyui-server/startup-flags.mdx index b2775ec68a..8b8d7011b9 100644 --- a/es/development/comfyui-server/startup-flags.mdx +++ b/es/development/comfyui-server/startup-flags.mdx @@ -3,28 +3,34 @@ title: "Flags de inicio" sidebarTitle: "Flags de inicio" description: "Referencia de flags de inicio de ComfyUI: argumentos de main.py en comfy/cli_args.py y cómo añadirlos a los .bat de Windows Portable." icon: "terminal" -translationSourceHash: 10f50b2f +translationSourceHash: a7c889d8 translationFrom: development/comfyui-server/startup-flags.mdx translationBlockHashes: + "_intro": 10812161 "Network & Server": 6e570fe4 "Directories": 220fd7a7 + "Launch & Browser": 09ebe818 "Devices & CUDA": d25282b5 "Precision & Inference": 8dcd25ed "Preview": 92d0c26e "Cache": 0cc84384 "Attention": 83fff51d "VRAM & Memory": 95b978ec + "Performance & Debugging": ca216ce9 "ComfyUI Manager": 4fa916e3 + "Custom Nodes & API Nodes": 6ef4b9a3 + "Frontend & API": dad3634f "Logging & Misc": 4d81c96d --- -ComfyUI acepta argumentos de línea de comandos cuando se inicia con `python main.py`. Esta página documenta todos los flags definidos en [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). + +ComfyUI accepts command-line arguments when started with `python main.py`. This page documents every flag defined in [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). - Los usuarios de **Windows Portable** pueden añadir flags a los archivos `.bat` de inicio (por ejemplo, `run_nvidia_gpu.bat`). Consulta la [guía de Windows Portable](/es/installation/comfyui_portable_windows) para ver los detalles. + **Windows Portable** users can add flags to the `.bat` launch files (for example, `run_nvidia_gpu.bat`). See the [Windows Portable guide](/installation/comfyui_portable_windows) for details. -Ejecuta `python main.py --help` en tu directorio de ComfyUI para ver el texto de ayuda integrado. Combina varios flags según necesites: +Run `python main.py --help` in your ComfyUI directory for the built-in help text. Combine multiple flags as needed: ```bash python main.py --listen 0.0.0.0 --port 8288 --disable-auto-launch --lowvram @@ -34,20 +40,20 @@ python main.py --listen 0.0.0.0 --port 8288 --disable-auto-launch --lowvram | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--listen` `[IP]` | `127.0.0.1` | Dirección IP en la que escuchar. Se admite una lista separada por comas (p. ej. `127.2.2.2,127.3.3.3`). Si se indica sin valor, toma `0.0.0.0,::` por defecto (todas las interfaces IPv4 e IPv6). | +| `--listen` `[IP]` | `127.0.0.1` | Dirección IP en la que escuchar. Se admite una lista separada por comas (por ejemplo, `127.2.2.2,127.3.3.3`). Si se indica sin valor, se usa `0.0.0.0,::` de forma predeterminada (todas las interfaces IPv4 e IPv6). | | `--port` | `8188` | Puerto en el que escuchar. | -| `--tls-keyfile` `PATH` | Ninguno | Ruta al archivo de clave TLS (SSL). Habilita HTTPS. Requiere `--tls-certfile`. | -| `--tls-certfile` `PATH` | Ninguno | Ruta al archivo de certificado TLS (SSL). Habilita HTTPS. Requiere `--tls-keyfile`. | -| `--enable-cors-header` `[ORIGIN]` | deshabilitado | Habilita CORS. Origen opcional, o `*` para todos los orígenes cuando no se indica un valor. | +| `--tls-keyfile` `PATH` | — | Ruta al archivo de clave TLS (SSL). Habilita HTTPS. Requiere `--tls-certfile`. | +| `--tls-certfile` `PATH` | — | Ruta al archivo de certificado TLS (SSL). Habilita HTTPS. Requiere `--tls-keyfile`. | +| `--enable-cors-header` `[ORIGIN]` | deshabilitado | Habilita CORS. Origen opcional, o `*` para todos los orígenes cuando no se indica ningún valor. | | `--max-upload-size` | `100` | Tamaño máximo de subida en MB. | | `--enable-compress-response-body` | deshabilitado | Habilita la compresión del cuerpo de la respuesta HTTP. | ```bash -# Escuchar en todas las interfaces (acceso a la LAN) +# Escucha en todas las interfaces (acceso a la LAN) python main.py --listen -# Escuchar en una IP específica +# Escucha en una IP específica python main.py --listen 0.0.0.0 # Puerto personalizado con HTTPS @@ -57,11 +63,11 @@ python main.py --port 8443 --tls-keyfile key.pem --tls-certfile cert.pem ## Directorios -| Opción | Predeterminado | Descripción | +| Flag | Predeterminado | Descripción | |------|---------|-------------| | `--base-directory` `PATH` | Raíz de ComfyUI | Directorio base para los directorios de modelos, custom_nodes, entrada, salida, temp y usuario. | -| `--models-directory` `PATH` | Raíz de ComfyUI/models | Directorio de modelos. Anula la carpeta de modelos en `--base-directory`. | -| `--extra-model-paths-config` `PATH` | — | Carga uno o más archivos `extra_model_paths.yaml`. Se puede especificar varias veces. | +| `--models-directory` `PATH` | Raíz de ComfyUI/models | Directorio de modelos. Anula la carpeta de modelos de `--base-directory`. | +| `--extra-model-paths-config` `PATH` | — | Carga uno o más archivos `extra_model_paths.yaml`. Puedes especificarlo varias veces. | | `--output-directory` `PATH` | — | Directorio de salida. Anula `--base-directory`. | | `--temp-directory` `PATH` | — | Directorio temporal. Anula `--base-directory`. | | `--input-directory` `PATH` | — | Directorio de entrada. Anula `--base-directory`. | @@ -69,31 +75,30 @@ python main.py --port 8443 --tls-keyfile key.pem --tls-certfile cert.pem ## Inicio y navegador -| Flag | Predeterminado | Descripción | +| Opción | Predeterminado | Descripción | |------|---------|-------------| -| `--auto-launch` | deshabilitado | Abre ComfyUI automáticamente en el navegador predeterminado al iniciar. | -| `--disable-auto-launch` | deshabilitado | Deshabilita la apertura automática del navegador. | -| `--windows-standalone-build` | deshabilitado | Modo de comodidad de la compilación portable de Windows. Habilita la apertura automática al iniciar (equivale a `--auto-launch`) y activa el sistema de recursos. | +| `--auto-launch` | desactivado | Abre ComfyUI automáticamente en el navegador predeterminado al iniciar. | +| `--disable-auto-launch` | desactivado | Desactiva la apertura automática del navegador. | +| `--windows-standalone-build` | desactivado | Modo de conveniencia para la compilación portable de Windows. Habilita la apertura automática al iniciar (equivalente a `--auto-launch`) y activa el sistema de recursos. | - `--windows-standalone-build` establece `auto_launch` en `true` y habilita el sistema de recursos. `--disable-auto-launch` anula la apertura del navegador y `--disable-assets` anula el sistema de recursos. Para ejecutar como servidor sin abrir un navegador, usa `--disable-auto-launch`. + `--windows-standalone-build` establece `auto_launch` en `true` y activa el sistema de recursos. `--disable-auto-launch` anula la apertura del navegador y `--disable-assets` anula el sistema de recursos. Para ejecutar como servidor sin abrir un navegador, usa `--disable-auto-launch`. ```bash # Run server without opening browser python main.py --disable-auto-launch ``` - ## Dispositivos y CUDA | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--cuda-device` `DEVICE_ID` | Ninguno | IDs de dispositivo CUDA que se usarán, separados por comas (p. ej. `0` o `0,1`), o `all` para conservar todos los dispositivos visibles en ese momento. Los demás dispositivos quedan ocultos. | -| `--default-device` `ID` | Ninguno | ID del dispositivo predeterminado. Todos los demás dispositivos permanecen visibles. | -| `--cuda-malloc` | automático (torch 2.0+) | Habilita cudaMallocAsync. Es mutuamente excluyente con `--disable-cuda-malloc`. | +| `--cuda-device` `DEVICE_ID` | Ninguno | IDs de dispositivo CUDA que se usarán, separados por comas (p. ej., `0` o `0,1`), o `all` para mantener todos los dispositivos visibles actualmente. Los demás dispositivos quedan ocultos. | +| `--default-device` `ID` | Ninguno | ID de dispositivo predeterminado. Todos los demás dispositivos permanecen visibles. | +| `--cuda-malloc` | Automático (torch 2.0+) | Habilita cudaMallocAsync. Es mutuamente excluyente con `--disable-cuda-malloc`. | | `--disable-cuda-malloc` | Ninguno | Deshabilita cudaMallocAsync. Es mutuamente excluyente con `--cuda-malloc`. | -| `--directml` `[DEVICE]` | Ninguno | Usa torch-directml. Índice de dispositivo opcional; si no se indica un valor, se usa `-1` de forma predeterminada. | -| `--oneapi-device-selector` `STRING` | Ninguno | Cadena selectora de dispositivo oneAPI para dispositivos Intel. | +| `--directml` `[DEVICE]` | Ninguno | Usa torch-directml. Índice de dispositivo opcional; el valor predeterminado es `-1` cuando no se proporciona ningún valor. | +| `--oneapi-device-selector` `STRING` | Ninguno | Cadena selectora de dispositivos oneAPI para dispositivos Intel. | En Windows, ComfyUI usa solo la GPU 0 de forma predeterminada. Para restaurar todas las GPU, pasa `--cuda-device all`. @@ -102,7 +107,7 @@ python main.py --disable-auto-launch ## Precisión e inferencia - Los flags de los grupos **Global**, **UNET**, **VAE** y **Text Encoder** que aparecen a continuación son mutuamente excluyentes dentro de cada grupo. Solo puedes usar un flag por grupo a la vez. + Los flags de los grupos **Global**, **UNET**, **VAE** y **Text Encoder** que aparecen abajo son mutuamente excluyentes dentro de cada grupo. Solo puedes usar un flag por grupo a la vez. ### Punto flotante global @@ -116,17 +121,17 @@ python main.py --disable-auto-launch | Flag | Descripción | |------|-------------| -| `--fp32-unet` | Ejecuta el modelo de difusión en fp32. | -| `--fp64-unet` | Ejecuta el modelo de difusión en fp64. | -| `--bf16-unet` | Ejecuta el modelo de difusión en bf16. | -| `--fp16-unet` | Ejecuta el modelo de difusión en fp16. | +| `--fp32-unet` | Ejecuta el modelo de diffusion en fp32. | +| `--fp64-unet` | Ejecuta el modelo de diffusion en fp64. | +| `--bf16-unet` | Ejecuta el modelo de diffusion en bf16. | +| `--fp16-unet` | Ejecuta el modelo de diffusion en fp16. | | `--fp8_e4m3fn-unet` | Almacena los pesos de UNET en fp8 (e4m3fn). | | `--fp8_e5m2-unet` | Almacena los pesos de UNET en fp8 (e5m2). | | `--fp8_e8m0fnu-unet` | Almacena los pesos de UNET en fp8 (e8m0fnu). | -Cada sufijo de flag de FP8 indica un formato de coma flotante de 8 bits de la especificación FP8 de la industria (ONNX / OCP): +Cada sufijo de flag FP8 corresponde a un formato de coma flotante de 8 bits de la especificación FP8 de la industria (ONNX / OCP): - **e4m3fn**: 4 bits de exponente, 3 bits de mantisa. Buen equilibrio entre precisión y alcance para los pesos del modelo en GPU NVIDIA Ada Lovelace y posteriores. -- **e5m2**: 5 bits de exponente, 2 bits de mantisa. Mayor rango dinámico pero menor precisión que e4m3fn. Útil cuando las magnitudes de los pesos varían mucho. +- **e5m2**: 5 bits de exponente, 2 bits de mantisa. Mayor rango dinámico pero menor precisión que e4m3fn. Útil cuando la magnitud de los pesos varía mucho. - **e8m0fnu**: 8 bits de exponente, 0 bits de mantisa. Máximo rango dinámico sin precisión fraccionaria. Normalmente se usa como factor de escala por bloques (solo potencias de dos). ### Precisión de VAE @@ -154,96 +159,96 @@ Consulta la sección [Precisión de UNET](#precisión-de-unet) para ver la expli | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--fp16-intermediates` | deshabilitado | Experimental: usa fp16 para los tensores intermedios entre nodos en lugar de fp32. | -| `--force-channels-last` | deshabilitado | Fuerza el formato de memoria de canales al final durante la inferencia. | -| `--supports-fp8-compute` | deshabilitado | Actúa como si el dispositivo admitiera cómputo fp8. | -| `--enable-triton-backend` | deshabilitado | Habilita el backend Triton en comfy-kitchen. Deshabilitado de forma predeterminada al iniciar. | -| `--disable-triton-backend` | deshabilitado | Fuerza la deshabilitación del backend Triton de comfy-kitchen, anulando `--enable-triton-backend`. | +| `--fp16-intermediates` | disabled | Experimental: usa fp16 para los tensores intermedios entre nodos en lugar de fp32. | +| `--force-channels-last` | disabled | Fuerza el formato de memoria de los canales al final durante la inferencia. | +| `--supports-fp8-compute` | disabled | Actúa como si el dispositivo admitiera cómputo fp8. | +| `--enable-triton-backend` | disabled | Habilita el backend Triton en comfy-kitchen. Deshabilitado de forma predeterminada al iniciar. | +| `--disable-triton-backend` | disabled | Fuerza la desactivación del backend Triton de comfy-kitchen, anulando `--enable-triton-backend`. | ## Vista previa | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--preview-method` | `none` | Método de vista previa para nodos sampler. Opciones: `none`, `auto`, `latent2rgb`, `taesd`. | +| `--preview-method` | `none` | Método de vista previa para los nodos sampler. Opciones: `none`, `auto`, `latent2rgb`, `taesd`. | | `--preview-size` | `512` | Tamaño máximo de la vista previa de imagen en píxeles. | ## Caché - Los flags de modo de caché son mutuamente excluyentes. Solo debes usar uno de `--cache-ram`, `--cache-classic`, `--high-ram`, `--cache-lru` o `--cache-none`. + Las flags de modo de caché son mutuamente excluyentes. Solo debes usar una de `--cache-ram`, `--cache-classic`, `--high-ram`, `--cache-lru` o `--cache-none`. | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--cache-ram` `[GB] [GB]` | habilitado (modo predeterminado) | Caché por presión de RAM. Primer valor: umbral de caché activa en GB. Segundo valor opcional: umbral de caché inactiva/anclaje en GB. Si no se dan valores: activa = 10 % de la RAM del sistema (mín. 2 GB, máx. 10 GB); inactiva = 100 % de la RAM del sistema (máx. 128 GB). Acepta como máximo dos valores. | -| `--cache-classic` | — | Usa el antiguo estilo de caché agresiva. | +| `--cache-ram` `[GB] [GB]` | habilitado (modo predeterminado) | Caché por presión de RAM. Primer valor: umbral de caché activa en GB. Segundo valor opcional: umbral de caché inactiva/anclaje en GB. Cuando no se indican valores: activa = 10 % de la RAM del sistema (mín. 2 GB, máx. 10 GB); inactiva = 100 % de la RAM del sistema (máx. 128 GB). Acepta como máximo dos valores. | +| `--cache-classic` | Ninguno | Usar el antiguo estilo de caché agresivo. | | `--high-ram` | deshabilitado | Puede mejorar ligeramente el rendimiento en sistemas con abundante RAM o donde se prefiere usar el archivo de paginación antes que recargar modelos. También habilita la caché clásica. | -| `--cache-lru` `N` | `0` (deshabilitado) | Caché LRU con un máximo de N resultados de nodo en caché. Sin límite superior estricto; está acotada por la RAM/VRAM disponible. Puede usar más RAM/VRAM. | -| `--cache-none` | — | Menor uso de RAM/VRAM; vuelve a ejecutar cada nodo en cada ejecución. | +| `--cache-lru` `N` | `0` (deshabilitado) | Caché LRU con un máximo de N resultados de nodo en caché. Sin límite superior estricto; está limitada por la RAM/VRAM disponible. Puede consumir más RAM/VRAM. | +| `--cache-none` | Ninguno | Menor uso de RAM/VRAM; vuelve a ejecutar todos los nodos en cada ejecución. | - ComfyUI reutiliza los resultados de nodo en caché entre ejecuciones de la misma sesión, y eso es lo que hace más rápidas las ejecuciones repetidas. Usa `--cache-none` cuando prefieras que cada ejecución comience con una caché limpia, por ejemplo mientras depuras un flujo de trabajo o descartas la reutilización de la caché entre ejecuciones. Cada nodo se vuelve a ejecutar, así que las generaciones tardan más. Es un flag de inicio, por lo que debes reiniciar ComfyUI para que tenga efecto. + ComfyUI reutiliza los resultados de nodo en caché entre ejecuciones de la misma sesión, y eso es lo que hace más rápidas las ejecuciones repetidas. Usa `--cache-none` cuando prefieras que cada ejecución empiece con una caché limpia, por ejemplo, al depurar un flujo de trabajo o al descartar la reutilización de caché entre ejecuciones. Todos los nodos se vuelven a ejecutar, así que las generaciones tardan más. Es una flag de inicio, así que reinicia ComfyUI para que surta efecto. ## Atención - Las flags de método de atención cruzada son mutuamente excluyentes. La atención dividida y la atención quad se ignoran cuando se usa xformers. + Las flags del método de cross-attention son mutuamente excluyentes. Las atenciones split y quad se ignoran cuando se usa xformers. | Flag | Descripción | |------|-------------| -| `--use-split-cross-attention` | Usar la optimización de atención cruzada dividida. | -| `--use-quad-cross-attention` | Usar la optimización de atención cruzada subcuadrática. | -| `--use-pytorch-cross-attention` | Usar la atención cruzada de PyTorch 2.0. | -| `--use-sage-attention` | Usar la atención Sage. | -| `--use-flash-attention` | Usar FlashAttention. | -| `--use-ck-attention` | Usar la atención de Comfy Kitchen. Requiere soporte de hardware para sus kernels INT8. | -| `--disable-xformers` | Desactivar xformers. | -| `--force-upcast-attention` | Forzar el upcasting de atención. Reporta si esto soluciona las imágenes negras. Es mutuamente excluyente con `--dont-upcast-attention`. | -| `--dont-upcast-attention` | Desactivar todo el upcasting de atención. Solo para depuración. | +| `--use-split-cross-attention` | Usa la optimización de atención cruzada split. | +| `--use-quad-cross-attention` | Usa la optimización de atención cruzada subcuadrática. | +| `--use-pytorch-cross-attention` | Usa la atención cruzada de PyTorch 2.0. | +| `--use-sage-attention` | Usa Sage attention. | +| `--use-flash-attention` | Usa FlashAttention. | +| `--use-ck-attention` | Usa la atención de Comfy Kitchen. Requiere soporte de hardware para sus kernels INT8. | +| `--disable-xformers` | Desactiva xformers. | +| `--force-upcast-attention` | Fuerza el upcasting de atención. Reporta si esto corrige las imágenes negras. Mutuamente excluyente con `--dont-upcast-attention`. | +| `--dont-upcast-attention` | Desactiva todo el upcasting de atención. Solo para depuración. | ## VRAM y memoria -La descarga asíncrona de pesos está activada por defecto en GPU Nvidia y AMD, y la VRAM dinámica se habilita automáticamente donde es compatible. Los flags siguientes anulan esos valores predeterminados. +La descarga asíncrona de pesos está activada de forma predeterminada en GPUs Nvidia y AMD, y la VRAM dinámica se habilita automáticamente donde es compatible. Las flags siguientes anulan esos valores predeterminados. - Los flags de modo de VRAM (`--gpu-only`, `--highvram`, `--lowvram`, `--novram`, `--cpu`) son mutuamente excluyentes. + Las flags de modo de VRAM (`--gpu-only`, `--highvram`, `--lowvram`, `--novram`, `--cpu`) son mutuamente excluyentes. | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--gpu-only` | — | Almacena y ejecuta todo en la GPU (codificadores de texto, CLIP, etc.). | -| `--highvram` | — | Mantiene los modelos en la memoria de la GPU en lugar de descargarlos a la CPU después de usarlos. | -| `--lowvram` | — | No tiene efecto cuando la VRAM dinámica está habilitada. De lo contrario, ejecuta los codificadores de texto en la CPU. | -| `--novram` | — | Uso mínimo de VRAM cuando `--lowvram` no es suficiente. | -| `--cpu` | — | Usa la CPU para todo (lento). | -| `--reserve-vram` `GB` | Depende del sistema operativo | VRAM en GB que se reserva para el sistema operativo y otro software. | -| `--vram-headroom` `GB` | `0` | VRAM adicional en GB que la VRAM dinámica mantiene libre por encima del margen predeterminado. ComfyUI intenta mantener esa cantidad de VRAM completamente libre y sin usar, incluso contando la VRAM que usan otras aplicaciones. | +| `--gpu-only` | N/A | Almacena y ejecuta todo en la GPU (codificadores de texto, CLIP, etc.). | +| `--highvram` | N/A | Mantiene los modelos en la memoria de la GPU en lugar de descargarlos a la CPU después de usarlos. | +| `--lowvram` | N/A | No tiene efecto cuando la VRAM dinámica está habilitada. De lo contrario, ejecuta los codificadores de texto en la CPU. | +| `--novram` | N/A | Uso mínimo de VRAM cuando `--lowvram` no es suficiente. | +| `--cpu` | N/A | Usa la CPU para todo (lento). | +| `--reserve-vram` `GB` | según el SO | VRAM en GB que se reserva para el SO y otro software. | +| `--vram-headroom` `GB` | `0` | VRAM adicional en GB que la VRAM dinámica debe mantener libre por encima del margen predeterminado. ComfyUI intenta mantener esta cantidad de VRAM completamente libre y sin usar, incluso contando la VRAM que usan otras aplicaciones. | | `--disable-nvml-pressure` | deshabilitado | Usa CUDA en lugar de NVML para reportar la presión de memoria de la VRAM dinámica. | -| `--async-offload` `[NUM_STREAMS]` | habilitado en Nvidia y AMD | Descarga asíncrona de pesos. Cantidad de streams opcional (predeterminado: 2). | -| `--disable-async-offload` | — | Deshabilita la descarga asíncrona de pesos. | -| `--disable-dynamic-vram` | — | Deshabilita la VRAM dinámica; usa la carga de modelos basada en estimaciones. | -| `--enable-dynamic-vram` | automático en Nvidia, ROCm 7.14+ | Habilita la VRAM dinámica en sistemas donde no está habilitada por defecto. | -| `--fast-disk` | falso | Fuerza la carga y descarga dinámicas respaldadas por disco en lugar de la RAM no fijada. Útil con NVMe rápido. Cuando no se establece ni este flag ni `--disable-fast-disk`, la carga y descarga respaldadas por disco se habilitan automáticamente si todos los archivos de modelos están en almacenamiento detectado como rápido. | -| `--disable-fast-disk` | deshabilitado | Deshabilita la carga y descarga dinámicas respaldadas por disco, de modo que se usa la RAM no fijada en su lugar. Anula `--fast-disk` y la detección automática. | -| `--disable-cuda-graphs` | deshabilitado | Deshabilita los CUDA graphs. | -| `--disable-comfy-compiler` | deshabilitado | Deshabilita el compilador de modelos de Comfy, incluida su subfunción de CUDA graphs. | -| `--assert-graph-breaks` | deshabilitado | Falla cuando el compilador de modelos de Comfy produce interrupciones del gráfico. | +| `--async-offload` `[NUM_STREAMS]` | habilitado en Nvidia y AMD | Descarga asíncrona de pesos. Cantidad opcional de flujos (predeterminado: 2). | +| `--disable-async-offload` | N/A | Deshabilita la descarga asíncrona de pesos. | +| `--disable-dynamic-vram` | N/A | Deshabilita la VRAM dinámica; usa carga de modelos basada en estimaciones. | +| `--enable-dynamic-vram` | automático en Nvidia, ROCm 7.14+ | Habilita la VRAM dinámica en sistemas donde no está habilitada de forma predeterminada. | +| `--fast-disk` | false | Fuerza la carga dinámica y la descarga respaldadas por disco en lugar de la RAM no fijada. Útil con NVMe rápido. Cuando no se establece esta flag ni `--disable-fast-disk`, la carga y la descarga respaldadas por disco se habilitan automáticamente si todos los archivos de modelo están en un almacenamiento detectado como rápido. | +| `--disable-fast-disk` | deshabilitado | Deshabilita la carga dinámica y la descarga respaldadas por disco, por lo que se usa la RAM no fijada en su lugar. Anula `--fast-disk` y la detección automática. | +| `--disable-cuda-graphs` | deshabilitado | Deshabilita los grafos CUDA. | +| `--disable-comfy-compiler` | deshabilitado | Deshabilita el compilador de modelos de Comfy, incluida su subcaracterística de grafos CUDA. | +| `--assert-graph-breaks` | deshabilitado | Falla ante roturas de grafo del compilador de modelos de Comfy. | | `--force-non-blocking` | deshabilitado | Fuerza operaciones de tensor no bloqueantes. Puede ayudar en sistemas que no son Nvidia; puede romper algunos flujos de trabajo. | -| `--disable-smart-memory` | deshabilitado | Descarga de forma agresiva a la RAM en lugar de mantener los modelos en la VRAM. | +| `--disable-smart-memory` | deshabilitado | Descarga agresivamente a la RAM en lugar de mantener los modelos en la VRAM. | | `--disable-pinned-memory` | deshabilitado | Deshabilita el uso de memoria fijada. | | `--mmap-torch-files` | deshabilitado | Usa mmap al cargar archivos ckpt/pt. | | `--disable-mmap` | deshabilitado | No usa mmap al cargar safetensors. | ## Rendimiento y depuración -| Flag | Predeterminado | Descripción | +| Opción | Predeterminado | Descripción | |------|---------|-------------| -| `--fast` `[OPT...]` | deshabilitado | Habilita optimizaciones experimentales que pueden afectar a la calidad o a la estabilidad. `--fast` por sí solo las habilita todas. Opciones específicas: `fp16_accumulation`, `fp8_matrix_mult`, `cublas_ops`, `autotune`. | -| `--deterministic` | deshabilitado | Usa algoritmos deterministas de PyTorch, más lentos, cuando es posible. No garantiza imágenes idénticas en todos los casos. | -| `--default-hashing-function` | `sha256` | Función hash para comparar nombres y contenidos de archivos duplicados. Opciones: `md5`, `sha1`, `sha256`, `sha512`. | -| `--debug-hang` | deshabilitado | Habilita el volcado de trazas de pila con Ctrl-C para depurar bloqueos. | +| `--fast` `[OPT...]` | deshabilitado | Habilita optimizaciones experimentales que pueden afectar la calidad o la estabilidad. `--fast` por sí solo habilita todas. Opciones específicas: `fp16_accumulation`, `fp8_matrix_mult`, `cublas_ops`, `autotune`. | +| `--deterministic` | deshabilitado | Usa algoritmos deterministas de PyTorch más lentos cuando sea posible. No garantiza imágenes idénticas en todos los casos. | +| `--default-hashing-function` | `sha256` | Función hash para la comparación de nombres de archivo y contenido duplicados. Opciones: `md5`, `sha1`, `sha256`, `sha512`. | +| `--debug-hang` | deshabilitado | Habilita volcados de seguimiento de pila al pulsar Ctrl-C para depurar bloqueos. | ```bash # Enable all fast optimizations (experimental) @@ -252,31 +257,30 @@ python main.py --fast # Enable specific optimizations only python main.py --fast fp16_accumulation cublas_ops ``` +## Administrador de ComfyUI -## ComfyUI Manager - -Consulta [ComfyUI-Manager Installation](/es/manager/install) para ver las instrucciones de configuración. +Consulta [Instalación de ComfyUI-Manager](/es/manager/install) para las instrucciones de configuración. -| Opción | Descripción | +| Flag | Descripción | |------|-------------| -| `--enable-manager` | Habilita ComfyUI-Manager. | -| `--disable-manager-ui` | Deshabilita solo la UI y los endpoints ComfyUI Manager. Las tareas en segundo plano (instalaciones programadas, etc.) continúan. Requiere `--enable-manager`. | -| `--enable-manager-legacy-ui` | Usa la UI clásica ComfyUI Manager. Implica `--enable-manager`. Es mutuamente excluyente con `--disable-manager-ui`. | +| `--enable-manager` | Habilita el Administrador de ComfyUI. | +| `--disable-manager-ui` | Deshabilita solo la interfaz y los endpoints del Administrador. Las tareas en segundo plano (instalaciones programadas, etc.) continúan. Requiere `--enable-manager`. | +| `--enable-manager-legacy-ui` | Usa la interfaz clásica del Administrador. Implica `--enable-manager`. Es mutuamente excluyente con `--disable-manager-ui`. | -## Nodos personalizados y nodos de API +## Nodos personalizados y Nodos API -| Flag | Predeterminado | Descripción | +| Bandera | Predeterminado | Descripción | |------|---------|-------------| -| `--disable-all-custom-nodes` | deshabilitado | Deshabilita la carga de todos los nodos personalizados. | -| `--whitelist-custom-nodes` `FOLDER...` | — | Carpetas de nodos personalizados que se cargan incluso cuando `--disable-all-custom-nodes` está establecido. | -| `--disabled-nodes-config` `PATH` | — | Ruta a un archivo YAML que enumera los IDs de nodo a deshabilitar. El archivo debe contener una lista `disabled_nodes` con cadenas de IDs de nodo. | -| `--disable-partner-nodes` | deshabilitado | Deshabilita la carga de Nodos asociados (los nodos de API de pago). El frontend conserva su acceso a internet. | -| `--offline` | deshabilitado | Impide que el frontend se comunique con internet añadiendo una Content-Security-Policy restrictiva. También deshabilita los Nodos asociados. | -| `--disable-api-nodes` | deshabilitado | Alias obsoleto de `--offline`. Usa `--offline`, o `--disable-partner-nodes` para deshabilitar solo los Nodos asociados. | -| `--disable-metadata` | deshabilitado | Deshabilita el guardado de los metadatos del prompt en los archivos de salida. | +| `--disable-all-custom-nodes` | disabled | Desactiva la carga de todos los nodos personalizados. | +| `--whitelist-custom-nodes` `FOLDER...` | — | Carpetas de nodos personalizados que se cargan incluso cuando `--disable-all-custom-nodes` está activado. | +| `--disabled-nodes-config` `PATH` | — | Ruta a un archivo YAML que enumera los ID de nodo que se van a desactivar. El archivo debe contener una lista `disabled_nodes` con cadenas de ID de nodo. | +| `--disable-partner-nodes` | disabled | Desactiva la carga de los Nodos asociados (los nodos API de pago). El frontend conserva su acceso a internet. | +| `--offline` | disabled | Impide que el frontend se comunique con internet agregando una Content-Security-Policy restrictiva. También desactiva los Nodos asociados. | +| `--disable-api-nodes` | disabled | Alias obsoleto de `--offline`. Usa `--offline`, o `--disable-partner-nodes` para desactivar solo los Nodos asociados. | +| `--disable-metadata` | disabled | Desactiva el guardado de los metadatos del prompt en los archivos de salida. | - `--offline` también cambia lo que el navegador puede cargar. El flag añade una Content-Security-Policy que mantiene la página en recursos servidos por el propio ComfyUI, así que las imágenes, fuentes, medios, fotogramas y solicitudes de red de otros orígenes quedan bloqueados, y los Nodos asociados (nodos de API) no se registran en absoluto. Si una vista previa o una miniatura que normalmente se carga desaparece después de un reinicio, revisa los argumentos de inicio en busca de este flag antes de depurar el nodo. `--disable-partner-nodes` solo impide que se carguen los Nodos asociados y deja intacto el resto del acceso a internet del frontend. + `--offline` también cambia lo que el navegador puede cargar. La opción agrega una Content-Security-Policy que mantiene la página en recursos servidos por el propio ComfyUI, por lo que se bloquean las imágenes, las fuentes, los medios, los frames y las solicitudes de red de otros orígenes, y los Nodos asociados (nodos API) no se registran en absoluto. Si después de reiniciar desaparece una vista previa o una miniatura que normalmente se carga, revisa los argumentos de inicio en busca de esta opción antes de solucionar problemas del nodo. `--disable-partner-nodes` solo impide que se carguen los Nodos asociados y deja intacto el resto del acceso a internet del frontend. ```bash @@ -286,20 +290,19 @@ python main.py --disable-all-custom-nodes # Allow only specific custom nodes python main.py --disable-all-custom-nodes --whitelist-custom-nodes ComfyUI-Manager ``` - ## Frontend y API | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--front-end-version` | `comfyanonymous/ComfyUI@latest` | Versión del frontend con el formato `[owner]/[repo]@[version]`. Requiere internet para descargarla desde las releases de GitHub. La versión puede ser `latest` o una versión semver (p. ej. `1.0.0`). | +| `--front-end-version` | `comfyanonymous/ComfyUI@latest` | Versión del frontend en formato `[owner]/[repo]@[version]`. Requiere internet para descargarla desde las releases de GitHub. La versión puede ser `latest` o una versión semver (por ejemplo, `1.0.0`). | | `--front-end-root` `PATH` | — | Ruta del sistema de archivos local al directorio del frontend. Anula `--front-end-version`. | | `--comfy-api-base` | `https://api.comfy.org` | URL base de la API de ComfyUI. | -| `--database-url` | `sqlite:////user/comfyui.db` | URL de la base de datos. Usa `sqlite:///:memory:` para usar la memoria. | -| `--enable-assets` | deshabilitado | Habilita el sistema de recursos (rutas de API, sincronización con la base de datos, escaneo en segundo plano). | +| `--database-url` | `sqlite:////user/comfyui.db` | URL de la base de datos. Usa `sqlite:///:memory:` para memoria en RAM. | +| `--enable-assets` | deshabilitado | Habilita el sistema de recursos (rutas de la API, sincronización con la base de datos, escaneo en segundo plano). | | `--disable-assets` | deshabilitado | Deshabilita el sistema de recursos, incluso cuando `--enable-assets` o `--windows-standalone-build` están activados. | -| `--enable-asset-hashing` | deshabilitado | Calcula hashes de contenido blake3 al escanear recursos. Habilita futuras funciones de portabilidad de recursos, como la deduplicación y la resolución de modelos entre máquinas, a costa del tiempo de inicio y del hashing en cada salida con directorios de modelos grandes. Desactivado de forma predeterminada; requiere el sistema de recursos (`--enable-assets` o `--windows-standalone-build`). | -| `--feature-flag` `KEY[=VALUE]` | — | Establece un feature flag del servidor. `KEY` por sí solo establece verdadero. Se puede repetir. Los booleanos y los números se convierten automáticamente. | -| `--list-feature-flags` | — | Imprime como JSON los feature flags conocidos que se pueden establecer desde la CLI y sale. | +| `--enable-asset-hashing` | deshabilitado | Calcula hashes de contenido blake3 al escanear recursos. Habilita futuras funciones de portabilidad de recursos, como la deduplicación y la resolución de modelos entre máquinas, a costa del tiempo de inicio y del hashing de cada salida en directorios de modelos grandes. Desactivado de forma predeterminada; requiere el sistema de recursos (`--enable-assets` o `--windows-standalone-build`). | +| `--feature-flag` `KEY[=VALUE]` | — | Establece una flag de funcionalidad del servidor. Una `KEY` sin valor la establece en verdadero. Se puede repetir. Los booleanos y los números se convierten automáticamente. | +| `--list-feature-flags` | — | Imprime en JSON las flags de funcionalidad conocidas que se pueden establecer desde la CLI y sale. | ```bash # List available feature flags @@ -308,7 +311,6 @@ python main.py --list-feature-flags # Set feature flags python main.py --feature-flag show_signin_button=true ``` - ## Registro y varios | Flag | Predeterminado | Descripción | @@ -316,12 +318,12 @@ python main.py --feature-flag show_signin_button=true | `--verbose` `[LEVEL] [FILE]` | `INFO` | Nivel de registro. Opciones: `DEBUG`, `DETAIL`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`. `--verbose` por sí solo establece `DEBUG`. Agrega un nivel seguido de una ruta de archivo para escribir ese nivel también en un archivo; el flag se puede repetir para configurar juntas las salidas de consola y de archivo. | | `--log-stdout` | deshabilitado | Envía la salida normal del proceso a stdout en lugar de stderr. | | `--dont-print-server` | deshabilitado | No imprime la salida del servidor en la consola. | -| `--disable-product-tips` | deshabilitado | Oculta los consejos de la consola acerca de los productos comerciales y los despliegues de Comfy-Org. Equivale a establecer `COMFYUI_DISABLE_PRODUCT_TIPS=1`. Los consejos también se omiten con `CI`, `--dont-print-server` o `--windows-standalone-build`. | +| `--disable-product-tips` | deshabilitado | Oculta los consejos de la consola sobre productos comerciales y despliegues de Comfy-Org. Equivale a establecer `COMFYUI_DISABLE_PRODUCT_TIPS=1`. Los consejos también se omiten con `CI`, `--dont-print-server` o `--windows-standalone-build`. | | `--multi-user` | deshabilitado | Habilita el almacenamiento por usuario. | -| `--quick-test-for-ci` | deshabilitado | Prueba de inicio rápida para CI. Sale inmediatamente después de la inicialización. | +| `--quick-test-for-ci` | deshabilitado | Prueba rápida de inicio para CI. Sale inmediatamente después de la inicialización. | --- - Esta referencia se basa en ComfyUI [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). Al actualizar ComfyUI, ejecuta `python main.py --help` o compara tu [`cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py) local con esta página para comprobar si hay flags nuevos o modificados. + Esta referencia se basa en [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py) de ComfyUI. Al actualizar ComfyUI, ejecuta `python main.py --help` o compara tu [`cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py) local con esta página para comprobar si hay flags nuevos o modificados. diff --git a/es/development/serverless/overview.mdx b/es/development/serverless/overview.mdx index f7c49310c2..fc1badf1c5 100644 --- a/es/development/serverless/overview.mdx +++ b/es/development/serverless/overview.mdx @@ -3,18 +3,22 @@ title: "Guía de despliegue de Comfy API" sidebarTitle: "Guía de despliegue" description: "Administra compilaciones, versiones, despliegues, escalado, facturación y solución de problemas de Comfy API." icon: "cloud-arrow-up" -translationSourceHash: f7bfa813 +translationSourceHash: 2184a3a5 translationFrom: development/serverless/overview.mdx translationBlockHashes: "_intro": f163eb63 "Platform concepts": 97134dfe + "The Build file": 70f351b1 + "Update and release": 66e5f4ab "Regions and GPU availability": fe40705f "Workspace limits": e0643567 "Monitor and call a deployment": ff860dab + "Operate a deployment": de5e72b5 "Inspect and clean up": 0033fd9b "FAQ": 54896279 "Next steps": 0045baa9 --- + Comfy API permite que tu aplicación ejecute flujos de trabajo de ComfyUI a través de un endpoint gestionado. Empaquetas la versión de ComfyUI, los modelos, los nodos personalizados y las dependencias que necesita el flujo de trabajo, y luego Comfy lo ejecuta en GPUs gestionadas. Úsalo cuando necesites un entorno repetible y un endpoint al que tu aplicación pueda llamar. ## Conceptos de la plataforma @@ -34,25 +38,24 @@ Los flujos de trabajo compatibles con [Comfy Cloud](/es/development/deploy/cloud Para las instantáneas de Desktop y las importaciones de flujos de trabajo en JSON, consulta [Orígenes de Build](/es/development/serverless/build-sources). -## El archivo Build +## El archivo de Build -`comfy-build.yaml` guarda la definición del Build y el último estado remoto conocido. La CLI usa ese estado para detectar cuándo ha cambiado el Build remoto. Mantén el archivo junto al proyecto. Describe el entorno, pero no contiene archivos de modelos. +`comfy-build.yaml` almacena la definición del Build y el último estado remoto conocido. La CLI usa ese estado para detectar cuándo ha cambiado el Build remoto. Mantén el archivo junto al proyecto. Describe el entorno, pero no contiene archivos de modelo. -Comprueba cómo se compara el Build local con la instalación y con la versión remota antes de publicar cambios: +Comprueba cómo se compara el Build local con la instalación y la versión remota antes de subir cambios: ```bash comfy build status ``` +## Actualizar y publicar una versión -## Actualizar y publicar - -Después de cambiar la instalación local, actualiza la definición del Build: +Después de cambiar la instalación local, actualiza la definición de Build: ```bash comfy build update --yes ``` -Para crear otra versión a partir de un Build existente, consulta los destinos admitidos y selecciona uno: +Para crear otra versión a partir de un Build existente, consulta los objetivos admitidos y elige uno: ```bash comfy build refs build-targets @@ -64,42 +67,40 @@ Sigue el registro de compilación de una versión con: ```bash comfy build release logs rel_123456 --target linux/nvidia --follow ``` - ## Regiones y disponibilidad de GPU -La capacidad de las regiones cambia, así que consulta el catálogo de la plataforma al elegir un objetivo de implementación. Filtra los resultados con `--region `: +La capacidad de las regiones cambia, así que consulta el catálogo de la plataforma cuando elijas un objetivo de despliegue. Filtra los resultados con `--region `: ```bash comfy deploy refs compute --region ``` -El catálogo es la fuente de verdad sobre qué clases de GPU están disponibles en cada región al momento de la implementación. +El catálogo es la fuente de referencia sobre qué clases de GPU están disponibles en cada región en el momento del despliegue. ## Límites del espacio de trabajo -Consulta [Limits](https://platform.comfy.org/profile/limits) para ver el uso y los límites de tu plan de tu espacio de trabajo. Mantén `--max` dentro del límite de workers por despliegue. +Consulta [Limits](https://platform.comfy.org/profile/limits) para ver el uso y los límites de tu plan de espacio de trabajo. Mantén `--max` dentro del límite de workers por despliegue. ## Supervisar y llamar a un despliegue Las opciones `--min` y `--max` establecen los límites de workers. Ejecuta `comfy deploy status --watch` para seguir el estado del despliegue, la vigencia de las versiones y la actividad de servicio. -También puedes llamar al endpoint con los [SDK de Comfy](/es/development/api-development/sdks). Establece `COMFY_BASE_URL` en la URL del despliegue y proporciona una clave API. Consulta [Elegir una URL base](/es/development/api-development/sdks#elegir-una-url-base). +También puedes llamar al endpoint con los [Comfy SDKs](/es/development/api-development/sdks). Establece `COMFY_BASE_URL` con la URL del despliegue y proporciona una clave API. Consulta [Elegir una URL base](/es/development/api-development/sdks#elegir-una-url-base). ## Operar un despliegue ```bash -# Cambiar los límites de workers +# Change the worker bounds comfy deploy scale --deployment dep_123456 --min 2 --max 5 -# Pausar o reanudar conservando el registro del despliegue +# Pause or resume while retaining the deployment record comfy deploy stop --deployment dep_123456 comfy deploy start --deployment dep_123456 ``` - ## Inspeccionar y limpiar ```bash -# Estado del build +# Estado de Build comfy build ls comfy build show --id bld_123456 comfy build release ls @@ -112,46 +113,46 @@ comfy deploy events --deployment dep_123456 ``` - Eliminar un despliegue y eliminar un Build son operaciones irreversibles e independientes. Confirma el objetivo antes de usar `comfy deploy delete --yes` o `comfy build delete --id bld_123456 --yes`. + Eliminar un despliegue y eliminar un Build son operaciones irreversibles independientes. Confirma el objetivo antes de usar `comfy deploy delete --yes` o `comfy build delete --id bld_123456 --yes`. ## Preguntas frecuentes - - Sí. En el Builder, sube uno o más flujos de trabajo para preseleccionar sus modelos y nodos personalizados. Incluye las dependencias que necesitan todos los flujos de trabajo que planeas ejecutar y luego envía cada flujo de trabajo en formato API al endpoint desplegado. + + Sí. En el Builder, sube uno o más flujos de trabajo para preseleccionar sus modelos y nodos personalizados. Incluye las dependencias que necesitan todos los flujos de trabajo que planeas ejecutar y después envía cada flujo de trabajo en formato API al endpoint desplegado. Cada despliegue usa un solo tipo de GPU. Para ejecutar flujos de trabajo en distintos tipos de GPU, crea despliegues separados del mismo Build. - - No. Los Builds y sus releases se guardan en tu cuenta sin costo. No se te factura el espacio de almacenamiento de un Build hasta que lo despliegas. + + No. Los Builds y sus releases se guardan en tu cuenta sin cargo. No se te factura el espacio de almacenamiento de un Build hasta que lo despliegas. La facturación de almacenamiento comienza con un despliegue: - - Cuando despliegas un release, sus modelos se preparan en almacenamiento de red compartido por los workers del despliegue. El almacenamiento es de solo lectura después del despliegue y se factura por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso mientras un despliegue está en pausa con `comfy deploy stop`. + - Cuando despliegas un release, sus modelos se preparan en el almacenamiento en red que comparten los workers del despliegue. Ese almacenamiento es de solo lectura después del despliegue y se factura por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso mientras un despliegue está en pausa con `comfy deploy stop`. - Cada worker también recibe un disco de contenedor fijo de 50 GB. Es efímero y solo se factura mientras el worker está en ejecución, como parte del costo de cómputo del worker. - - Eliminar un despliegue libera su cómputo. El almacenamiento de red preparado se limpia poco después de que se elimine el último despliegue que lo usa en esa región, y su facturación termina. + - Eliminar un despliegue libera su cómputo. El almacenamiento en red preparado se limpia poco después de eliminar el último despliegue que lo usa en esa región, y la facturación correspondiente termina. - Para conocer las tarifas de almacenamiento vigentes, consulta la [página de precios de Comfy](https://www.comfy.org/pricing). El catálogo de cómputo (`comfy deploy refs compute`) y el diálogo de despliegue también muestran las tarifas que aplican a un despliegue. + Para conocer las tarifas de almacenamiento actuales, consulta la [página de precios de Comfy](https://www.comfy.org/pricing). El catálogo de cómputo (`comfy deploy refs compute`) y el diálogo de despliegue también muestran las tarifas que se aplican a un despliegue. - - `--min` define la cantidad de **workers activos**: workers que permanecen en ejecución todo el tiempo para que las solicitudes nunca esperen un inicio en frío. Un worker activo se factura por segundo durante todo el tiempo que está en ejecución, procese tareas o no. + + `--min` establece el número de **workers activos**: workers que permanecen en ejecución en todo momento para que las solicitudes nunca esperen un inicio en frío. Un worker activo se factura por segundo durante todo el tiempo que está en ejecución, procese o no tareas. - Los workers por encima de `--min`, hasta `--max`, son **workers flexibles**. Un worker flexible se factura por segundo desde el momento en que inicia (incluido el arranque y la carga de modelos), durante el procesamiento de tareas, más una breve ventana de inactividad (actualmente 30 segundos) antes de reducirse. Cuando los workers flexibles se reducen, no cuestan nada. Con `--min 0`, todo el despliegue se reduce a cero y no factura cómputo mientras está inactivo, a cambio de un inicio en frío en la primera solicitud. + Los workers por encima de `--min`, hasta `--max`, son **workers flexibles**. Un worker flexible se factura por segundo desde el momento en que arranca (incluidos el arranque y la carga de modelos), durante todo el procesamiento de tareas, más una breve ventana de inactividad (actualmente 30 segundos) antes de reducirse. Cuando los workers flexibles se reducen, no cuestan nada. Con `--min 0`, todo el despliegue se reduce a cero y no factura cómputo mientras está inactivo, a cambio de un inicio en frío en la primera solicitud. - La facturación mide el uso real por segundo de los workers, multiplicado por la cantidad de workers en ejecución. Si tu espacio de trabajo se queda sin créditos, los despliegues se detienen automáticamente. + La facturación mide el uso real por segundo de los workers, multiplicado por el número de workers en ejecución. Si tu espacio de trabajo se queda sin créditos, los despliegues se detienen automáticamente. - Para conocer las tarifas vigentes por worker de GPU, consulta la [página de precios de Comfy](https://www.comfy.org/pricing). Las tarifas se expresan por hora de worker y se facturan por segundo. La disponibilidad de GPU por región proviene del catálogo de cómputo: ejecuta `comfy deploy refs compute` para ver la lista actual. + Para conocer las tarifas actuales de GPU por worker, consulta la [página de precios de Comfy](https://www.comfy.org/pricing). Las tarifas se expresan por hora de worker y se facturan por segundo. La disponibilidad de GPU por región proviene del catálogo de cómputo: ejecuta `comfy deploy refs compute` para ver la lista actual. - Un despliegue distribuye automáticamente las solicitudes entre sus workers y escala dentro de los límites configurados de `--min` y `--max`. Las solicitudes que no pueden ejecutarse de inmediato quedan en cola y se procesan a medida que haya capacidad de workers disponible. + Un despliegue distribuye automáticamente las solicitudes entre sus workers y escala dentro de los límites configurados de `--min` y `--max`. Las solicitudes que no pueden ejecutarse de inmediato se ponen en cola y se procesan a medida que hay capacidad de workers disponible. - - Sigue el estado del despliegue y luego revisa sus registros y eventos para encontrar la causa: + + Sigue el estado del despliegue y después revisa sus registros y eventos para encontrar la causa: ```bash comfy deploy status --deployment --watch @@ -159,11 +160,11 @@ comfy deploy events --deployment dep_123456 comfy deploy events --deployment ``` - Si la GPU o la región seleccionada no tiene capacidad, reintenta más tarde o ejecuta `comfy deploy refs compute` y elige un par de región y GPU disponible. Incluye los ID del Build, del release y del despliegue cuando pidas ayuda. + Si la GPU o la región seleccionada no tiene capacidad, reintenta más tarde o ejecuta `comfy deploy refs compute` y elige un par de región y GPU disponible. Incluye los IDs del Build, del release y del despliegue cuando pidas ayuda. - - Eliminar un despliegue quita su endpoint y libera su cómputo. No elimina el Build ni sus releases. Después de que elimines el último despliegue que usa ese Build en una región, el almacenamiento de red preparado se limpia y la facturación de almacenamiento termina poco después. + + Eliminar un despliegue quita su endpoint y libera su cómputo. No elimina el Build ni sus releases. Después de eliminar el último despliegue que usa ese Build en una región, su almacenamiento en red preparado se limpia y la facturación de almacenamiento termina poco después. Eliminar el Build es una operación aparte: `comfy build delete --id --yes`. @@ -172,16 +173,16 @@ comfy deploy events --deployment dep_123456 ## Próximos pasos - + Úsalos desde una aplicación de Python o TypeScript para enviar flujos de trabajo y gestionar entradas, progreso y salidas. - Úsala desde cualquier lenguaje cuando llames directamente a la API HTTP o quieras consultar sus formatos de solicitud y respuesta. + Úsala desde cualquier lenguaje cuando llames directamente a la API HTTP o cuando revises sus formatos de solicitud y respuesta. - - Úsalo cuando prepares un JSON de flujo de trabajo para una solicitud a la API o para solucionar problemas con sus entradas y salidas. + + Úsalo cuando prepares un JSON de flujo de trabajo para una solicitud a la API o cuando diagnostiques sus entradas y salidas. - + Úsala para automatizar los comandos de compilación, publicación, despliegue y flujos de trabajo desde una terminal. diff --git a/es/installation/desktop/usage/manage.mdx b/es/installation/desktop/usage/manage.mdx index 28574d8384..66d3d22b35 100644 --- a/es/installation/desktop/usage/manage.mdx +++ b/es/installation/desktop/usage/manage.mdx @@ -3,24 +3,21 @@ title: "Administración de instalaciones" description: "Inicia, actualiza, crea instantáneas y administra tus instalaciones de ComfyUI" icon: "sliders" sidebarTitle: "Administrar" -translationSourceHash: d0ebcc32 +translationSourceHash: 63417988 translationFrom: installation/desktop/usage/manage.mdx translationBlockHashes: - "The Manage Panel": 8e1aaf92 + "The Manage Panel": 8f9e66aa "Installation Actions": 3bf198ca --- + ## El panel Administrar El contenido del panel Administrar varía según el tipo de instancia. Las capturas de pantalla de esta página muestran una **instalación local independiente**. Las instancias en la nube y remotas tienen menos pestañas y configuraciones. -Selecciona **Administrar** en una instalación para abrir el panel de configuraciones. +Para abrirlo, ve a la vista **Selector** (la pantalla de inicio que lista tus instancias), haz clic en el icono ⋮ de la tarjeta de una instancia y luego selecciona **Administrar**. ![Panel Administrar de una instancia local: Actualizar, Argumentos de inicio, Instantáneas, Almacenamiento, Terminal, Acerca de](/images/desktop/usage/instance_settings_00.png) -- Abre la vista **Selector** (la pantalla de inicio que muestra todas tus instancias) -- Haz clic en el icono ⋮ de la tarjeta de una instancia -- Selecciona **Administrar** en el menú contextual - El panel tiene seis pestañas: **Actualizar**, **Argumentos de inicio**, **Instantáneas**, **Almacenamiento**, **Terminal** y **Acerca de**. ### Pestaña Actualizar @@ -54,15 +51,15 @@ Las compilaciones nocturnas se marcan como inestables. El selector las ofrece du ![Pestaña Argumentos de inicio del panel Administrar para los argumentos de lanzamiento de la instancia y los argumentos beta](/images/desktop/usage/instance_settings_02_startup_args.png) -Configura argumentos CLI de inicio, la política ComfyUI Manager, el modo de lanzamiento, el uso compartido de la caché del navegador, el comportamiento ante conflictos de puertos y las variables de entorno. +Configura los argumentos CLI de inicio, la política de ComfyUI Manager, el modo de lanzamiento, el uso compartido de la caché del navegador, el comportamiento ante conflictos de puerto y las variables de entorno. - **Argumentos de inicio**: Argumentos CLI personalizados para ComfyUI (por ejemplo, `--listen`). Haz clic en el icono de engranaje para ver las opciones categorizadas. Cuando las funciones beta están habilitadas, una etiqueta **+N beta** junto al campo enumera los argumentos beta que Comfy Desktop agregó para la sesión en ejecución, o los que son elegibles para el próximo lanzamiento. -- **Nivel de seguridad ComfyUI Manager**: Controla qué paquetes de nodos puede instalar ComfyUI-Manager para esta instancia. Se aplica la próxima vez que inicies. +- **Nivel de seguridad de Manager**: Controla qué paquetes de nodos puede instalar ComfyUI-Manager para esta instancia. Se aplica la próxima vez que inicies. - **Estricto**: Bloquea todas las instalaciones, actualizaciones y desinstalaciones de paquetes de nodos. El Administrador es de solo lectura. - **Estándar (RECOMENDADO)**: Permite paquetes de nodos registrados. Bloquea las instalaciones desde fuentes no registradas (por ejemplo, URL de git arbitrarias). - **Relajado**: Como Estándar, pero también permite instalaciones desde fuentes no registradas mientras ComfyUI solo sea accesible desde esta máquina. `--listen` las bloquea de nuevo. - **Permisivo**: Permite todos los niveles de riesgo. Si ComfyUI está expuesto con `--listen`, las instalaciones aún requieren el modo de red **Personal cloud**. -- **Modo de red ComfyUI Manager**: Cómo se comunica ComfyUI Manager con el registro de nodos. +- **Modo de red de Manager**: Cómo se comunica Manager con el registro de nodos. - **Público (predeterminado)**: Usa el registro público. `--listen` bloquea las instalaciones de paquetes de nodos en todos los niveles de seguridad. - **Privado**: Usa una base de datos de nodos privada que configuras tú mismo. - **Sin conexión**: Sin red externa. Las descargas no están disponibles. @@ -111,7 +108,7 @@ Configura si esta instancia usa las carpetas compartidas globales y agrega direc - **Usar carpeta de entrada compartida**: Cuando está activada, esta instancia lee los archivos de entrada desde la carpeta de entrada compartida global. Desactívala para usar la carpeta de entrada propia de esta instancia. - **Usar carpeta de salida compartida**: Cuando está activada, esta instancia escribe las salidas generadas en la carpeta de salida compartida global. Desactívala para usar la carpeta de salida propia de esta instancia. - **Directorios de modelos**: Directorios de modelos adicionales solo para esta instancia, que se buscan además de los directorios de modelos compartidos. -- **Directorio de entrada** / **Directorio de salida**: Las carpetas propias de esta instancia cuando los interruptores compartidos de arriba están desactivados. +- **Directorio de entrada** / **Directorio de salida**: Las carpetas propias de esta instancia cuando los interruptores de carpetas compartidas de arriba están desactivados. ### Pestaña Terminal @@ -120,20 +117,20 @@ Configura si esta instancia usa las carpetas compartidas globales y agrega direc Un shell interactivo en la carpeta de esta instancia. Funciona tanto si ComfyUI está en ejecución como si está detenido. - Úsalo para inspeccionar los registros de inicio, los errores y la salida de Python. -- Copiar, pegar y seleccionar todo siguen los atajos del sistema operativo. Haz clic derecho en la terminal para las mismas acciones. +- Copiar, pegar y seleccionar todo usan los atajos del sistema operativo. Haz clic derecho en la terminal para las mismas acciones. ### Pestaña Acerca de ![Pestaña Acerca de de Administrar: el nombre de instancia editable, los datos de la instancia y la ruta de instalación](/images/desktop/usage/instance_settings_05_about.png) -La pestaña Acerca de reúne lo que Comfy Desktop sabe sobre la instancia. Al hacer clic en una ruta, esta se abre en tu administrador de archivos, y el botón de copiar que está al lado copia la ruta. +La pestaña Acerca de reúne lo que Comfy Desktop sabe sobre la instancia. Cuando haces clic en una ruta, esta se abre en tu administrador de archivos, y el botón de copiar que está al lado copia la ruta. Los datos están agrupados, y un grupo solo aparece cuando tiene algo que mostrar: -- **Detalles de la instancia**: Versión de ComfyUI, hardware, y las versiones de Python y PyTorch. Para una Conexión remota, este grupo contiene la URL de conexión y la fecha en que se agregó la conexión. +- **Detalles de la instancia**: la versión de ComfyUI, el hardware y las versiones de Python y PyTorch. En una Conexión remota, este grupo contiene la URL de conexión y la fecha en que se agregó la conexión. - **Detalles de ejecución**: el puerto en el que ComfyUI está escuchando. Aparece mientras la instancia está en ejecución. - **Ubicación y almacenamiento**: la ruta de instalación completa en el disco y cuánto espacio ocupa la instalación. Solo una instalación local guarda archivos en esta máquina, así que Comfy Cloud y las Conexiones remotas no tienen este grupo. -- **Linaje**: la instancia desde la que se copió esta, y cuándo. Aparece en una instancia que proviene de **Duplicar instancia**, de una copia que cambió su versión o PyTorch, de una migración desde Desktop clásico, o de una adopción in situ. +- **Linaje**: la instancia desde la que se copió esta y cuándo. Aparece en una instancia que proviene de **Duplicar instancia**, de una copia que cambió su versión o PyTorch, de una migración desde Desktop clásico o de una adopción in situ. #### Renombrar una instancia diff --git a/es/installation/desktop/usage/migrate.mdx b/es/installation/desktop/usage/migrate.mdx index 4848694131..80da69263e 100644 --- a/es/installation/desktop/usage/migrate.mdx +++ b/es/installation/desktop/usage/migrate.mdx @@ -11,9 +11,10 @@ translationBlockHashes: "What Changes After Migration": 1f09d2db "Does My Old Link Still Work?": 528b3e43 "Step-by-Step Migration": d15dfd28 - "Migrate from the Selector": 9517089b + "Migrate from the Chooser": 9517089b "Troubleshooting": a6cd9f9b --- + Esta página cubre la migración desde **Legacy Desktop** (la aplicación de escritorio anterior de instalación única). Si es tu primera vez como usuario, puedes saltarte esta sección. @@ -91,25 +92,25 @@ Inicia tu nueva instalación y confirma: -## Migrar desde el Selector +## Migrar desde el Chooser -Si ya finalizaste la configuración inicial, o si la instalación de Legacy Desktop ya aparece en el Selector, inicia la migración desde la tarjeta de la instancia: +Si ya finalizaste la configuración inicial, o la instalación de Legacy Desktop ya aparece en el Chooser, inicia la migración desde la tarjeta de la instancia: -1. Busca la tarjeta de la instancia de Legacy Desktop. Lleva una etiqueta **Migrar**. +1. Busca la tarjeta de instancia de Legacy Desktop. Incluye un distintivo **Migrate**. - ![Tarjeta de la instancia de Legacy Desktop en el Selector con la etiqueta Migrar](/images/desktop/usage/migrate_02_pill.png) + ![Tarjeta de instancia de Legacy Desktop en el Chooser con el distintivo Migrate](/images/desktop/usage/migrate_02_pill.png) -2. Haz clic en la etiqueta, o abre el menú **⋮** de la tarjeta y selecciona **Migrar a Standalone**. +2. Haz clic en el distintivo o abre el menú **⋮** de la tarjeta y selecciona **Migrate to Standalone**. - ![Menú de la tarjeta de instancia con Migrar a Standalone](/images/desktop/usage/migrate_03_menu.png) + ![Menú de la tarjeta de instancia con Migrate to Standalone](/images/desktop/usage/migrate_03_menu.png) -3. Revisa la confirmación y luego selecciona **Iniciar migración**. +3. Revisa la confirmación y luego selecciona **Start Migration**. - ![Confirmación para migrar Legacy Desktop a Standalone con Iniciar migración](/images/desktop/usage/migrate_04_confirm.png) + ![Confirmación para migrar Legacy Desktop a Standalone con Start Migration](/images/desktop/usage/migrate_04_confirm.png) -Una instalación de Legacy Desktop se adopta en el mismo lugar, así que la instancia que aparece es tu configuración existente bajo la administración de Comfy Desktop. En cambio, migrar una instalación de Git rastreada o una instalación portátil crea una nueva instancia Standalone y deja la instalación rastreada en su lugar. En ambos casos, los archivos de modelo no se copian, se leen desde donde ya están. +Una instalación de Legacy Desktop se adopta en su ubicación actual, por lo que la instancia que aparece es tu configuración existente bajo la gestión de Comfy Desktop. En cambio, migrar una instalación registrada de Git o portable crea una nueva instancia Standalone y deja la instalación registrada en su lugar. En ambos casos, la aplicación no copia los archivos de modelo; los lee desde donde ya están. -Una actualización pendiente tiene prioridad en esas tarjetas: muestran la etiqueta de actualización en lugar de **Migrar**. +Una actualización pendiente tiene prioridad en esas tarjetas: muestran el distintivo de actualización en lugar de **Migrate**. ## Solución de problemas diff --git a/es/specs/workflow_json.mdx b/es/specs/workflow_json.mdx index 31679c41a0..ca6376bf46 100644 --- a/es/specs/workflow_json.mdx +++ b/es/specs/workflow_json.mdx @@ -1,15 +1,18 @@ --- title: "Workflow JSON" description: "Esquema JSON del formato de archivo de flujo de trabajo de ComfyUI (v1.0 y clásico v0.4): nodos, enlaces, grupos y campos de versión." -translationSourceHash: 7cf3516f +translationSourceHash: d25be209 translationFrom: specs/workflow_json.mdx translationBlockHashes: "_intro": 44945004 + "Version 1.0 (Latest)": f3881a59 "Older versions": fd8590ae --- -El JSON del flujo de trabajo se define con [JSON Schema](https://json-schema.org/). Los cambios en este esquema se tratarán en el [repositorio de rfcs](https://github.com/comfy-org/rfcs). -## Versión 1.0 (más reciente) +El JSON del flujo de trabajo se define con [JSON Schema](https://json-schema.org/). Los cambios en este esquema se debatirán en el [repositorio rfcs](https://github.com/comfy-org/rfcs). + +## Versión 1.0 (última) + ```json ComfyUI Workflow v1.0 { "$ref": "#/definitions/ComfyWorkflow1_0", @@ -735,7 +738,6 @@ El JSON del flujo de trabajo se define con [JSON Schema](https://json-schema.org "$schema": "http://json-schema.org/draft-07/schema#" } ``` - ## Versiones anteriores - [0.4](./workflow_json_0.4) diff --git a/es/troubleshooting/custom-node-issues.mdx b/es/troubleshooting/custom-node-issues.mdx index b810896265..54b10db5cf 100644 --- a/es/troubleshooting/custom-node-issues.mdx +++ b/es/troubleshooting/custom-node-issues.mdx @@ -3,17 +3,21 @@ title: "Solución de problemas de nodos personalizados" description: "Soluciona problemas de nodos personalizados en ComfyUI: desactívalos todos con --disable-all-custom-nodes y aísla, corrige o elimina el nodo dañado." icon: "puzzle-piece" sidebarTitle: "Problemas de nodos personalizados" -translationSourceHash: 520e34be +translationSourceHash: 09e72de3 translationFrom: troubleshooting/custom-node-issues.mdx translationBlockHashes: + "_intro": 74fe2b37 "How to disable all custom nodes?": acf7da1a + "What is Binary Search?": 7dd95c5a "Two Troubleshooting Methods": e27d6d29 + "Using Binary Search for Troubleshooting": 84acbb08 "How to Fix the Issue": eb2a4de5 "Reporting Issues": a0fe8b80 --- -Aquí tienes el enfoque general para solucionar problemas de nodos personalizados: + +Este es el enfoque general para solucionar problemas de nodos personalizados: ```mermaid flowchart TD @@ -51,24 +55,24 @@ python main.py --disable-all-custom-nodes Abre la carpeta donde se encuentra la versión portable y busca el archivo `run_nvidia_gpu.bat` o `run_cpu.bat` - ![Modificar el archivo .bat](/images/troubleshooting/Portable-disable-custom-nodes.jpg) + ![Modificar archivo .bat](/images/troubleshooting/Portable-disable-custom-nodes.jpg) 1. Copia el archivo `run_nvidia_gpu.bat` o `run_cpu.bat` y renómbralo a `run_nvidia_gpu_disable_custom_nodes.bat` 2. Abre el archivo copiado con el Bloc de notas - 3. Agrega el parámetro `--disable-all-custom-nodes` al archivo, o copia los parámetros de abajo en un archivo `.txt` y renombra el archivo a `run_nvidia_gpu_disable_custom_nodes.bat` + 3. Agrega el parámetro `--disable-all-custom-nodes` al archivo, o copia los siguientes parámetros en un archivo `.txt` y renombra el archivo a `run_nvidia_gpu_disable_custom_nodes.bat` ```bash .\python_embeded\python.exe -s ComfyUI\main.py --disable-all-custom-nodes --windows-standalone-build pause ``` 4. Guarda el archivo y ciérralo - 5. Haz doble clic en el archivo para ejecutarlo. Si todo es normal, deberías ver ComfyUI iniciar y los nodos personalizados desactivados + 5. Haz doble clic en el archivo para ejecutarlo. Si todo es normal, deberías ver que ComfyUI se inicia con los nodos personalizados desactivados - + ![Solución de problemas de ComfyUI](/images/troubleshooting/portable-disable-custom-nodes-cml-1.jpg) - 1. Entra a la carpeta donde se encuentra la versión portable - 2. Abre la terminal haciendo clic derecho en el menú → Abrir terminal + 1. Entra en la carpeta donde se encuentra la versión portable + 2. Abre la terminal con clic derecho en el menú → Abrir terminal ![Solución de problemas de ComfyUI](/images/troubleshooting/portable-disable-custom-nodes-cml-2.jpg) 3. Asegúrate de que el nombre de la carpeta sea el directorio actual de la versión portable - 4. Introduce el siguiente comando para iniciar ComfyUI a través del python de la versión portable y desactivar los nodos personalizados + 4. Introduce el siguiente comando para iniciar ComfyUI mediante el python portable y desactivar los nodos personalizados ``` .\python_embeded\python.exe -s ComfyUI\main.py --disable-all-custom-nodes ``` @@ -78,14 +82,14 @@ python main.py --disable-all-custom-nodes **Resultados:** -- ✅ **El problema desaparece**: Un nodo personalizado está causando el problema → Continúa con el paso 2 -- ❌ **El problema persiste**: No es un problema de nodos personalizados → [Reporta el problema](#reporting-issues) +- ✅ **El problema desaparece**: Un nodo personalizado está causando el problema → Continúa al paso 2 +- ❌ **El problema persiste**: No es un problema de nodos personalizados → [Reporta el problema](#reportar-problemas) ## ¿Qué es la búsqueda binaria? -En este documento presentamos el método de búsqueda binaria para solucionar problemas de nodos personalizados, que consiste en comprobar la mitad de los nodos personalizados a la vez hasta localizar el nodo problemático. +En este documento presentamos el enfoque de búsqueda binaria para solucionar problemas con nodos personalizados, que consiste en revisar la mitad de los nodos personalizados a la vez hasta localizar el nodo que causa el problema. -Consulta el diagrama de flujo de abajo para ver el método concreto: habilita cada vez la mitad de los nodos que están deshabilitados y comprueba si aparece el problema, hasta identificar qué nodo personalizado lo está causando. +Consulta el siguiente diagrama de flujo para ver el procedimiento específico: habilita la mitad de los nodos deshabilitados cada vez y comprueba si el problema aparece, hasta identificar qué nodo personalizado lo está causando. ```mermaid flowchart TD @@ -106,23 +110,23 @@ flowchart TD L --> M[End] ``` -## Dos métodos de diagnóstico de problemas +## Dos métodos de solución de problemas -En este documento, clasificamos los nodos personalizados en dos tipos para el diagnóstico de problemas: +En este documento, clasificamos los nodos personalizados en dos tipos para la solución de problemas: ![Tipos de nodos personalizados](/images/troubleshooting/custom_node_type.jpg) -- A: Nodos personalizados con extensiones del frontend -- B: Nodos personalizados regulares +- A: Nodos personalizados con extensiones de frontend +- B: Nodos personalizados normales -Primero, conozcamos los posibles problemas y causas de los diferentes tipos de nodos personalizados: +Primero, conozcamos los problemas y causas potenciales de los distintos tipos de nodos personalizados: - - Para los nodos personalizados, podemos priorizar el diagnóstico de aquellos con extensiones del frontend, ya que son los que más problemas causan. Sus principales conflictos surgen de incompatibilidades con las actualizaciones de la versión del frontend de ComfyUI. + + En el caso de los nodos personalizados, podemos priorizar la solución de problemas de aquellos con extensiones de frontend, ya que son los que más problemas causan. Sus principales conflictos surgen de incompatibilidades con las actualizaciones de la versión del frontend de ComfyUI. Los problemas comunes incluyen: - Flujos de trabajo que no se ejecutan - - Algunos nodos no pueden mostrar imágenes de vista previa (como el nodo Save Image) + - Algunos nodos no pueden mostrar imágenes de vista previa (como el nodo Guardar Imagen) - Elementos de la interfaz desalineados - No se puede acceder al frontend de ComfyUI - Interfaz completamente rota o pantalla en blanco @@ -131,142 +135,139 @@ Primero, conozcamos los posibles problemas y causas de los diferentes tipos de n - Y más Causas comunes de estos problemas: - - Modificaciones del frontend durante las actualizaciones a las que los nodos personalizados aún no se han adaptado - - Usuarios que actualizan ComfyUI sin actualizar los nodos personalizados de forma sincronizada, aunque los autores hayan publicado versiones compatibles - - Autores que dejan de dar mantenimiento, lo que genera incompatibilidad entre las extensiones de los nodos personalizados y el frontend de ComfyUI + - Modificaciones en el frontend durante las actualizaciones a las que los nodos personalizados aún no se han adaptado + - Usuarios que actualizan ComfyUI sin actualizar al mismo tiempo los nodos personalizados, aunque los autores ya hayan publicado versiones compatibles + - Autores que dejan de dar mantenimiento, lo que provoca incompatibilidad entre las extensiones de los nodos personalizados y el frontend de ComfyUI - - Si el problema no lo causan las extensiones del frontend de los nodos personalizados, los problemas suelen estar relacionados con las dependencias. Los problemas comunes incluyen: - - Errores de «Failed to import» en la consola o en los registros - - Los nodos faltantes siguen apareciendo como faltantes después de la instalación y el reinicio - - ComfyUI se bloquea o no se inicia + + Si el problema no lo causan las extensiones de frontend de los nodos personalizados, a menudo está relacionado con las dependencias. Los problemas comunes incluyen: + - Errores de "Failed to import" en la consola o los registros + - Nodos faltantes que siguen apareciendo como faltantes después de instalarlos y reiniciar + - ComfyUI se bloquea o no logra iniciar - Y más Causas comunes de estos errores: - Nodos personalizados que requieren wheels adicionales como ComfyUI-Nunchaku - - Nodos personalizados que usan versiones estrictas de dependencias (p. ej., `torch==2.4.1`) mientras que otros plugins usan versiones diferentes (p. ej., `torch>=2.4.2`), lo que causa conflictos después de la instalación + - Nodos personalizados que usan versiones estrictas de dependencias (por ejemplo, `torch==2.4.1`) mientras otros plugins usan versiones diferentes (por ejemplo, `torch>=2.4.2`), lo que genera conflictos después de la instalación - Problemas de red que impiden que las dependencias se instalen correctamente - Cuando los problemas involucran las interdependencias y versiones del entorno de Python, el diagnóstico se vuelve más complejo y requiere conocimientos sobre la gestión del entorno de Python, incluido cómo instalar y desinstalar dependencias. + Cuando los problemas involucran interdependencias y versiones del entorno de Python, la solución de problemas se vuelve más compleja y requiere conocimientos de gestión de entornos de Python, incluido cómo instalar y desinstalar dependencias -## Uso de la búsqueda binaria para la solución de problemas +## Usar la búsqueda binaria para solucionar problemas -De estos dos tipos de problemas de nodos personalizados, los conflictos entre las extensiones del frontend de los nodos personalizados y ComfyUI son los más frecuentes. Daremos prioridad a la solución de problemas de estos nodos. Este es el enfoque general para solucionar problemas: +Entre estos dos tipos distintos de problemas de nodos personalizados, los conflictos entre las extensiones frontend de los nodos personalizados y ComfyUI son los más comunes. Vamos a priorizar la solución de problemas de estos nodos primero. Este es el enfoque general para solucionar problemas: -### 1. Solución de problemas de las extensiones del frontend de los nodos personalizados +### 1. Solucionar problemas de las extensiones frontend de los nodos personalizados - - ![Deshabilitar todas las extensiones del frontend de los plugins](/images/troubleshooting/disable_3rd_party.jpg) - Después de iniciar ComfyUI, busca el menú `Extensions` en las configuraciones y sigue los pasos que se muestran en la imagen para deshabilitar todas las extensiones de terceros + + ![Desactivar todas las extensiones frontend de los plugins](/images/troubleshooting/disable_3rd_party.jpg) + Después de iniciar ComfyUI, busca el menú `Extensions` en las configuraciones y sigue los pasos que se muestran en la imagen para desactivar todas las extensiones de terceros - Si no puedes entrar al frontend de ComfyUI, omite la sección de solución de problemas de las extensiones del frontend y continúa con el [Enfoque general para solucionar problemas de nodos personalizados](#2-solución-de-problemas-general-de-nodos-personalizados) + Si no puedes entrar al frontend de ComfyUI, simplemente salta la sección de solución de problemas de extensiones frontend y continúa con el [Enfoque general para solucionar problemas de nodos personalizados](#2-solución-general-de-problemas-de-nodos-personalizados) - Después de deshabilitar las extensiones del frontend por primera vez, se recomienda reiniciar ComfyUI para asegurarte de que todas las extensiones del frontend queden deshabilitadas correctamente - - Si el problema desaparece, lo causaban las extensiones del frontend de los nodos personalizados y podemos continuar con la solución de problemas mediante búsqueda binaria - - Si el problema persiste, no lo causan las extensiones del frontend: consulta los otros enfoques de solución de problemas de este documento + Después de desactivar las extensiones frontend por primera vez, se recomienda reiniciar ComfyUI para asegurarte de que todas las extensiones frontend estén correctamente desactivadas + - Si el problema desaparece, entonces fue causado por las extensiones frontend de nodos personalizados, y podemos continuar con la solución de problemas mediante búsqueda binaria + - Si el problema persiste, entonces no fue causado por las extensiones frontend: consulta los otros enfoques de solución de problemas en este documento. - Usa el método mencionado al principio de este documento: habilita la mitad de los nodos personalizados a la vez hasta encontrar el nodo problemático - ![Habilitar las extensiones del frontend](/images/troubleshooting/enable_extensions.jpg) - Consulta la imagen para habilitar la mitad de las extensiones del frontend. Ten en cuenta que, si los nombres de las extensiones son similares, probablemente vienen de las extensiones del frontend del mismo nodo personalizado + Usa el método mencionado al inicio de este documento para solucionar el problema, habilitando la mitad de los nodos personalizados a la vez hasta que encuentres el nodo problemático + ![Habilitar extensiones frontend](/images/troubleshooting/enable_extensions.jpg) + Consulta la imagen para habilitar la mitad de las extensiones frontend. Ten en cuenta que si los nombres de las extensiones son similares, probablemente provienen de las extensiones frontend del mismo nodo personalizado - Si encuentras el nodo personalizado problemático, consulta la sección de solución de problemas de este documento para resolver los problemas del nodo personalizado + Si encuentras el nodo personalizado problemático, consulta la sección de corrección de problemas de este documento para resolver los problemas del nodo personalizado -Con este método no necesitas reiniciar ComfyUI varias veces: solo tienes que recargar ComfyUI después de habilitar o deshabilitar las extensiones del frontend de los nodos personalizados. Además, tu ámbito de diagnóstico se limita a los nodos con extensiones del frontend, lo que reduce mucho el rango de búsqueda. +Con este método, no necesitas reiniciar ComfyUI varias veces: basta con recargar ComfyUI después de habilitar o deshabilitar las extensiones frontend de los nodos personalizados. Además, tu alcance de solución de problemas se limita a los nodos con extensiones frontend, lo que reduce enormemente el rango de búsqueda. -### 2. Solución de problemas general de nodos personalizados +### 2. Solución general de problemas de nodos personalizados - - Para el método de localización por búsqueda binaria, además de la búsqueda manual, también disponemos de la búsqueda binaria automatizada con comfy-cli, como se detalla abajo: + + Para el método de localización por búsqueda binaria, además de la búsqueda manual, también contamos con una búsqueda binaria automatizada usando comfy-cli, como se detalla a continuación: - - - Usar Comfy CLI requiere algo de experiencia con la línea de comandos. Si no te sientes cómodo con ella, usa la búsqueda binaria manual. + + Usar Comfy CLI requiere algo de experiencia con la línea de comandos. Si no te sientes cómodo con ella, usa la búsqueda binaria manual en su lugar. - Si tienes [Comfy CLI](/es/comfy-cli/getting-started) instalado, puedes usar la herramienta de bisección automatizada para encontrar el nodo problemático: + Si tienes [Comfy CLI](/es/comfy-cli/getting-started) instalado, puedes usar la herramienta automatizada de bisección para encontrar el nodo problemático: ```bash - # Start a bisect session + # Inicia una sesión de bisección comfy-cli node bisect start - # Follow the prompts: - # - Test ComfyUI with the current set of enabled nodes - # - Mark as 'good' if the issue is gone: comfy-cli node bisect good - # - Mark as 'bad' if the issue persists: comfy-cli node bisect bad - # - Repeat until the problematic node is identified + # Sigue las indicaciones: + # - Prueba ComfyUI con el conjunto actual de nodos habilitados + # - Márcalo como 'good' si el problema desaparece: comfy-cli node bisect good + # - Márcalo como 'bad' si el problema persiste: comfy-cli node bisect bad + # - Repite hasta identificar el nodo problemático - # Reset when done + # Reinicia cuando termines comfy-cli node bisect reset ``` - La herramienta de bisección habilitará y deshabilitará los nodos automáticamente y te guiará durante el proceso. + La herramienta de bisección activa y desactiva nodos automáticamente y te guía por el proceso. - - + - Antes de empezar, **crea una copia de seguridad** de tu carpeta custom_nodes por si algo sale mal. + Antes de comenzar, **crea una copia de seguridad** de tu carpeta custom_nodes por si algo sale mal. - Si prefieres hacer el proceso manualmente o no tienes Comfy CLI instalado, sigue los pasos de abajo: + Si prefieres hacer el proceso manualmente o no tienes Comfy CLI instalado, sigue los pasos a continuación: - Antes de empezar, entra en la carpeta `\ComfyUI\` + Antes de comenzar, entra en la carpeta `\ComfyUI\` - - **Copia de seguridad de todos los nodos personalizados**: copia la carpeta `custom_nodes` y renómbrala a `custom_nodes_backup` - - **Crear una carpeta temporal**: crea una carpeta llamada `custom_nodes_temp` + - **Haz una copia de seguridad de todos los nodos personalizados**: Copia y renombra `custom_nodes` a `custom_nodes_backup` + - **Crea una carpeta temporal**: Crea una carpeta llamada `custom_nodes_temp` O usa la siguiente línea de comandos para hacer la copia de seguridad: ```bash - # Create backup and temporary folder + # Crear la copia de seguridad y la carpeta temporal mkdir "%USERPROFILE%\custom_nodes_backup" mkdir "%USERPROFILE%\custom_nodes_temp" - # Backup all content + # Copiar todo el contenido xcopy "custom_nodes\*" "%USERPROFILE%\custom_nodes_backup\" /E /H /Y ``` - - - Haz una copia de seguridad manual de la carpeta custom_nodes - O usa la siguiente línea de comandos para hacer la copia de seguridad: + + Respalda manualmente la carpeta custom_nodes + O usa la siguiente línea de comandos para hacer el respaldo: ```bash - # Create backup and temporary folder + # Crear respaldo y carpeta temporal mkdir ~/custom_nodes_backup mkdir ~/custom_nodes_temp - # Backup all content + # Respaldar todo el contenido cp -r custom_nodes/* ~/custom_nodes_backup/ ``` - + ```bash - # Create backup and temporary folder + # Crea una carpeta de respaldo y una temporal mkdir /content/custom_nodes_backup mkdir /content/custom_nodes_temp - # Backup all content + # Respalda todo el contenido cp -r /content/ComfyUI/custom_nodes/* /content/custom_nodes_backup/ ``` - + - Como Windows tiene interfaz gráfica, puedes omitir este paso a menos que solo uses la línea de comandos + Como Windows tiene una interfaz visual, puedes saltarte este paso a menos que solo uses la línea de comandos ```bash dir custom_nodes ``` @@ -283,12 +284,12 @@ Con este método no necesitas reiniciar ComfyUI varias veces: solo tienes que re - + Supongamos que tienes 8 nodos personalizados. Mueve la primera mitad al almacenamiento temporal: ```bash - # Move first half (nodes 1-4) to temp + # Mueve la primera mitad (nodos 1-4) a temp move "custom_nodes\node1" "%USERPROFILE%\custom_nodes_temp\" move "custom_nodes\node2" "%USERPROFILE%\custom_nodes_temp\" move "custom_nodes\node3" "%USERPROFILE%\custom_nodes_temp\" @@ -297,7 +298,7 @@ Con este método no necesitas reiniciar ComfyUI varias veces: solo tienes que re ```bash - # Move first half (nodes 1-4) to temp + # Mueve la primera mitad (nodos 1-4) a temp mv custom_nodes/node1 ~/custom_nodes_temp/ mv custom_nodes/node2 ~/custom_nodes_temp/ mv custom_nodes/node3 ~/custom_nodes_temp/ @@ -306,7 +307,7 @@ Con este método no necesitas reiniciar ComfyUI varias veces: solo tienes que re ```bash - # Move first half (nodes 1-4) to temp + # Mueve la primera mitad (nodos 1-4) a temp mv /content/ComfyUI/custom_nodes/node1 /content/custom_nodes_temp/ mv /content/ComfyUI/custom_nodes/node2 /content/custom_nodes_temp/ mv /content/ComfyUI/custom_nodes/node3 /content/custom_nodes_temp/ @@ -315,19 +316,19 @@ Con este método no necesitas reiniciar ComfyUI varias veces: solo tienes que re - + Inicia ComfyUI con normalidad ```bash python main.py ``` - - - **El problema persiste**: el problema está en los nodos restantes (5-8) - - **El problema desaparece**: el problema estaba en los nodos movidos (1-4) + + - **El problema persiste**: El problema está en los nodos restantes (5-8) + - **El problema desaparece**: El problema estaba en los nodos movidos (1-4) - - - Si el problema persiste: mueve la mitad de los nodos restantes (p. ej., los nodos 7-8) a la carpeta temporal - - Si el problema había desaparecido: devuelve la mitad de los nodos temporales (p. ej., los nodos 3-4) a custom_nodes + + - Si el problema persiste: mueve la mitad de los nodos restantes (por ejemplo, los nodos 7-8) a temp + - Si el problema desapareció: mueve la mitad de los nodos de temp (por ejemplo, los nodos 3-4) de vuelta a custom_nodes - Repite hasta encontrar el único nodo problemático @@ -347,7 +348,7 @@ Una vez que hayas identificado el nodo personalizado problemático: 2. Actualiza el nodo y vuelve a probar ### Opción 2: Reemplazar el nodo -1. Busca nodos personalizados alternativos con funcionalidad similar +1. Busca nodos personalizados alternativos con una funcionalidad similar 2. Consulta el [ComfyUI Registry](https://registry.comfy.org) para encontrar alternativas ### Opción 3: Reportar el problema @@ -355,35 +356,39 @@ Contacta con el desarrollador del nodo personalizado: 1. Encuentra el repositorio de GitHub del nodo 2. Crea una incidencia con: - Tu versión de ComfyUI - - Mensajes de error/registros + - Mensajes de error y registros - Pasos para reproducir el problema - Tu sistema operativo ### Opción 4: Eliminar o deshabilitar el nodo -Si no hay una solución disponible y no necesitas la funcionalidad: +Si no hay una solución disponible y no necesitas esa funcionalidad: 1. Elimina el nodo problemático de `custom_nodes/` o deshabilítalo en la interfaz de ComfyUI Manager 2. Reinicia ComfyUI -## Informar problemas {#reporting-issues} +## Reportar problemas -Si el problema no es causado por nodos personalizados, consulta la [descripción general de solución de problemas](/es/troubleshooting/overview) para otros problemas comunes. +Si el problema no lo causan los nodos personalizados, consulta la [descripción general de solución de problemas](/es/troubleshooting/overview) para ver otros problemas comunes. ### Para problemas específicos de nodos personalizados + Contacta al desarrollador del nodo personalizado: - Busca el repositorio de GitHub del nodo -- Crea un issue con tu versión de ComfyUI, los mensajes de error, los pasos para reproducirlo y tu sistema operativo -- Revisa la documentación del nodo y su página de Issues para ver problemas conocidos +- Crea un reporte de problema con tu versión de ComfyUI, los mensajes de error, los pasos para reproducirlo y tu sistema operativo +- Revisa la documentación del nodo y su página de Issues para comprobar si hay problemas conocidos ### Para problemas del núcleo de ComfyUI + - **GitHub**: [Problemas de ComfyUI](https://github.com/Comfy-Org/ComfyUI/issues) -- **Foro**: [Foro de ComfyUI](https://forum.comfy.org/) +- **Foro**: [Foro oficial de ComfyUI](https://forum.comfy.org/) ### Para problemas de la aplicación de escritorio + - **GitHub**: [Problemas de Comfy Desktop](https://github.com/Comfy-Org/Comfy-Desktop/issues) ### Para problemas del frontend + - **GitHub**: [Problemas del frontend de ComfyUI](https://github.com/Comfy-Org/ComfyUI_frontend/issues) -Para problemas generales de instalación, modelos o rendimiento, consulta nuestras páginas de [descripción general de solución de problemas](/es/troubleshooting/overview) y [problemas con modelos](/es/troubleshooting/model-issues). +Para problemas generales de instalación, modelos o rendimiento, consulta las páginas de [descripción general de solución de problemas](/es/troubleshooting/overview) y [problemas de modelos](/es/troubleshooting/model-issues). diff --git a/es/troubleshooting/model-issues.mdx b/es/troubleshooting/model-issues.mdx index 9bf5bdce76..f4f37b2c4e 100644 --- a/es/troubleshooting/model-issues.mdx +++ b/es/troubleshooting/model-issues.mdx @@ -3,17 +3,18 @@ title: "Cómo solucionar problemas de modelos en ComfyUI" description: "Soluciona problemas de modelos: arquitecturas incompatibles, modelos faltantes y errores de carga" icon: "cube" sidebarTitle: "Problemas de modelos" -translationSourceHash: 719b9600 +translationSourceHash: 4ece7de6 translationFrom: troubleshooting/model-issues.mdx translationBlockHashes: + "Model Architecture Mismatch": 23e5abcf "Missing Models Error": ec98bd75 "Model Loading Errors": dd723562 "Model Performance Issues": f8467439 --- -## Desajuste de arquitectura del modelo +## Incompatibilidad de arquitectura de modelos -**Síntomas:** errores de dimensión de tensores durante la generación, especialmente en la etapa de decodificación del VAE +**Síntomas:** Errores de dimensiones de tensor durante la generación, especialmente durante la etapa de decodificación VAE **Mensajes de error comunes:** - `Given groups=1, weight of size [64, 4, 3, 3], expected input[1, 16, 128, 128] to have 4 channels, but got 16 channels instead` @@ -23,55 +24,54 @@ translationBlockHashes: - `Tensors must have same number of dimensions: got 2 and 3` - `mat1 and mat2 shapes cannot be multiplied (154x2048 and 768x320)` -**Causa principal:** usar juntos modelos de familias de arquitectura distintas +**Causa raíz:** Combinar modelos de diferentes familias de arquitectura ### Soluciones 1. **Verifica la compatibilidad de la familia de modelos:** - - **Los modelos Flux** usan un espacio latente de 16 canales con conditioning de doble codificador de texto (CLIP-L + T5-XXL) + - **Los modelos Flux** usan un espacio latente de 16 canales con acondicionamiento de doble codificador de texto (CLIP-L + T5-XXL) - **Los modelos SD1.5** usan un espacio latente de 4 canales con un único codificador de texto CLIP ViT-L/14 - **Los modelos SDXL** usan un espacio latente de 4 canales con doble codificador de texto (CLIP ViT-L/14 + OpenCLIP ViT-bigG/14) - - **Los modelos SD3** usan un espacio latente de 16 canales con conditioning de triple codificador de texto (CLIP-L + OpenCLIP bigG + T5-XXL) + - **Los modelos SD3** usan un espacio latente de 16 canales con acondicionamiento de triple codificador de texto (CLIP-L + OpenCLIP bigG + T5-XXL) - **Los modelos ControlNet** deben coincidir con la arquitectura del checkpoint base (los ControlNets de SD1.5 solo funcionan con checkpoints SD1.5, los ControlNets de SDXL solo funcionan con checkpoints SDXL, etc.) -2. **Escenarios de desajuste habituales y sus soluciones:** +2. **Escenarios comunes de incompatibilidad y soluciones:** - **Flux + VAE equivocado:** + **Flux + VAE incorrecto:** ``` - Problem: Using taesd or sdxl_vae.safetensors with Flux checkpoint - Fix: Use ae.safetensors (Flux VAE) from Hugging Face Flux releases + Problema: Usar taesd o sdxl_vae.safetensors con un checkpoint Flux + Solución: Usa ae.safetensors (VAE de Flux) de las versiones de Flux en Hugging Face ``` - **Flux + configuración de CLIP incorrecta:** + **Flux + configuración incorrecta de CLIP:** ``` - Problem: Using t5xxl_fp8_e4m3fn.safetensors in both CLIP slots of DualClipLoader - Fix: Use t5xxl_fp8_e4m3fn.safetensors in one slot and clip_l.safetensors in the other + Problema: Usar t5xxl_fp8_e4m3fn.safetensors en ambas ranuras de CLIP de DualClipLoader + Solución: Usa t5xxl_fp8_e4m3fn.safetensors en una ranura y clip_l.safetensors en la otra ``` - **Desajuste de arquitectura de ControlNet:** + **Incompatibilidad de arquitectura de ControlNet:** ``` - Problem: SD1.5 ControlNet with SDXL checkpoint (or vice versa) + Problema: ControlNet de SD1.5 con un checkpoint SDXL (o viceversa) Error: "mat1 and mat2 shapes cannot be multiplied (154x2048 and 768x320)" - Fix: Use ControlNet models designed for your checkpoint architecture - - SD1.5 checkpoints require SD1.5 ControlNets - - SDXL checkpoints require SDXL ControlNets + Solución: Usa modelos ControlNet diseñados para la arquitectura de tu checkpoint + - Los checkpoints SD1.5 requieren ControlNets de SD1.5 + - Los checkpoints SDXL requieren ControlNets de SDXL ``` 3. **Diagnóstico rápido:** ```bash - # Check if error occurs at VAE decode stage - # Look for "expected input[X, Y, Z] to have N channels, but got M channels" - # Y value indicates channel count: 4 = SD models, 16 = Flux models + # Verifica si el error ocurre en la etapa de decodificación VAE + # Busca "expected input[X, Y, Z] to have N channels, but got M channels" + # El valor Y indica el número de canales: 4 = modelos SD, 16 = modelos Flux ``` 4. **Estrategias de prevención:** - - Mantén todos los modelos de un flujo de trabajo dentro de la misma familia de arquitectura - - Descarga paquetes de modelos completos de la misma fuente o versión (a menudo están todos en un mismo repositorio de Hugging Face) - - Cuando pruebes modelos nuevos, empieza con las plantillas de flujos de trabajo o con los ejemplos de flujos de trabajo oficiales de ComfyUI antes de personalizarlos - + - Mantén todos los modelos del flujo de trabajo dentro de la misma familia de arquitectura + - Descarga paquetes de modelos completos de la misma fuente o versión (a menudo todos en un repositorio de Hugging Face) + - Cuando pruebes modelos nuevos, empieza con los flujos de trabajo de plantilla o con los ejemplos de flujos de trabajo oficiales de ComfyUI antes de personalizarlos ## Error de modelos faltantes -**Mensaje de error de ejemplo:** +**Mensaje de error de ejemplo:** ``` Prompt execution failed Prompt outputs failed validation: @@ -82,7 +82,7 @@ CheckpointLoaderSimple: ### Soluciones 1. **Descarga los modelos requeridos:** - - Usa ComfyUI Manager para descargar modelos de forma automática + - Usa ComfyUI Manager para descargar los modelos automáticamente - Verifica que los modelos estén en las subcarpetas correctas 2. **Verifica las rutas de los modelos:** @@ -98,7 +98,7 @@ CheckpointLoaderSimple: ### Configuración de rutas de búsqueda de modelos -Si tienes modelos en ubicaciones personalizadas, consulta la guía detallada sobre [Compartir modelos de ComfyUI y configuración de directorios de modelos personalizados](/es/installation/comfyui_portable_windows#agregar-rutas-de-modelos-adicionales) para configurar ComfyUI para que los encuentre. +Si tienes modelos en ubicaciones personalizadas, consulta la guía detallada sobre [Compartir modelos de ComfyUI y configuración de directorios de modelos personalizados](/es/installation/comfyui_portable_windows#agregar-rutas-de-modelos-adicionales) para configurar ComfyUI de modo que los encuentre. ## Errores al cargar modelos @@ -106,16 +106,16 @@ Si tienes modelos en ubicaciones personalizadas, consulta la guía detallada sob ### Soluciones -1. **Vuelve a descargar el modelo** - El archivo puede estar dañado durante la descarga -2. **Verifica el espacio disponible en disco** - Asegúrate de tener suficiente espacio para cargar el modelo (los modelos pueden ocupar de 2 a 15 GB o más) -3. **Revisa los permisos de archivo** - Asegúrate de que ComfyUI pueda leer los archivos del modelo -4. **Prueba con un modelo diferente** - Verifica si el problema es específico del modelo o afecta a todo el sistema +1. **Vuelve a descargar el modelo**: el archivo puede estar dañado durante la descarga +2. **Verifica el espacio disponible en disco**: asegúrate de tener suficiente espacio para cargar el modelo (los modelos pueden ocupar 2-15GB+) +3. **Revisa los permisos de los archivos**: asegúrate de que ComfyUI pueda leer los archivos del modelo +4. **Prueba con un modelo diferente**: verifica si el problema es específico del modelo o de todo el sistema ## Problemas de rendimiento de los modelos ### Carga lenta de modelos -**Síntomas:** Demoras prolongadas al cambiar de modelo o al iniciar la generación +**Síntomas:** largas esperas al cambiar de modelo o al iniciar la generación **Soluciones:** 1. **Usa un almacenamiento más rápido:** @@ -124,7 +124,7 @@ Si tienes modelos en ubicaciones personalizadas, consulta la guía detallada sob 2. **Ajusta la configuración de la caché:** ```bash - python main.py --cache-classic # Usa el almacenamiento en caché de estilo antiguo (agresivo). + python main.py --cache-classic # Usa el estilo antiguo (agresivo) de caché. python main.py --cache-lru 10 # Aumenta el tamaño de la caché LRU ``` @@ -134,12 +134,12 @@ Si tienes modelos en ubicaciones personalizadas, consulta la guía detallada sob ```bash # Reducción progresiva de memoria -python main.py --lowvram # Primera opción +python main.py --lowvram # Primer intento python main.py --novram # Si lowvram no es suficiente python main.py --cpu # Último recurso ``` -**Optimización de memoria específica por modelo:** +**Optimización de memoria específica del modelo:** ```bash # Fuerza una precisión más baja python main.py --force-fp16 @@ -149,5 +149,5 @@ python main.py --use-pytorch-cross-attention ``` -Para obtener más información sobre la configuración y la puesta en marcha de modelos, consulta la [documentación de modelos](/es/basic-concepts/models). +Para obtener más información sobre la configuración y la puesta en marcha de modelos, consulta la [documentación de Modelos](/es/basic-concepts/models). diff --git a/es/troubleshooting/overview.mdx b/es/troubleshooting/overview.mdx index c8049360bf..646da274c7 100644 --- a/es/troubleshooting/overview.mdx +++ b/es/troubleshooting/overview.mdx @@ -3,20 +3,24 @@ title: "Cómo solucionar problemas de ComfyUI" description: "Guía de solución de problemas de ComfyUI: descarta primero los nodos personalizados, corrige problemas comunes del núcleo y reporta errores con los detalles correctos." icon: "lightbulb" sidebarTitle: "Descripción general" -translationSourceHash: da480886 +translationSourceHash: 3ad82e25 translationFrom: troubleshooting/overview.mdx translationBlockHashes: "_intro": d5cccf02 + "Common Issues & Quick Fixes": a018a0e9 + "Installation-Specific Issues": a62b3b77 "Model-Related Issues": 1fececea "Network & API Issues": 995f7fb7 + "Hardware-Specific Issues": 992e251b "Frequently Asked Questions": fd33d2d3 "Getting Help & Reporting Bugs": fcd87672 "Community Resources": 1f81eee3 --- + import DockerNotice from "/snippets/es/install/docker-notice.mdx" - Recibimos muchos reportes de problemas y notamos que la mayoría de los enviados están relacionados con nodos personalizados. Por eso, asegúrate de haber leído la [guía de solución de problemas de nodos personalizados](/es/troubleshooting/custom-node-issues) antes de enviar un reporte de error, para confirmar que el problema no se debe a fallas del núcleo de ComfyUI. + Recibimos muchos comentarios sobre problemas y hemos notado que la mayoría de los que se envían están relacionados con nodos personalizados. Por eso, asegúrate de haber leído la [guía de solución de problemas de nodos personalizados](/es/troubleshooting/custom-node-issues) antes de enviar un reporte de error, para confirmar que el problema no se debe a fallas del núcleo de ComfyUI. @@ -25,37 +29,37 @@ import DockerNotice from "/snippets/es/install/docker-notice.mdx" ## Problemas comunes y soluciones rápidas -Antes de entrar en la solución de problemas detallada, prueba estas soluciones comunes: +Antes de entrar en la solución de problemas detallada, prueba estas soluciones habituales: -### ComfyUI no se inicia +### ComfyUI no inicia -**Síntomas:** la aplicación se bloquea al iniciar, se queda en pantalla negra o no termina de cargar +**Síntomas:** la aplicación se cierra al iniciar, muestra una pantalla negra o no carga **Soluciones rápidas:** -1. **Verifica los requisitos del sistema** - Asegúrate de que tu sistema cumpla los [requisitos mínimos](/es/installation/system_requirements) +1. **Revisa los requisitos del sistema** - Asegúrate de que tu sistema cumpla los [requisitos mínimos](/es/installation/system_requirements) 2. **Actualiza los controladores de la GPU** - Descarga los controladores más recientes de NVIDIA/AMD/Intel ### La generación falla o produce errores -**Síntomas:** aparece el diálogo "Prompt execution failed" con el botón "Show report" y el flujo de trabajo deja de ejecutarse +**Síntomas:** aparece el diálogo "La ejecución del prompt falló" con el botón "Mostrar informe" y el flujo de trabajo deja de ejecutarse **Soluciones rápidas:** -1. **Haz clic en "Show report"** - Lee el mensaje de error detallado para identificar el problema concreto -2. **Comprueba si es un problema de nodos personalizados** - [Sigue nuestra guía de solución de problemas de nodos personalizados](/es/troubleshooting/custom-node-issues) +1. **Haz clic en "Mostrar informe"** - Lee el mensaje de error detallado para identificar el problema concreto +2. **Comprueba si es un problema de un nodo personalizado** - [Sigue nuestra guía de solución de problemas de nodos personalizados](/es/troubleshooting/custom-node-issues) 3. **Verifica los archivos de modelo** - Consulta la [documentación de modelos](/es/basic-concepts/models) para configurar los modelos -4. **Revisa el uso de VRAM** - Cierra otras aplicaciones que estén usando la memoria de la GPU +4. **Revisa el uso de VRAM** - Cierra otras aplicaciones que estén usando memoria de la GPU ### Rendimiento lento **Síntomas:** tiempos de generación muy lentos, el sistema se congela, errores de memoria insuficiente **Soluciones rápidas:** -1. **Reduce la resolución o el tamaño del lote** - Disminuye el tamaño de la imagen o el número de imágenes -2. **Usa las opciones de optimización de memoria** - Consulta la sección de optimización de rendimiento de más abajo +1. **Reduce la resolución o el tamaño del lote** - Disminuye el tamaño de la imagen o la cantidad de imágenes +2. **Usa las opciones de optimización de memoria** - Consulta la sección de optimización del rendimiento más abajo 3. **Cierra las aplicaciones innecesarias** - Libera RAM y VRAM 4. **Revisa el uso de CPU/GPU** - Usa el Administrador de tareas para identificar los cuellos de botella -**Comandos de optimización de rendimiento:** +**Comandos de optimización del rendimiento:** Para sistemas con poca VRAM: ```bash @@ -66,7 +70,7 @@ python main.py --lowvram python main.py --cpu ``` -Para obtener un mejor rendimiento: +Para obtener mejor rendimiento: ```bash # Disable previews (saves VRAM and processing) python main.py --preview-method none @@ -92,35 +96,34 @@ python main.py --cache-none # Less RAM usage, but slower python main.py --cache-lru 10 # Cache 10 results, faster python main.py --cache-classic # Use the old style (aggressive) caching. ``` - -## Problemas específicos de la instalación +## Problemas específicos de instalación ### Problemas de la aplicación de escritorio -Para una solución de problemas completa de la instalación de escritorio, consulta la [Guía de instalación de escritorio](/es/installation/desktop/windows). +Para una guía completa de solución de problemas de instalación en escritorio, consulta la [Guía de instalación de escritorio](/es/installation/desktop/windows). -- **Dispositivo no compatible**: Comfy Desktop para Windows solo admite GPUs NVIDIA con CUDA. Usa [ComfyUI Portable](/es/installation/comfyui_portable_windows) o la [instalación manual](/es/installation/manual_install) para otras GPUs -- **La instalación falla**: ejecuta el instalador como administrador y asegúrate de tener al menos 15 GB de espacio en disco -- **Página de mantenimiento**: revisa la [configuración de espejos](/es/installation/desktop/usage/settings#avanzado) si las descargas fallan -- **Modelos faltantes**: los modelos no se copian durante la migración, solo se enlazan. Verifica las rutas de los modelos +- **Dispositivo no compatible**: Comfy Desktop para Windows solo admite GPU NVIDIA con CUDA. Usa [ComfyUI Portable](/es/installation/comfyui_portable_windows) o la [instalación manual](/es/installation/manual_install) para otras GPU +- **La instalación falla**: Ejecuta el instalador como administrador y asegúrate de tener al menos 15 GB de espacio en disco +- **Página de Mantenimiento**: Revisa las [Configuraciones de Espejo](/es/installation/desktop/usage/settings#avanzado) si fallan las descargas +- **Modelos faltantes**: Los modelos no se copian durante la migración, solo se vinculan. Verifica las rutas de los modelos -- **"La app está dañada"**: permite la app en la configuración de Seguridad y privacidad -- **Problemas de rendimiento**: concede Acceso completo al disco en la configuración de Privacidad -- **Cierres inesperados**: revisa la app Consola para ver los informes de fallos +- **"La aplicación está dañada"**: Permite la aplicación en las configuraciones de Seguridad y Privacidad +- **Problemas de rendimiento**: Otorga Acceso total al disco en las configuraciones de Privacidad +- **Cierres inesperados**: Revisa la aplicación Consola para ver los informes de fallos -- **Bibliotecas faltantes**: instala las dependencias con el gestor de paquetes -- **Errores de LD_LIBRARY_PATH**: problemas con la ruta de las bibliotecas de PyTorch (ver más abajo) +- **Librerías faltantes**: Instala las dependencias con el gestor de paquetes +- **Errores de LD_LIBRARY_PATH**: Problemas con la ruta de las librerías de PyTorch (ver abajo) ### Problemas de la instalación manual -Es posible que la documentación esté ligeramente desactualizada. Si surge algún problema, verifica manualmente si existe una versión estable más reciente de PyTorch o de cualquiera de las bibliotecas indicadas. Consulta recursos como la [matriz de instalación de PyTorch](https://pytorch.org/get-started/locally/) o el [sitio web de ROCm](https://rocm.docs.amd.com/projects/install-on-linux/en/develop/install/3rd-party/pytorch-install.html#using-a-wheels-package). +Es posible que la documentación esté un poco desactualizada. Si surge un problema, verifica manualmente si existe una versión estable más reciente de pytorch o de cualquiera de las librerías mencionadas. Consulta recursos como la [matriz de instalación de pytorch](https://pytorch.org/get-started/locally/) o el [sitio web de ROCm](https://rocm.docs.amd.com/projects/install-on-linux/en/develop/install/3rd-party/pytorch-install.html#using-a-wheels-package). **Conflictos de versión de Python:** @@ -134,7 +137,7 @@ source comfyui_env/bin/activate # Linux/Mac comfyui_env\Scripts\activate # Windows ``` -**Fallos al instalar paquetes:** +**Fallos en la instalación de paquetes:** ```bash # Update pip first python -m pip install --upgrade pip @@ -177,7 +180,7 @@ export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/cuda_runtime/lib:$LD_LIBRARY_PATH export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/cublas/lib:$LD_LIBRARY_PATH ``` -2. **Averigua qué bibliotecas tienes:** +2. **Averigua qué librerías tienes:** ```bash # Check installed NVIDIA packages python -c "import site; import os; nvidia_path=os.path.join(site.getsitepackages()[0], 'nvidia'); print('NVIDIA libs:', [d for d in os.listdir(nvidia_path) if os.path.isdir(os.path.join(nvidia_path, d))] if os.path.exists(nvidia_path) else 'Not found')" @@ -210,7 +213,7 @@ sudo echo "/usr/local/cuda/lib64" > /etc/ld.so.conf.d/cuda.conf sudo ldconfig ``` -5. **Depura la carga de bibliotecas:** +5. **Depura la carga de librerías:** ```bash # Verbose library loading to see what's missing LD_DEBUG=libs python main.py 2>&1 | grep "looking for" @@ -218,54 +221,53 @@ LD_DEBUG=libs python main.py 2>&1 | grep "looking for" # Check PyTorch CUDA availability python -c "import torch; print('CUDA available:', torch.cuda.is_available()); print('CUDA version:', torch.version.cuda)" ``` - ## Problemas relacionados con los modelos -Para una resolución de problemas de modelos completa, que incluye desajustes de arquitectura, modelos faltantes y errores de carga, consulta la página dedicada [Problemas de modelos](/es/troubleshooting/model-issues). +Para un diagnóstico completo de problemas con modelos, incluidas las incompatibilidades de arquitectura, los modelos faltantes y los errores de carga, consulta la página dedicada [Problemas de modelos](/es/troubleshooting/model-issues). ## Problemas de red y API -### Nodos asociados que no funcionan +### Los nodos asociados no funcionan -**Síntomas:** las llamadas a la API fallan, errores de tiempo de espera, cuota excedida +**Síntomas:** fallos en las llamadas a la API, errores de tiempo de espera, cuota excedida **Soluciones:** -1. **Verifica la validez de la clave API** - Comprueba las claves en [configuraciones de usuario](/es/interface/user) -2. **Revisa los créditos de la cuenta** - Asegúrate de tener suficientes [créditos de API](/es/interface/credits) -3. **Verifica la conexión a internet** - Prueba con otros servicios en línea -4. **Revisa el estado del servicio** - Es posible que el proveedor esté sufriendo una interrupción +1. **Verifica la validez de la clave API**: revisa las claves en [configuraciones de usuario](/es/interface/user) +2. **Verifica los créditos de la cuenta**: asegúrate de tener suficientes [créditos de API](/es/interface/credits) +3. **Verifica la conexión a internet**: prueba con otros servicios en línea +4. **Verifica el estado del servicio**: es posible que el proveedor tenga una interrupción del servicio ### Problemas de conexión -**Síntomas:** "Failed to connect to server", errores de tiempo de espera +**Síntomas:** "No se pudo conectar al servidor", errores de tiempo de espera **Soluciones:** -1. **Revisa la configuración del firewall** - Permite que ComfyUI pase a través del firewall -2. **Prueba con otro puerto** - El predeterminado es 8188, prueba con 8189 o 8190 -3. **Desactiva la VPN temporalmente** - La VPN puede estar bloqueando las conexiones -4. **Revisa la configuración del proxy** - Desactiva el proxy si no es necesario +1. **Verifica la configuración del firewall**: permite que ComfyUI pase por el firewall +2. **Prueba con un puerto diferente**: el predeterminado es 8188; prueba 8189 o 8190 +3. **Desactiva la VPN temporalmente**: es posible que la VPN esté bloqueando las conexiones +4. **Verifica la configuración del proxy**: desactiva el proxy si no es necesario ### Problemas del frontend **"El paquete de frontend o de plantillas no está actualizado":** ```bash -# Después de actualizar ComfyUI vía Git, actualiza las dependencias del frontend +# Después de actualizar ComfyUI mediante Git, actualiza las dependencias del frontend pip install -r requirements.txt ``` -**"No se encuentra el nodo personalizado":** +**"No se puede encontrar el nodo personalizado":** - Desactiva la validación de nodos en las configuraciones de ComfyUI -**"Aviso de error sobre un flujo de trabajo que no pasa la validación":** +**"Notificación de error sobre un flujo de trabajo que no supera la validación":** - Desactiva temporalmente la validación del flujo de trabajo en las configuraciones - Reporta el problema al equipo de ComfyUI -**Problemas de inicio de sesión fuera de localhost:** +**Problemas de inicio de sesión cuando no estás en localhost:** - El inicio de sesión normal solo funciona cuando accedes desde localhost - Para acceso por LAN o remoto: genera una clave API en [platform.comfy.org/login](https://platform.comfy.org/login) - Usa la clave API en el diálogo de inicio de sesión o con el argumento de línea de comandos `--api-key` -## Problemas específicos del hardware +## Problemas específicos de hardware ### Problemas con GPU NVIDIA @@ -293,16 +295,16 @@ nvidia-smi nvidia-smi --query-gpu=driver_version --format=csv ``` -**GPUs Blackwell (`sm_103`): la generación falla en la primera capa de atención:** +**GPU Blackwell (`sm_103`): la generación falla en la primera capa de atención:** -En las GPUs NVIDIA de generación Blackwell, la atención de producto escalar escalada (SDPA) que PyTorch usa de forma predeterminada puede -seleccionar el backend de cuDNN, que no tiene ningún plan válido para esta arquitectura: +En las GPU NVIDIA de generación Blackwell, la atención de producto escalar escalado (SDPA) predeterminada de PyTorch puede +seleccionar el backend cuDNN, que no tiene un plan válido para esta arquitectura: ``` cuDNN Frontend error: No valid execution plans built ``` -Con FLUX esto afecta al primer bloque de atención de la UNet, así que nunca se llega a producir ninguna imagen. +Con FLUX, esto afecta al primer bloque de atención de la UNet, por lo que nunca se genera una imagen. ```bash # Use a hand-written attention implementation that bypasses SDPA and cuDNN @@ -313,16 +315,16 @@ python main.py --use-split-cross-attention ``` -Desactivar el backend cuDNN de SDPA mediante código antes del arranque — por ejemplo, llamando a -`torch.backends.cuda.enable_cudnn_sdp(False)` desde un `sitecustomize.py` — no funciona, porque -el flag no se conserva a través de la inicialización de CUDA. El flag de arranque es la solución fiable. +Deshabilitar el backend SDPA de cuDNN mediante programación antes del inicio, por ejemplo llamando a +`torch.backends.cuda.enable_cudnn_sdp(False)` desde un `sitecustomize.py`, no funciona, porque +el indicador no se conserva durante la inicialización de CUDA. La opción de inicio es la solución fiable. -*Esta entrada se añadió en el [PR #1491](https://github.com/Comfy-Org/docs/pull/1491).* +*Esta entrada se añadió en [PR #1491](https://github.com/Comfy-Org/docs/pull/1491).* ### Problemas con GPU AMD -**Compatibilidad con ROCm (solo Linux):** +**Soporte de ROCm (solo Linux):** ```bash # Install stable ROCm PyTorch (7.2 at the time of writing) pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2 @@ -331,7 +333,7 @@ pip install torch torchvision torchaudio --index-url https://download.pytorch.or pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.2 ``` -**GPUs AMD no compatibles:** +**GPU AMD no compatibles:** ```bash # For RDNA2 or older (6700, 6600) HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py @@ -340,7 +342,7 @@ HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py ``` -**Optimización de rendimiento:** +**Optimización del rendimiento:** ```bash # Enable experimental memory efficient attention (no longer necessary with PyTorch 2.4) TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 python main.py --use-pytorch-cross-attention @@ -353,9 +355,9 @@ PYTORCH_TUNABLEOP_ENABLED=1 python main.py ### Problemas con Apple Silicon (M1/M2/M3) -Los pasos de esta sección se aplican a una instalación manual o desde el código fuente, en la que ComfyUI se ejecuta en un entorno de Python que configuras tú mismo. Consulta los [Requisitos del sistema](/es/installation/system_requirements) para ver las versiones de Python compatibles y la [Instalación manual](/es/installation/manual_install) para los pasos de configuración. +Los pasos de esta sección se aplican a una instalación manual o desde el código fuente, donde ComfyUI se ejecuta en un entorno de Python que configuras tú mismo. Consulta [Requisitos del sistema](/es/installation/system_requirements) para conocer las versiones de Python compatibles y [Instalación manual](/es/installation/manual_install) para los pasos de configuración. -**Comfy Desktop** en Apple silicon no necesita una instalación de Python aparte: la app gestiona su propio entorno de Python para cada instancia. Consulta [Comfy Desktop para macOS](/es/installation/desktop/macos). +**Comfy Desktop** en Apple Silicon no necesita una instalación separada de Python: la aplicación gestiona su propio entorno de Python para cada instancia. Consulta [Comfy Desktop para macOS](/es/installation/desktop/macos). **Configuración del backend MPS:** @@ -379,13 +381,13 @@ python main.py --cpu python main.py --force-fp16 --cpu ``` -### Problemas con GPU Intel {#intel-gpu-issues} +### Problemas con GPU Intel **Error "Torch not compiled with CUDA enabled":** -En las GPUs Intel este error significa que ComfyUI intentó usar CUDA porque el backend XPU no estaba disponible. No sigas los pasos de reinstalación de CUDA para NVIDIA indicados arriba. Las GPUs Intel usan XPU, no CUDA. +En las GPU Intel, este error significa que ComfyUI intentó usar CUDA porque el backend XPU no estaba disponible. No sigas los pasos de reinstalación de CUDA para NVIDIA indicados arriba. Las GPU Intel usan XPU, no CUDA. -Comprueba si PyTorch puede ver la GPU Intel: +Comprueba si PyTorch puede detectar la GPU Intel: ```bash python -c "import torch; print('XPU available:', hasattr(torch, 'xpu') and torch.xpu.is_available())" @@ -395,11 +397,11 @@ Si imprime `True`, ComfyUI usa el backend XPU automáticamente. Si imprime `False`: -1. Confirma que tienes una GPU Intel Arc compatible (Arc serie A, Arc serie B o un procesador Core Ultra con Arc Graphics). +1. Confirma que tienes una GPU Intel Arc compatible (Arc serie A, Arc serie B o un procesador Core Ultra con gráficos Arc). 2. Instala o actualiza el [controlador de GPU Intel](https://www.intel.com/content/www/us/en/developer/articles/tool/pytorch-prerequisites-for-intel-gpu.html). -3. Instala una versión de PyTorch con soporte XPU usando una de las opciones de abajo. No instales un wheel de CUDA. +3. Instala una compilación de PyTorch habilitada para XPU usando una de las opciones siguientes. No instales un wheel de CUDA. -**Opción 1: soporte XPU nativo de PyTorch (Windows/Linux):** +**Opción 1: Soporte nativo de XPU en PyTorch (Windows/Linux):** ```bash # Stable XPU wheels (recommended) pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu @@ -417,31 +419,30 @@ python main.py conda install libuv pip install torch==2.3.1.post0+cxx11.abi torchvision==0.18.1.post0+cxx11.abi torchaudio==2.3.1.post0+cxx11.abi intel-extension-for-pytorch==2.3.110.post0+xpu --extra-index-url https://pytorch-extension.intel.com/release-whl/stable/xpu/us/ ``` - ## Preguntas frecuentes ### ¿Cómo ejecuto ComfyUI con Docker? -Para la instalación local en Linux, sigue la [Guía de instalación manual](/es/installation/manual_install). Para el uso en la nube, consulta [Comfy Cloud](/es/get_started/cloud). +Para instalar localmente en Linux, sigue la [Guía de instalación manual](/es/installation/manual_install). Para usarlo en la nube, consulta [Comfy Cloud](/es/get_started/cloud). -## Obtener ayuda y reportar errores +## Obtener ayuda y reportar errores {#getting-help--reporting-bugs} ### Antes de reportar un error -1. **Verifica si es un problema conocido:** - - Busca en [Problemas de GitHub](https://github.com/Comfy-Org/ComfyUI/issues) +1. **Comprueba si es un problema conocido:** + - Busca en los [Problemas de GitHub](https://github.com/Comfy-Org/ComfyUI/issues) - Revisa el [Foro de ComfyUI](https://forum.comfy.org/) - - Consulta las [discusiones de Discord](https://discord.com/invite/comfyorg) + - Consulta las [discusiones en Discord](https://discord.com/invite/comfyorg) 2. **Prueba la solución de problemas básica:** - Prueba con el [flujo de trabajo predeterminado](/es/get_started/first_generation) - Desactiva todos los nodos personalizados (consulta [solución de problemas de nodos personalizados](/es/troubleshooting/custom-node-issues)) - - Revisa la consola/terminal en busca de mensajes de error + - Revisa la consola/terminal para ver los mensajes de error - Si usas comfy-cli, intenta actualizar: `comfy node update all` -### Cómo reportar errores de forma efectiva +### Cómo reportar errores de forma eficaz #### Para problemas del núcleo de ComfyUI **Dónde reportar:** [Problemas de GitHub](https://github.com/Comfy-Org/ComfyUI/issues) @@ -464,15 +465,15 @@ Al reportar cualquier problema, incluye: -**Información del sistema (la puedes encontrar en la página Acerca de, en configuraciones):** +**Información del sistema (se encuentra en la página Acerca de en las configuraciones):** - Sistema operativo (Windows 11, macOS 14.1, Ubuntu 22.04, etc.) -- Versión de ComfyUI (revisa la página Acerca de en configuraciones) +- Versión de ComfyUI (consulta la página Acerca de en las configuraciones) - Versión de Python: `python --version` - Versión de PyTorch: `python -c "import torch; print(torch.__version__)"` - Modelo de GPU y versión del controlador - Método de instalación (Desktop, Portable, Manual, comfy-cli) -![Página Acerca de en configuraciones](/images/troubleshooting/menu-about.jpg) +![Página Acerca de en las configuraciones](/images/troubleshooting/menu-about.jpg) @@ -519,12 +520,12 @@ Al reportar cualquier problema, incluye: **Detalles del problema:** - Descripción clara del problema - Pasos para reproducir el problema -- Comportamiento esperado vs. real +- Comportamiento esperado frente al real - Capturas de pantalla o videos si corresponde **Mensajes de error:** - Texto completo del error de la consola/terminal -- Errores de la consola del navegador (F12 → pestaña Consola) +- Errores de la consola del navegador (F12 → pestaña Console) - Cualquier registro de fallos o diálogo de error From 892f8f79da762550a9b34239dbe1d6d292926dad Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 12:49:55 +0800 Subject: [PATCH 2/5] i18n(es): translate custom-nodes guides (batch 2) --- es/custom-nodes/backend/lazy_evaluation.mdx | 45 +++-- es/custom-nodes/backend/node-replacement.mdx | 70 ++++---- es/custom-nodes/i18n.mdx | 20 +-- es/custom-nodes/js/context-menu-migration.mdx | 42 ++--- .../js/javascript_commands_keybindings.mdx | 28 +-- es/custom-nodes/js/javascript_examples.mdx | 35 ++-- .../js/javascript_objects_and_hijacking.mdx | 163 +++++++++--------- .../js/javascript_selection_toolbox.mdx | 40 ++--- es/custom-nodes/js/javascript_settings.mdx | 100 +++++------ .../js/javascript_sidebar_tabs.mdx | 23 +-- es/custom-nodes/js/javascript_topbar_menu.mdx | 12 +- es/custom-nodes/js/subgraphs.mdx | 58 +++---- es/custom-nodes/walkthrough.mdx | 36 ++-- 13 files changed, 324 insertions(+), 348 deletions(-) diff --git a/es/custom-nodes/backend/lazy_evaluation.mdx b/es/custom-nodes/backend/lazy_evaluation.mdx index 3d3724163d..785850209d 100644 --- a/es/custom-nodes/backend/lazy_evaluation.mdx +++ b/es/custom-nodes/backend/lazy_evaluation.mdx @@ -1,35 +1,33 @@ --- title: "Evaluación diferida" -description: "Aprende a aplazar la evaluación de entradas en ComfyUI (v0.2.0+), optimizar la VRAM y usar lazy: True en tus nodos personalizados." -translationSourceHash: e3b0c442 +description: "Aprende cómo funciona la evaluación diferida en ComfyUI (v0.2.0+): aplaza entradas, optimiza la VRAM y usa lazy: True en nodos personalizados." +translationSourceHash: 7295486b translationFrom: custom-nodes/backend/lazy_evaluation.mdx translationBlockHashes: + "Lazy Evaluation": 31ec63ad + "Execution Blocking": 7ef9a880 --- - ## Evaluación diferida -De forma predeterminada, todas las entradas `required` y `optional` se evalúan antes de que un nodo pueda ejecutarse. A veces, sin embargo, una -entrada no se usará necesariamente y evaluarla supondría un procesamiento innecesario. Aquí tienes algunos ejemplos -de nodos en los que la evaluación diferida puede resultar beneficiosa: -1. Un nodo `ModelMergeSimple` en el que el ratio es `0.0` (en cuyo caso no es necesario cargar el primer modelo) -o `1.0` (en cuyo caso no es necesario cargar el segundo modelo). -2. Una interpolación entre dos imágenes en la que el ratio (o la máscara) es enteramente `0.0` o enteramente `1.0`. -3. Un nodo Switch en el que una entrada determina cuál de las demás entradas se dejará pasar. +De forma predeterminada, todas las entradas `required` y `optional` se evalúan antes de que un nodo pueda ejecutarse. Sin embargo, a veces una entrada no necesariamente se usará y evaluarla daría lugar a un procesamiento innecesario. Estos son algunos ejemplos de nodos en los que la evaluación diferida puede resultar beneficiosa: +1. Un nodo `ModelMergeSimple` en el que la relación es `0.0` (en cuyo caso el primer modelo no necesita cargarse) o `1.0` (en cuyo caso el segundo modelo no necesita cargarse). +2. Una interpolación entre dos imágenes en la que la relación (o la máscara) es completamente `0.0` o completamente `1.0`. +3. Un nodo Switch en el que una entrada determina cuál de las otras entradas se transmitirá. -Hacer que una entrada sea diferida tiene muy poco coste. Si es algo que puedes hacer, por lo general deberías hacerlo. +Hacer que una entrada sea diferida tiene muy poco costo. Si puedes hacerlo, por lo general deberías. ### Crear entradas diferidas -Hay dos pasos para convertir una entrada en una entrada "diferida". Son estos: +Hay dos pasos para convertir una entrada en una entrada "diferida". Son los siguientes: 1. Marca la entrada como diferida en el diccionario que devuelve `INPUT_TYPES` -2. Define un método llamado `check_lazy_status` (nota: *no* es un método de clase) que se llamará antes de la evaluación para determinar si se necesitan más entradas. +2. Define un método llamado `check_lazy_status` (nota: *no* un método de clase) que se llamará antes de la evaluación para determinar si se necesitan más entradas. -Para demostrarlo, crearemos un nodo "MixImages" que interpola entre dos imágenes según una máscara. Si toda la máscara es `0.0`, no necesitamos evaluar ninguna parte del árbol que conduce a la segunda imagen. Si toda la máscara es `1.0`, podemos omitir la evaluación de la primera imagen. +Para demostrarlo, crearemos un nodo "MixImages" que interpola entre dos imágenes según una máscara. Si toda la máscara es `0.0`, no necesitamos evaluar ninguna parte del árbol que conduce a la segunda imagen. Si toda la máscara es `1.0`, podemos saltar la evaluación de la primera imagen. #### Definir `INPUT_TYPES` -Declarar que una entrada es diferida es tan simple como añadir un par clave-valor `lazy: True` al diccionario de opciones de la entrada. +Declarar que una entrada es diferida es tan simple como agregar un par clave-valor `lazy: True` al diccionario de opciones de la entrada. ```python @classmethod @@ -47,11 +45,11 @@ En este ejemplo, `image1` e `image2` están marcadas como entradas diferidas, pe #### Definir `check_lazy_status` -Se llama a un método `check_lazy_status` si hay una o más entradas diferidas que todavía no están disponibles. Este método recibe los mismos argumentos que la función de ejecución estándar. Todas las entradas disponibles se pasan con sus valores finales, mientras que las entradas diferidas no disponibles tienen un valor de `None`. +Se llama a un método `check_lazy_status` si hay una o más entradas diferidas que aún no están disponibles. Este método recibe los mismos argumentos que la función de ejecución estándar. Todas las entradas disponibles se pasan con sus valores finales, mientras que las entradas diferidas no disponibles tienen un valor de `None`. La responsabilidad de la función `check_lazy_status` es devolver una lista con los nombres de las entradas diferidas que se necesitan para continuar. Si todas las entradas diferidas están disponibles, la función debe devolver una lista vacía. -Ten en cuenta que `check_lazy_status` puede llamarse varias veces. (Por ejemplo, tras evaluar una entrada diferida puedes descubrir que necesitas evaluar otra.) +Ten en cuenta que `check_lazy_status` puede llamarse varias veces. (Por ejemplo, después de evaluar una entrada diferida puedes descubrir que necesitas evaluar otra). Ten en cuenta que, como la función usa los valores reales de las entradas, *no* es un método de clase. ```python @@ -108,24 +106,23 @@ class LazyMixImages: result = image1 * (1. - mask) + image2 * mask, return (result[0],) ``` - ## Bloqueo de la ejecución -Aunque la evaluación diferida es la forma recomendada de "desactivar" parte de un grafo, hay ocasiones en las que quieres desactivar un nodo `OUTPUT` que no implementa la evaluación diferida por sí mismo. Si es un nodo de salida que has desarrollado tú, simplemente deberías añadir la evaluación diferida de la siguiente manera: +Aunque la Evaluación diferida es la forma recomendada de "desactivar" parte de un gráfico, hay ocasiones en las que quieres desactivar un nodo `OUTPUT` que no implementa la evaluación diferida por sí mismo. Si es un nodo de salida que desarrollaste tú, simplemente debes agregar la evaluación diferida de la siguiente manera: -1. Añade una entrada `enabled` requerida (si es un nodo nuevo) u opcional (si te importa la compatibilidad hacia atrás) que tenga `True` por defecto +1. Agrega una entrada requerida (si es un nodo nuevo) u opcional (si te importa la compatibilidad hacia atrás) para `enabled` que tenga `True` como valor predeterminado 2. Convierte todas las demás entradas en entradas `lazy` 3. Evalúa las demás entradas solo si `enabled` es `True` -Si no es un nodo que controles, puedes usar un `comfy_execution.graph.ExecutionBlocker`. Este objeto especial se puede devolver como salida desde cualquier conector. Cualquier nodo que reciba un `ExecutionBlocker` como entrada omitirá la ejecución y devolverá ese `ExecutionBlocker` en todas sus salidas. +Si no es un nodo que controlas, puedes usar un `comfy_execution.graph.ExecutionBlocker`. Este objeto especial se puede devolver como salida desde cualquier socket. Cualquier nodo que reciba un `ExecutionBlocker` como entrada saltará la ejecución y devolverá ese `ExecutionBlocker` en todas sus salidas. -**Deliberadamente no hay forma de impedir que un ExecutionBlocker se propague hacia delante.** Si crees que quieres esto, en realidad deberías usar la evaluación diferida. +**Intencionalmente no existe ninguna forma de impedir que un ExecutionBlocker se propague hacia adelante.** Si crees que quieres esto, en realidad deberías usar la Evaluación diferida. ### Uso Hay dos formas de construir y usar un `ExecutionBlocker` -1. Pasa `None` al constructor para bloquear la ejecución de forma silenciosa. Esto es útil en los casos en los que bloquear la ejecución forma parte de una ejecución exitosa, como desactivar una salida. +1. Pasa `None` al constructor para bloquear la ejecución de forma silenciosa. Esto es útil en casos donde bloquear la ejecución forma parte de una ejecución exitosa, como desactivar una salida. ```python def silent_passthrough(self, passthrough, blocked): if blocked: @@ -134,7 +131,7 @@ def silent_passthrough(self, passthrough, blocked): return (passthrough,) ``` -2. Pasa una cadena al constructor para mostrar un mensaje de error cuando un nodo se bloquea por recibir el objeto. Esto puede ser útil si quieres mostrar un mensaje de error significativo cuando alguien usa una salida sin sentido, por ejemplo, la salida `VAE` al cargar un modelo que no contiene VAE. +2. Pasa una cadena al constructor para mostrar un mensaje de error cuando un nodo se bloquee por recibir el objeto. Esto puede ser útil si quieres mostrar un mensaje de error significativo cuando alguien usa una salida sin sentido, por ejemplo, la salida `VAE` al cargar un modelo que no contiene VAE. ```python def load_checkpoint(self, ckpt_name): diff --git a/es/custom-nodes/backend/node-replacement.mdx b/es/custom-nodes/backend/node-replacement.mdx index 3f330d039f..4407fa2daf 100644 --- a/es/custom-nodes/backend/node-replacement.mdx +++ b/es/custom-nodes/backend/node-replacement.mdx @@ -1,27 +1,34 @@ --- title: "Reemplazo de nodos" description: "Registra reemplazos de nodos para que los usuarios migren de los nodos obsoletos" -translationSourceHash: fa4b1539 +translationSourceHash: 2ac538b1 translationFrom: custom-nodes/backend/node-replacement.mdx translationBlockHashes: "_intro": 0dc318ee "When to use": df3092ae + "Where to register replacements": c2c95bb5 + "Complete example": 6def7f45 + "Core examples": 77a9e90a "NodeReplace parameters": 22f2bd38 + "Input mapping": 573af3a3 + "Output mapping": 9520b317 + "Widget ID binding": 37e95b97 + "REST API": e15f8cd2 "Frontend behavior": 2fc5a2b5 --- -La API de reemplazo de nodos permite a los desarrolladores de nodos personalizados definir rutas de migración desde nodos obsoletos hasta sus equivalentes más recientes. Cuando actualizas o renombras nodos, los usuarios pueden actualizar automáticamente sus flujos de trabajo. +La API de reemplazo de nodos permite a los desarrolladores de nodos personalizados definir rutas de migración desde nodos obsoletos hasta sus equivalentes más recientes. Cuando actualizas o renombras nodos, los usuarios pueden mejorar automáticamente sus flujos de trabajo. ## Cuándo usar -- **Cambiar nombres de clase de nodo**: Cambiaste el nombre de clase de un nodo (usa `DISPLAY_NAME` para cambios de nombre para mostrar en su lugar) +- **Cambiar nombres de clase de nodo**: Cambiaste el nombre de clase de un nodo (en su lugar, usa `DISPLAY_NAME` para cambios de nombre para mostrar) - **Fusionar nodos**: Varios nodos consolidados en uno (p. ej., `Load3DAnimation` fusionado en `Load3D`) - **Refactorizar entradas**: Los nombres o tipos de las entradas cambiaron entre versiones - **Corregir errores tipográficos**: Corregir nombres de nodos sin romper los flujos de trabajo existentes ## Dónde registrar los reemplazos -Registra los reemplazos durante el gancho de ciclo de vida `on_load` de tu extensión. Crea un archivo dedicado (p. ej., `node_replacements.py`) en el paquete de tu nodo personalizado: +Registra los reemplazos durante el hook del ciclo de vida `on_load` de tu extensión. Crea un archivo dedicado (por ejemplo, `node_replacements.py`) en tu paquete de nodos personalizados: ``` my_custom_nodes/ @@ -29,10 +36,9 @@ my_custom_nodes/ ├── nodes.py └── node_replacements.py # Register replacements here ``` - ## Ejemplo completo -Aquí tienes un ejemplo completo de cómo estructurar los reemplazos de nodos en un paquete de nodo personalizado: +Aquí tienes un ejemplo completo que muestra cómo estructurar los reemplazos de nodos en un paquete de nodos personalizados: ```python # node_replacements.py @@ -78,14 +84,13 @@ class MyExtension(ComfyExtension): async def comfy_entrypoint() -> MyExtension: return MyExtension() ``` +## Ejemplos principales -## Ejemplos del núcleo - -El núcleo de ComfyUI usa reemplazos de nodos para las migraciones de nodos integrados. Aquí tienes ejemplos reales de [`comfy_extras/nodes_replacements.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy_extras/nodes_replacements.py): +El núcleo de ComfyUI usa reemplazos de nodos para las migraciones de nodos integrados. Aquí hay ejemplos reales de [`comfy_extras/nodes_replacements.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy_extras/nodes_replacements.py): ### Fusión simple de nodos -Cuando `Load3DAnimation` se fusionó en `Load3D`: +Cuando `Load3DAnimation` se fusionó con `Load3D`: ```python await api.node_replacement.register(io.NodeReplace( @@ -94,9 +99,9 @@ await api.node_replacement.register(io.NodeReplace( )) ``` -### Corrección de errata +### Corrección de un error tipográfico -Corrección de una errata en `SDV_img2vid_Conditioning` → `SVD_img2vid_Conditioning`: +Cómo corregir un error tipográfico en `SDV_img2vid_Conditioning` → `SVD_img2vid_Conditioning`: ```python await api.node_replacement.register(io.NodeReplace( @@ -107,7 +112,7 @@ await api.node_replacement.register(io.NodeReplace( ### Renombrar entradas con valores predeterminados -Sustituir `ImageScaleBy` por `ResizeImageMaskNode`: +Cómo reemplazar `ImageScaleBy` por `ResizeImageMaskNode`: ```python await api.node_replacement.register(io.NodeReplace( @@ -123,9 +128,9 @@ await api.node_replacement.register(io.NodeReplace( )) ``` -### Mapeo de entradas Autogrow +### Asignación de entradas con Autogrow -Para los nodos que usan Autogrow (entradas dinámicas), usa la notación con puntos: +Para los nodos que usan Autogrow (entradas dinámicas), usa la notación con punto: ```python await api.node_replacement.register(io.NodeReplace( @@ -137,22 +142,21 @@ await api.node_replacement.register(io.NodeReplace( ], )) ``` - ## Parámetros de NodeReplace | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `new_node_id` | str | Nombre de clase del nodo de reemplazo | | `old_node_id` | str | Nombre de clase del nodo obsoleto | -| `old_widget_ids` | list[str] \| None | Lista ordenada que vincula los IDs de widget con sus índices relativos | +| `old_widget_ids` | list[str] \| None | Lista ordenada que vincula los ID de widget con sus índices relativos | | `input_mapping` | list \| None | Cómo asignar las entradas del nodo antiguo al nuevo | | `output_mapping` | list \| None | Cómo asignar las salidas del nodo antiguo al nuevo | -## Mapeo de entradas +## Asignación de entradas -Cada entrada del mapeo define cómo se transfiere una entrada del nodo antiguo al nuevo. +Cada entrada de la asignación define cómo se transfiere una entrada del nodo anterior al nuevo. -**Mapear desde una entrada antigua:** +**Asignar desde la entrada anterior:** ```python {"new_id": "model", "old_id": "model"} ``` @@ -162,23 +166,21 @@ Cada entrada del mapeo define cómo se transfiere una entrada del nodo antiguo a {"new_id": "scheduler", "set_value": "normal"} ``` -**Mapear entradas dinámicas o autogrow (usa la notación con puntos):** +**Asignar entradas dinámicas/autogrow (usa notación con punto):** ```python {"new_id": "images.image0", "old_id": "image1"} ``` +## Asignación de salidas -## Mapeo de salidas - -Los mapeos de salidas usan referencias basadas en índices: +Las asignaciones de salidas usan referencias basadas en índices: ```python {"new_idx": 0, "old_idx": 0} # Map first output {"new_idx": 1, "old_idx": 0} # Old output 0 -> new output 1 ``` +## Vinculación de ID de widget -## Vinculación de IDs de widget - -El campo `old_widget_ids` asigna los IDs de widget a sus índices posicionales. Esto es necesario porque el JSON del flujo de trabajo guarda los valores de los widgets por posición, no por ID. +El campo `old_widget_ids` asigna los ID de widget a sus índices posicionales. Esto es requerido porque el JSON del flujo de trabajo almacena los valores de los widgets por posición, no por ID. ```python old_widget_ids=["steps", "cfg", "sampler"] @@ -186,8 +188,7 @@ old_widget_ids=["steps", "cfg", "sampler"] # Widget at index 1 = "cfg" # Widget at index 2 = "sampler" ``` - -## API REST +## REST API Recupera todos los reemplazos registrados: @@ -215,18 +216,17 @@ GET /api/node_replacements ] } ``` - ## Comportamiento del frontend Cuando un flujo de trabajo contiene un nodo obsoleto, el frontend: 1. Obtiene los reemplazos desde `GET /api/node_replacements` 2. Detecta los nodos que coinciden con `old_node_id` -3. Pide al usuario que los actualice -4. Aplica las asignaciones de entrada/salida automáticamente +3. Pide al usuario que actualice +4. Aplica las asignaciones de entrada y salida automáticamente 5. Conserva las conexiones y los valores de los widgets Consulta la implementación del frontend: -- [PR #8364 de lógica de negocio](https://github.com/Comfy-Org/ComfyUI_frontend/pull/8364) -- [PR #8483 de lógica adicional](https://github.com/Comfy-Org/ComfyUI_frontend/pull/8483) -- [PR #8604 de vistas de UI](https://github.com/Comfy-Org/ComfyUI_frontend/pull/8604) +- [PR de lógica de negocio #8364](https://github.com/Comfy-Org/ComfyUI_frontend/pull/8364) +- [PR de lógica adicional #8483](https://github.com/Comfy-Org/ComfyUI_frontend/pull/8483) +- [PR de vistas de UI #8604](https://github.com/Comfy-Org/ComfyUI_frontend/pull/8604) diff --git a/es/custom-nodes/i18n.mdx b/es/custom-nodes/i18n.mdx index 642f8f5552..383950cce2 100644 --- a/es/custom-nodes/i18n.mdx +++ b/es/custom-nodes/i18n.mdx @@ -2,15 +2,17 @@ title: "Soporte de i18n para nodos personalizados de ComfyUI" description: "Aprende a agregar soporte multilingüe a los nodos personalizados de ComfyUI" sidebarTitle: "Soporte i18n" -translationSourceHash: fb121c03 +translationSourceHash: fe4cc833 translationFrom: custom-nodes/i18n.mdx translationBlockHashes: "_intro": 7768476b + "Directory Structure": b47ab692 "nodeDefs.json - Node Definition Translation": 845d40ff + "Menu Settings": 495c02c3 "Custom Frontend Component Localization Support": 6c46ce53 --- -import SupportedLanguages from "/snippets/es/interface/supported-languages.mdx" +import SupportedLanguages from '/snippets/es/interface/supported-languages.mdx' Si quieres agregar soporte para varios idiomas, puedes consultar este documento para aprender a implementar la compatibilidad multilingüe. @@ -40,7 +42,6 @@ your_custom_node/ ├──... ``` - ## nodeDefs.json - Traducción de definiciones de nodos Por ejemplo, aquí tienes un ejemplo de definición en Python de un nodo [i18n-demo](https://github.com/comfyui-wiki/ComfyUI-i18n-demo): @@ -103,7 +104,7 @@ class I18nTextProcessor: return (f"Error: {str(e)}",) ``` -Después, el contenido correspondiente del archivo nodeDefs.json de soporte de localización debe incluir: +Luego, el contenido correspondiente del archivo nodeDefs.json de soporte localizado debe incluir: ```json { @@ -144,11 +145,11 @@ Después, el contenido correspondiente del archivo nodeDefs.json de soporte de l } ``` -En la parte de salida del nodo, usa el índice de salida correspondiente en lugar del nombre de la salida: por ejemplo, la primera salida debe ser `0`, la segunda debe ser `1`, y así sucesivamente. +Para la parte de salida del nodo, se usa el índice de salida correspondiente en lugar del nombre de la salida. Por ejemplo, la primera salida debe ser `0`, la segunda debe ser `1`, y así sucesivamente. -## Configuración de menús +## Configuraciones del menú -Por ejemplo, en el nodo personalizado i18n-demo registramos las siguientes dos configuraciones de menú: +Por ejemplo, en el nodo personalizado i18n-demo, registramos las siguientes dos configuraciones de menú: ```javascript app.registerExtension({ name: "I18nDemo", @@ -179,7 +180,7 @@ app.registerExtension({ }) ``` -Si necesitas añadir el soporte de internacionalización correspondiente, para la categoría del menú debes añadirlo en el archivo `main.json`: +Si necesitas agregar el soporte de internacionalización correspondiente, para la categoría del menú debes agregarlo en el archivo `main.json`: ```json { @@ -216,7 +217,6 @@ Ten en cuenta que el nombre de la clave de traducción correspondiente debe reem ``` "I18nDemo.EnableDebugMode" -> "I18nDemo_EnableDebugMode" ``` - -## Soporte de localización de componentes personalizados del frontend +## Soporte de localización de componentes de frontend personalizados [Por actualizar] diff --git a/es/custom-nodes/js/context-menu-migration.mdx b/es/custom-nodes/js/context-menu-migration.mdx index 78265ac53a..5bcb601af4 100644 --- a/es/custom-nodes/js/context-menu-migration.mdx +++ b/es/custom-nodes/js/context-menu-migration.mdx @@ -2,12 +2,14 @@ title: "Guía de migración del menú contextual" sidebarTitle: "Migración del menú contextual" description: "Migra extensiones de ComfyUI del monkey-patching obsoleto a la API del menú contextual: menús del lienzo y nodos, elementos condicionales, submenús y depuración." -translationSourceHash: 07ff20d5 +translationSourceHash: 85f8bc2d translationFrom: custom-nodes/js/context-menu-migration.mdx translationBlockHashes: "_intro": 490e9066 "Migrating Canvas Menus": e50eec10 "Migrating Node Menus": e70e5cae + "Common Patterns": 25c1531e + "Troubleshooting": cb75f0ed "Additional Resources": cd3bcadb --- @@ -79,7 +81,7 @@ app.registerExtension({ | Modificado en `setup()` | Usa el hook `getCanvasMenuItems()` | | Envuelve la función existente | Devuelve los elementos del menú directamente | | Modifica el arreglo `options` | Devuelve un arreglo nuevo | -| Acceso al lienzo mediante `this` | Lienzo recibido como parámetro | +| Acceso al lienzo mediante `this` | El lienzo se pasa como parámetro | ## Migrar los menús de nodos @@ -94,7 +96,7 @@ app.registerExtension({ name: "MyExtension", async beforeRegisterNodeDef(nodeType, nodeData, app) { if (nodeType.comfyClass === "KSampler") { - // ❌ ANTERIOR: modificar el prototipo del nodo + // ❌ ANTERIOR: parchear el prototipo del nodo const original = nodeType.prototype.getExtraMenuOptions nodeType.prototype.getExtraMenuOptions = function(canvas, options) { original?.apply(this, arguments) @@ -152,7 +154,7 @@ app.registerExtension({ | Se modificaba en `beforeRegisterNodeDef()` | Usa el hook `getNodeMenuItems()` | | Específico por tipo mediante una comprobación `if` | Específico por tipo mediante una comprobación `if` en el hook | | Modifica el array `options` | Devuelve un array nuevo | -| Se accede al nodo mediante `this` | El nodo se pasa como parámetro | +| Acceso al nodo mediante `this` | El nodo se pasa como parámetro | ## Patrones comunes @@ -178,9 +180,9 @@ getCanvasMenuItems(canvas) { } ``` -### Añadir separadores +### Agregar separadores -Los separadores se añaden de la misma forma en ambos enfoques: +Los separadores se agregan de la misma forma en ambos enfoques: ```javascript getCanvasMenuItems(canvas) { @@ -214,9 +216,9 @@ getNodeMenuItems(node) { } ``` -Este enfoque declarativo es más limpio y coincide con los patrones que se usan en todo el código de ComfyUI. +Este enfoque declarativo es más limpio y coincide con los patrones usados en todo el código base de ComfyUI. -Aunque también se admite un enfoque basado en callbacks con `has_submenu: true` y `new LiteGraph.ContextMenu()`, se prefiere la propiedad declarativa `submenu` porque es más fácil de mantener. +Aunque también se admite un enfoque basado en callbacks con `has_submenu: true` y `new LiteGraph.ContextMenu()`, se prefiere la propiedad declarativa `submenu` por su mejor mantenibilidad. ### Acceder al estado @@ -239,7 +241,6 @@ getNodeMenuItems(node) { return [/* menu items */] } ``` - ## Solución de problemas ### Cómo identificar el uso de la API antigua @@ -262,20 +263,20 @@ Please use the new context menu API instead. See: https://docs.comfy.org/custom-nodes/js/context-menu-migration ``` -Tu extensión está usando el enfoque antiguo y deberías migrarla. +Tu extensión está usando el enfoque anterior y debes migrarla. -### Verificar que la migración funcionó +### Verificar el éxito de la migración Después de la migración: -1. Elimina todas las modificaciones de prototipos de `setup()` y `beforeRegisterNodeDef()` -2. Añade los hooks `getCanvasMenuItems()` y/o `getNodeMenuItems()` -3. Comprueba que tus elementos de menú siguen apareciendo correctamente +1. Elimina todas las modificaciones de prototipo de `setup()` y `beforeRegisterNodeDef()` +2. Agrega los ganchos `getCanvasMenuItems()` y/o `getNodeMenuItems()` +3. Verifica que tus elementos del menú sigan apareciendo correctamente 4. Verifica que no aparezcan advertencias de obsolescencia en la consola -### Ejemplo de migración completo +### Ejemplo completo de migración -**Antes:** +**ANTES:** ```javascript app.registerExtension({ @@ -300,7 +301,7 @@ app.registerExtension({ }) ``` -**Después:** +**DESPUÉS:** ```javascript app.registerExtension({ @@ -320,9 +321,8 @@ app.registerExtension({ } }) ``` - ## Recursos adicionales -- [Ejemplos comentados](./javascript_examples): más ejemplos con la nueva API -- [Ganchos de extensión](./javascript_hooks): lista completa de los ganchos de extensión disponibles -- [Comandos y atajos de teclado](./javascript_commands_keybindings): agrega atajos de teclado a las acciones de tu menú +- [Ejemplos anotados](./javascript_examples): Más ejemplos con la nueva API +- [Ganchos de extensión](./javascript_hooks): Lista completa de los ganchos de extensión disponibles +- [Comandos y atajos de teclado](./javascript_commands_keybindings): Agrega atajos de teclado a las acciones de tu menú diff --git a/es/custom-nodes/js/javascript_commands_keybindings.mdx b/es/custom-nodes/js/javascript_commands_keybindings.mdx index ab44c36365..67bf3dd028 100644 --- a/es/custom-nodes/js/javascript_commands_keybindings.mdx +++ b/es/custom-nodes/js/javascript_commands_keybindings.mdx @@ -1,15 +1,19 @@ --- title: "Comandos y atajos de teclado" description: "Domina los comandos y atajos de teclado de Comfy para registrar acciones y atajos personalizados en tus extensiones." -translationSourceHash: 1227c61f +translationSourceHash: c8261f93 translationFrom: custom-nodes/js/javascript_commands_keybindings.mdx translationBlockHashes: "_intro": f96d3780 + "Basic Usage": 82556c7c + "Command Configuration": ad9a0317 "Keybinding Configuration": 58a94034 + "Command Examples": 4d410f38 + "Keybinding Examples": 54afc260 "Notes and Limitations": f68952c6 --- -La API de Commands y Keybindings permite que las extensiones registren comandos personalizados y los asocien a atajos de teclado. Así, los usuarios pueden activar acciones rápidamente sin usar el mouse. +La API de Commands and Keybindings permite que las extensiones registren comandos personalizados y los asocien a atajos de teclado. Así, los usuarios pueden activar acciones rápidamente sin usar el ratón. ## Uso básico @@ -35,10 +39,9 @@ app.registerExtension({ ] }); ``` - ## Configuración de comandos -Cada comando requiere un `id`, un `label` y una `function`: +Cada comando requiere un `id`, una `label` y una `function`: ```javascript { @@ -47,8 +50,7 @@ Cada comando requiere un `id`, un `label` y una `function`: function: () => void // Function to execute when command is triggered } ``` - -## Configuración de las combinaciones de teclas +## Configuración de combinaciones de teclas Cada combinación de teclas requiere un `combo` y un `commandId`: @@ -61,15 +63,15 @@ Cada combinación de teclas requiere un `combo` y un `commandId`: alt?: boolean, // Requiere la tecla Alt (opcional) meta?: boolean // Requiere la tecla Meta/Command (opcional) }, - commandId: string // ID del comando que se va a activar + commandId: string // ID del comando que se activará } ``` ### Teclas especiales Para las teclas que no son caracteres, usa uno de estos valores: -- Flechas: `"ArrowUp"`, `"ArrowDown"`, `"ArrowLeft"`, `"ArrowRight"` -- Teclas de función: `"F1"` hasta `"F12"` +- Teclas de flecha: `"ArrowUp"`, `"ArrowDown"`, `"ArrowLeft"`, `"ArrowRight"` +- Teclas de función: `"F1"` a `"F12"` - Otras teclas especiales: `"Escape"`, `"Tab"`, `"Enter"`, `"Backspace"`, `"Delete"`, `"Home"`, `"End"`, `"PageUp"`, `"PageDown"` ## Ejemplos de comandos @@ -112,7 +114,6 @@ app.registerExtension({ ] }); ``` - ## Ejemplos de atajos de teclado ```javascript @@ -145,14 +146,13 @@ app.registerExtension({ ] }); ``` - ## Notas y limitaciones -- Las extensiones no pueden sobrescribir los atajos de teclado definidos en el núcleo de ComfyUI. Revisa los atajos de teclado del núcleo en estos archivos fuente: +- Las extensiones no pueden sobrescribir los atajos de teclado definidos en el núcleo de ComfyUI. Consulta los atajos de teclado del núcleo en estos archivos fuente: - [Comandos del núcleo](https://github.com/Comfy-Org/ComfyUI_frontend/blob/e76e9ec61a068fd2d89797762f08ee551e6d84a0/src/composables/useCoreCommands.ts) - - [Comandos del menú del núcleo](https://github.com/Comfy-Org/ComfyUI_frontend/blob/e76e9ec61a068fd2d89797762f08ee551e6d84a0/src/constants/coreMenuCommands.ts) + - [Comandos del menú del núcleo](https://github.com/Comfy-Org/ComfyUI_frontend/blob/e76e9ec61a068fd2d89797762f08ee551e6d84a0/src/constants/coreMenuCommands.ts) - [Atajos de teclado del núcleo](https://github.com/Comfy-Org/ComfyUI_frontend/blob/e76e9ec61a068fd2d89797762f08ee551e6d84a0/src/constants/coreKeybindings.ts) - [Combinaciones de teclas reservadas](https://github.com/Comfy-Org/ComfyUI_frontend/blob/e76e9ec61a068fd2d89797762f08ee551e6d84a0/src/constants/reservedKeyCombos.ts) -- Algunas combinaciones de teclas están reservadas por el navegador (como Ctrl+F para buscar) y no se pueden sobrescribir +- El navegador reserva algunas combinaciones de teclas (como Ctrl+F para Buscar) y no se pueden sobrescribir - Si varias extensiones registran la misma combinación de teclas, el comportamiento no está definido diff --git a/es/custom-nodes/js/javascript_examples.mdx b/es/custom-nodes/js/javascript_examples.mdx index 0ab141dfb2..f554fccea1 100644 --- a/es/custom-nodes/js/javascript_examples.mdx +++ b/es/custom-nodes/js/javascript_examples.mdx @@ -1,19 +1,24 @@ --- title: "Ejemplos anotados" description: "Explora ejemplos de JavaScript de Comfy para crear Nodos personalizados y Extensiones de UI. Fragmentos de código prácticos para interfaces web robustas." -translationSourceHash: 2e4e63ce +translationSourceHash: b5a477bc translationFrom: custom-nodes/js/javascript_examples.mdx translationBlockHashes: "_intro": 55d773e9 + "Right click menus": 1143c5c2 + "Capture UI events": 7fb75825 + "Detect when a workflow starts": e090fc16 + "Detect an interrupted workflow": ff1078a6 + "Catch clicks on your node": 728044d4 --- Una colección cada vez mayor de fragmentos de código de ejemplo... ## Menús de clic derecho -### Menú del fondo +### Menú de fondo -El menú principal del fondo (clic derecho sobre el lienzo) se genera con una llamada a +El menú principal de fondo (clic derecho en el lienzo) se genera con una llamada a `LGraphCanvas.getCanvasMenuOptions`. La forma estándar de editarlo es implementar el método `getCanvasMenuItems` en tu extensión: ```javascript @@ -33,7 +38,7 @@ app.registerExtension({ }); ``` -### Menú del nodo +### Menú de nodo Cuando haces clic derecho sobre un nodo, el menú se genera de forma similar mediante `node.getExtraMenuOptions`. La forma estándar es implementar el método `getNodeMenuItems` en tu extensión: @@ -97,19 +102,15 @@ app.registerExtension({ } }); ``` +## Capturar eventos de UI -## Capturar eventos de la UI - -Esto funciona tal como esperas: busca el elemento de la UI en el DOM y -añade un eventListener. `setup()` es un buen lugar para hacerlo, ya que la página -se ha cargado por completo. Por ejemplo, para detectar un clic en el botón 'Queue': +Esto funciona tal como esperas: busca el elemento de la UI en el DOM y agrega un eventListener. `setup()` es un buen lugar para hacerlo, ya que la página se ha cargado por completo. Por ejemplo, para detectar un clic en el Botón de Cola: ```Javascript function queue_button_pressed() { console.log("Queue button was pressed!") } document.getElementById("queue-button").addEventListener("click", queue_button_pressed); ``` - -## Detectar cuándo empieza un flujo de trabajo +## Detectar cuándo inicia un flujo de trabajo Este es uno de los muchos eventos de `api`: @@ -121,14 +122,13 @@ import { api } from "../../scripts/api.js"; } api.addEventListener("execution_start", on_execution_start); ``` - ## Detectar un flujo de trabajo interrumpido -**Obsoleto:** El patrón de interceptación de la API que se muestra abajo está obsoleto y puede cambiar en cualquier momento en un futuro próximo. Usa los [ganchos de extensión](/es/custom-nodes/js/javascript_hooks) oficiales y los escuchadores de eventos de la API cuando estén disponibles. +**Obsoleto:** El patrón de interceptación de la API que se muestra a continuación está obsoleto y está sujeto a cambios en cualquier momento en el futuro cercano. Usa los [ganchos de extensión](/es/custom-nodes/js/javascript_hooks) oficiales y los escuchadores de eventos de la API cuando estén disponibles. -Un ejemplo sencillo de interceptación de la api: +Un ejemplo simple de interceptación de la API: ```Javascript import { api } from "../../scripts/api.js"; @@ -140,15 +140,14 @@ import { api } from "../../scripts/api.js"; /* Or after */ } ``` - ## Capturar clics en tu nodo -**Obsoleto:** El patrón de interceptación de métodos de nodo que se muestra abajo está obsoleto y puede cambiar en cualquier momento en un futuro próximo. Usa los [ganchos de extensión](/es/custom-nodes/js/javascript_hooks) oficiales cuando estén disponibles. +**Obsoleto:** El patrón de secuestro de métodos de nodo que se muestra a continuación está obsoleto y puede cambiar en cualquier momento en el futuro cercano. Usa los [ganchos de extensión](/es/custom-nodes/js/javascript_hooks) oficiales cuando estén disponibles. -`node` tiene un método mouseDown que puedes interceptar. -Esta vez tenemos cuidado de propagar cualquier valor de retorno. +`node` tiene un método mouseDown que puedes secuestrar. +Esta vez ten cuidado de propagar cualquier valor de retorno. ```javascript async nodeCreated(node) { diff --git a/es/custom-nodes/js/javascript_objects_and_hijacking.mdx b/es/custom-nodes/js/javascript_objects_and_hijacking.mdx index a81310f548..81efcd78cc 100644 --- a/es/custom-nodes/js/javascript_objects_and_hijacking.mdx +++ b/es/custom-nodes/js/javascript_objects_and_hijacking.mdx @@ -1,11 +1,12 @@ --- title: "Objetos de Comfy" description: "Guía de referencia de los objetos centrales del frontend de ComfyUI: LiteGraph, ComfyApp, LGraph, LLink y ComfyNode, con sus propiedades y funciones." -translationSourceHash: 80e25970 +translationSourceHash: e48a6bdd translationFrom: custom-nodes/js/javascript_objects_and_hijacking.mdx translationBlockHashes: "LiteGraph": 33b00279 "ComfyApp": 09c85456 + "LGraph": cef2473d "LLink": 9d75d321 "ComfyNode": 33354cbb "Inputs and Widgets": 5aec68cf @@ -14,15 +15,14 @@ translationBlockHashes: ## LiteGraph -La interfaz de Comfy UI se construye sobre [LiteGraph](https://github.com/jagenjo/litegraph.js). +La interfaz de Comfy UI está construida sobre [LiteGraph](https://github.com/jagenjo/litegraph.js). Gran parte de la funcionalidad de Comfy la proporciona LiteGraph, así que si desarrollas nodos más complejos, probablemente te resulte útil clonar ese repositorio y explorar la documentación, que se encuentra en `doc/index.html`. ## ComfyApp -El objeto `app` (siempre accesible mediante `import { app } from "../../scripts/app.js";`) representa la aplicación de Comfy que se ejecuta en el navegador -y contiene varias propiedades y funciones útiles, algunas de las cuales se enumeran a continuación. +El objeto `app` (siempre accesible mediante `import { app } from "../../scripts/app.js";`) representa la aplicación de Comfy que se ejecuta en el navegador y contiene varias propiedades y funciones útiles, algunas de las cuales se enumeran a continuación. **Obsoleto:** Secuestrar o parchear funciones de forma manual (monkey-patching) en `app` o en sus prototipos está obsoleto y puede cambiar en cualquier momento en un futuro cercano. En su lugar, usa los [ganchos de extensión](/es/custom-nodes/js/javascript_hooks) y la [API del Menú Contextual](/es/custom-nodes/js/context-menu-migration) oficiales. @@ -48,12 +48,12 @@ Entre las propiedades importantes de `app` se incluyen (esta no es una lista exh De nuevo, hay muchas. Algunas de las más importantes son: -| función | notas | -| ----------------- | -------------------------------------------------------------------------- | +| función | notas | +| ----------------- | --------------------------------------------------------------------------- | | graphToPrompt | Convierte el gráfico en un prompt que se puede enviar al servidor de Python | -| loadGraphData | Carga un gráfico | -| queuePrompt | Envía un prompt a la cola | -| registerExtension | Ya lo has visto: se usa para agregar una extensión | +| loadGraphData | Carga un gráfico | +| queuePrompt | Envía un prompt a la cola | +| registerExtension | Ya lo has visto: se usa para agregar una extensión | ## LGraph @@ -61,7 +61,7 @@ El objeto `LGraph` forma parte del framework LiteGraph y representa el estado l Si quieres manipular el gráfico, la documentación de LiteGraph (en `doc/index.html` si clonas `https://github.com/jagenjo/litegraph.js`) describe las funciones que necesitarás. -Puedes usar `graph` para obtener los detalles de nodos y conexiones, por ejemplo: +Puedes usar `graph` para obtener detalles de nodos y conexiones, por ejemplo: ```Javascript const ComfyNode_object_for_my_node = app.graph._nodes_by_id(my_node_id) @@ -74,29 +74,27 @@ ComfyNode_object_for_my_node.inputs.forEach(input => { } }); ``` - ## LLink -El objeto `LLink`, accesible a través de `graph.links`, representa una conexión individual en el gráfico, desde el nodo `link.origin_id` en la ranura de salida `link.origin_slot` hasta el nodo `link.target_id` en la ranura `link.target_slot`. También tiene una cadena que representa el tipo de datos, en `link.type`, y `link.id`. +El objeto `LLink`, accesible a través de `graph.links`, representa un enlace individual del gráfico, desde el slot de salida `link.origin_slot` del nodo `link.origin_id` hasta el slot `link.target_slot` del nodo `link.target_id`. También incluye una cadena que representa el tipo de dato en `link.type`, además de `link.id`. Los `LLink` se crean en el método `connect` de un `LGraphNode` (del cual `ComfyNode` es una subclase). -Evita crear tus propios objetos LLink; usa las funciones de LiteGraph en su lugar. +Evita crear tus propios objetos LLink: usa las funciones de LiteGraph en su lugar. ## ComfyNode -`ComfyNode` es una subclase de `LGraphNode`, por lo que la documentación de LiteGraph resulta útil para operaciones más genéricas. Sin embargo, Comfy ha ampliado significativamente el comportamiento del núcleo de LiteGraph y tampoco hace uso de toda la funcionalidad de LiteGraph. +`ComfyNode` es una subclase de `LGraphNode`, por lo que la documentación de LiteGraph resulta útil para operaciones más genéricas. Sin embargo, Comfy ha ampliado de forma significativa el comportamiento del núcleo de LiteGraph y tampoco hace uso de toda la funcionalidad de LiteGraph. -La descripción que sigue se aplica a un nodo normal. -Los nodos de grupo, los nodos primitivos, las notas y los nodos de redirección tienen propiedades diferentes. +La descripción que sigue se aplica a un nodo normal. Los nodos de grupo, los nodos primitivos, las notas y los nodos de redirección tienen propiedades diferentes. -Un objeto `ComfyNode` representa un nodo del flujo de trabajo actual. Tiene varias propiedades importantes que quizás quieras aprovechar, y una gran cantidad de funciones que puedes usar o sobrescribir para modificar su comportamiento. +Un objeto `ComfyNode` representa un nodo del flujo de trabajo actual. Tiene una serie de propiedades importantes que quizá quieras aprovechar, además de una gran cantidad de funciones que puedes usar o interceptar para modificar su comportamiento. -**Obsoleto:** Sobrescribir los métodos del prototipo en `ComfyNode` o `LGraphNode` está obsoleto y puede cambiar en cualquier momento en un futuro próximo. Usa los [ganchos de extensión](/es/custom-nodes/js/javascript_hooks) oficiales cuando estén disponibles, como `getNodeMenuItems` para los menús contextuales. Consulta la [guía de migración del menú contextual](/es/custom-nodes/js/context-menu-migration) para ver ejemplos. - +**Obsoleto:** Interceptar los métodos del prototipo en `ComfyNode` o `LGraphNode` está obsoleto y puede cambiar en cualquier momento en un futuro próximo. Usa los [ganchos de extensión](/es/custom-nodes/js/javascript_hooks) oficiales cuando estén disponibles, como `getNodeMenuItems` para los menús contextuales. Consulta la [Guía de migración del menú contextual](/es/custom-nodes/js/context-menu-migration) para ver ejemplos. + -Para hacerte una idea más completa del objeto nodo, quizás te resulte útil insertar el siguiente código en tu extensión y colocar un punto de interrupción en el comando `console.log`. Cuando después crees un nodo nuevo, podrás usar tu depurador favorito para inspeccionar el nodo. +Para hacerte una idea más completa del objeto nodo, puede resultarte útil insertar el siguiente código en tu extensión y colocar un punto de interrupción en el comando `console.log`. Cuando crees un nodo nuevo, podrás usar tu depurador favorito para inspeccionar el nodo. ```Javascript async nodeCreated(node) { @@ -106,43 +104,43 @@ async nodeCreated(node) { ### Propiedades -| Propiedad | Contenido | +| propiedad | contenido | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -| `bgcolor` | El color de fondo del nodo, o undefined para el valor predeterminado | -| `comfyClass` | La clase de Python que representa el nodo | -| `flags` | Un diccionario que puede contener indicadores relacionados con el estado del nodo. En particular, `flags.collapsed` es verdadero para los nodos contraídos. | -| `graph` | Una referencia al objeto LGraph | -| `id` | Un id único | -| `input_type` | Una lista de los tipos de entrada (p. ej., "STRING", "MODEL", "CLIP", etc.). Por lo general, coincide con los INPUT_TYPES de Python | -| `inputs` | Una lista de entradas (que se describen a continuación) | -| `mode` | Normalmente 0; se establece en 2 si el nodo está silenciado y en 4 si está en bypass. Comfy no usa los valores 1 y 3 | -| `order` | La posición del nodo en el orden de ejecución. La establece `LGraph.computeExecutionOrder()` cuando se envía el prompt | -| `pos` | La posición [x,y] del nodo en el lienzo | -| `properties` | Un diccionario que contiene `"Node name for S&R"`, que usa LiteGraph | -| `properties_info` | El tipo y el valor predeterminado de las entradas de `properties` | -| `size` | El ancho y el alto del nodo en el lienzo | -| `title` | Título visible | -| `type` | El nombre único (de Python) de la clase del nodo | -| `widgets` | Una lista de widgets (que se describen a continuación) | -| `widgets_values` | Una lista de los valores actuales de los widgets | +| `bgcolor` | El color de fondo del nodo, o undefined para el valor predeterminado | +| `comfyClass` | La clase de Python que representa el nodo | +| `flags` | Un diccionario que puede contener indicadores relacionados con el estado del nodo. En particular, `flags.collapsed` es verdadero en los nodos contraídos. | +| `graph` | Una referencia al objeto LGraph | +| `id` | Un id único | +| `input_type` | Una lista de los tipos de entrada (por ejemplo, "STRING", "MODEL", "CLIP", etc.). Por lo general, coincide con INPUT_TYPES de Python | +| `inputs` | Una lista de entradas (se describe más abajo) | +| `mode` | Normalmente 0; se establece en 2 si el nodo está en silencio y en 4 si está en bypass. Comfy no usa los valores 1 y 3 | +| `order` | La posición del nodo en el orden de ejecución. La establece `LGraph.computeExecutionOrder()` cuando se envía el prompt | +| `pos` | La posición [x,y] del nodo en el lienzo | +| `properties` | Un diccionario que contiene `"Node name for S&R"`, usado por LiteGraph | +| `properties_info` | El tipo y el valor predeterminado de las entradas de `properties` | +| `size` | El ancho y el alto del nodo en el lienzo | +| `title` | Título mostrado | +| `type` | El nombre único (de Python) de la clase del nodo | +| `widgets` | Una lista de widgets (se describe más abajo) | +| `widgets_values` | Una lista de los valores actuales de los widgets | ### Funciones Hay una cantidad muy grande de funciones (85, la última vez que las conté). A continuación se muestra una selección. -La mayoría de estas funciones no tienen modificaciones respecto al código central de LiteGraph. +La mayoría de estas funciones no presentan modificaciones respecto al código central de LiteGraph. -#### Entradas, salidas, widgets +#### Entradas, salidas y widgets | función | notas | | ---------------------- | -------------------------------------------------------------------------------------------------- | | Entradas / Salidas | La mayoría tiene métodos de salida con nombres equivalentes: s/In/Out/ | | `addInput` | Crea una nueva entrada, definida por nombre y tipo | -| `addInputs` | Versión de array de `addInput` | +| `addInputs` | Versión en arreglo de `addInput` | | `findInputSlot` | Encuentra el índice de la ranura a partir del nombre de la entrada | -| `findInputSlotByType` | Encuentra una entrada que coincida con el tipo. Opciones para preferir, o usar solo, ranuras libres | +| `findInputSlotByType` | Encuentra una entrada que coincida con el tipo. Opciones para preferir ranuras libres o usar solo ranuras libres | | `removeInput` | Por índice de ranura | -| `getInputNode` | Obtén el nodo conectado a esta entrada. El equivalente de salida es `getOutputNodes` y devuelve una lista | -| `getInputLink` | Obtén el LLink conectado a esta entrada. Sin equivalente de salida | +| `getInputNode` | Obtiene el nodo conectado a esta entrada. El equivalente de salida es `getOutputNodes` y devuelve una lista | +| `getInputLink` | Obtiene el LLink conectado a esta entrada. No hay equivalente de salida | | Widgets | | | `addWidget` | Agrega un widget estándar de Comfy | | `addCustomWidget` | Agrega un widget personalizado (definido en el hook `getComfyWidgets`) | @@ -154,71 +152,66 @@ La mayoría de estas funciones no tienen modificaciones respecto al código cent | función | notas | | --------------------- | ------------------------------------------------------------------------------------------------- | | `connect` | Conecta la salida de este nodo a la entrada de otro nodo | -| `connectByType` | Conecta la salida a otro nodo especificando el tipo; se conecta a la primera ranura coincidente disponible | +| `connectByType` | Conecta la salida a otro nodo especificando el tipo: se conecta a la primera ranura disponible que coincida | | `connectByTypeOutput` | Conecta la entrada a la salida de otro nodo por tipo | | `disconnectInput` | Elimina cualquier conexión hacia la entrada (especificada por nombre o índice) | | `disconnectOutput` | Desconecta una salida de la entrada de un nodo especificado | | `onConnectionChange` | Se llama en cada nodo. `side==1` si es una entrada en este nodo | -| `onConnectInput` | Se llama _antes_ de que se realice una conexión. Si devuelve `false`, se rechaza la conexión | +| `onConnectInput` | Se llama _antes_ de que se realice una conexión. Si devuelve `false`, la conexión se rechaza | #### Visualización | función | notas | | ------------------ | ------------------------------------------------------------------------------------------------------ | -| `setDirtyCanvas` | Indica que el primer plano (nodos) y/o el fondo (conexiones e imágenes) deben volver a dibujarse | +| `setDirtyCanvas` | Indica que el primer plano (nodos) y/o el fondo (conexiones e imágenes) deben volver a dibujarse | | `onDrawBackground` | Se llama con un objeto `CanvasRenderingContext2D` para dibujar el fondo. Comfy lo usa para renderizar imágenes | | `onDrawForeground` | Se llama con un objeto `CanvasRenderingContext2D` para dibujar el nodo. | | `getTitle` | El título que se mostrará. | | `collapse` | Alterna el estado contraído del nodo. | -El nombre de `collapse` es poco adecuado; _alterna_ el estado contraído. -Recibe un parámetro booleano que se puede usar para anular +`collapse` tiene un nombre poco adecuado: _alterna_ el estado contraído. +Recibe un parámetro booleano, que se puede usar para anular `node.collapsable === false`. #### Otros | función | notas | | ------------ | ------------------------------------------------------------------ | -| `changeMode` | Se usa para establecer el nodo en modo bypass (`mode == 4`) o no (`mode == 0`) | +| `changeMode` | Se usa para poner el nodo en modo bypass (`mode == 4`) o no (`mode == 0`) | ## Entradas y widgets -Las entradas y los widgets representan las dos formas en que se pueden introducir datos en un nodo. En general, un widget se puede convertir en entrada, pero no todas las entradas se pueden convertir en widget (ya que muchos tipos de datos no se pueden introducir mediante un elemento de la UI). +Las entradas y los widgets representan las dos formas de introducir datos en un nodo. Por lo general, puedes convertir un widget en una entrada, pero no todas las entradas pueden convertirse en un widget (ya que muchos tipos de datos no se pueden introducir mediante un elemento de la interfaz). -`node.inputs` es una lista de las entradas actuales (los puntos de color en el lado izquierdo del nodo), que especifica su `.name`, `.type` y `.link` (una referencia al `LLink` conectado en `app.graph.links`). +`node.inputs` es una lista de las entradas actuales (los puntos de colores del lado izquierdo del nodo), que especifica su `.name`, `.type` y `.link` (una referencia al `LLink` conectado en `app.graph.links`). -Si una entrada es un widget que se ha convertido, también contiene una referencia al widget, ahora inactivo, en `.widget`. +Si una entrada es un widget que se ha convertido, también guarda una referencia al widget, ahora inactivo, en `.widget`. -`node.widgets` es una lista de todos los widgets, se hayan convertido o no en entrada. Un widget tiene: +`node.widgets` es una lista de todos los widgets, tanto si se han convertido en una entrada como si no. Un widget tiene: | propiedad/función | notas | | ----------------- | ------------------------------------------------------------------------- | | `callback` | Una función que se llama cuando cambia el valor del widget | | `last_y` | La posición vertical del widget en el nodo | | `name` | El nombre del widget (único dentro de un nodo) | -| `options` | Según lo especificado en el código de Python (como default, mín y máx) | +| `options` | Tal como se especifican en el código de Python (como default, min y max) | | `type` | El nombre del tipo de widget (ver abajo) en minúsculas | | `value` | El valor actual del widget. Es una propiedad con métodos `get` y `set` | ### Tipos de widget -`app.widgets` es un diccionario de los tipos de widget registrados actualmente, indexado por la versión en MAYÚSCULAS del nombre del tipo. -Los tipos de widget integrados de Comfy incluyen los autoexplicativos `BOOLEAN`, `INT` y `FLOAT`, -además de `STRING` (que viene en dos variantes, de una línea y multilínea), -`COMBO` para la selección desplegable de una lista, e `IMAGEUPLOAD`, usado en los nodos Load Image. +`app.widgets` es un diccionario de los tipos de widget registrados actualmente, indexado por la versión en MAYÚSCULAS del nombre del tipo. Entre los tipos de widget integrados de Comfy se incluyen los obvios `BOOLEAN`, `INT` y `FLOAT`, así como `STRING` (que tiene dos variantes, de una línea y de varias líneas), `COMBO` para seleccionar de una lista desplegable, e `IMAGEUPLOAD`, que se usa en los nodos Load Image. Puedes agregar tipos de widget personalizados proporcionando un método `getCustomWidgets` en tu extensión. -{/* TODO agregar enlace */} +{/* TODO add link */} -### Widgets vinculados +### Widgets enlazados -También puedes vincular widgets, como ocurre con el comportamiento integrado de `seed` y `control_after_generate`, por ejemplo. -Un widget vinculado tiene `.type = 'base_widget_type:base_widget_name'`; así, `control_after_generate` puede tener el tipo `int:seed`. +También puedes enlazar widgets, como ocurre con el comportamiento integrado de `seed` y `control_after_generate`, por ejemplo. Un widget enlazado tiene `.type = 'base_widget_type:base_widget_name'`; así, `control_after_generate` puede tener el tipo `int:seed`. ## Prompt -Cuando pulsas el botón `Queue Prompt` en Comfy, se llama al método `app.graphToPrompt()` para convertir el -gráfico actual en un prompt que se puede enviar al servidor. +Cuando presionas el botón `Queue Prompt` en Comfy, se llama al método `app.graphToPrompt()` para convertir el gráfico actual en un prompt que se pueda enviar al servidor. `app.graphToPrompt` devuelve un objeto (al que aquí llamamos `prompt`) con dos propiedades, `output` y `workflow`. @@ -229,32 +222,32 @@ gráfico actual en un prompt que se puede enviar al servidor. - `prompt.output[node_id].class_type`, el nombre único de la clase del nodo personalizado, tal como se define en el código de Python - `prompt.output[node_id].inputs`, que contiene el valor de cada entrada (o widget) como un mapa del nombre de la entrada a: - el valor seleccionado, si es un widget, o - - un array que contiene (`upstream_node_id`, `upstream_node_output_slot`) si hay una conexión en la entrada, o + - un arreglo que contiene (`upstream_node_id`, `upstream_node_output_slot`) si hay una conexión en la entrada, o - undefined, si es un widget que se ha convertido en entrada y no está conectado - las demás entradas no conectadas no se incluyen en `.inputs` -Ten en cuenta que el `upstream_node_id` del array que describe una entrada conectada se representa como una cadena, no como un entero. +Ten en cuenta que el `upstream_node_id` del arreglo que describe una entrada conectada se representa como una cadena, no como un entero. ### workflow `prompt.workflow` contiene las siguientes propiedades: -- `config`: un diccionario de opciones de configuración adicionales (vacío de forma predeterminada) -- `extra`: un diccionario con información adicional sobre el flujo de trabajo. De forma predeterminada contiene: - - `extra.ds`: describe la vista actual del gráfico (`scale` y `offset`) -- `groups`: todos los grupos del flujo de trabajo -- `last_link_id`: el id de la última conexión agregada -- `last_node_id`: el id del último nodo agregado -- `links`: una lista de todas las conexiones del gráfico. Cada entrada es un array de cinco enteros y una cadena: - - (`link_id`, `upstream_node_id`, `upstream_node_output_slot`, `downstream_node_id`, `downstream_node_input_slot`, `tipo de datos`) -- `nodes`: una lista de todos los nodos del gráfico. Cada entrada es un mapa con un subconjunto de las propiedades del nodo descritas [arriba](#comfynode) +- `config` - un diccionario de opciones de configuración adicionales (vacío de forma predeterminada) +- `extra` - un diccionario con información adicional sobre el flujo de trabajo. De forma predeterminada contiene: + - `extra.ds` - describe la vista actual del gráfico (`scale` y `offset`) +- `groups` - todos los grupos del flujo de trabajo +- `last_link_id` - el id del último enlace agregado +- `last_node_id` - el id del último nodo agregado +- `links` - una lista de todos los enlaces del gráfico. Cada entrada es un arreglo de cinco enteros y una cadena: + - (`link_id`, `upstream_node_id`, `upstream_node_output_slot`, `downstream_node_id`, `downstream_node_input_slot`, `data type`) +- `nodes` - una lista de todos los nodos del gráfico. Cada entrada es un mapa de un subconjunto de las propiedades del nodo como se describe [arriba](#comfynode) - Se incluyen las siguientes propiedades: `flags`, `id`, `inputs`, `mode`, `order`, `pos`, `properties`, `size`, `type`, `widgets_values` - - Además, salvo que un nodo no tenga salidas, hay una propiedad `outputs`, que es una lista de las salidas del nodo, cada una con: - - `name`: el nombre de la salida - - `type`: el tipo de datos de la salida - - `links`: una lista con el `link_id` de todas las conexiones desde esta salida (si no hay conexiones, puede ser una lista vacía o null) - - `shape`: la forma usada para dibujar la salida (3 por defecto para un punto) - - `slot_index`: el número de ranura de la salida -- `version`: el número de versión de LiteGraph (al momento de escribir, `0.4`) - -La propiedad `nodes.output` no existe en los nodos sin salidas; no es una lista vacía. + - Además, a menos que un nodo no tenga salidas, existe una propiedad `outputs`, que es una lista de las salidas del nodo, y cada una contiene: + - `name` - el nombre de la salida + - `type` - el tipo de dato de la salida + - `links` - una lista de los `link_id` de todos los enlaces desde esta salida (si no hay conexiones, puede ser una lista vacía o null), + - `shape` - la forma usada para dibujar la salida (3 de forma predeterminada para un punto) + - `slot_index` - el número de ranura de la salida +- `version` - el número de versión de LiteGraph (al momento de escribir esto, `0.4`) + +`nodes.output` no existe en los nodos sin salidas, no es una lista vacía. diff --git a/es/custom-nodes/js/javascript_selection_toolbox.mdx b/es/custom-nodes/js/javascript_selection_toolbox.mdx index 471a598243..10583dc161 100644 --- a/es/custom-nodes/js/javascript_selection_toolbox.mdx +++ b/es/custom-nodes/js/javascript_selection_toolbox.mdx @@ -1,24 +1,28 @@ --- title: "Selection Toolbox" description: "Añade comandos de acción personalizados a Selection Toolbox de ComfyUI para nodos, grupos y elementos del lienzo seleccionados con getSelectionToolboxCommands." -translationSourceHash: 438c3413 +translationSourceHash: f66d3f91 translationFrom: custom-nodes/js/javascript_selection_toolbox.mdx translationBlockHashes: "_intro": 356ec52a + "Basic Usage": a850ba5d "Command Definition": b0aab3a4 "Icon Options": c511932a + "Dynamic Command Visibility": 49b6198d + "Working with Selected Items": 90ff1ddb + "Complete Example": dc8a50e4 "Notes": 6f71c3bf --- -La API Selection Toolbox permite a las extensiones agregar botones de acción personalizados que aparecen al seleccionar nodos en el lienzo. Esto brinda acceso rápido a comandos contextuales para los elementos seleccionados (nodos, grupos, etc.). +La API de Selection Toolbox permite a las extensiones agregar botones de acción personalizados que aparecen al seleccionar nodos en el lienzo. Esto brinda acceso rápido a comandos contextuales para los elementos seleccionados (nodos, grupos, etc.). ## Uso básico -Para añadir comandos al cuadro de herramientas de selección, tu extensión debe: -1. Definir los comandos con la [interfaz de comandos](/es/custom-nodes/js/javascript_commands_keybindings) estándar +Para agregar comandos al cuadro de herramientas de selección, tu extensión necesita: +1. Definir los comandos con la [interfaz de comandos](https://docs.comfy.org/custom-nodes/js/javascript_commands_keybindings) estándar 2. Implementar el método `getSelectionToolboxCommands` para especificar qué comandos aparecen en el cuadro de herramientas -Nota: el método `getSelectionToolboxCommands` se llama para cada elemento del conjunto de selección cada vez que se realiza una nueva selección. +Nota: el método `getSelectionToolboxCommands` se llama para cada elemento del conjunto de selección cada vez que haces una nueva selección. ```javascript app.registerExtension({ @@ -40,17 +44,16 @@ app.registerExtension({ } }); ``` - -## Definición de comando +## Definición de comandos Los comandos del cuadro de herramientas de selección usan la interfaz de comandos estándar de ComfyUI: ```javascript { - id: string, // Unique identifier for the command - label: string, // Display text for the button tooltip - icon?: string, // Icon class for the button (optional) - function: (selectedItem) => void // Function executed when clicked + id: string, // Identificador único para el comando + label: string, // Texto a mostrar en la información sobre herramientas del botón + icon?: string, // Clase de icono para el botón (opcional) + function: (selectedItem) => void // Función que se ejecuta al hacer clic } ``` @@ -65,7 +68,7 @@ Los botones del cuadro de herramientas de selección admiten las mismas bibliote ## Visibilidad dinámica de comandos -El método `getSelectionToolboxCommands` se llama cada vez que cambia la selección, lo que te permite mostrar comandos distintos según lo que esté seleccionado: +Cada vez que cambia la selección se llama al método `getSelectionToolboxCommands`, lo que te permite mostrar comandos diferentes según lo que esté seleccionado: ```javascript app.registerExtension({ @@ -104,10 +107,9 @@ app.registerExtension({ } }); ``` +## Trabajar con elementos seleccionados -## Trabajar con los elementos seleccionados - -Accede a la información de los elementos seleccionados a través del objeto canvas de la app. La propiedad `selectedItems` es un Set que incluye nodos, grupos y otros elementos del lienzo: +Accede a la información sobre los elementos seleccionados a través del objeto canvas de la aplicación. La propiedad `selectedItems` es un Set que incluye nodos, grupos y otros elementos del lienzo: ```javascript app.registerExtension({ @@ -136,10 +138,9 @@ app.registerExtension({ getSelectionToolboxCommands: () => ["my-ext.show-info"] }); ``` - ## Ejemplo completo -Aquí tienes un ejemplo sencillo que muestra varias características del cuadro de herramientas de selección: +Aquí tienes un ejemplo sencillo que muestra varias funciones del cuadro de herramientas de selección: ```javascript app.registerExtension({ @@ -214,12 +215,11 @@ app.registerExtension({ } }); ``` - ## Notas -- La cuadro de herramientas de selección debe estar habilitada en las configuraciones: `Comfy.Canvas.SelectionToolbox` +- El cuadro de herramientas de selección debe estar habilitado en las configuraciones: `Comfy.Canvas.SelectionToolbox` - Los comandos deben definirse en el arreglo `commands` antes de referenciarlos en `getSelectionToolboxCommands` -- La cuadro de herramientas se actualiza automáticamente cuando cambia la selección +- El cuadro de herramientas se actualiza automáticamente cuando cambia la selección - El método `getSelectionToolboxCommands` se llama para cada elemento del conjunto de selección cada vez que se realiza una nueva selección - Usa `app.canvas.selectedItems` (un Set) para acceder a todos los elementos seleccionados, incluidos nodos, grupos y otros elementos del lienzo - Por compatibilidad con versiones anteriores, `app.canvas.selected_nodes` todavía existe, pero solo contiene nodos diff --git a/es/custom-nodes/js/javascript_settings.mdx b/es/custom-nodes/js/javascript_settings.mdx index dd97fb80eb..9bad36ae80 100644 --- a/es/custom-nodes/js/javascript_settings.mdx +++ b/es/custom-nodes/js/javascript_settings.mdx @@ -1,17 +1,20 @@ --- title: "API de configuraciones" description: "Agrega, lee, escribe y reacciona a las configuraciones de extensiones de ComfyUI con app.registerExtension: tipos booleano, texto, número, slider, combo, color e imagen." -translationSourceHash: 3e40f1fa +translationSourceHash: 30dee1fd translationFrom: custom-nodes/js/javascript_settings.mdx translationBlockHashes: "_intro": ac25633e + "Basic operation": 2cef8fa5 + "Types": 00f1c38c + "Other": 0bbfcc3c --- Puedes proporcionar a ComfyUI un objeto de configuraciones que aparecerá cuando el usuario abra el panel de configuraciones de ComfyUI. ## Funcionamiento básico -### Añadir una configuración +### Agregar una configuración ```javascript import { app } from "../../scripts/app.js"; @@ -31,14 +34,14 @@ app.registerExtension({ El `id` debe ser único en todas las extensiones y se usará para obtener los valores. -Si no [proporcionas una categoría](#categorías), el `id` se dividirá por -`.` para determinar dónde aparece en el panel de configuraciones. +Si no [proporcionas una categoría](#categorías), el `id` se dividirá por `.` para +determinar dónde aparece en el panel de configuraciones. -- Si tu `id` no contiene ningún `.`, aparecerá en la categoría "Other" - y tu `id` se usará como encabezado de sección. -- Si tu `id` contiene al menos un `.`, la parte más a la izquierda se usará - como categoría de la configuración y la segunda parte se usará como - encabezado de sección. Las demás partes se ignoran. +- Si tu `id` no contiene ningún `.`, aparecerá en la categoría "Other" y tu `id` + se usará como encabezado de sección. +- Si tu `id` contiene al menos un `.`, la parte más a la izquierda se usará como + categoría de la configuración y la segunda parte se usará como encabezado de + sección. Las demás partes se ignoran. ### Leer una configuración @@ -55,8 +58,8 @@ if (app.extensionManager.setting.get('example.boolean')) { ### Reaccionar a los cambios -El controlador de eventos `onChange()` se llamará en cuanto el usuario cambie -la configuración en el panel de configuraciones. +El controlador de eventos `onChange()` se llamará en cuanto el usuario cambie la +configuración en el panel de configuraciones. También se llamará cuando se registre la extensión, en cada carga de página. @@ -87,10 +90,10 @@ try { ### Configuración adicional Los tipos de configuración se basan en componentes de [PrimeVue](https://primevue.org/). -Las props descritas en la documentación de PrimeVue se pueden definir para las -configuraciones de ComfyUI añadiéndolas en un campo `attrs`. +Puedes definir las props descritas en la documentación de PrimeVue para las +configuraciones de ComfyUI agregándolas en un campo `attrs`. -Por ejemplo, esto añade botones de incremento y decremento a una entrada numérica: +Por ejemplo, esto agrega botones de incremento y decremento a una entrada de número: ```javascript { @@ -106,15 +109,13 @@ Por ejemplo, esto añade botones de incremento y decremento a una entrada numér }, } ``` - ## Tipos -### Booleano (Boolean) +### Booleano -Muestra un interruptor de activado y desactivado. +Muestra un interruptor de activado/desactivado. -Basado en el [componente ToggleSwitch de -PrimeVue](https://primevue.org/toggleswitch/). +Basado en el [componente ToggleSwitch de PrimeVue](https://primevue.org/toggleswitch/). ```javascript { @@ -128,9 +129,9 @@ PrimeVue](https://primevue.org/toggleswitch/). } ``` -### Texto (Text) +### Texto -Es texto libre. +Es texto de forma libre. Basado en el [componente InputText de PrimeVue](https://primevue.org/inputtext/). @@ -146,14 +147,13 @@ Basado en el [componente InputText de PrimeVue](https://primevue.org/inputtext/) } ``` -### Número (Number) +### Número Sirve para introducir números. Para permitir decimales, establece el atributo `maxFractionDigits` en un número mayor que cero. -Basado en el [componente InputNumber de -PrimeVue](https://primevue.org/inputnumber/). +Basado en el [componente InputNumber de PrimeVue](https://primevue.org/inputnumber/). ```javascript { @@ -171,12 +171,11 @@ PrimeVue](https://primevue.org/inputnumber/). } ``` -### Slider +### Control deslizante -Permite al usuario introducir un número directamente o mediante un slider. +Permite al usuario introducir un número directamente o mediante un control deslizante. -Basado en el [componente Slider de PrimeVue](https://primevue.org/slider/). No se -admiten rangos. +Basado en el [componente Slider de PrimeVue](https://primevue.org/slider/). No se admiten rangos. ```javascript { @@ -199,15 +198,11 @@ admiten rangos. Permite al usuario elegir de una lista desplegable de valores. -Puedes proporcionar las opciones como una cadena simple o como un objeto con los -campos `text` y `value`. Si solo proporcionas una cadena simple, se usará -para ambos. +Puedes proporcionar las opciones como una cadena simple o como un objeto con los campos `text` y `value`. Si solo proporcionas una cadena simple, se usará tanto como texto como valor. -Puedes permitir que el usuario introduzca texto libre con el atributo -`editable: true`, o que busque con el atributo `filter: true`. +Puedes permitir que el usuario introduzca texto libre aportando el atributo `editable: true`, o que busque aportando el atributo `filter: true`. -Basado en el [componente Select de PrimeVue](https://primevue.org/select/). No se -admiten grupos. +Basado en el [componente Select de PrimeVue](https://primevue.org/select/). No se admiten grupos. ```javascript { @@ -231,14 +226,11 @@ admiten grupos. ### Color -Permite al usuario seleccionar un color en un selector de color o escribir una -referencia hexadecimal. +Permite al usuario seleccionar un color desde un selector de color o escribir una referencia hexadecimal. -Ten en cuenta que el formato requiere seis dígitos hexadecimales completos; la -forma abreviada de tres dígitos no funciona. +Ten en cuenta que el formato requiere seis dígitos hexadecimales completos: la forma abreviada de tres dígitos no funciona. -Basado en el [componente ColorPicker de -PrimeVue](https://primevue.org/colorpicker/). +Basado en el [componente ColorPicker de PrimeVue](https://primevue.org/colorpicker/). ```javascript { @@ -252,15 +244,13 @@ PrimeVue](https://primevue.org/colorpicker/). } ``` -### Imagen (Image) +### Imagen Permite al usuario subir una imagen. -La configuración se guardará como una [URL de -datos](https://developer.mozilla.org/en-US/docs/Web/URI/Schemes/data). +La configuración se guarda como [data URL](https://developer.mozilla.org/en-US/docs/Web/URI/Schemes/data). -Basado en el [componente FileUpload de -PrimeVue](https://primevue.org/fileupload/). +Basado en el [componente FileUpload de PrimeVue](https://primevue.org/fileupload/). ```javascript { @@ -273,10 +263,9 @@ PrimeVue](https://primevue.org/fileupload/). } ``` -### Oculto (Hidden) +### Oculto -Las configuraciones ocultas no se muestran en el panel de configuraciones, pero -puedes leerlas y escribirlas desde tu código. +Las configuraciones ocultas no se muestran en el panel de configuraciones, pero puedes leerlas y escribir en ellas desde tu código. ```javascript { @@ -285,14 +274,13 @@ puedes leerlas y escribirlas desde tu código. type: "hidden", } ``` - ## Otros ### Categorías -Puedes especificar la categorización de tu configuración de forma independiente -del `id`. Esto significa que puedes cambiar la categorización y los nombres sin -cambiar el `id` y sin perder los valores que los usuarios ya hayan establecido. +Puedes especificar la categorización de tu ajuste de forma independiente al `id`. +Esto significa que puedes cambiar la categorización y el nombre sin cambiar el +`id` y perder los valores que los usuarios ya hayan establecido. ```javascript { @@ -306,9 +294,9 @@ cambiar el `id` y sin perder los valores que los usuarios ya hayan establecido. ### Tooltips -Puedes añadir ayuda contextual adicional con el campo `tooltip`. Esto añade un -pequeño icono ℹ︎ después del nombre del campo que mostrará el texto de ayuda -cuando el usuario pase el cursor por encima. +Puedes añadir ayuda contextual adicional con el campo `tooltip`. Esto añade un pequeño icono ℹ︎ +después del nombre del campo que mostrará el texto de ayuda cuando el usuario pase el cursor +sobre él. ```javascript { diff --git a/es/custom-nodes/js/javascript_sidebar_tabs.mdx b/es/custom-nodes/js/javascript_sidebar_tabs.mdx index db29ddc3b8..0985a4da11 100644 --- a/es/custom-nodes/js/javascript_sidebar_tabs.mdx +++ b/es/custom-nodes/js/javascript_sidebar_tabs.mdx @@ -1,13 +1,16 @@ --- title: "Pestañas de la barra lateral" description: "Domina la API de Comfy Extension y crea pestañas personalizadas en la barra lateral. Explora ejemplos de React y actualizaciones dinámicas. Lee la documentación." -translationSourceHash: 8e36635a +translationSourceHash: bf389e93 translationFrom: custom-nodes/js/javascript_sidebar_tabs.mdx translationBlockHashes: "_intro": 3df6f709 + "Basic Usage": 8dc773cb "Tab Configuration": f4594df2 "Icon Options": 32c3f0a8 + "Stateful Tab Example": 063a70c3 "Using React Components": 68aa4ede + "Dynamic Content Updates": d90422de --- La API de Sidebar Tabs permite que las extensiones agreguen pestañas personalizadas a la barra lateral de la interfaz de ComfyUI. Esto es útil para agregar funciones que requieren visibilidad persistente y acceso rápido. @@ -26,14 +29,13 @@ app.extensionManager.registerSidebarTab({ } }); ``` - ## Configuración de pestañas Cada pestaña requiere varias propiedades: ```javascript { - id: string, // Identificador único para la pestaña + id: string, // Identificador único de la pestaña icon: string, // Clase de icono para el botón de la pestaña title: string, // Texto del título de la pestaña tooltip?: string, // Texto de tooltip al pasar el cursor (opcional) @@ -46,17 +48,17 @@ La función `render` recibe un elemento DOM donde debes insertar el contenido de ## Opciones de iconos -Los iconos de las pestañas de la barra lateral pueden usar distintos conjuntos de iconos: +Los iconos de las pestañas de la barra lateral pueden usar varios conjuntos de iconos: -- Iconos PrimeVue: `pi pi-[icon-name]` (por ejemplo, `pi pi-home`) -- Iconos Material Design: `mdi mdi-[icon-name]` (por ejemplo, `mdi mdi-robot`) -- Iconos Font Awesome: `fa-[style] fa-[icon-name]` (por ejemplo, `fa-solid fa-star`) +- Iconos de PrimeVue: `pi pi-[icon-name]` (por ejemplo, `pi pi-home`) +- Iconos de Material Design: `mdi mdi-[icon-name]` (por ejemplo, `mdi mdi-robot`) +- Iconos de Font Awesome: `fa-[style] fa-[icon-name]` (por ejemplo, `fa-solid fa-star`) Asegúrate de que la biblioteca de iconos correspondiente esté cargada antes de usar estos iconos. ## Ejemplo de pestaña con estado -Puedes crear pestañas que mantengan su estado: +Puedes crear pestañas que conservan su estado: ```javascript app.extensionManager.registerSidebarTab({ @@ -91,7 +93,6 @@ app.extensionManager.registerSidebarTab({ } }); ``` - ## Usar componentes de React Puedes montar componentes de React en las pestañas de la barra lateral: @@ -112,7 +113,7 @@ app.extensionManager.registerSidebarTab({ container.id = "react-sidebar-container"; el.appendChild(container); - // Define un componente de React simple + // Define un componente de React sencillo function SidebarContent() { const [count, setCount] = React.useState(0); @@ -139,7 +140,7 @@ app.extensionManager.registerSidebarTab({ Para ver un ejemplo real de una aplicación de React integrada como pestaña de la barra lateral, consulta el [proyecto ComfyUI-Copilot en GitHub](https://github.com/AIDC-AI/ComfyUI-Copilot). -## Actualizaciones dinámicas de contenido +## Actualizaciones dinámicas del contenido Puedes actualizar el contenido de la barra lateral en respuesta a cambios en el gráfico: diff --git a/es/custom-nodes/js/javascript_topbar_menu.mdx b/es/custom-nodes/js/javascript_topbar_menu.mdx index d09985964f..8113b1e5e7 100644 --- a/es/custom-nodes/js/javascript_topbar_menu.mdx +++ b/es/custom-nodes/js/javascript_topbar_menu.mdx @@ -2,16 +2,17 @@ title: "API del menú de la barra superior de ComfyUI" sidebarTitle: "API del menú de la barra superior" description: "Agrega comandos personalizados al menú de la barra superior de ComfyUI: añádelos a menús existentes, crea submenús o coloca un comando en varias ubicaciones." -translationSourceHash: 993cda8b +translationSourceHash: 210e5e77 translationFrom: custom-nodes/js/javascript_topbar_menu.mdx translationBlockHashes: "_intro": 686d68ec "Basic Usage": f50d108f + "Command Configuration": ad9a0317 "Menu Configuration": 58481d65 "Menu Examples": f310db1f --- -La API Topbar Menu permite a las extensiones agregar elementos de menú personalizados a la barra de menú superior de ComfyUI. Resulta útil para dar acceso a funciones avanzadas o a comandos que se usan con menos frecuencia. +La API Topbar Menu permite que las extensiones agreguen elementos de menú personalizados a la barra de menú superior de ComfyUI. Resulta útil para dar acceso a funciones avanzadas o a comandos que se usan con menos frecuencia. ## Uso básico @@ -49,7 +50,6 @@ Cada comando requiere un `id`, un `label` y una `function`: function: () => void // Function to execute when command is triggered } ``` - ## Configuración del menú El arreglo `menuCommands` define dónde colocar los comandos dentro de la estructura del menú: @@ -96,7 +96,7 @@ app.registerExtension({ }); ``` -### Crear una estructura de submenú +### Crear una estructura de submenús ```javascript app.registerExtension({ @@ -134,7 +134,7 @@ app.registerExtension({ ### Varias ubicaciones de menú -Puedes agregar el mismo comando en varias ubicaciones de menú: +Puedes agregar el mismo comando en varias ubicaciones del menú: ```javascript app.registerExtension({ @@ -161,4 +161,4 @@ app.registerExtension({ }); ``` -Los comandos pueden funcionar con otras API de ComfyUI, como las configuraciones. Para obtener más información sobre la API de configuraciones, consulta la documentación de la [API de configuraciones](./javascript_settings). +Los comandos pueden trabajar con otras API de ComfyUI, como las configuraciones. Para obtener más información sobre la API de configuraciones, consulta la documentación de la [API de Configuraciones](./javascript_settings). diff --git a/es/custom-nodes/js/subgraphs.mdx b/es/custom-nodes/js/subgraphs.mdx index cc1e4cf50e..20a0931725 100644 --- a/es/custom-nodes/js/subgraphs.mdx +++ b/es/custom-nodes/js/subgraphs.mdx @@ -2,10 +2,15 @@ title: "Subgrafos de ComfyUI" sidebarTitle: "Subgrafos" description: "Trabaja con subgrafos en extensiones de ComfyUI: IDs de nodo, recorrido del gráfico, eventos, promoción de widgets y limpieza." -translationSourceHash: df3169a9 +translationSourceHash: ae2fd7bc translationFrom: custom-nodes/js/subgraphs.mdx translationBlockHashes: "Overview": 227bb063 + "Node Identifiers": 7899f492 + "Traversing Nodes": c992584f + "Root vs Active Graph": bab1d3eb + "Events": 98abc485 + "Widget Promotion": 3e5658d9 "Cleanup": fa9bac21 "See Also": 8736e3b6 --- @@ -14,17 +19,17 @@ translationBlockHashes: Los subgrafos permiten agrupar nodos en componentes reutilizables y anidables. Cada subgrafo es su propio `LGraph` con un UUID. Para la guía de usuario, consulta [Subgrafos](/es/interface/features/subgraph). -## Identificadores de nodo +## Identificadores de nodos -ComfyUI usa tres tipos distintos de identificador de nodo. Usar el equivocado provoca fallos silenciosos. +ComfyUI usa tres tipos distintos de identificadores de nodos. Usar el incorrecto causa fallos silenciosos. | Tipo | Formato | Se usa para | |------|--------|----------| -| `node.id` | `42` (número) | Local a su nivel inmediato del grafo. `graph.getNodeById(id)` | +| `node.id` | `42` (número) | Local al nivel inmediato de su gráfico. `graph.getNodeById(id)` | | ID de ejecución | `"1:2:3"` (cadena separada por dos puntos) | Mensajes de progreso del backend, `UNIQUE_ID` | | ID de localizador | `":"` o `""` | Estado de la UI: insignias, errores, imágenes | -Para construir el ID de localizador de un nodo desde dentro de una extensión: +Para construir el ID de localizador de un nodo desde una extensión: ```javascript function getLocatorId(node) { @@ -32,8 +37,7 @@ function getLocatorId(node) { return graphId ? `${graphId}:${node.id}` : String(node.id) } ``` - -## Recorrer los nodos +## Recorrer nodos ### Solo la capa actual @@ -45,7 +49,7 @@ for (const node of app.graph.nodes) { ### Todos los nodos de forma recursiva -Para entrar en subgrafos anidados, usa un helper recursivo que llame a un callback en cada nodo: +Para entrar en los subgrafos anidados, usa un auxiliar recursivo que llame a un callback en cada nodo: ```javascript function walkGraph(graph, callback) { @@ -77,13 +81,12 @@ app.registerExtension({ } }) ``` +## Gráfico raíz frente a gráfico activo -## Grafo raíz vs grafo activo - -| Quieres... | Usa | +| Lo que quieres hacer | Usa | |-----------------|-----| -| Operar sobre todos los nodos del flujo de trabajo | `app.graph` (raíz) | -| Operar solo sobre la capa visible | `app.canvas?.graph` | +| Operar en todos los nodos del flujo de trabajo | `app.graph` (raíz) | +| Operar solo en la capa visible | `app.canvas?.graph` | | Acceder a un subgrafo específico | `someNode.subgraph` | ```javascript @@ -93,32 +96,31 @@ walkGraph(app.graph, (node) => { /* ... */ }) // Only nodes the user currently sees for (const node of app.canvas?.graph?.nodes ?? []) { /* ... */ } ``` - ## Eventos -### Eventos de nivel de subgrafo +### Eventos a nivel de subgrafo -Se emiten en `subgraph.events`: +Se despachan en `subgraph.events`: | Evento | Carga útil | Cuándo | |-------|---------|------| | `widget-promoted` | `{ widget, subgraphNode }` | Widget promovido al nodo padre | | `widget-demoted` | `{ widget, subgraphNode }` | Widget eliminado del nodo padre | -| `input-added` | `{ input }` | Ranura de entrada añadida | +| `input-added` | `{ input }` | Ranura de entrada agregada | | `removing-input` | `{ input, index }` | Ranura de entrada en proceso de eliminación | -| `output-added` | `{ output }` | Ranura de salida añadida | +| `output-added` | `{ output }` | Ranura de salida agregada | | `removing-output` | `{ output, index }` | Ranura de salida en proceso de eliminación | | `renaming-input` | `{ input, index, oldName, newName }` | Ranura de entrada renombrada | | `renaming-output` | `{ output, index, oldName, newName }` | Ranura de salida renombrada | -### Eventos de nivel de lienzo +### Eventos a nivel de lienzo -Se emiten en `app.canvas.canvas` (el elemento canvas de HTML): +Se despachan en `app.canvas.canvas` (el elemento HTML canvas): | Evento | Carga útil | Cuándo | |-------|---------|------| -| `subgraph-opened` | `{ subgrafo, closingGraph, fromNode }` | El usuario navega dentro de un subgrafo | -| `subgraph-converted` | `{ subgraphNode }` | Una selección se convierte en un subgrafo | +| `subgraph-opened` | `{ subgraph, closingGraph, fromNode }` | El usuario navega hacia un subgrafo | +| `subgraph-converted` | `{ subgraphNode }` | La selección se convierte en un subgrafo | ### Patrón de escucha @@ -135,13 +137,12 @@ app.registerExtension({ } }) ``` - ## Promoción de widgets -Cuando un `SubgraphInput` se conecta a un widget dentro de un subgrafo, aparece una copia de ese widget en el nodo de subgrafo padre. Esto dispara `widget-promoted`. Eliminar la conexión dispara `widget-demoted`. +Cuando un `SubgraphInput` se conecta a un widget dentro de un subgrafo, aparece una copia de ese widget en el nodo del subgrafo padre. Esto dispara `widget-promoted`. Al eliminar la conexión se dispara `widget-demoted`. -El comportamiento de la promoción de widgets todavía está en evolución y puede cambiar en versiones futuras. +El comportamiento de la promoción de widgets todavía está en evolución y puede cambiar en futuras versiones. ```javascript @@ -181,10 +182,9 @@ app.registerExtension({ } }) ``` - ## Limpieza -Usa un `AbortController` para limpiar todos los listeners de eventos cuando se elimina un nodo. +Usa un `AbortController` para limpiar todos los detectores de eventos cuando se elimina un nodo. ```javascript import { app } from "../../scripts/app.js" @@ -215,10 +215,10 @@ app.registerExtension({ ``` -`onRemoved` también puede dispararse durante la conversión de un subgrafo, no solo al eliminar. Protege la lógica de desmontaje si necesitas conservar el estado durante la reestructuración. +`onRemoved` también puede dispararse durante la conversión de un subgraph, no solo al eliminar. Protege la lógica de limpieza si necesitas conservar el estado durante la reestructuración. -## Véase también +## Ver también - [Subgrafos (guía del usuario)](/es/interface/features/subgraph) - [Ganchos de extensión](/es/custom-nodes/js/javascript_hooks) diff --git a/es/custom-nodes/walkthrough.mdx b/es/custom-nodes/walkthrough.mdx index 0615140cb7..696787c5b6 100644 --- a/es/custom-nodes/walkthrough.mdx +++ b/es/custom-nodes/walkthrough.mdx @@ -2,19 +2,20 @@ title: "Crear nodos personalizados en ComfyUI" sidebarTitle: "Crea tu primer nodo" description: "Guía paso a paso para crear un nodo personalizado en ComfyUI: define CATEGORY, INPUT_TYPES y FUNCTION, registra el nodo y crea una extensión JS del cliente." -translationSourceHash: ff922dfe +translationSourceHash: 37645276 translationFrom: custom-nodes/walkthrough.mdx translationBlockHashes: "_intro": 511dfaae "Write a basic node": 5acd782d + "Add some options": f12afecf "Tweak the UI": 566e9dcc --- Esta página te guiará paso a paso por el proceso de crear un nodo personalizado. -Nuestro ejemplo tomará un lote de imágenes y devolverá una de las imágenes. Inicialmente, el nodo +Nuestro ejemplo tomará un lote de imágenes y devolverá una de ellas. Inicialmente, el nodo devolverá la imagen que, en promedio, sea la más clara de color; luego lo extenderemos -para que tenga una variedad de criterios de selección y, finalmente, agregaremos algo de código del lado del cliente. +para que tenga una serie de criterios de selección y, finalmente, agregaremos algo de código del lado del cliente. Esta página asume muy poco conocimiento de Python o Javascript. @@ -85,7 +86,7 @@ de la función que se llamará cuando se ejecute el nodo. Observa que el tipo de dato de entrada y salida es `IMAGE` (singular) aunque esperamos recibir un lote de imágenes y devolver solo una. En Comfy, `IMAGE` significa -lote de imágenes, y una sola imagen se trata como un lote de tamaño 1. +lote de imágenes, y una imagen individual se considera un lote de tamaño 1. ### La función principal @@ -101,7 +102,7 @@ Luego agrega la función a tu clase. El tipo de dato de la imagen es `torch.Tens donde `B` es el tamaño del lote y `C` es el número de canales: 3, para RGB. Si iteramos sobre ese tensor, obtendremos una serie de `B` tensores con forma `[H,W,C]`. El método `.flatten()` lo convierte en un tensor unidimensional de longitud `H*W*C`, `torch.mean()` toma la media y `.item()` -convierte un tensor de un solo valor en un float de Python. +convierte un tensor de un solo valor en un `float` de Python. ```Python def choose_image(self, images): @@ -113,9 +114,9 @@ def choose_image(self, images): Notas sobre esas dos últimas líneas: -- `images[brightest]` devolverá un tensor con forma `[H,W,C]`. `unsqueeze` se usa para insertar una dimensión (de longitud 1), en este caso, en la dimensión cero, y obtener +- `images[brightest]` devolverá un tensor con forma `[H,W,C]`. `unsqueeze` inserta una dimensión (de longitud 1), en este caso, en la dimensión cero, para darnos `[B,H,W,C]` con `B=1`: una sola imagen. -- en `return (result,)`, la coma final es esencial para asegurar que devuelves una tupla. +- en `return (result,)`, la coma final es esencial para garantizar que devuelves una tupla. ### Registrar el nodo @@ -137,10 +138,9 @@ NODE_DISPLAY_NAME_MAPPINGS = { Para una explicación detallada de cómo ComfyUI descubre y carga los nodos personalizados, consulta la [documentación del ciclo de vida de los nodos](/es/custom-nodes/backend/lifecycle). -## Añadir algunas opciones +## Agregar algunas opciones -Ese nodo quizá sea un poco aburrido, así que podríamos añadir algunas opciones: un widget que te permita -elegir la imagen más brillante, o la más roja, la más azul o la más verde. Edita tu `INPUT_TYPES` para que quede así: +Ese nodo quizá sea un poco aburrido, así que podríamos agregar algunas opciones: un widget que te permita elegir la imagen más brillante, o la más roja, la más azul o la más verde. Edita tu `INPUT_TYPES` para que se vea así: ```Python @classmethod @@ -149,8 +149,7 @@ def INPUT_TYPES(s): "mode": (["brightest", "reddest", "greenest", "bluest"],)} } ``` -Después, actualiza la función principal. Usaremos una definición bastante ingenua de 'reddest' (lo más rojo) como el valor -medio de `R` de los píxeles dividido por la media de los tres colores. Así: +Luego actualiza la función principal. Usaremos una definición bastante ingenua de "la más roja" como el valor promedio de `R` de los píxeles dividido entre el promedio de los tres colores. Así: ```Python def choose_image(self, images, mode): @@ -166,20 +165,19 @@ def choose_image(self, images, mode): result = images[best].unsqueeze(0) return (result,) ``` - ## Ajustar la interfaz -Quizá queramos algo de retroalimentación visual, así que enviemos un pequeño mensaje de texto para que se muestre. +Tal vez queramos un poco de retroalimentación visual, así que enviemos un pequeño mensaje de texto para mostrarlo. ### Enviar un mensaje desde el servidor -Esto requiere agregar dos líneas al código Python: +Esto requiere agregar dos líneas al código de Python: ```Python from server import PromptServer ``` -y, al final del método `choose_image`, agrega una línea para enviar un mensaje al front end (`send_sync` recibe un tipo de mensaje, que debe ser único, y un diccionario) +y, al final del método `choose_image`, agrega una línea para enviar un mensaje al frontend (`send_sync` recibe un tipo de mensaje, que debe ser único, y un diccionario) ```Python PromptServer.instance.send_sync("example.imageselector.textmessage", {"message":f"Picked image {best+1}"}) @@ -188,14 +186,14 @@ return (result,) ### Escribir una extensión de cliente -Para agregar algo de JavaScript al cliente, crea un subdirectorio, `web/js`, en el directorio de tu nodo personalizado y modifica el final de `__init__.py` para informarle a Comfy sobre él exportando `WEB_DIRECTORY`: +Para agregar un poco de JavaScript al cliente, crea un subdirectorio, `web/js`, en el directorio de tu nodo personalizado y modifica el final de `__init__.py` para avisarle a Comfy sobre ello exportando `WEB_DIRECTORY`: ```Python WEB_DIRECTORY = "./web/js" __all__ = ['NODE_CLASS_MAPPINGS', 'WEB_DIRECTORY'] ``` -La extensión de cliente se guarda como un archivo `.js` en el subdirectorio `web/js`, así que crea `image_selector/web/js/imageSelector.js` con el código a continuación. (Para más información, consulta [client side coding](./js/javascript_overview)). +La extensión de cliente se guarda como un archivo `.js` en el subdirectorio `web/js`, así que crea `image_selector/web/js/imageSelector.js` con el código de abajo. (Para más información, consulta [programación del lado del cliente](./js/javascript_overview)). ```Javascript import { app } from "../../scripts/app.js"; @@ -208,7 +206,7 @@ app.registerExtension({ }) ``` -Lo único que hicimos fue registrar una extensión y agregar un detector para el tipo de mensaje que enviamos en el método `setup()`. Esto lee el diccionario que enviamos (que se almacena en `event.detail`). +Lo único que hemos hecho es registrar una extensión y agregar un receptor de eventos para el tipo de mensaje que enviamos en el método `setup()`. Esto lee el diccionario que enviamos (que se almacena en `event.detail`). Detén el servidor de Comfy, inícialo de nuevo, recarga la página web y ejecuta tu flujo de trabajo. From 9663dcbc2fd31a3ef4c827132597da50c81b8074 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 12:55:13 +0800 Subject: [PATCH 3/5] i18n(es): translate Cloud API reference, registry spec and Router guides (batch 3) --- es/development/cloud/api-reference.mdx | 7 +- es/development/comfy-router/api.mdx | 7 +- es/development/comfy-router/limitations.mdx | 47 +++-- es/development/comfy-router/quickstart.mdx | 28 +-- es/development/comfy-router/realtime.mdx | 223 ++++++++++++++++++++ es/registry/specifications.mdx | 56 ++--- 6 files changed, 299 insertions(+), 69 deletions(-) create mode 100644 es/development/comfy-router/realtime.mdx diff --git a/es/development/cloud/api-reference.mdx b/es/development/cloud/api-reference.mdx index ff2e77f9bc..f42e67c57d 100644 --- a/es/development/cloud/api-reference.mdx +++ b/es/development/cloud/api-reference.mdx @@ -3,14 +3,14 @@ title: "Referencia de la API de Cloud" sidebarTitle: "Ejemplos de código" description: "Referencia completa de la API de Comfy Cloud con ejemplos de código" icon: "book-open" -translationSourceHash: 9dfb0617 +translationSourceHash: e15f0e0e translationFrom: development/cloud/api-reference.mdx translationBlockHashes: "_intro": 1729f5d3 "Setup": 311034bb "Object Info": 7b62a397 "Uploading Inputs": 92df17f8 - "Running Workflows": d6ddd0b4 + "Running Workflows": 2c6519c7 "Checking Job Status": d74b4922 "WebSocket for Real-Time Progress": 02c49b4a "Downloading Outputs": 5e1d63d3 @@ -18,6 +18,7 @@ translationBlockHashes: "Queue Management": 857edaaf "Error Handling": b2513ee9 --- + import PollJobCompletion from "/snippets/es/cloud/poll-job-completion.mdx" import WebSocketProgress from "/snippets/es/cloud/websocket-progress.mdx" import DownloadOutputs from "/snippets/es/cloud/download-outputs.mdx" @@ -274,7 +275,7 @@ def upload_mask(file_path: str, original_ref: dict) -> dict: Envía un flujo de trabajo para ejecutarlo. - **Envíos simultáneos admitidos:** Según tu nivel de suscripción, puedes enviar varios flujos de trabajo sin esperar a que terminen las tareas anteriores. Las tareas se ejecutan en paralelo hasta el límite de tu nivel. Las tareas adicionales se ponen en cola automáticamente. Consulta [Tareas simultáneas](/es/development/deploy/cloud-usage#tareas-simultáneas) para ver los detalles y los límites de simultaneidad. + **Envíos simultáneos admitidos:** Según tu nivel de suscripción, puedes enviar varios flujos de trabajo sin esperar a que terminen las tareas anteriores. Las tareas se ejecutan en paralelo hasta el límite de tu nivel. Las tareas adicionales se ponen en cola automáticamente. Consulta [Tareas simultáneas](/es/development/deploy/cloud-usage#tareas-simultáneas) para ver los detalles. ### Enviar flujo de trabajo diff --git a/es/development/comfy-router/api.mdx b/es/development/comfy-router/api.mdx index 0b51b8ef18..05e6dc9c1c 100644 --- a/es/development/comfy-router/api.mdx +++ b/es/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Descripción general de la API de Comfy Router" sidebarTitle: "Descripción general" description: "Cómo funciona la API de Comfy Router: una ruta por ID de modelo y guías de descubrimiento, esquemas, solicitudes en cola, errores y facturación." -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -21,7 +21,7 @@ Elige un modelo, revisa su esquema y llama a `POST /v2/models/{provider}/{model} Envía una ejecución ahora y luego consúltala, recógela o cancélala más tarde. - Lee las respuestas de error y reintenta sin un segundo cargo. + Lee las respuestas de error y reintenta sin un segundo cobro. Qué se cobra, la facturación por rechazo de política y la conciliación del uso. @@ -45,4 +45,5 @@ Elige un modelo, revisa su esquema y llama a `POST /v2/models/{provider}/{model} - [Inicio rápido](/es/development/comfy-router/quickstart): instalación, invocación y guardado de la imagen. - [Modelos](/es/development/comfy-router/models): explora el catálogo y consulta ejemplos de solicitud específicos de cada modelo. - [Encabezados](/es/development/comfy-router/headers): autenticación, idempotencia, IDs de solicitud y ritmo de reintentos. -- [Referencia de la API](/es/development/comfy-router/reference): parámetros de los endpoints, esquemas y códigos de respuesta. \ No newline at end of file +- [Referencia de la API](/es/development/comfy-router/reference): parámetros de los endpoints, esquemas y códigos de respuesta. +- [Voz en tiempo real](/es/development/comfy-router/realtime): abre una sesión de WebSocket de Grok Voice, facturada por segundo. \ No newline at end of file diff --git a/es/development/comfy-router/limitations.mdx b/es/development/comfy-router/limitations.mdx index f4326aafa5..1144a911b5 100644 --- a/es/development/comfy-router/limitations.mdx +++ b/es/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Capacidades y límites de Comfy Router" sidebarTitle: "Capacidades y límites" description: "Elige Router o un proxy socio, planifica llamadas largas y entiende la recuperación, los límites de tasa y el almacenamiento de recursos." -translationSourceHash: 4e0a5a98 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -13,12 +13,13 @@ translationBlockHashes: "Request bodies are capped": 675b77c8 "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d - "Comfy charges and usage": ed49ddec - "Models without a pre-flight estimate": b9174050 - "Router does not cover every partner operation": 97d31362 + "Comfy charges and usage": cf6e2050 + "Models without a pre-flight estimate": f6dfd921 + "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- + Router ejecuta un modelo socio a través de una llamada HTTP síncrona o mediante una solicitud en cola que envías y recoges más tarde. Úsalo cuando tu aplicación pueda esperar un resultado finalizado o recogerlo más tarde, y pueda manejar los campos de entrada y salida propios del modelo. ## Qué admite Router @@ -92,11 +93,11 @@ Muestra un indicador de progreso indeterminado. Si necesitas progreso o streamin ## Cargos y uso de Comfy -La respuesta puede contener campos de uso o costo del proveedor. No representan un cargo universal de Comfy. `X-Comfy-Credits-Used` es opcional: que falte el encabezado significa que el costo no se informó, no que la ejecución haya sido gratis. Una respuesta reproducida (`Idempotent-Replayed: true`) nunca se cobra de nuevo, pero puede repetir la cifra de la ejecución original, así que no sumes el encabezado entre reintentos de una misma `Idempotency-Key`. Usa la plataforma de Comfy para saldos, uso y facturas. +La respuesta puede contener campos de uso o de costo del proveedor. No representan un cargo universal de Comfy. `X-Comfy-Credits-Used` es opcional: que falte el encabezado significa que el costo no se informó, no que la ejecución haya sido gratis. Una respuesta reproducida (`Idempotent-Replayed: true`) nunca se cobra de nuevo, pero puede repetir la cifra de la ejecución original, así que no sumes el encabezado entre reintentos de una misma `Idempotency-Key`. Usa la plataforma de Comfy para saldos, uso y facturas. -El catálogo proporciona datos de facturación, incluido `billing.charges_on_policy_rejection`, pero no precios. Maneja `yes`, `no` y `unknown` de forma explícita. Consulta [facturación](/es/development/comfy-router/billing#datos-de-facturación-de-los-modelos). +El catálogo proporciona datos de facturación, incluido `billing.charges_on_policy_rejection`, pero no precios. Maneja `yes`, `no` y `unknown` de forma explícita. Cuando es `yes`, un error síncrono `content_policy_violation` puede incluir `X-Comfy-Credits-Used`: lo incluye cuando el proveedor rechazó la salida generada por el modelo y Comfy registró uso para esa generación rechazada, y en ese caso contiene esa cantidad. Un rechazo del lado de la entrada, una repetición con la misma clave y un cargo demasiado pequeño para mostrarse en los dos decimales del encabezado no lo incluyen; un rechazo sin el encabezado no se informa, no es gratis. Consulta [facturación](/es/development/comfy-router/billing#datos-de-facturación-de-los-modelos). -Para ver un precio antes de una ejecución, llama a `POST /v2/models/{provider}/{model}/estimate`, o lee el objeto `estimate` en el `201` de un envío en cola. Mientras la estimación se está desplegando, la ruta responde `403` con `error_type: not_enabled` y el envío omite `estimate`. Cada uno se calcula a partir de la tarjeta de tarifas contra la que Comfy factura la ejecución, pero la cifra es una estimación, no el cargo final, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es definitivo. Tampoco es un bloqueo de precio. Comfy no factura una ejecución realizada con tu propia clave de proveedor, incluso cuando `/estimate` devuelve una cifra para ella, y una estimación `unknown` no incluye ninguna cifra; eso no significa que sea gratis. `X-Comfy-Credits-Used` sigue siendo una cifra redondeada calculada a posteriori para una ejecución, no un recibo. Consulta [Estimaciones de costo antes de la ejecución](/es/development/comfy-router/reference#estimaciones-de-costos-previas-a-la-ejecución) para saber cómo interpretar `exact`, `estimated` y `unknown`. Los modelos cuyo precio no se puede calcular antes de una ejecución se enumeran en [modelos sin una estimación previa a la ejecución](#modelos-sin-estimación-previa). +Para consultar un precio antes de una ejecución, llama a `POST /v2/models/{provider}/{model}/estimate`, o lee el objeto `estimate` en el `201` de un envío en cola. Mientras la estimación se implementa gradualmente, la ruta responde `403` con `error_type: not_enabled` y el envío omite `estimate`. Cada estimación se calcula a partir de la tarjeta de tarifas contra la que Comfy factura la ejecución (a un modelo al que se le factura el costo que reporta su proveedor, en cambio, se le estima a partir de la lista de precios publicada por ese proveedor), pero la cifra es una estimación, no el cargo final, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es definitivo. Tampoco es un bloqueo de precio. Comfy no factura una ejecución realizada con tu propia clave de proveedor, incluso cuando `/estimate` devuelve una cifra para ella, y una estimación `unknown` no incluye ninguna cifra; eso no significa que sea gratis. `X-Comfy-Credits-Used` sigue siendo una cifra redondeada calculada a posteriori para una ejecución, no un recibo. Consulta [Estimaciones de costo antes de la ejecución](/es/development/comfy-router/reference#estimaciones-de-costos-previas-a-la-ejecución) para saber cómo interpretar `exact`, `estimated` y `unknown`. Los modelos cuyo precio no se puede calcular antes de una ejecución se enumeran en [modelos sin estimación previa](#modelos-sin-estimación-previa). ## Modelos sin estimación previa @@ -106,36 +107,36 @@ Esta lista se reduce a medida que crece la cobertura de estimaciones. Se genera {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} -- **bfl**: `bfl/erase-v1`, `bfl/flux-2-max`, `bfl/flux-2-pro`, `bfl/flux-3-image`, `bfl/flux-3-video`, `bfl/flux-kontext-max`, `bfl/flux-kontext-pro`, `bfl/flux-pro-1.0-expand`, `bfl/flux-pro-1.0-fill`, `bfl/flux-pro-1.1`, `bfl/flux-pro-1.1-ultra`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **elevenlabs**: `elevenlabs/eleven_sfx_v2` -- **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` +- **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` +- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5` - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` -- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` -- **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` -- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` +- **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` -- **recraft**: `recraft/recraftv2`, `recraft/recraftv3`, `recraft/recraftv4`, `recraft/recraftv4_1`, `recraft/recraftv4_1_pro`, `recraft/recraftv4_1_pro_vector`, `recraft/recraftv4_1_utility`, `recraft/recraftv4_1_utility_pro`, `recraft/recraftv4_1_utility_pro_vector`, `recraft/recraftv4_1_utility_vector`, `recraft/recraftv4_1_vector`, `recraft/recraftv4_pro`, `recraft/recraftv4_styles`, `recraft/recraftv4_styles_pro`, `recraft/recraftv4_styles_pro_vector`, `recraft/recraftv4_styles_vector` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` -- **runway**: `runway/gen4_image` - **synclabs**: `synclabs/sync-3` -- **veed**: `veed/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` -- **wavespeed**: `wavespeed/flashvsr`, `wavespeed/seedvr2`, `wavespeed/ultimate-image-upscaler`, `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` -- **xai**: `xai/grok-imagine-image`, `xai/grok-imagine-image-2.0`, `xai/grok-imagine-image-pro`, `xai/grok-imagine-image-quality`, `xai/grok-imagine-video`, `xai/grok-imagine-video-1.5`, `xai/grok-imagine-video-1.5-lite`, `xai/grok-imagine-video-1.5-preview` +- **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} +Las ediciones con `openai/gpt-image-2`, `openai/gpt-image-2.5-flare` y `openai/gpt-image-2.5-sunburst` tampoco tienen estimación previa. Una llamada de edición a uno de estos modelos, o una llamada de generación que incluya una imagen de entrada, responde `source: unknown`. Una llamada de generación solo de texto a estos modelos sí se estima, y por eso no aparecen en la lista anterior. + ## Router no cubre todas las operaciones de los socios -Router ejecuta modelos. La carga de archivos, la lectura de cuentas, la gestión de recursos, el streaming y el control de tareas del proveedor pueden requerir rutas de proxy de socio bajo `/proxy/…`, que quedan fuera de Router y no están descritas en su contrato. La superficie propia de Router es la [especificación de Comfy Router](/router-openapi.yaml); el soporte varía según el proveedor. +Router ejecuta modelos. La carga de archivos, la lectura de cuentas, la gestión de recursos, el streaming y el control de tareas del proveedor pueden requerir rutas de proxy de socio bajo `/proxy/…`, que quedan fuera de Router y no están descritas en su contrato. La superficie propia de Router es la [especificación de Comfy Router](/es/router-openapi.yaml); el soporte varía según el proveedor. + +### Imágenes de referencia de Krea 3: subir primero o usar una URL https pública + +En los `image_urls` de `krea/krea-3`, un `image_url` devuelto por `POST /proxy/krea/assets` (una URL `https://app-uploads.krea.ai/...`) siempre se acepta. Que se acepten otros enlaces depende del entorno; en api.comfy.org actualmente se aceptan. -### Las imágenes de referencia de Krea 3 deben subirse primero +- **Donde se aceptan otros enlaces**, funciona cualquier URL de imagen `https` pública. Router lee el tamaño de cada imagen antes de que se ejecute el modelo: un enlace cuyo host no sea accesible públicamente o no exista, que responda con un `4xx` distinto de `408` o `429`, o que no sea una imagen se rechaza con `400` `invalid_input` indicando su host. Un fallo transitorio de DNS, TLS o de conexión, un tiempo de espera agotado o un `408` o `429` del origen provoca un error `502`. Un enlace de `app-uploads.krea.ai` que no sea una carga activa se rechaza con `400` como cualquier otra referencia no accesible. Justo después de que arranque un servidor, antes de que haya aprendido qué regla se aplica, una URL `https` pública que no sea un enlace de `app-uploads.krea.ai` puede fallar con un `503` que se puede reintentar sin riesgo. +- **Donde no se aceptan otros enlaces**, cada entrada debe ser el `image_url` de una carga. Router solo comprueba que el enlace se analice como una URL `https` cuyo host sea exactamente `app-uploads.krea.ai` (ningún otro host y ningún puerto explícito): cualquier otro enlace, incluida una URL `https` pública que alojes tú mismo, se rechaza con `400` `invalid_input` antes de que se ejecute el modelo. Un enlace que pase esa comprobación pero que no sea una carga activa (expirada, eliminada o escrita incorrectamente) también la supera, y entonces Router no consigue leer el tamaño de la imagen y responde con un error `5xx`, no con un `400`. -`krea/krea-3` no acepta enlaces de imagen arbitrarios. Cada entrada de `image_urls` debe ser un `image_url` devuelto por `POST /proxy/krea/assets`, es decir, una URL `https://app-uploads.krea.ai/...`. Router solo comprueba que el enlace se analice como una URL `https` cuyo host sea exactamente `app-uploads.krea.ai` (ningún otro host y ningún puerto explícito): cualquier otro enlace, incluida una URL `https` pública que alojes tú mismo, se rechaza con `400` `invalid_input` antes de que se ejecute el modelo. Un enlace que pase esa comprobación pero que no sea una carga activa (expirada, eliminada o escrita incorrectamente) también la supera, y entonces Router no consigue leer el tamaño de la imagen y responde con un error `5xx`, no con un `400`, así que pasa siempre el `image_url` exactamente tal como lo devolvió la carga. +Subir archivos funciona en todos los entornos, así que es la opción portátil; pasa siempre el `image_url` exactamente tal como lo devolvió la carga. 1. Sube cada imagen de referencia como `multipart/form-data`, con la imagen en el campo de formulario `file` (JPEG, PNG o WebP, hasta 75 MB). Autentícate igual que en Router, con `X-API-Key` o `Authorization: Bearer`. diff --git a/es/development/comfy-router/quickstart.mdx b/es/development/comfy-router/quickstart.mdx index 503b557db0..5ed155a80a 100644 --- a/es/development/comfy-router/quickstart.mdx +++ b/es/development/comfy-router/quickstart.mdx @@ -2,12 +2,14 @@ title: "Inicio rápido de Comfy Router" sidebarTitle: "Inicio rápido" description: "Genera imágenes y videos con los últimos modelos de IA en minutos." -translationSourceHash: ccf476cf +translationSourceHash: ea087f5c translationFrom: development/comfy-router/quickstart.mdx translationBlockHashes: "_intro": 201b5b50 + "Image-to-video and reference-to-video": 8ac90191 "Next steps": ed466781 --- +
Comfy Router te ofrece una sola API para modelos alojados de imagen y video en `https://api.comfy.org`. Crea una clave API en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y luego llama a cualquier modelo con los [SDK oficiales de Python y TypeScript](/es/development/api-development/sdks) o por HTTP simple. La facturación es de pago por uso: de forma predeterminada, cada solicitud toma créditos del saldo de tu espacio de trabajo, sin suscripción. Consulta los [precios de Router](/es/development/comfy-router/pricing) para ver las tarifas y otras opciones de facturación. @@ -128,25 +130,25 @@ Comfy Router te ofrece una sola API para modelos alojados de imagen y video en ` Cada llamada de envío del SDK crea una clave de idempotencia y la reutiliza para los reintentos automáticos. - El ejemplo de cURL crea una con `uuidgen`. Si no está disponible, usa otro generador de UUID. - Para obtener detalles sobre el estado, la cancelación y la recopilación, consulta [Entrega en cola](/es/development/comfy-router/queue). + El ejemplo de cURL genera una con `uuidgen`. Si no está disponible, usa otro generador de UUID. + Para detalles sobre el estado, la cancelación y la recopilación del resultado, consulta [Entrega en cola](/es/development/comfy-router/queue). ## Imagen a video y referencia a video -La misma solicitud de Seedance acepta entradas de imagen, video y audio. Agrega elementos a `content` y define el `role` de cada uno. Los roles que envías deciden la operación que ejecuta Router. El precio sigue los tipos de medio de `content`, no los roles: una solicitud con cualquier entrada de video se factura como video a video; si no, una con cualquier imagen se factura como imagen a video, y una solicitud solo de texto se factura como texto a video. Algunos modelos cobran la misma tarifa para texto a video y para imagen a video. +La misma solicitud de Seedance acepta entradas de imagen, video y audio. Agrega elementos a `content` y define el `role` de cada uno. Los roles que envías determinan la operación que ejecuta Router. El precio sigue los tipos de medio en `content`, no los roles: una solicitud con cualquier entrada de video se cobra como video a video; si no, una con cualquier imagen se cobra como imagen a video; y una solicitud solo de texto se cobra como texto a video. Algunos modelos cobran la misma tarifa para texto a video e imagen a video. | Operación | Elementos de `content` | |---|---| | Texto a video | un elemento `text` | | Imagen a video | un elemento `text` más un elemento `image_url` con `role: first_frame` | | Primer y último fotograma | lo anterior más un segundo elemento `image_url` con `role: last_frame` | -| Referencia a video | un elemento `text` más elementos `image_url` con `role: reference_image`, y en Seedance 2.0 y 2.5, elementos `video_url` con `role: reference_video` y elementos `audio_url` con `role: reference_audio` | +| Referencia a video | un elemento `text` más elementos `image_url` con `role: reference_image` y, en Seedance 2.0 y 2.5, elementos `video_url` con `role: reference_video` y elementos `audio_url` con `role: reference_audio` | -Una `url` de imagen puede ser una URL pública o una cadena `data:image/;base64,`. Envía, consulta y recoge exactamente como en el inicio rápido de arriba. Solo cambia el cuerpo. +La `url` de una imagen puede ser una URL pública o una cadena `data:image/;base64,`. Envía, consulta el estado y recoge el resultado exactamente como en la guía de inicio anterior. Solo cambia el cuerpo. -```bash Imagen a video +```bash Image-to-video curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ @@ -161,7 +163,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque }' ``` -```bash Referencia a video +```bash Reference-to-video curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ @@ -178,15 +180,15 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque }' ``` -En Seedance 2.5, las solicitudes de primer fotograma y de primer y último fotograma toman la relación de aspecto de salida del primer fotograma. Omite `ratio` o envía `adaptive`, porque una relación concreta se rechaza con un `400`. El esquema de la solicitud es compartido en toda la familia Seedance y puede listar roles que un modelo ignora, así que revisa el campo `x-comfy-router-input-modalities` en el [esquema de entrada](/es/development/comfy-router/models) de cada modelo para conocer los tipos de entrada que ese modelo acepta. Por ejemplo, `reference_video` y `reference_audio` necesitan un modelo que liste `video` o `audio` ahí. +En Seedance 2.5, las solicitudes de primer fotograma y de primer y último fotograma toman la relación de aspecto de salida del primer fotograma. Omite `ratio` o envía `adaptive`, porque una relación concreta se rechaza con un `400`. El esquema de la solicitud es compartido por toda la familia Seedance y puede listar roles que un modelo ignora, así que revisa el campo `x-comfy-router-input-modalities` en el [esquema de entrada](/es/development/comfy-router/models) de cada modelo para conocer los tipos de entrada que ese modelo acepta. Por ejemplo, `reference_video` y `reference_audio` necesitan un modelo que liste `video` o `audio` ahí. -## Próximos pasos +## Siguientes pasos - Explora los modelos disponibles y encuentra ejemplos de solicitudes para cada modelo. + Explora los modelos disponibles y encuentra ejemplos de solicitudes específicos para cada modelo. - - Conoce cómo funciona el descubrimiento de modelos, los esquemas, las solicitudes en cola, los errores y la facturación. + + Conoce el descubrimiento de modelos, los esquemas, las solicitudes en cola, los errores y la facturación. diff --git a/es/development/comfy-router/realtime.mdx b/es/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..d52073e19a --- /dev/null +++ b/es/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Sesiones de voz en tiempo real con Comfy Router" +sidebarTitle: "Voz en tiempo real" +description: "Abre una sesión WebSocket de voz en tiempo real de Grok Voice con Comfy Router: endpoint, autenticación, costo por segundo, límites, errores y códigos de cierre." +translationSourceHash: e4024a38 +translationFrom: development/comfy-router/realtime.mdx +translationBlockHashes: + "_intro": a85f88e5 + "Endpoint": 2ae36abf + "Authentication": 582120fe + "Connect": b61ae8c6 + "Events": a3ac8c47 + "Pricing": 25d35f6c + "Limits": 85e21dff + "Errors": 3085ba65 + "Next": 3e8c1bd8 +--- +Comfy Router retransmite una sesión de voz a voz en tiempo real con Grok Voice de xAI, servida por fal. Abres un WebSocket a Router con tu Clave API de Comfy. Router verifica tu cuenta y tus créditos, abre la sesión en el servicio upstream y luego retransmite eventos en ambas direcciones. Pagas por segundo de sesión con tus créditos de Comfy. + +## Punto de conexión + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +La solicitud es una actualización a WebSocket (`GET` con `Connection: Upgrade` y `Upgrade: websocket`). El servidor rechaza cualquier otra solicitud con `426`. + +## Autenticación + +Envía tu Clave API de Comfy en un encabezado de la solicitud de actualización, ya sea como `X-API-Key: comfyui-...` o como `Authorization: Bearer comfyui-...`. Router no lee ninguna clave de la cadena de consulta ni del subprotocolo WebSocket. + + +Los navegadores no pueden establecer encabezados en un WebSocket, y una Clave API de Comfy nunca debe llegar a un navegador. Abre la sesión desde tu servidor y retransmite el audio al navegador tú mismo. + + +## Conectar + +Cuando la actualización se complete correctamente, envía y recibe los eventos en tiempo real que xAI documenta para Grok Voice. Este ejemplo configura la sesión, envía un turno de texto e imprime cada tipo de evento que recibe. + + + +```python Python +# pip install websockets msgpack +import asyncio +import os + +import msgpack +import websockets + +URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime" + + +async def send(ws, event): + await ws.send(msgpack.packb(event)) + + +async def main(): + async with websockets.connect( + URL, + additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]}, + ) as ws: + await send(ws, { + "type": "session.update", + "session": { + "voice": "eve", + "instructions": "You are a helpful assistant.", + "turn_detection": {"type": "server_vad"}, + }, + }) + await send(ws, { + "type": "conversation.item.create", + "item": { + "type": "message", + "role": "user", + "content": [{"type": "input_text", "text": "Hello!"}], + }, + }) + await send(ws, {"type": "response.create"}) + + async for message in ws: + if isinstance(message, str): + continue # tramas x-fal-message propias de fal + event = msgpack.unpackb(message) + print(event["type"]) + if event["type"] == "response.done": + break + + +asyncio.run(main()) +``` + +```javascript Node.js +// npm install ws @msgpack/msgpack +import WebSocket from "ws"; +import { encode, decode } from "@msgpack/msgpack"; + +const ws = new WebSocket( + "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime", + { headers: { "X-API-Key": process.env.COMFY_API_KEY } }, +); + +ws.on("unexpected-response", (req, res) => { + // Se rechazó la actualización. El cuerpo JSON indica el motivo. + let body = ""; + res.on("data", (chunk) => (body += chunk)); + res.on("end", () => console.error(res.statusCode, body)); +}); + +const send = (event) => ws.send(encode(event)); + +ws.on("open", () => { + send({ + type: "session.update", + session: { + voice: "eve", + instructions: "You are a helpful assistant.", + turn_detection: { type: "server_vad" }, + }, + }); + send({ + type: "conversation.item.create", + item: { + type: "message", + role: "user", + content: [{ type: "input_text", text: "Hello!" }], + }, + }); + send({ type: "response.create" }); +}); + +ws.on("message", (data, isBinary) => { + if (!isBinary) return; // tramas x-fal-message propias de fal + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +Cierra el socket en cuanto termines. Se te factura hasta que se cierre la sesión, no hasta la última respuesta. + +## Eventos + +Router no define su propio protocolo de eventos. Los eventos del servidor te llegan exactamente como los envía fal, y Router reenvía sin cambios los eventos de cliente que acepta. Para consultar la lista de eventos, los campos de sesión, las voces y los formatos de audio, consulta: + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) y el [esquema de eventos en tiempo real](https://docs.x.ai/voice-realtime.ws.json) de xAI +- la [página del modelo en tiempo real Grok Voice](https://fal.ai/models/xai/grok-voice/realtime) de fal y su [página de API](https://fal.ai/models/xai/grok-voice/realtime/api) + +Envía cada evento de cliente como un único mensaje binario msgpack, como en los ejemplos. Este es el formato de trama que usan los clientes en tiempo real de fal, y los eventos del modelo regresan de la misma manera, como mensajes binarios msgpack que comienzan con `session.created`. fal también envía sus propios mensajes de texto JSON de tipo `x-fal-message` (información de temporización); puedes omitirlos. Las comprobaciones de Router también aceptan un evento de cliente como un único mensaje de texto JSON, pero usa msgpack a menos que hayas probado JSON con tu cliente. + +Router comprueba cada evento de cliente antes de reenviarlo: + +- **Tipos de evento:** `session.update`, `input_audio_buffer.append`, `input_audio_buffer.commit`, `input_audio_buffer.clear`, `conversation.item.create`, `conversation.item.delete`, `conversation.item.truncate`, `response.create`, `response.cancel` y `x-fal-session.configure` de fal. +- **Modelos:** un `model` en `session.update` debe ser `grok-voice-latest`, `grok-voice-3.0` o `grok-voice-2.0`. +- **Herramientas:** las herramientas de función que ejecuta tu cliente están permitidas. Router rechaza las herramientas del lado del servidor (búsqueda web, búsqueda en X, búsqueda de archivos y MCP). +- **Multimedia:** Router rechaza la entrada de imagen y video. La sesión es solo de voz y texto. +- **Tamaño:** un mensaje de cliente puede ocupar como máximo 1 MiB. + +Un evento rechazado no se reenvía, y Router cierra la sesión con el código de cierre `1008`. + +## Precios + +Una sesión cuesta **$0.0011869 por segundo** (aproximadamente $0.0712 por minuto, o 0.2504 créditos por segundo, alrededor de 15.0 créditos por minuto, con 211 créditos = $1 USD). Se factura en incrementos de 15 segundos mientras la sesión está abierta, y el último incremento parcial se factura por segundo, redondeado hacia arriba. La facturación corre desde la actualización de la conexión hasta que se cierra el socket, independientemente de que haya o no audio en transmisión. + +## Límites + +| Límite | Valor | +| --- | --- | +| Sesiones por cuenta | Una sesión abierta a la vez. Abrir una segunda devuelve `429` con `router.realtime.session_already_live`. | +| Duración de la sesión | Como máximo 30 minutos, y nunca más de lo que cubre tu saldo de créditos en el momento de la conexión. | +| Créditos durante una sesión | Router vuelve a comprobar tu saldo cada 15 segundos y finaliza la sesión cuando el saldo ya no puede cubrir el siguiente segundo. | +| Tasa de conexión | Cada intento de mejora cuenta para tu [tasa de solicitudes por solicitante](/es/development/comfy-router/limitations#límite-de-tasa-de-solicitudes-por-solicitante), compartida con tus demás llamadas a Router. | + +Cuando una sesión alcanza su límite de tiempo o se queda sin créditos, la conexión puede cerrarse sin una trama de cierre (a menudo aparece como el código de cierre `1006`). Vuelve a conectarte solo después de recargar, o inicia una nueva sesión si necesitas más tiempo. + +## Errores + +### Antes de la actualización + +Si Router rechaza la conexión, responde con un estado HTTP y un cuerpo JSON en lugar de cambiar de protocolo: + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +Cambia según `code`; `detail` es para las personas. + +| Estado | `code` | Causa | Qué hacer | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | La solicitud no era una actualización de WebSocket. | Conéctate con un cliente WebSocket. | +| `401` | `router.realtime.unauthorized` | La clave API falta o no es válida. | Envía una clave válida en `X-API-Key` o `Authorization: Bearer`. | +| `402` | `router.realtime.insufficient_credits` | Tu saldo no cubre al menos un segundo de sesión. | Agrega créditos y vuelve a conectarte. | +| `402` | `router.realtime.spend_denied` | La billetera a la que se cobraría la sesión no tiene fondos para ella. `denied_reason` y `billed_workspace` en el cuerpo indican cuál billetera. | Agrega créditos a ese espacio de trabajo y vuelve a conectarte. | +| `403` | `router.realtime.provider_disabled` | La política de proveedores socios de tu espacio de trabajo no permite este proveedor. | Pide a un administrador del espacio de trabajo que lo permita. | +| `404` | `router.realtime.model_not_allowed` | El modelo de la URL no está disponible para realtime. | Revisa la URL. | +| `429` | `router.realtime.rate_limited` | Superaste la tasa de solicitudes. | Espera `Retry-After` y vuelve a intentarlo. | +| `429` | `router.realtime.session_already_live` | Ya hay otra sesión abierta para tu cuenta. | Ciérrala primero. | +| `429` | `router.realtime.concurrency_limit` | Demasiadas llamadas simultáneas a modelos socios. | Reduce el trabajo simultáneo y vuelve a intentarlo. | +| `502` | `router.realtime.upstream_refused`, `router.realtime.token_mint_failed` | El proveedor upstream no abrió la sesión. | Reintenta con retroceso exponencial. | +| `503` | cualquier otro código `router.realtime.*` | Las sesiones realtime no están disponibles temporalmente. | Reintenta con retroceso exponencial. | + +### Después de la actualización + +| Código de cierre | Significado | Qué hacer | +| --- | --- | --- | +| `1008` | Se rechazó un evento de cliente (consulta [Events](#eventos)). | Corrige el evento. La sesión termina. | +| `1012` | Router se está reiniciando. | Vuelve a conectarte. Se inicia una nueva sesión y se cobra desde la nueva actualización. | +| `1006` (sin trama de cierre) | Suele ser lo que reportan los clientes cuando la sesión alcanzó su límite de tiempo o se quedó sin créditos. Las caídas de red se ven igual. | Agrega créditos o inicia una nueva sesión. | + +Cualquier otro cierre proviene de fal o xAI. Consulta su documentación enlazada en [Events](#eventos). + +## Siguiente + +- [Facturación](/es/development/comfy-router/billing): cómo cobra Router y cómo conciliar el uso. +- [Errores y reintentos](/es/development/comfy-router/errors): los grupos de errores que devuelven otras llamadas de Router. +- [Limitaciones](/es/development/comfy-router/limitations): tasas de solicitudes y otros límites. diff --git a/es/registry/specifications.mdx b/es/registry/specifications.mdx index 621f4976c7..dad0056f99 100644 --- a/es/registry/specifications.mdx +++ b/es/registry/specifications.mdx @@ -1,12 +1,15 @@ --- title: "pyproject.toml" description: "Especificación de pyproject.toml en Nodos personalizados de ComfyUI: secciones [project] y [tool.comfy], campos requeridos, versionado y un ejemplo completo." -translationSourceHash: fc84af05 +translationSourceHash: 89a4bc1e translationFrom: registry/specifications.mdx translationBlockHashes: "_intro": 2bd726bd + "[project] Section": 00ed6e04 "[tool.comfy] Section": 54d126bc + "Complete Example": 24cf243a --- + # Especificaciones El archivo `pyproject.toml` contiene dos secciones principales para los nodos personalizados de ComfyUI: `[project]` y `[tool.comfy]`. A continuación encontrarás las especificaciones de cada sección. @@ -14,7 +17,7 @@ El archivo `pyproject.toml` contiene dos secciones principales para los nodos pe ## Sección [project] ### name (requerido) -El id del nodo identifica de forma única el nodo personalizado y se usará en las URL del registro. Los usuarios pueden instalar el nodo haciendo referencia a este nombre: +El id del nodo identifica de forma única al nodo personalizado y se usará en las URL del registry. Los usuarios pueden instalar el nodo haciendo referencia a este nombre: ```bash comfy node install @@ -24,13 +27,13 @@ comfy node install - Debe tener menos de 100 caracteres - Solo puede contener caracteres alfanuméricos, guiones, guiones bajos y puntos - No puede tener caracteres especiales consecutivos -- No puede empezar por un número ni por un carácter especial -- La comparación no distingue entre mayúsculas y minúsculas +- No puede comenzar con un número ni con un carácter especial +- La comparación no distingue mayúsculas de minúsculas -**Prácticas recomendadas:** +**Buenas prácticas:** - Usa un nombre corto y descriptivo - No incluyas "ComfyUI" en el nombre -- Haz que sea fácil de recordar y de escribir +- Hazlo fácil de recordar y de escribir **Ejemplos:** ```toml @@ -40,14 +43,14 @@ name = "ComfyUI-enhancer" # ❌ Bad: Includes ComfyUI name = "123-tool" # ❌ Bad: Starts with number ``` -Consulta la [documentación oficial de Python](https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#name) para obtener más detalles. +Consulta la [documentación oficial de python](https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#name) para obtener más detalles. ### version (requerido) -Usa el [versionado semántico](https://semver.org/) con un número de versión de tres dígitos X.Y.Z: +Usa [versionado semántico](https://semver.org/) con un número de versión de tres dígitos X.Y.Z: -- X (**MAJOR**): cambios que rompen la compatibilidad -- Y (**MINOR**): nuevas funcionalidades (compatibles hacia atrás) -- Z (**PATCH**): correcciones de errores +- X (**MAJOR**): Cambios incompatibles +- Y (**MINOR**): Funciones nuevas (compatibles con versiones anteriores) +- Z (**PATCH**): Correcciones de errores **Ejemplos:** ```toml @@ -58,7 +61,7 @@ version = "2.0.0" # Breaking changes ``` ### license (opcional) -Especifica la licencia de tu nodo personalizado. Se puede indicar de dos formas: +Especifica la licencia de tu nodo personalizado. Puedes especificarla de dos maneras: 1. **Referencia a un archivo:** ```toml @@ -108,13 +111,13 @@ requires-python = ">=3.8" # Python 3.8 or higher requires-python = ">=3.8,<3.11" # Python 3.8 up to (but not including) 3.11 ``` -### Compatibilidad de versión del frontend (opcional) -Si tu nodo tiene requisitos específicos sobre qué versiones del frontend de ComfyUI admite, puedes indicarlo con la dependencia `comfyui-frontend-package`. Este paquete se publica en [PyPI](https://pypi.org/project/comfyui-frontend-package/). +### Compatibilidad de versiones del frontend (opcional) +Si tu nodo tiene requisitos específicos sobre qué versiones del frontend de ComfyUI admite, puedes especificarlo con la dependencia `comfyui-frontend-package`. Este paquete se publica en [PyPI](https://pypi.org/project/comfyui-frontend-package/). Por ejemplo, usa este campo cuando: -- Tu nodo personalizado usa API del frontend introducidas en una versión concreta -- Has identificado incompatibilidades entre tu nodo y determinadas versiones del frontend -- Tu nodo requiere funciones de interfaz específicas que solo están disponibles en versiones más recientes del frontend +- Tu nodo personalizado usa API del frontend que se introdujeron en una versión específica +- Has identificado incompatibilidades entre tu nodo y ciertas versiones del frontend +- Tu nodo requiere funciones de UI específicas que solo están disponibles en versiones más recientes del frontend ```toml [project] @@ -128,7 +131,7 @@ dependencies = [ ``` ### classifiers (recomendado) -Usa los classifiers para especificar la compatibilidad con el sistema operativo y con los aceleradores de GPU. Esta información ayuda a los usuarios a encontrar el nodo adecuado para su sistema. +Usa los clasificadores para especificar la compatibilidad con el sistema operativo y los aceleradores GPU. Esta información ayuda a los usuarios a encontrar el nodo adecuado para su sistema. ```toml [project] @@ -149,7 +152,6 @@ classifiers = [ "Environment :: GPU :: Apple Metal", # Apple Metal support ] ``` - ## Sección [tool.comfy] ### PublisherId (requerido) @@ -162,14 +164,14 @@ PublisherId = "image-wizard" # ✅ Identificador único ``` ### DisplayName (opcional) -Un nombre fácil de reconocer para tu nodo personalizado. +Un nombre fácil de leer y reconocer para tu nodo personalizado. ```toml DisplayName = "Super Resolution Node" ``` ### Icon (opcional) -URL del icono de tu nodo personalizado que se mostrará en ComfyUI Registry y ComfyUI-Manager. +URL al icono de tu nodo personalizado que se mostrará en ComfyUI Registry y ComfyUI-Manager. **Requisitos:** - Tipos de archivo: SVG, PNG, JPG o GIF @@ -181,7 +183,7 @@ Icon = "https://raw.githubusercontent.com/username/repo/main/icon.png" ``` ### Banner (opcional) -URL de una imagen de banner más grande que se mostrará en ComfyUI Registry y ComfyUI-Manager. +URL a una imagen de banner más grande que se mostrará en ComfyUI Registry y ComfyUI-Manager. **Requisitos:** - Tipos de archivo: SVG, PNG, JPG o GIF @@ -192,20 +194,20 @@ Banner = "https://raw.githubusercontent.com/username/repo/main/banner.png" ``` ### requires-comfyui (opcional) -Especifica con qué versión de ComfyUI es compatible tu nodo. Esto ayuda a los usuarios a asegurarse de que tengan instalada la versión correcta de ComfyUI. +Especifica con qué versión de ComfyUI es compatible tu nodo. Esto ayuda a los usuarios a asegurarse de que tienen instalada la versión correcta de ComfyUI. **Operadores admitidos:** `<`, `>`, `<=`, `>=`, `~=`, `<>`, `!=` y rangos ```toml requires-comfyui = ">=1.0.0" # ComfyUI 1.0.0 o superior -requires-comfyui = ">=1.0.0,<2.0.0" # ComfyUI 1.0.0 hasta (sin incluir) 2.0.0 -requires-comfyui = "~=1.0.0" # Versión compatible: 1.0.0 o posterior, pero no la 2.0.0 -requires-comfyui = "!=1.2.3" # Cualquier versión excepto la 1.2.3 +requires-comfyui = ">=1.0.0,<2.0.0" # ComfyUI 1.0.0 hasta 2.0.0 (sin incluirlo) +requires-comfyui = "~=1.0.0" # Versión compatible: 1.0.0 o posterior, pero no la versión 2.0.0 +requires-comfyui = "!=1.2.3" # Cualquier versión excepto 1.2.3 requires-comfyui = ">0.1.3,<1.0.0" # Mayor que 0.1.3 y menor que 1.0.0 ``` ### includes (opcional) -Especifica si deseas forzar la inclusión de ciertas carpetas específicas. En algunas situaciones, como los nodos personalizados en proyectos de frontend, la carpeta de salida final empaquetada puede estar incluida en .gitignore. En esos casos, debemos forzar su inclusión para poder usarla en el registro. +Indica si quieres forzar la inclusión de determinadas carpetas concretas. En algunas situaciones, como los nodos personalizados en proyectos de frontend, la carpeta de salida final empaquetada puede estar incluida en .gitignore. En esos casos, necesitamos forzar su inclusión para poder usar el registro. ```toml includes = ['dist'] From 8a642eb5f06eb9b14b925ce1a1b070258ba9b22e Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 12:55:58 +0800 Subject: [PATCH 4/5] i18n(es): localize remaining links and the startup-flags intro --- es/development/comfy-router/limitations.mdx | 2 +- es/development/comfyui-server/startup-flags.mdx | 7 +++---- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/es/development/comfy-router/limitations.mdx b/es/development/comfy-router/limitations.mdx index 1144a911b5..a2e4ab0bb5 100644 --- a/es/development/comfy-router/limitations.mdx +++ b/es/development/comfy-router/limitations.mdx @@ -127,7 +127,7 @@ Las ediciones con `openai/gpt-image-2`, `openai/gpt-image-2.5-flare` y `openai/g ## Router no cubre todas las operaciones de los socios -Router ejecuta modelos. La carga de archivos, la lectura de cuentas, la gestión de recursos, el streaming y el control de tareas del proveedor pueden requerir rutas de proxy de socio bajo `/proxy/…`, que quedan fuera de Router y no están descritas en su contrato. La superficie propia de Router es la [especificación de Comfy Router](/es/router-openapi.yaml); el soporte varía según el proveedor. +Router ejecuta modelos. La carga de archivos, la lectura de cuentas, la gestión de recursos, el streaming y el control de tareas del proveedor pueden requerir rutas de proxy de socio bajo `/proxy/…`, que quedan fuera de Router y no están descritas en su contrato. La superficie propia de Router es la [especificación de Comfy Router](/router-openapi.yaml); el soporte varía según el proveedor. ### Imágenes de referencia de Krea 3: subir primero o usar una URL https pública diff --git a/es/development/comfyui-server/startup-flags.mdx b/es/development/comfyui-server/startup-flags.mdx index 8b8d7011b9..3fea731c12 100644 --- a/es/development/comfyui-server/startup-flags.mdx +++ b/es/development/comfyui-server/startup-flags.mdx @@ -23,14 +23,13 @@ translationBlockHashes: "Logging & Misc": 4d81c96d --- - -ComfyUI accepts command-line arguments when started with `python main.py`. This page documents every flag defined in [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). +ComfyUI acepta argumentos de línea de comandos cuando se inicia con `python main.py`. Esta página documenta cada flag definido en [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). - **Windows Portable** users can add flags to the `.bat` launch files (for example, `run_nvidia_gpu.bat`). See the [Windows Portable guide](/installation/comfyui_portable_windows) for details. + Los usuarios de **Windows Portable** pueden agregar flags a los archivos de inicio `.bat` (por ejemplo, `run_nvidia_gpu.bat`). Consulta la [guía de Windows Portable](/es/installation/comfyui_portable_windows) para obtener más detalles. -Run `python main.py --help` in your ComfyUI directory for the built-in help text. Combine multiple flags as needed: +Ejecuta `python main.py --help` en tu directorio de ComfyUI para ver el texto de ayuda integrado. Combina varios flags según sea necesario: ```bash python main.py --listen 0.0.0.0 --port 8288 --disable-auto-launch --lowvram From c8a80b4dd1968cc999ef4a31344e9d6a37a87031 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 12:56:24 +0800 Subject: [PATCH 5/5] i18n(es): point the Intel install snippet at the localized troubleshooting anchor --- snippets/es/intel-install.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snippets/es/intel-install.mdx b/snippets/es/intel-install.mdx index 7d641ad1ac..97657e4955 100644 --- a/snippets/es/intel-install.mdx +++ b/snippets/es/intel-install.mdx @@ -5,4 +5,4 @@ Las GPU Intel Arc (Arc serie A, Arc serie B y procesadores Core Ultra con Arc Gr pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu ``` -Asegúrate de que tu [controlador de GPU Intel](https://www.intel.com/content/www/us/en/developer/articles/tool/pytorch-prerequisites-for-intel-gpu.html) esté instalado y actualizado. No instales los wheels de CUDA. Si ComfyUI sigue sin detectar la GPU, consulta [solución de problemas de GPU Intel](/es/troubleshooting/overview#intel-gpu-issues). \ No newline at end of file +Asegúrate de que tu [controlador de GPU Intel](https://www.intel.com/content/www/us/en/developer/articles/tool/pytorch-prerequisites-for-intel-gpu.html) esté instalado y actualizado. No instales los wheels de CUDA. Si ComfyUI sigue sin detectar la GPU, consulta [solución de problemas de GPU Intel](/es/troubleshooting/overview#problemas-con-gpu-intel). \ No newline at end of file