From 592786d61e04985df543b54ba7d7f2a172b782a7 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 21:02:37 +0800 Subject: [PATCH 1/5] i18n: sync zh/ja/ko and es translations with upstream/main (2026-11-02) Single consolidated sync for the four published/translated locales: the per-locale daily branches had piled up into six open PRs (#2148, #2192, #2205, #2202, #2217, #2216) with 170 files between them, so they were merged here by taking the newest version of every file and re-running the gates. - zh/ja/ko: 75 files, 0 sections left pending - es: 93 files + 1 snippet, pending backlog down from 169 to 97 pages - fixed two links that pointed at English/renamed anchors (comfyui-server/api-examples.mdx, cloud/api-reference.mdx) --- docs.json | 3 + es/agent-tools/cli.mdx | 26 +- es/agent-tools/partner-mcp.mdx | 61 +-- es/comfy-cli/getting-started.mdx | 64 +-- es/custom-nodes/backend/images_and_masks.mdx | 10 +- 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 +- es/development/cloud/api-reference.mdx | 7 +- es/development/cloud/overview.mdx | 49 ++- es/development/comfy-router/api.mdx | 7 +- .../comfy-router/higgsfield-byok.mdx | 416 ++++++++++++++++++ es/development/comfy-router/limitations.mdx | 45 +- es/development/comfy-router/litellm.mdx | 16 +- es/development/comfy-router/models.mdx | 43 +- .../flux-pro-1-0-expand/code.mdx | 6 +- .../image-edit-product-virtual-tryon/code.mdx | 53 +-- .../models/fal/h3-max-turbo/code.mdx | 7 +- .../code.mdx | 8 +- .../models/kling/kling-image-o1/code.mdx | 9 +- .../recraftv4-1-utility-vector/code.mdx | 58 +-- .../models/veed/fabric-1-0/code.mdx | 13 +- .../models/veed/lipsync-2-0/code.mdx | 7 +- .../veed/video-background-removal/code.mdx | 60 +-- es/development/comfy-router/quickstart.mdx | 28 +- es/development/comfy-router/realtime.mdx | 223 ++++++++++ .../comfyui-server/api-examples.mdx | 34 +- .../comfyui-server/api-key-integration.mdx | 19 +- .../comfyui-server/startup-flags.mdx | 211 ++++----- es/development/deploy/cloud-usage.mdx | 6 +- es/development/serverless/overview.mdx | 83 ++-- es/installation/desktop/usage/manage.mdx | 27 +- es/installation/desktop/usage/migrate.mdx | 23 +- es/interface/features/subgraph.mdx | 5 +- es/interface/settings/overview.mdx | 8 +- es/registry/specifications.mdx | 56 +-- es/specs/workflow_json.mdx | 10 +- es/troubleshooting/custom-node-issues.mdx | 207 ++++----- es/troubleshooting/model-issues.mdx | 74 ++-- es/troubleshooting/overview.mdx | 161 +++---- es/tutorials/3d/hunyuan3D-2.mdx | 42 +- es/tutorials/audio/ace-step/ace-step-v1-5.mdx | 42 +- es/tutorials/audio/ace-step/ace-step-v1.mdx | 72 +-- .../audio/minimax/minimax-music-3.mdx | 41 +- es/tutorials/audio/yue2/yue2.mdx | 48 +- es/tutorials/basic/text-to-image.mdx | 116 ++--- es/tutorials/flux/flux-1-uso.mdx | 10 +- es/tutorials/flux/flux-3-klein.mdx | 69 +-- es/tutorials/image/anima/anima.mdx | 37 +- .../image/ernie-image/ernie-image.mdx | 66 +-- es/tutorials/image/hidream/hidream-e1.mdx | 61 +-- es/tutorials/image/hidream/hidream-i1.mdx | 127 +++--- es/tutorials/image/krea/krea-2.mdx | 78 ++-- es/tutorials/image/lens/lens.mdx | 31 +- es/tutorials/image/mage-flow/mage-flow.mdx | 36 +- es/tutorials/image/moss-image/moss-image.mdx | 83 ++-- es/tutorials/image/ovis/ovis-image.mdx | 2 +- es/tutorials/image/pixeldit/pixeldit.mdx | 16 +- es/tutorials/image/qwen/qwen-image-2512.mdx | 24 +- es/tutorials/image/qwen/qwen-image-edit.mdx | 24 +- .../image/qwen/qwen-image-layered.mdx | 39 +- es/tutorials/image/z-image/z-image-turbo.mdx | 42 +- es/tutorials/image/z-image/z-image.mdx | 16 +- .../black-forest-labs/flux-1-kontext.mdx | 30 +- .../bytedance/seedream-5-flash.mdx | 90 ++++ .../bytedance/seedream-5-pro.mdx | 7 +- es/tutorials/partner-nodes/google/gemini.mdx | 18 +- .../partner-nodes/ideogram/ideogram-v3.mdx | 53 +++ .../partner-nodes/luma/luma-uni-1.mdx | 77 ++-- .../partner-nodes/magnific/overview.mdx | 6 +- .../partner-nodes/openai/dall-e-2.mdx | 129 ++++++ .../partner-nodes/openai/dall-e-3.mdx | 82 ++++ es/tutorials/partner-nodes/overview.mdx | 49 ++- .../partner-nodes/pixverse/overview.mdx | 4 +- .../partner-nodes/quiver/overview.mdx | 4 +- es/tutorials/partner-nodes/topaz/overview.mdx | 8 +- .../video-enhance-starlight-precise-2-5.mdx | 6 +- .../partner-nodes/wavespeed/overview.mdx | 4 +- es/tutorials/utility/depth-anything-3.mdx | 53 +-- es/tutorials/utility/marigold-v2.mdx | 37 +- .../utility/pose-detection-sdpose.mdx | 101 ++--- es/tutorials/utility/sam3d-body.mdx | 20 +- es/tutorials/utility/seedvr2.mdx | 65 +-- es/tutorials/video/hunyuan/hunyuan-video.mdx | 80 ++-- ja/development/comfy-router/api.mdx | 5 +- ja/development/comfy-router/limitations.mdx | 14 +- .../dreamina-seedance-2-0-260128/code.mdx | 10 +- .../code.mdx | 10 +- .../dreamina-seedance-2-0-mini/code.mdx | 10 +- .../dreamina-seedance-2-5-260628/code.mdx | 10 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 10 +- .../seedance-1-0-pro-fast-251015/code.mdx | 10 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 10 +- .../models/kling/kling-3-0-turbo/code.mdx | 8 +- .../models/kling/kling-image-o1/code.mdx | 8 +- .../models/kling/kling-v2-5-turbo/code.mdx | 8 +- .../models/kling/kling-v2-6/code.mdx | 8 +- .../models/kling/kling-v3-omni/code.mdx | 8 +- .../models/kling/kling-v3/code.mdx | 8 +- .../models/kling/kling-video-o1/code.mdx | 8 +- .../kling/videos-avatar-image2video/code.mdx | 8 +- .../models/kling/videos-lip-sync/code.mdx | 6 +- .../models/runway/gen4-image/code.mdx | 6 +- .../xai/grok-imagine-image-2-0/code.mdx | 8 +- .../xai/grok-imagine-image-pro/code.mdx | 8 +- .../xai/grok-imagine-image-quality/code.mdx | 8 +- .../models/xai/grok-imagine-image/code.mdx | 8 +- ja/development/comfy-router/realtime.mdx | 223 ++++++++++ ja/development/comfy-router/reference.mdx | 20 +- ko/development/comfy-router/api.mdx | 5 +- ko/development/comfy-router/limitations.mdx | 14 +- .../dreamina-seedance-2-0-260128/code.mdx | 10 +- .../code.mdx | 10 +- .../dreamina-seedance-2-0-mini/code.mdx | 10 +- .../dreamina-seedance-2-5-260628/code.mdx | 10 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 10 +- .../seedance-1-0-pro-fast-251015/code.mdx | 10 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 10 +- .../models/kling/kling-3-0-turbo/code.mdx | 8 +- .../models/kling/kling-image-o1/code.mdx | 8 +- .../models/kling/kling-v2-5-turbo/code.mdx | 8 +- .../models/kling/kling-v2-6/code.mdx | 8 +- .../models/kling/kling-v3-omni/code.mdx | 8 +- .../models/kling/kling-v3/code.mdx | 8 +- .../models/kling/kling-video-o1/code.mdx | 8 +- .../kling/videos-avatar-image2video/code.mdx | 8 +- .../models/kling/videos-lip-sync/code.mdx | 6 +- .../models/runway/gen4-image/code.mdx | 6 +- .../xai/grok-imagine-image-2-0/code.mdx | 8 +- .../xai/grok-imagine-image-pro/code.mdx | 8 +- .../xai/grok-imagine-image-quality/code.mdx | 8 +- .../models/xai/grok-imagine-image/code.mdx | 8 +- ko/development/comfy-router/realtime.mdx | 223 ++++++++++ ko/development/comfy-router/reference.mdx | 20 +- snippets/es/intel-install.mdx | 2 +- zh/development/comfy-router/api.mdx | 5 +- zh/development/comfy-router/limitations.mdx | 14 +- .../dreamina-seedance-2-0-260128/code.mdx | 10 +- .../code.mdx | 10 +- .../dreamina-seedance-2-0-mini/code.mdx | 10 +- .../dreamina-seedance-2-5-260628/code.mdx | 10 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 10 +- .../seedance-1-0-pro-fast-251015/code.mdx | 10 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 10 +- .../models/kling/kling-3-0-turbo/code.mdx | 8 +- .../models/kling/kling-image-o1/code.mdx | 8 +- .../models/kling/kling-v2-5-turbo/code.mdx | 8 +- .../models/kling/kling-v2-6/code.mdx | 8 +- .../models/kling/kling-v3-omni/code.mdx | 8 +- .../models/kling/kling-v3/code.mdx | 8 +- .../models/kling/kling-video-o1/code.mdx | 8 +- .../kling/videos-avatar-image2video/code.mdx | 8 +- .../models/kling/videos-lip-sync/code.mdx | 6 +- .../models/runway/gen4-image/code.mdx | 6 +- .../xai/grok-imagine-image-2-0/code.mdx | 8 +- .../xai/grok-imagine-image-pro/code.mdx | 8 +- .../xai/grok-imagine-image-quality/code.mdx | 8 +- .../models/xai/grok-imagine-image/code.mdx | 8 +- zh/development/comfy-router/realtime.mdx | 223 ++++++++++ zh/development/comfy-router/reference.mdx | 20 +- 170 files changed, 3945 insertions(+), 2237 deletions(-) create mode 100644 es/development/comfy-router/higgsfield-byok.mdx create mode 100644 es/development/comfy-router/realtime.mdx create mode 100644 es/tutorials/partner-nodes/bytedance/seedream-5-flash.mdx create mode 100644 es/tutorials/partner-nodes/ideogram/ideogram-v3.mdx create mode 100644 es/tutorials/partner-nodes/openai/dall-e-2.mdx create mode 100644 es/tutorials/partner-nodes/openai/dall-e-3.mdx create mode 100644 ja/development/comfy-router/realtime.mdx create mode 100644 ko/development/comfy-router/realtime.mdx create mode 100644 zh/development/comfy-router/realtime.mdx diff --git a/docs.json b/docs.json index adeab7e429..ba584cd2a3 100644 --- a/docs.json +++ b/docs.json @@ -7487,6 +7487,7 @@ "zh/development/comfy-router/queue", "zh/development/comfy-router/errors", "zh/development/comfy-router/billing", + "zh/development/comfy-router/realtime", "zh/development/comfy-router/headers", "zh/development/comfy-router/reference", "zh/development/comfy-router/limitations", @@ -11556,6 +11557,7 @@ "ja/development/comfy-router/queue", "ja/development/comfy-router/errors", "ja/development/comfy-router/billing", + "ja/development/comfy-router/realtime", "ja/development/comfy-router/headers", "ja/development/comfy-router/reference", "ja/development/comfy-router/limitations", @@ -15555,6 +15557,7 @@ "ko/development/comfy-router/queue", "ko/development/comfy-router/errors", "ko/development/comfy-router/billing", + "ko/development/comfy-router/realtime", "ko/development/comfy-router/headers", "ko/development/comfy-router/reference", "ko/development/comfy-router/limitations", 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/agent-tools/partner-mcp.mdx b/es/agent-tools/partner-mcp.mdx index 80ff8c6744..928febb6aa 100644 --- a/es/agent-tools/partner-mcp.mdx +++ b/es/agent-tools/partner-mcp.mdx @@ -3,16 +3,19 @@ title: "Comfy Partner MCP" description: "Servidor MCP local con herramientas de generación unificadas para más de 30 proveedores socios (BFL, Ideogram, Kling, Runway, Veo, Meshy, ElevenLabs y más)." sidebarTitle: "Partner MCP" icon: "plug" -translationSourceHash: 9ea0ad19 +translationSourceHash: ecf72ee2 translationFrom: agent-tools/partner-mcp.mdx translationBlockHashes: "_intro": a7191a40 "Requirements": 1596caad "Installation": 389df01f + "Configuration": 9773ba00 "Environment Variables": adce61c2 "Available Tools": 9dc9a92d + "Example Prompts": 8c35cf5b "Related": 6f4e604e --- + **Vista previa privada: aún no disponible al público.** El servidor MCP de Comfy Partner está actualmente en pruebas privadas. Las funciones y las API pueden cambiar. El acceso está limitado a los socios invitados. @@ -21,9 +24,9 @@ Comfy Partner MCP es un servidor MCP local que proporciona a los agentes de IA h **Funciones principales:** - 🎨 **6 modalidades de generación**: imagen, video, 3D, SVG, audio y música -- 🔌 **Más de 30 proveedores** en una sola interfaz -- 💻 **Servidor local**: se ejecuta en tu máquina y se conecta a la API de Comfy -- 🔍 **Buscar modelos integrado** con búsqueda de texto BM25 +- 🔌 **Más de 30 proveedores** bajo una sola interfaz +- 💻 **Servidor local**: se ejecuta en tu equipo y se conecta a la API de Comfy +- 🔍 **Búsqueda de modelos integrada** con búsqueda de texto BM25 - 🧩 **Compatible de forma directa** con Claude Desktop, Claude Code y Amp --- @@ -45,13 +48,13 @@ pnpm install pnpm build ``` -Después de compilar, el lanzador del servidor MCP está en `packages/mcp/dist/bin.js`. +Después de compilar, el lanzador del servidor MCP se encuentra en `packages/mcp/dist/bin.js`. --- ## Configuración -Añade el servidor a la configuración de tu cliente MCP. El mismo formato JSON funciona en Claude Desktop, Claude Code y Amp: +Agrega el servidor a la configuración de tu cliente MCP. El mismo formato JSON funciona en Claude Desktop, Claude Code y Amp: ```json { @@ -67,17 +70,17 @@ Añade el servidor a la configuración de tu cliente MCP. El mismo formato JSON } ``` -**Ubicaciones de la configuración del cliente:** +**Ubicaciones de configuración del cliente:** | Cliente | Archivo de configuración | |--------|-------------| | Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) / `%APPDATA%/Claude/claude_desktop_config.json` (Windows) | -| Claude Code | `~/.claude/mcp.json` (or run `claude mcp add`) | -| Amp | Settings → MCP Servers, o `~/.config/amp/settings.json` | +| Claude Code | `~/.claude/mcp.json` (o ejecuta `claude mcp add`) | +| Amp | Configuraciones → MCP Servers, o `~/.config/amp/settings.json` | -Después de añadir la configuración, reinicia tu cliente MCP. Deberías ver **10 herramientas** registradas en el servidor `comfy-partner`. +Después de agregar la configuración, reinicia tu cliente MCP. Deberías ver **10 herramientas** registradas en el servidor `comfy-partner`. -Para comprobar que el servidor arranca correctamente antes de conectarlo a un cliente, ejecútalo directamente: debería imprimir el handshake JSON-RPC y después quedarse inactivo: +Para verificar que el servidor inicia correctamente antes de conectarlo a un cliente, ejecútalo directamente: debería imprimir el handshake JSON-RPC y luego quedar inactivo: ```bash COMFY_API_KEY=comfyui-... node /ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js @@ -90,34 +93,34 @@ COMFY_API_KEY=comfyui-... node /ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/b | Variable | Requerido | Propósito | |----------|----------|---------| | `COMFY_API_KEY` | sí | Clave API (`comfyui-…`). Se envía como cabecera `X-API-Key`. | -| `COMFY_API_BASE_URL` | no | Sobrescribe el host del proxy (de forma predeterminada, la API de Comfy de producción). | -| `COMFY_INLINE_LIMIT_KB` | no | Límite (KB) para la inclusión en línea de los bytes de imagen en los resultados de la herramienta. Predeterminado: `600`. | -| `COMFY_MCP_RESOURCE_LINKS` | no | Fuerza la activación o desactivación de los bloques de contenido `resource_link`. De forma predeterminada, usa una lista de permitidos (`claude-*`, `mcp-inspector`). | +| `COMFY_API_BASE_URL` | no | Sobrescribe el host del proxy (por defecto, la API de producción de Comfy). | +| `COMFY_INLINE_LIMIT_KB` | no | Límite (KB) para insertar los bytes de imagen directamente en los resultados de las herramientas. Por defecto, `600`. | +| `COMFY_MCP_RESOURCE_LINKS` | no | Fuerza la activación o desactivación de los bloques de contenido `resource_link`. Por defecto, una lista de permitidos (`claude-*`, `mcp-inspector`). | --- ## Herramientas disponibles -El servidor MCP expone **10 herramientas**. Después de una instalación correcta, tu cliente MCP debería mostrar las 10 registradas en el servidor `comfy-partner`. +El servidor MCP expone **10 herramientas**. Después de una instalación correcta, tu cliente MCP debería mostrar las 10 registradas bajo el servidor `comfy-partner`. | Herramienta | Descripción | |------|-------------| -| `generate_image` | Generar imágenes fijas: texto a imagen, edición o upscale | -| `generate_video` | Generar clips de video: texto a video, imagen a video o sincronización labial | -| `generate_3d` | Generar mallas 3D (GLB/FBX/OBJ) a partir de texto o una imagen de referencia | -| `generate_svg` | Generar ilustraciones vectoriales SVG a partir de un prompt de texto | -| `generate_audio` | Generar voz, clones de voz o efectos de sonido a partir de texto | -| `generate_music` | Generar música instrumental o vocal a partir de un prompt | -| `media_upload` | Subir un archivo (imagen/video/audio) y obtener una referencia `media:` para usar en llamadas `generate_*` | -| `read_media` | Obtener y renderizar un artefacto multimedia insertado: acepta una URL HTTPS o un token `media:…` | -| `models_explore` | Descubrir modelos, buscar por capacidad y consultar la forma completa de llamada de un modelo | -| `balance` | Obtener el saldo restante de la cuenta actual en USD | +| `generate_image` | Genera imágenes fijas: texto a imagen, edición o upscale | +| `generate_video` | Genera clips de video: texto a video, imagen a video o lipsync | +| `generate_3d` | Genera mallas 3D (GLB/FBX/OBJ) a partir de texto o de una imagen de referencia | +| `generate_svg` | Genera ilustraciones vectoriales SVG a partir de un prompt de texto | +| `generate_audio` | Genera voz, clones de voz o efectos de sonido a partir de texto | +| `generate_music` | Genera música instrumental o vocal a partir de un prompt | +| `media_upload` | Sube un archivo (imagen, video o audio) y obtén una referencia `media:` para usarla en llamadas `generate_*` | +| `read_media` | Obtiene y renderiza un artefacto multimedia en línea: acepta una URL HTTPS o un token `media:…` | +| `models_explore` | Descubre modelos, busca por capacidad y consulta la forma completa de llamada de un modelo | +| `balance` | Obtiene el saldo restante de la cuenta actual en USD | --- -## Prompts de ejemplo +## Ejemplos de prompts -Una vez instalado, prueba estos en tu asistente de IA: +Después de instalar, prueba lo siguiente en tu asistente de IA: ``` Generate an image of a cat astronaut floating in space, photorealistic style @@ -139,5 +142,5 @@ Generate music with a calm, lo-fi vibe, about 30 seconds long ## Relacionado -- [Comfy Cloud MCP](/es/agent-tools/mcp): Servidor MCP alojado para la ejecución de flujos de trabajo en Comfy Cloud -- [CLI de Comfy Partner Nodes](/es/comfy-cli/reference#generar-nodos-asociados-beta): Usa los Nodos asociados desde la línea de comandos +- [Comfy Cloud MCP](/es/agent-tools/mcp): servidor MCP alojado para la ejecución de flujos de trabajo de Comfy Cloud +- [Comfy Partner Nodes CLI](/es/comfy-cli/reference#generar-nodos-asociados-beta): usa nodos asociados desde la línea de comandos 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/custom-nodes/backend/images_and_masks.mdx b/es/custom-nodes/backend/images_and_masks.mdx index 238cb85b2f..5768cfcf46 100644 --- a/es/custom-nodes/backend/images_and_masks.mdx +++ b/es/custom-nodes/backend/images_and_masks.mdx @@ -1,8 +1,8 @@ --- title: "Imágenes, latentes y máscaras" -description: "Domina el manejo de datos de imágenes y máscaras en el backend de nodos personalizados de Comfy: formas de tensores de PyTorch, conversiones PIL y latentes." +description: "Domina el manejo de datos en el backend de Comfy: tensores de PyTorch, conversiones PIL y latentes para imágenes y máscaras." sidebarTitle: "Imágenes, latentes y máscaras" -translationSourceHash: 08596871 +translationSourceHash: 4521b4f6 translationFrom: custom-nodes/backend/images_and_masks.mdx --- @@ -10,7 +10,7 @@ Cuando trabajes con estos tipos de datos, necesitarás conocer la clase `torch.T La documentación completa está [aquí](https://pytorch.org/docs/stable/tensors.html), o una introducción a los conceptos clave requeridos para Comfy [aquí](./tensors). -Si tu nodo tiene una sola salida que es un tensor, recuerda devolver `(image,)` no `(image)` +Si tu nodo tiene una sola salida que es un tensor, recuerda devolver `(image,)` y no `(image)` La mayoría de los conceptos a continuación se ilustran en los [fragmentos de código de ejemplo](./snippets). @@ -50,8 +50,8 @@ Para usar una MASK, a menudo tendrás que igualar las formas añadiendo dimensio Para añadir la dimensión `C`, debes usar `unsqueeze(-1)`; para añadir `B`, usas `unsqueeze(0)`. Si tu nodo recibe una MASK como entrada, sería prudente que siempre revises `len(mask.shape)`. -## Latents +## Latentes -Un LATENT es un `dict`; la muestra de latent se referencia con la clave `samples` y tiene forma `[B,C,H,W]`, con `C=4`. +Un LATENT es un `dict`; la muestra del latente se referencia con la clave `samples` y tiene forma `[B,C,H,W]`, con `C=4`. LATENT tiene el canal primero, IMAGE tiene el canal al final \ No newline at end of file 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. diff --git a/es/development/cloud/api-reference.mdx b/es/development/cloud/api-reference.mdx index ff2e77f9bc..d332f5d8ca 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#límites-de-simultaneidad) para ver los detalles. ### Enviar flujo de trabajo 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/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/higgsfield-byok.mdx b/es/development/comfy-router/higgsfield-byok.mdx new file mode 100644 index 0000000000..910a4a4b85 --- /dev/null +++ b/es/development/comfy-router/higgsfield-byok.mdx @@ -0,0 +1,416 @@ +--- +title: "Usa tu clave API de Higgsfield en Comfy Router" +sidebarTitle: "Higgsfield (tu clave)" +description: "Usa tu clave de Higgsfield en Comfy Router: las generaciones se facturan a tu cuenta de Higgsfield, no a tus créditos de Comfy, desde el mismo endpoint." +translationSourceHash: b38d2e4c +translationFrom: development/comfy-router/higgsfield-byok.mdx +translationBlockHashes: + "_intro": 5cc171ab + "What changes when you bring a key": d6506a33 + "Models": de45668e + "Reading the result": 1ccba71b + "Notes": 240c8b8e +--- +Higgsfield está [llevando a cabo una promoción de cashback sobre el gasto en API](https://higgsfield.ai). No vamos a intentar convencerte de lo contrario. + +Trae tu propia clave de Higgsfield a Comfy Router y tus generaciones se ejecutan en **tu** cuenta de Higgsfield, así que cuentan como tu gasto en Higgsfield, y lo que esa promoción valga para ti es tuyo. Aun así obtienes un solo endpoint, un solo cliente y la misma forma de solicitud que con cualquier otro modelo en Router. + + + Higgsfield es dueño de la promoción y de sus términos. Consulta la oferta vigente en su sitio antes de hacer planes en función de ella. + + +## Qué cambia al usar tu propia clave + +| | Tu clave de Comfy | Tu clave de Higgsfield | +| --- | --- | --- | +| Se factura a | Tus créditos de Comfy | Tu cuenta de Higgsfield | +| Créditos de Comfy cobrados | Sí | **Ninguno** | +| Endpoint, cuerpo de la solicitud y respuesta | Igual | Igual | + +Todo lo demás de la llamada es idéntico. No cambias tu código para hacer el cambio: guardas una clave y Router la usa. + + + + Crea una clave en tu [cuenta de Higgsfield](https://higgsfield.ai). Higgsfield la emite como un **par de id y secreto**, y Comfy la almacena como la única cadena `id:secret`: conserva los dos puntos y no la dividas en dos campos. + + + + Abre [**Claves de proveedor**](https://platform.comfy.org/profile/provider-keys) en tu perfil de Comfy, elige **Higgsfield** y pega el valor `id:secret`. + + Tu clave está cifrada en reposo y la API nunca la devuelve una vez guardada. Router solo la lee para firmar tus propias llamadas. + + + + Esta es la clave que te autentica en Comfy, separada de la de Higgsfield. Créala en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys) y luego configura: + + ```bash + export COMFY_API_KEY="comfyui-..." + ``` + + Mantén las claves API en tu servidor o en tu entorno local. Estos ejemplos son para una terminal o un servidor, no para JavaScript en el navegador. + + + + Copia y pega uno de los fragmentos de código de abajo para el modelo seleccionado. + + + +## Modelos + + + Equilibrio entre calidad y velocidad. `duration` acepta de 3 a 15 segundos. + + + + ```bash cURL + curl --max-time 660 \ + https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-std \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise", + "duration": 5, + "aspect_ratio": "16:9", + "cfg_scale": 0.5, + "sound": "on" + }' + ``` + + ```python Python + # Python 3.10+ + # Instalar: python -m pip install "comfy-sdk>=0.3.0" + + from comfy_sdk import Comfy + + # Comfy lee COMFY_API_KEY del entorno. + with Comfy() as client: + result = client.models.run( + "higgsfield/higgsfield-kling-3-std", + { + "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise", + "duration": 5, + "aspect_ratio": "16:9", + "cfg_scale": 0.5, + "sound": "on", + }, + timeout=660.0, + ) + + print("video:", result["video"]["url"]) + ``` + + ```typescript TypeScript + // Node.js 22+ + // Instalar: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx + + import { comfy } from "@comfyorg/sdk"; + + type HiggsfieldResult = { video: { url: string } }; + + const { data } = await comfy.models.run( + "higgsfield/higgsfield-kling-3-std", + { + prompt: "A cinematic glass pavilion in a misty pine forest at sunrise", + duration: 5, + aspect_ratio: "16:9", + cfg_scale: 0.5, + sound: "on", + }, + { timeoutMs: 660_000 }, + ); + + console.log("video:", data.video.url); + ``` + + + + Mayor fidelidad que `std`, mismo cuerpo. `duration` acepta de 3 a 15 segundos. + + + + ```bash cURL + curl --max-time 660 \ + https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-pro \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise", + "duration": 5, + "aspect_ratio": "16:9", + "cfg_scale": 0.5, + "sound": "on" + }' + ``` + + ```python Python + # Python 3.10+ + # Instalar: python -m pip install "comfy-sdk>=0.3.0" + + from comfy_sdk import Comfy + + with Comfy() as client: + result = client.models.run( + "higgsfield/higgsfield-kling-3-pro", + { + "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise", + "duration": 5, + "aspect_ratio": "16:9", + "cfg_scale": 0.5, + "sound": "on", + }, + timeout=660.0, + ) + + print("video:", result["video"]["url"]) + ``` + + ```typescript TypeScript + // Node.js 22+ + // Instalar: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx + + import { comfy } from "@comfyorg/sdk"; + + type HiggsfieldResult = { video: { url: string } }; + + const { data } = await comfy.models.run( + "higgsfield/higgsfield-kling-3-pro", + { + prompt: "A cinematic glass pavilion in a misty pine forest at sunrise", + duration: 5, + aspect_ratio: "16:9", + cfg_scale: 0.5, + sound: "on", + }, + { timeoutMs: 660_000 }, + ); + + console.log("video:", data.video.url); + ``` + + + + El nivel 4K, con el mismo cuerpo que `std` y `pro`. `duration` acepta un rango de 3–15 segundos. + + + + ```bash cURL + curl --max-time 660 \ + https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-4k \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise", + "duration": 5, + "aspect_ratio": "16:9", + "cfg_scale": 0.5, + "sound": "on" + }' + ``` + + ```python Python + # Python 3.10+ + # Instalar: python -m pip install "comfy-sdk>=0.3.0" + + from comfy_sdk import Comfy + + with Comfy() as client: + result = client.models.run( + "higgsfield/higgsfield-kling-3-4k", + { + "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise", + "duration": 5, + "aspect_ratio": "16:9", + "cfg_scale": 0.5, + "sound": "on", + }, + timeout=660.0, + ) + + print("video:", result["video"]["url"]) + ``` + + ```typescript TypeScript + // Node.js 22+ + // Instalar: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx + + import { comfy } from "@comfyorg/sdk"; + + type HiggsfieldResult = { video: { url: string } }; + + const { data } = await comfy.models.run( + "higgsfield/higgsfield-kling-3-4k", + { + prompt: "A cinematic glass pavilion in a misty pine forest at sunrise", + duration: 5, + aspect_ratio: "16:9", + cfg_scale: 0.5, + sound: "on", + }, + { timeoutMs: 660_000 }, + ); + + console.log("video:", data.video.url); + ``` + + + + El nivel más rápido de Kling. Su cuerpo lleva `resolution` en lugar de `cfg_scale` y `sound`. `duration` acepta de 3 a 15 segundos. + + + + ```bash cURL + curl --max-time 660 \ + https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-turbo \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise", + "duration": 5, + "aspect_ratio": "16:9", + "resolution": "720p" + }' + ``` + + ```python Python + # Python 3.10+ + # Instalar: python -m pip install "comfy-sdk>=0.3.0" + + from comfy_sdk import Comfy + + with Comfy() as client: + result = client.models.run( + "higgsfield/higgsfield-kling-3-turbo", + { + "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise", + "duration": 5, + "aspect_ratio": "16:9", + "resolution": "720p", + }, + timeout=660.0, + ) + + print("video:", result["video"]["url"]) + ``` + + ```typescript TypeScript + // Node.js 22+ + // Instalar: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx + + import { comfy } from "@comfyorg/sdk"; + + type HiggsfieldResult = { video: { url: string } }; + + const { data } = await comfy.models.run( + "higgsfield/higgsfield-kling-3-turbo", + { + prompt: "A cinematic glass pavilion in a misty pine forest at sunrise", + duration: 5, + aspect_ratio: "16:9", + resolution: "720p", + }, + { timeoutMs: 660_000 }, + ); + + console.log("video:", data.video.url); + ``` + + + + Referencia a video: pasa imágenes o clips de referencia y describe cómo usarlos. `duration` acepta hasta 30 segundos. + + + + ```bash cURL + curl --max-time 660 \ + https://api.comfy.org/v2/models/higgsfield/higgsfield-wan-3 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "prompt": "Use Image 1 for the character and Video 1 for the camera movement", + "image_urls": ["https://cdn.example.com/character.jpg"], + "video_urls": ["https://cdn.example.com/camera-reference.mp4"], + "duration": 8, + "resolution": "1080p", + "aspect_ratio": "adaptive", + "generate_audio": true + }' + ``` + + ```python Python + # Python 3.10+ + # Instalar: python -m pip install "comfy-sdk>=0.3.0" + + from comfy_sdk import Comfy + + with Comfy() as client: + result = client.models.run( + "higgsfield/higgsfield-wan-3", + { + "prompt": "Use Image 1 for the character and Video 1 for the camera movement", + "image_urls": ["https://cdn.example.com/character.jpg"], + "video_urls": ["https://cdn.example.com/camera-reference.mp4"], + "duration": 8, + "resolution": "1080p", + "aspect_ratio": "adaptive", + "generate_audio": True, + }, + timeout=660.0, + ) + + print("video:", result["video"]["url"]) + ``` + + ```typescript TypeScript + // Node.js 22+ + // Instalar: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx + + import { comfy } from "@comfyorg/sdk"; + + type HiggsfieldResult = { video: { url: string } }; + + const { data } = await comfy.models.run( + "higgsfield/higgsfield-wan-3", + { + prompt: "Use Image 1 for the character and Video 1 for the camera movement", + image_urls: ["https://cdn.example.com/character.jpg"], + video_urls: ["https://cdn.example.com/camera-reference.mp4"], + duration: 8, + resolution: "1080p", + aspect_ratio: "adaptive", + generate_audio: true, + }, + { timeoutMs: 660_000 }, + ); + + console.log("video:", data.video.url); + ``` + + + + + +## Leer el resultado + +`run` devuelve el documento terminal propio de Higgsfield. La URL de descarga está en `video.url`: + +```json +{ + "status": "completed", + "request_id": "0c4a9e17-5b82-4d66-9a3f-7c1e08b45d29", + "video": { "url": "https://example.com/generated.mp4" } +} +``` + +Guárdalo de inmediato: + +```bash +curl --fail --location "PASTE_VIDEO_URL_HERE" --output out.mp4 +``` + +El Router consulta Higgsfield por ti, así que `queued` y `in_progress` nunca te llegan: recibes el documento finalizado o un error. `nsfw`, `failed` y `canceled` son los fallos terminales; `failed` incluye los detalles en `error`. + +## Notas + +- **La validación ocurre antes de llamar a Higgsfield.** Un cuerpo fuera de los límites publicados devuelve `422` con el campo infractor señalado, y no se envía nada al proveedor, así que una solicitud incorrecta no te cuesta nada. +- **Tu clave se usa solo para los modelos para los que tienes una clave.** Guardar una clave de Higgsfield no cambia nada acerca de cómo se factura cualquier otro proveedor en Router. +- Los esquemas completos de solicitud y respuesta de cada modelo están en la [Referencia de Comfy Router](/es/development/comfy-router/reference). diff --git a/es/development/comfy-router/limitations.mdx b/es/development/comfy-router/limitations.mdx index f4326aafa5..a2e4ab0bb5 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. -### Las imágenes de referencia de Krea 3 deben subirse primero +### 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. + +- **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/litellm.mdx b/es/development/comfy-router/litellm.mdx index 1bf583855a..097381ddec 100644 --- a/es/development/comfy-router/litellm.mdx +++ b/es/development/comfy-router/litellm.mdx @@ -2,16 +2,17 @@ title: "Usar Comfy Router con LiteLLM" sidebarTitle: "LiteLLM" description: "Coloca Comfy Router detrás de LiteLLM Proxy como un endpoint pass-through y registra el costo exacto en USD de cada ejecución a partir del encabezado x-litellm-response-cost, sin ninguna tabla de precios que mantener." -translationSourceHash: e35cd883 +translationSourceHash: 71f7e7b3 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 4a9dcb84 "Queued delivery": 46044c93 "Notes": 50e3cf6b --- + Si ya haces seguimiento del gasto con [LiteLLM Proxy](https://docs.litellm.ai/docs/proxy/pass_through), puedes añadir Comfy Router como un endpoint pass-through más. Quien llama conserva sus claves de LiteLLM, y tu clave API de Comfy se queda en el proxy. Router informa en dólares estadounidenses cuánto costó una ejecución, en el encabezado de respuesta `x-litellm-response-cost` (en la respuesta de la ejecución cuando es síncrona, y en la recogida del resultado cuando está [en cola](#entrega-en-cola)), para los modelos que informan un precio en créditos de Comfy por ejecución (consulta [Ejecuciones que no informan un costo](#ejecuciones-que-no-informan-un-costo)). LiteLLM lee ese encabezado en cada respuesta pass-through y lo registra como el gasto de la solicitud, así que no tienes que mantener una tabla de precios para esos modelos. @@ -97,16 +98,17 @@ Igual que con `X-Comfy-Credits-Used`, el encabezado informa un precio y no un ca ### Ejecuciones que no informan un costo -Algunas ejecuciones no llevan `x-litellm-response-cost`. Falta en los mismos casos que `X-Comfy-Credits-Used`: +Algunas ejecuciones no llevan `x-litellm-response-cost`. En la mayoría de estos casos, `X-Comfy-Credits-Used` también está ausente: -- una ejecución facturada a tu propia clave de proveedor y no a tus créditos de Comfy +- una ejecución facturada a tu propia clave de proveedor en lugar de a tus créditos de Comfy - un modelo que todavía no está en la lista de Router de modelos que informan un precio en créditos por ejecución. Esa lista es conservadora, y algunos proveedores no aparecen en ella en absoluto - un cargo que no llegó a la facturación de Comfy -- una respuesta de error -También falta cuando Router reproduce un resultado almacenado para un reintento con la misma `Idempotency-Key` (enviada a través del proxy como `x-pass-Idempotency-Key`). Ese reintento no se cobra de nuevo, así que la reproducción no informa por segunda vez el costo exacto de la ejecución. Por la misma razón, solo una recogida del resultado de una ejecución en cola lo lleva, la primera después de que se registre el precio de la ejecución; recoger el mismo resultado otra vez sigue devolviendo `X-Comfy-Credits-Used`, pero no `x-litellm-response-cost`. +Un caso es distinto: una respuesta de error. Una respuesta síncrona de `content_policy_violation` de un modelo cuyo `billing.charges_on_policy_rejection` es `yes` puede llevar `X-Comfy-Credits-Used` con el uso que Comfy registró para la generación rechazada; ni siquiera entonces lleva `x-litellm-response-cost`, porque un error no es un resultado que LiteLLM deba contabilizar. + +También está ausente cuando Router reproduce un resultado almacenado para un reintento con la misma `Idempotency-Key` (enviada a través del proxy como `x-pass-Idempotency-Key`). Ese reintento no se cobra de nuevo, así que la reproducción no informa por segunda vez el costo exacto de la ejecución. Por la misma razón, solo una recogida del resultado de una ejecución en cola lo lleva, la primera después de que se registre el precio de la ejecución; recoger el mismo resultado otra vez sigue devolviendo `X-Comfy-Credits-Used`, pero no `x-litellm-response-cost`. -Cuando el encabezado falta, LiteLLM recurre al `cost_per_request` del endpoint. Eso se aplica a todos los casos anteriores. Las respuestas de error, las ejecuciones facturadas a tu propia clave de proveedor y las reproducciones idempotentes se registran por tanto con tu estimación, aunque Comfy no haya cobrado tus créditos por ellas. Defínelo con una estimación razonable de tu ejecución típica en lugar de `0`, para que una ejecución que no informa un costo no aparezca como gratuita en tus informes de gasto, y cuenta con que esas filas empujen los totales de LiteLLM por encima de tu factura de Comfy. Una ejecución con precio que realmente no costó nada informa `x-litellm-response-cost: 0`, que LiteLLM registra como cero. +Cuando el encabezado falta, LiteLLM recurre al `cost_per_request` del endpoint. Eso se aplica a todos los casos anteriores. Por tanto, las respuestas de error, las ejecuciones facturadas a tu propia clave de proveedor y las reproducciones idempotentes se registran con tu estimación. La mayoría de ellas no se cobraron a tus créditos, pero no todas: un rechazo por políticas de contenido que lleva `X-Comfy-Credits-Used` sí tenía precio, así que lee su costo en ese encabezado, y algunos otros fallos, como una generación que Router no pudo devolverte, se pueden facturar sin informar un costo. Concilia con los registros de uso de tu espacio de trabajo. Defínelo con una estimación razonable de tu ejecución típica en lugar de `0`, para que una ejecución que no informa un costo no aparezca como gratuita en tus informes de gasto, y cuenta con que esas filas empujen los totales de LiteLLM por encima de tu factura de Comfy. Una ejecución con precio que realmente no costó nada informa `x-litellm-response-cost: 0`, que LiteLLM registra como cero. ## Entrega en cola diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index 947bed39b8..96b3123784 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -2,18 +2,18 @@ title: "Modelos de Comfy Router" sidebarTitle: "Todos los modelos" description: "Todos los modelos disponibles en Comfy Router, agrupados por proveedor, con su modalidad de entrada y salida." -translationSourceHash: f12be9e4 +translationSourceHash: d2265d41 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9b1b4039 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 "BytePlus": 0ff87da0 "Elevenlabs": 7d6dbcc6 - "fal": 00f4c6b2 + "fal": 63e65674 "Freepik": 51b8af46 "Gemini Interactions": ca46b908 "Google": 4932820b @@ -23,12 +23,12 @@ translationBlockHashes: "Kling": 3002befa "Krea": 16b83e5e "LTX": 32595bf9 - "Luma": 37a12a19 + "Luma": 8cd2a7ce "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 - "OpenAI": c5c4af80 + "OpenAI": a5c1e692 "Openrouter": a4f6806b "Pika": f2b1d797 "Pruna": 903d76ee @@ -43,6 +43,7 @@ translationBlockHashes: "WaveSpeed": be89e7f0 "xAI": e1706271 --- + {/* ARCHIVO GENERADO. Generado a partir del catálogo del Router por `pnpm code-pages:gen`. */} Todos los modelos que aparecen a continuación se sirven por la misma ruta, `POST /v2/models/{provider}/{model}`, con el cuerpo JSON propio del modelo. Cada página muestra una solicitud funcional en Python, TypeScript y cURL. Para descubrimiento, esquemas, errores, reintentos y facturación, consulta [Usar la API de Comfy Router](/es/development/comfy-router/api). @@ -52,7 +53,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta ## Buscar por salida - + - [SwitchX](/es/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [FLUX 3 Video](/es/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` @@ -88,8 +89,6 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [LTX 2.5 Fast](/es/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/es/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [Ray 3.2](/es/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` -- [Ray 2](/es/development/comfy-router/models/luma/ray-2/code): `luma/ray-2` -- [Ray Flash 2](/es/development/comfy-router/models/luma/ray-flash-2/code): `luma/ray-flash-2` - [MiniMax H3](/es/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` - [Image To Video](/es/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` - [Text To Video](/es/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` @@ -134,7 +133,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Grok Imagine Video](/es/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/es/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/es/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -197,7 +196,6 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Photon 1](/es/development/comfy-router/models/luma/photon-1/code): `luma/photon-1` - [Photon Flash 1](/es/development/comfy-router/models/luma/photon-flash-1/code): `luma/photon-flash-1` - [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` -- [GPT Image 1](/es/development/comfy-router/models/openai/gpt-image-1/code): `openai/gpt-image-1` - [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` - [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` @@ -275,7 +273,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Wan 3.0 Video](/es/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` - + - [Animations](/es/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/es/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` @@ -289,7 +287,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Hunyuan 3D Uv](/es/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/es/development/comfy-router/models/anthropic/claude-fable-5-1/code): `anthropic/claude-fable-5-1` - [Claude Fable 5](/es/development/comfy-router/models/anthropic/claude-fable-5/code): `anthropic/claude-fable-5` @@ -318,7 +316,6 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Nano Banana 2](/es/development/comfy-router/models/google/nano-banana-2/code): `vertexai/gemini-3.1-flash-image` - [Nano Banana Pro](/es/development/comfy-router/models/google/nano-banana-pro/code): `vertexai/gemini-3-pro-image` - [GPT 4.1 Mini](/es/development/comfy-router/models/openai/gpt-4-1-mini/code): `openai/gpt-4.1-mini` -- [GPT 4.1 Nano](/es/development/comfy-router/models/openai/gpt-4-1-nano/code): `openai/gpt-4.1-nano` - [GPT 4.1](/es/development/comfy-router/models/openai/gpt-4-1/code): `openai/gpt-4.1` - [GPT 4o](/es/development/comfy-router/models/openai/gpt-4o/code): `openai/gpt-4o` - [GPT 5.5 Pro](/es/development/comfy-router/models/openai/gpt-5-5-pro/code): `openai/gpt-5.5-pro` @@ -332,10 +329,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [GPT 6 Astra](/es/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/es/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` - [GPT 6 Sol](/es/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` -- [o1-pro](/es/development/comfy-router/models/openai/o1-pro/code): `openai/o1-pro` -- [o1](/es/development/comfy-router/models/openai/o1/code): `openai/o1` - [o3](/es/development/comfy-router/models/openai/o3/code): `openai/o3` -- [o4-mini](/es/development/comfy-router/models/openai/o4-mini/code): `openai/o4-mini` - [Chat Completions](/es/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions` @@ -447,7 +441,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [Crystal Upscaler](/es/development/comfy-router/models/fal/crystal-upscaler/code) | `fal/crystal-upscaler` | Imagen | Imagen | | [Crystal Video Upscaler](/es/development/comfy-router/models/fal/crystal-video-upscaler/code) | `fal/crystal-video-upscaler` | Video | Video | | [FLUX 3 Max](/es/development/comfy-router/models/fal/flux-3-max/code) | `fal/flux-3-max` | Texto, Imagen | Video + Audio | -| [H3 Max Turbo](/es/development/comfy-router/models/fal/h3-max-turbo/code) | `fal/h3-max-turbo` | Texto, Imagen | Video + Audio | +| [H3 Max Turbo](/es/development/comfy-router/models/fal/h3-max-turbo/code) | `fal/h3-max-turbo` | Texto, Imagen, Video, Audio | Video + Audio | | [H3 Max](/es/development/comfy-router/models/fal/h3-max/code) | `fal/h3-max` | Texto, Imagen, Video, Audio | Video + Audio | | [Patina](/es/development/comfy-router/models/fal/patina/code) | `fal/patina` | Imagen | Imagen | @@ -542,8 +536,6 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | --- | --- | --- | --- | | [Photon 1](/es/development/comfy-router/models/luma/photon-1/code) | `luma/photon-1` | Texto | Imagen | | [Photon Flash 1](/es/development/comfy-router/models/luma/photon-flash-1/code) | `luma/photon-flash-1` | Texto | Imagen | -| [Ray 2](/es/development/comfy-router/models/luma/ray-2/code) | `luma/ray-2` | Texto, Imagen | Video | -| [Ray Flash 2](/es/development/comfy-router/models/luma/ray-flash-2/code) | `luma/ray-flash-2` | Texto, Imagen | Video | ## Luma 2 @@ -558,9 +550,9 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | | [Animations](/es/development/comfy-router/models/meshy/animations/code) | `meshy/animations` | 3D | 3D | -| [Meshy 6](/es/development/comfy-router/models/meshy/meshy-6/code) | `meshy/meshy-6` | Text | 3D | -| [Meshy 7.1](/es/development/comfy-router/models/meshy/meshy-7-1/code) | `meshy/meshy-7.1` | Text | 3D | -| [Meshy 7](/es/development/comfy-router/models/meshy/meshy-7/code) | `meshy/meshy-7` | Text | 3D | +| [Meshy 6](/es/development/comfy-router/models/meshy/meshy-6/code) | `meshy/meshy-6` | Texto | 3D | +| [Meshy 7.1](/es/development/comfy-router/models/meshy/meshy-7-1/code) | `meshy/meshy-7.1` | Texto | 3D | +| [Meshy 7](/es/development/comfy-router/models/meshy/meshy-7/code) | `meshy/meshy-7` | Texto | 3D | | [Remesh](/es/development/comfy-router/models/meshy/remesh/code) | `meshy/remesh` | 3D | 3D | | [Rigging](/es/development/comfy-router/models/meshy/rigging/code) | `meshy/rigging` | 3D | 3D | @@ -583,7 +575,6 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | | [GPT 4.1 Mini](/es/development/comfy-router/models/openai/gpt-4-1-mini/code) | `openai/gpt-4.1-mini` | Texto, Imagen | Texto | -| [GPT 4.1 Nano](/es/development/comfy-router/models/openai/gpt-4-1-nano/code) | `openai/gpt-4.1-nano` | Texto, Imagen | Texto | | [GPT 4.1](/es/development/comfy-router/models/openai/gpt-4-1/code) | `openai/gpt-4.1` | Texto, Imagen | Texto | | [GPT 4o](/es/development/comfy-router/models/openai/gpt-4o/code) | `openai/gpt-4o` | Texto, Imagen | Texto | | [GPT 5.5 Pro](/es/development/comfy-router/models/openai/gpt-5-5-pro/code) | `openai/gpt-5.5-pro` | Texto, Imagen | Texto | @@ -598,14 +589,10 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [GPT 6 Luna](/es/development/comfy-router/models/openai/gpt-6-luna/code) | `openai/gpt-6-luna` | Texto, Imagen | Texto | | [GPT 6 Sol](/es/development/comfy-router/models/openai/gpt-6-sol/code) | `openai/gpt-6-sol` | Texto, Imagen | Texto | | [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | Texto, Imagen | Imagen | -| [GPT Image 1](/es/development/comfy-router/models/openai/gpt-image-1/code) | `openai/gpt-image-1` | Texto, Imagen | Imagen | | [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | Texto, Imagen | Imagen | | [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | Texto, Imagen | Imagen | | [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | Texto, Imagen | Imagen | -| [o1-pro](/es/development/comfy-router/models/openai/o1-pro/code) | `openai/o1-pro` | Texto, Imagen | Texto | -| [o1](/es/development/comfy-router/models/openai/o1/code) | `openai/o1` | Texto, Imagen | Texto | | [o3](/es/development/comfy-router/models/openai/o3/code) | `openai/o3` | Texto, Imagen | Texto | -| [o4-mini](/es/development/comfy-router/models/openai/o4-mini/code) | `openai/o4-mini` | Texto, Imagen | Texto | ## Openrouter diff --git a/es/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code.mdx b/es/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code.mdx index 1d50263fe6..4071fd2f29 100644 --- a/es/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code.mdx +++ b/es/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code.mdx @@ -2,18 +2,20 @@ title: "Usa FLUX Pro 1.0 Expand con Comfy Router" description: "Llama a bfl/flux-pro-1.0-expand con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve el Router." sidebarTitle: "FLUX Pro 1.0 Expand" -translationSourceHash: 2f758245 +translationSourceHash: d422efaf translationFrom: development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code.mdx translationBlockHashes: "_intro": 62a96b75 "Quick start": 988468b8 "Schema": dfc6f70d + "Examples": d27504bc --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/bfl/flux-pro-1.0-expand.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; -Referencia de API de `bfl/flux-pro-1.0-expand`, que Comfy Router ofrece desde Black Forest Labs. +Referencia de la API de `bfl/flux-pro-1.0-expand`, que Comfy Router ofrece desde Black Forest Labs. **Entrada:** Imagen, Texto · **Salida:** Imagen diff --git a/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code.mdx b/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code.mdx index bb971c572f..c9ca4017b0 100644 --- a/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code.mdx +++ b/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code.mdx @@ -2,24 +2,26 @@ title: "Usa Image Edit Product Virtual Tryon con Comfy Router" description: "Llama a bria/image-edit-product-virtual-tryon mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Image Edit Product Virtual Tryon" -translationSourceHash: 808b91ec +translationSourceHash: 1b853c2a translationFrom: development/comfy-router/models/bria/image-edit-product-virtual-tryon/code.mdx translationBlockHashes: "_intro": 89084eac + "Quick start": 0eea6fe6 "Schema": 54cbc778 "Examples": 986187bf --- + {/* GENERATED FILE. Generated from router-schemas/bria/image-edit-product-virtual-tryon.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; -Referencia de API para `bria/image-edit-product-virtual-tryon`, servida por Comfy Router desde Bria. +Referencia de API para `bria/image-edit-product-virtual-tryon`, que Comfy Router ofrece desde Bria. **Entrada:** Imagen, Texto · **Salida:** Imagen ## Inicio rápido -Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. **ID del modelo:** `bria/image-edit-product-virtual-tryon` @@ -31,8 +33,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr ```python Python from comfy_sdk import Comfy -# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. with Comfy() as client: result = client.models.run( "bria/image-edit-product-virtual-tryon", @@ -48,8 +50,8 @@ print(result) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// The SDK automatically creates an idempotency key and reuses it for automatic retries. +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. const { data } = await comfy.models.run("bria/image-edit-product-virtual-tryon", { garment_images: ["https://labs-assets.bria.ai/api-examples/virtual-try-on/garment-1.jpg"], person_image: "https://labs-assets.bria.ai/api-examples/virtual-try-on/person.jpg", @@ -75,8 +77,8 @@ El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/bria/image-edit import asyncio from comfy_sdk import AsyncComfy -# Reads COMFY_API_KEY from the environment. -# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. async def main(): async with AsyncComfy() as client: handle = await client.models.submit( @@ -86,14 +88,14 @@ async def main(): "person_image": "https://labs-assets.bria.ai/api-examples/virtual-try-on/person.jpg", }, ) - print("request_id:", handle.request_id) # with the model ID, all another process needs + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso - # Poll until the request completes, waiting the Retry-After the server names. + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. async for update in handle.iter_events(): print(update.status, update.queue_position) - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. result = await handle.get() print(result) @@ -104,39 +106,39 @@ asyncio.run(main()) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. const handle = await comfy.models.submit("bria/image-edit-product-virtual-tryon", { garment_images: ["https://labs-assets.bria.ai/api-examples/virtual-try-on/garment-1.jpg"], person_image: "https://labs-assets.bria.ai/api-examples/virtual-try-on/person.jpg", }); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso -// Poll until the request completes, waiting the Retry-After the server names. +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. for await (const update of handle.events()) { console.log(update.status, update.queuePosition); } -// The same result models.run() returns. A request that failed or was cancelled rejects here. +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. const result = await handle.get(); console.log(result.data); ``` ```bash cURL -# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. curl https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"garment_images\": [\"https://labs-assets.bria.ai/api-examples/virtual-try-on/garment-1.jpg\"], \"person_image\": \"https://labs-assets.bria.ai/api-examples/virtual-try-on/person.jpg\"}" -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. REQUEST_ID="" curl -i https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" -# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. curl https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -153,7 +155,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon/reque - De una a tres imágenes de prendas o accesorios para poner en la persona. Cada entrada es una URL disponible públicamente o codificada en Base64, igual que person_image. + De una a tres imágenes de prendas o accesorios para poner sobre la persona. Cada entrada es una URL de acceso público o un valor codificado en Base64, igual que person_image. @@ -165,7 +167,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon/reque - La foto de la persona que se va a editar. URL disponible públicamente o codificada en Base64. Formatos aceptados: JPEG, JPG, PNG, WEBP. + La foto de la persona que se va a editar. URL de acceso público o codificada en Base64. Formatos aceptados: JPEG, JPG, PNG, WEBP. @@ -217,7 +219,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/bria/image-edi - Versión refinada del prompt, o null en una generación COMPLETED que Bria no refinó. Es nullable porque la clave está PRESENTE con null en lugar de omitirse; se observó en vivo en bria/image-edit-gen-fill. + Versión refinada del prompt, o null en una generación COMPLETED que Bria no refinó. Es anulable porque la clave está PRESENTE con valor null en lugar de omitirse; se observó en vivo en bria/image-edit-gen-fill. @@ -229,7 +231,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/bria/image-edi - El prompt estructurado detallado en JSON. + El prompt estructurado en JSON detallado. @@ -267,5 +269,4 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/bria/image-edi } ``` - diff --git a/es/development/comfy-router/models/fal/h3-max-turbo/code.mdx b/es/development/comfy-router/models/fal/h3-max-turbo/code.mdx index 067a899bdd..d9de33ba13 100644 --- a/es/development/comfy-router/models/fal/h3-max-turbo/code.mdx +++ b/es/development/comfy-router/models/fal/h3-max-turbo/code.mdx @@ -2,21 +2,22 @@ title: "Usa H3 Max Turbo con Comfy Router" description: "Llama a fal/h3-max-turbo con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "H3 Max Turbo" -translationSourceHash: 77aca164 +translationSourceHash: d670af32 translationFrom: development/comfy-router/models/fal/h3-max-turbo/code.mdx translationBlockHashes: - "_intro": 3932e8e2 + "_intro": 7c031ba1 "Quick start": 37ecc981 "Schema": fa803ecb "Examples": 53e0f9d0 --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/fal/h3-max-turbo.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; Referencia de API para `fal/h3-max-turbo`, servida por Comfy Router desde fal. -**Entrada:** Texto, Imagen · **Salida:** Video + Audio +**Entrada:** Texto, Imagen, Video, Audio · **Salida:** Video + Audio ## Inicio rápido diff --git a/es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx b/es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx index 04a9767117..5daeb967f6 100644 --- a/es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx +++ b/es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx @@ -2,13 +2,15 @@ title: "Usa Higgsfield Genjutsu Motion Transfer V1.0 con Comfy Router" description: "Llama a higgsfield/higgsfield-genjutsu-motion-transfer-v1.0 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Higgsfield Genjutsu Motion Transfer V1.0" -translationSourceHash: ddf059b9 +translationSourceHash: 667b4dc4 translationFrom: development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx translationBlockHashes: "_intro": 2de8a7d4 "Quick start": 9d8041a2 "Schema": 7fd57a19 + "Examples": 20f268ec --- + {/* GENERATED FILE. Generated from router-schemas/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -161,7 +163,7 @@ curl https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-trans - Orientación opcional para el recambio de reparto. + Orientación opcional para el cambio de reparto. @@ -177,7 +179,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/higgsfield/hi ### Salida - URL absoluta que se usa para cancelar una solicitud antes de que empiece el procesamiento. + URL absoluta para cancelar una solicitud antes de que empiece el procesamiento. diff --git a/es/development/comfy-router/models/kling/kling-image-o1/code.mdx b/es/development/comfy-router/models/kling/kling-image-o1/code.mdx index 388b16cd2c..6c505f85eb 100644 --- a/es/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/es/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -2,14 +2,15 @@ title: "Usa Kling Image O1 con Comfy Router" description: "Llama a kling/kling-image-o1 mediante Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Kling Image O1" -translationSourceHash: cf053382 +translationSourceHash: 0d76917c translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx translationBlockHashes: "_intro": 513c65df "Quick start": 6256a30d - "Schema": d18a5393 + "Schema": 61821697 "Examples": 826db173 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-image-o1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -164,7 +165,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - Dirección de notificación de callback para el resultado de esta tarea. Si se configura, el servidor notificará activamente cuando cambie el estado de la tarea. + Dirección de notificación de callback para el resultado de esta tarea. Si se configura, el servidor notificará activamente cuando cambie el estado de la tarea. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. Formato: `uri` @@ -180,7 +181,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - ID de tarea personalizado. Debe ser único dentro de una misma cuenta de usuario. + ID de tarea personalizado. Debe ser único dentro de una misma cuenta de usuario. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. diff --git a/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx b/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx index cdbfe07643..abff3629ef 100644 --- a/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx +++ b/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx @@ -2,13 +2,15 @@ title: "Usa Recraft V4.1 Utility Vector con Comfy Router" description: "Llama a recraft/recraftv4_1_utility_vector con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Recraft V4.1 Utility Vector" -translationSourceHash: b37b6af4 +translationSourceHash: d45af474 translationFrom: development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx translationBlockHashes: "_intro": cb8cd6d6 + "Quick start": 889594eb "Schema": a456e8b0 "Examples": 5c6fff21 --- + {/* GENERATED FILE. Generated from router-schemas/recraft/recraftv4_1_utility_vector.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -31,8 +33,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr ```python Python from comfy_sdk import Comfy -# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. with Comfy() as client: result = client.models.run( "recraft/recraftv4_1_utility_vector", @@ -48,8 +50,8 @@ print(result) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// The SDK automatically creates an idempotency key and reuses it for automatic retries. +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. const { data } = await comfy.models.run("recraft/recraftv4_1_utility_vector", { n: 1, prompt: "A single red maple leaf on a plain white background.", @@ -67,16 +69,16 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector \ ``` - -El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado cuando esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. ```python Python import asyncio from comfy_sdk import AsyncComfy -# Reads COMFY_API_KEY from the environment. -# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. async def main(): async with AsyncComfy() as client: handle = await client.models.submit( @@ -86,14 +88,14 @@ async def main(): "prompt": "A single red maple leaf on a plain white background.", }, ) - print("request_id:", handle.request_id) # with the model ID, all another process needs + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita - # Poll until the request completes, waiting the Retry-After the server names. + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. async for update in handle.iter_events(): print(update.status, update.queue_position) - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. result = await handle.get() print(result) @@ -104,39 +106,39 @@ asyncio.run(main()) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. const handle = await comfy.models.submit("recraft/recraftv4_1_utility_vector", { n: 1, prompt: "A single red maple leaf on a plain white background.", }); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita -// Poll until the request completes, waiting the Retry-After the server names. +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. for await (const update of handle.events()) { console.log(update.status, update.queuePosition); } -// The same result models.run() returns. A request that failed or was cancelled rejects here. +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. const result = await handle.get(); console.log(result.data); ``` ```bash cURL -# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. REQUEST_ID="" curl -i https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" -# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -167,7 +169,7 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests - Un arreglo de colores preferidos + Un arreglo de colores preferibles @@ -179,7 +181,7 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests - El modelo que se usará para generar (por ejemplo, "recraftv3"). Este campo NO está restringido a una enumeración: el proxy reenvía lo que envíe quien llama. Las grafías que incluye Comfy (el conjunto al que Comfy Router se refiere como `recraft/`) son recraftv2, recraftv3, recraftv4, recraftv4_pro, recraftv4_1, recraftv4_1_utility, recraftv4_1_pro, recraftv4_1_utility_pro, recraftv4_styles, recraftv4_styles_pro, recraftv4_1_vector, recraftv4_1_utility_vector, recraftv4_1_pro_vector, recraftv4_1_utility_pro_vector, recraftv4_styles_vector y recraftv4_styles_pro_vector. Se escriben aquí en lugar de nombrarlas por referencia porque nada referencia con `$ref` al componente RecraftGenerationModel que las declara, y por eso se elimina de la especificación que se sirve en GET /openapi, de modo que un puntero hacia él quedaría huérfano en el documento servido. Las cuatro grafías `recraftv4_styles*` además requieren `style_id`; consulta ese campo. + El modelo que se usa para la generación (p. ej., "recraftv3"). Este campo NO está restringido a un enum: el proxy reenvía lo que envíe quien llama. Las grafías que incluye Comfy, el conjunto que Comfy Router direcciona como `recraft/`, son recraftv2, recraftv3, recraftv4, recraftv4_pro, recraftv4_1, recraftv4_1_utility, recraftv4_1_pro, recraftv4_1_utility_pro, recraftv4_styles, recraftv4_styles_pro, recraftv4_1_vector, recraftv4_1_utility_vector, recraftv4_1_pro_vector, recraftv4_1_utility_pro_vector, recraftv4_styles_vector y recraftv4_styles_pro_vector. Se escriben aquí en lugar de nombrarse por referencia porque el componente RecraftGenerationModel que las declara no recibe `$ref` desde ningún otro lugar y, por lo tanto, se elimina del spec que se sirve en GET /openapi, de modo que un puntero a él quedaría colgando en el documento servido. Las cuatro grafías `recraftv4_styles*` además requieren `style_id`: consulta ese campo. @@ -197,15 +199,15 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests - El tamaño de la imagen generada (por ejemplo, "1024x1024") + El tamaño de la imagen generada (p. ej., "1024x1024") - El estilo que se aplicará a la imagen generada (por ejemplo, "digital_illustration") + El estilo que se aplica a la imagen generada (p. ej., "digital_illustration") - El ID de estilo que se aplicará a la imagen generada (por ejemplo, "123e4567-e89b-12d3-a456-426614174000"). Si se proporciona style_id, no se debería proporcionar style. Es REQUERIDO por los cuatro modelos `recraftv4_styles*`: Recraft los rechaza si no incluyen un style_id o una referencia de estilo. Crea uno con `POST /proxy/recraft/styles`, que este mismo proxy sirve con las mismas credenciales. Nada en esta ruta valida esa combinación: el cuerpo se reenvía a Recraft sin cambios, así que una llamada a `recraftv4_styles*` sin él llega al socio y regresa con un 4xx. + El ID de estilo que se aplica a la imagen generada (p. ej., "123e4567-e89b-12d3-a456-426614174000"). Si proporcionas style_id, no debes proporcionar style. Los cuatro modelos `recraftv4_styles*` lo REQUIEREN: Recraft rechaza esas llamadas sin un style_id o una referencia de estilo. Genera uno con `POST /proxy/recraft/styles`, que este mismo proxy sirve con las mismas credenciales. Nada en esta ruta exige el emparejamiento: el cuerpo se reenvía a Recraft sin cambios, así que una llamada a `recraftv4_styles*` sin él llega al socio y regresa con 4xx. Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraftv4_1_utility_vector/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. @@ -225,7 +227,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraf - Datos de imagen codificados en base64 (presentes en lugar de `url` cuando la solicitud estableció `response_format: b64_json`) + Datos de imagen codificados en Base64 (se incluyen en lugar de `url` cuando la solicitud estableció `response_format: b64_json`) @@ -233,7 +235,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraf - URL para acceder a la imagen generada (presente cuando `response_format` es `url`, el valor predeterminado) + URL para acceder a la imagen generada (se incluye cuando `response_format` es `url`, el valor predeterminado) diff --git a/es/development/comfy-router/models/veed/fabric-1-0/code.mdx b/es/development/comfy-router/models/veed/fabric-1-0/code.mdx index 1415b708da..d67b4cb84e 100644 --- a/es/development/comfy-router/models/veed/fabric-1-0/code.mdx +++ b/es/development/comfy-router/models/veed/fabric-1-0/code.mdx @@ -2,14 +2,15 @@ title: "Usa Fabric 1.0 con Comfy Router" description: "Llama a veed/fabric-1.0 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Fabric 1.0" -translationSourceHash: 8e2360a2 +translationSourceHash: 0d5557e0 translationFrom: development/comfy-router/models/veed/fabric-1-0/code.mdx translationBlockHashes: "_intro": c0f6ceff "Quick start": 2856fd42 - "Schema": 9ea03528 + "Schema": 17071210 "Examples": 952acc85 --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/veed/fabric-1.0.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -154,7 +155,7 @@ curl https://api.comfy.org/v2/models/veed/fabric-1.0/requests/$REQUEST_ID \ ### Entrada - URL http(s) pública de la pista de voz a la que sincronizar los labios. El video dura lo mismo que el audio. + URL http(s) pública de la pista de voz a la que sincronizar los labios. El video dura lo mismo que el audio. Devuelve 400 cuando el audio es más largo que el límite de entrada por llamada. @@ -224,7 +225,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/fabric-1. - URL desde la que se puede descargar el archivo. + URL de descarga del archivo. @@ -246,7 +247,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/fabric-1. - URL desde la que se puede descargar el archivo. + URL de descarga del archivo. @@ -268,7 +269,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/fabric-1. - URL desde la que se puede descargar el archivo. + URL de descarga del archivo. diff --git a/es/development/comfy-router/models/veed/lipsync-2-0/code.mdx b/es/development/comfy-router/models/veed/lipsync-2-0/code.mdx index 5f6ad5eb38..1ec3d42935 100644 --- a/es/development/comfy-router/models/veed/lipsync-2-0/code.mdx +++ b/es/development/comfy-router/models/veed/lipsync-2-0/code.mdx @@ -2,14 +2,15 @@ title: "Usa Lipsync 2.0 con Comfy Router" description: "Llama a veed/lipsync-2.0 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Lipsync 2.0" -translationSourceHash: 3d623f70 +translationSourceHash: 55607886 translationFrom: development/comfy-router/models/veed/lipsync-2-0/code.mdx translationBlockHashes: "_intro": 1fd676f1 "Quick start": 05550229 - "Schema": a26c8117 + "Schema": 24733e29 "Examples": 01527a02 --- + {/* GENERATED FILE. Generated from router-schemas/veed/lipsync-2.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -150,7 +151,7 @@ curl https://api.comfy.org/v2/models/veed/lipsync-2.0/requests/$REQUEST_ID \ ### Entrada - URL http(s) pública de la nueva pista de audio con la que sincronizar los labios del video. + URL http(s) pública de la nueva pista de audio con la que sincronizar los labios del video. Se rechaza con 400 cuando el audio supera el límite de entrada por llamada. diff --git a/es/development/comfy-router/models/veed/video-background-removal/code.mdx b/es/development/comfy-router/models/veed/video-background-removal/code.mdx index 8113ab8863..fd33abbf0c 100644 --- a/es/development/comfy-router/models/veed/video-background-removal/code.mdx +++ b/es/development/comfy-router/models/veed/video-background-removal/code.mdx @@ -2,13 +2,15 @@ title: "Usa Video Background Removal con Comfy Router" description: "Llama a veed/video-background-removal con Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Video Background Removal" -translationSourceHash: 46f48b9f +translationSourceHash: c172f3a9 translationFrom: development/comfy-router/models/veed/video-background-removal/code.mdx translationBlockHashes: "_intro": c7197af8 + "Quick start": 685e5c3d "Schema": 3663e733 "Examples": d388ec6e --- + {/* GENERATED FILE. Generated from router-schemas/veed/video-background-removal.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -19,7 +21,7 @@ Referencia de API de `veed/video-background-removal`, servida por Comfy Router d ## Inicio rápido -Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP sin procesar. **ID del modelo:** `veed/video-background-removal` @@ -31,8 +33,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr ```python Python from comfy_sdk import Comfy -# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. with Comfy() as client: result = client.models.run( "veed/video-background-removal", @@ -50,8 +52,8 @@ print(result) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// The SDK automatically creates an idempotency key and reuses it for automatic retries. +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. const { data } = await comfy.models.run("veed/video-background-removal", { output_codec: "vp9", refine_foreground_edges: true, @@ -72,15 +74,15 @@ curl https://api.comfy.org/v2/models/veed/video-background-removal \ -El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/veed/video-background-removal/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/veed/video-background-removal/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado cuando esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. ```python Python import asyncio from comfy_sdk import AsyncComfy -# Reads COMFY_API_KEY from the environment. -# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. async def main(): async with AsyncComfy() as client: handle = await client.models.submit( @@ -92,14 +94,14 @@ async def main(): "video_url": "https://static-assets.veed.io/api-examples/bg-v2v-input.mp4", }, ) - print("request_id:", handle.request_id) # with the model ID, all another process needs + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso - # Poll until the request completes, waiting the Retry-After the server names. + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. async for update in handle.iter_events(): print(update.status, update.queue_position) - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. result = await handle.get() print(result) @@ -110,41 +112,41 @@ asyncio.run(main()) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. const handle = await comfy.models.submit("veed/video-background-removal", { output_codec: "vp9", refine_foreground_edges: true, subject_is_person: true, video_url: "https://static-assets.veed.io/api-examples/bg-v2v-input.mp4", }); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso -// Poll until the request completes, waiting the Retry-After the server names. +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. for await (const update of handle.events()) { console.log(update.status, update.queuePosition); } -// The same result models.run() returns. A request that failed or was cancelled rejects here. +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. const result = await handle.get(); console.log(result.data); ``` ```bash cURL -# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. curl https://api.comfy.org/v2/models/veed/video-background-removal/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"output_codec\": \"vp9\", \"refine_foreground_edges\": true, \"subject_is_person\": true, \"video_url\": \"https://static-assets.veed.io/api-examples/bg-v2v-input.mp4\"}" -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +# 2. Consulta el estado hasta que sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. REQUEST_ID="" curl -i https://api.comfy.org/v2/models/veed/video-background-removal/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" -# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +# 3. Recoge el resultado. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. curl https://api.comfy.org/v2/models/veed/video-background-removal/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -165,11 +167,11 @@ curl https://api.comfy.org/v2/models/veed/video-background-removal/requests/$REQ - Establécelo en falso cuando el sujeto no sea una persona. + Establécelo en false cuando el sujeto no sea una persona. - URL http(s) pública del video de origen. + URL pública http(s) del video de origen. Generado a partir del esquema que Router sirve en `GET /v2/models/veed/video-background-removal/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. @@ -181,15 +183,15 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/video-bac - Créditos que VEED cobró por la tarea. Presente una vez que la tarea está COMPLETED. + Créditos que VEED cobró por la tarea. Aparece cuando la tarea está COMPLETED. - Créditos que VEED cotizó antes de ejecutar la tarea. Presente solo en la respuesta de envío. + Créditos que VEED cotizó antes de ejecutar la tarea. Aparece solo en la respuesta de envío. - Información del fallo. Presente una vez que la tarea está FAILED. + Información del fallo. Aparece cuando la tarea está FAILED. @@ -201,15 +203,15 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/video-bac - Mensaje de fallo legible por humanos. + Mensaje de fallo legible por personas. - ID de trabajo usado para consultar el estado. + ID de trabajo que se usa para consultar el estado. - Los medios producidos. Presente una vez que la tarea está COMPLETED. Las rutas de video responden `video`, Clean Audio responde `audio` y Video Background Removal responde `files`. + El contenido multimedia producido. Aparece cuando la tarea está COMPLETED. Las rutas de video responden `video`, Clean Audio responde `audio` y Video Background Removal responde `files`. 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/development/comfyui-server/api-examples.mdx b/es/development/comfyui-server/api-examples.mdx index f99d134548..97983e3364 100644 --- a/es/development/comfyui-server/api-examples.mdx +++ b/es/development/comfyui-server/api-examples.mdx @@ -1,20 +1,22 @@ --- title: "Ejemplos de API" description: "Tres patrones comunes para llamar a la API de ComfyUI Server" -translationSourceHash: d728bf1f +translationSourceHash: 7cb0120b translationFrom: development/comfyui-server/api-examples.mdx translationBlockHashes: "_intro": 84518317 "Method 1: Submit and Forget (HTTP only)": 040a0a2d "Method 2: WebSocket + History (Monitor Completion)": ce4e5a84 + "Method 3: WebSocket with SaveImageWebsocket (Real-time Images)": e0bafb7d "Which Method Should I Use?": 95cec253 --- + Esta página muestra tres formas de interactuar con la API del servidor de ComfyUI, desde un envío HTTP simple hasta una integración completa con WebSocket y salida de imágenes en tiempo real. Todos los ejemplos usan el [flujo de trabajo predeterminado de SD1.5](https://github.com/Comfy-Org/ComfyUI/blob/master/script_examples) a modo de ilustración. Antes de usar la API, debes exportar tu flujo de trabajo en [formato API](/es/development/api-development/workflow-api-format). - Estos ejemplos usan Python con la biblioteca estándar y el paquete `websocket-client` (`pip install websocket-client`). El protocolo subyacente de la API es el mismo independientemente del lenguaje. Consulta la [Referencia de la API de Cloud](/es/development/cloud/api-reference) para ver los equivalentes en TypeScript y curl. + Estos ejemplos usan Python con la biblioteca estándar y el paquete `websocket-client` (`pip install websocket-client`). El protocolo subyacente de la API es el mismo independientemente del idioma. Consulta la [Referencia de la API de Cloud](/es/development/cloud/api-reference) para ver los equivalentes en TypeScript y curl. --- @@ -100,14 +102,14 @@ if __name__ == "__main__": --- -## Método 2: WebSocket + historial (monitorizar la finalización) +## Método 2: WebSocket + historial (supervisar la finalización) Fuente: [`websockets_api_example.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/script_examples/websockets_api_example.py) Usa WebSocket para esperar a que finalice la ejecución y luego obtén las salidas a través del endpoint `/history`. Este es el patrón recomendado para la mayoría de los casos de uso. ```python -"""websockets_api_example.py: monitorea la ejecución por WebSocket y descarga mediante /history.""" +"""websockets_api_example.py: supervisa la ejecución por WebSocket y descarga mediante /history.""" import websocket # pip install websocket-client import uuid @@ -213,10 +215,10 @@ if __name__ == "__main__": Fuente: [`websockets_api_example_ws_images.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/script_examples/websockets_api_example_ws_images.py) -Para los casos en los que no quieres que las imágenes se guarden en disco, usa el nodo `SaveImageWebsocket`. Las imágenes se entregan directamente mediante mensajes binarios del WebSocket. +Para casos en los que no quieres que las imágenes se guarden en el disco, usa el nodo `SaveImageWebsocket`. Las imágenes llegan directamente mediante frames binarios de WebSocket. ```python -"""websockets_api_example_ws_images.py — Receive images directly via WebSocket.""" +"""websockets_api_example_ws_images.py: recibe imágenes directamente por WebSocket.""" import websocket # pip install websocket-client import uuid @@ -250,13 +252,13 @@ def get_images(ws, prompt): data = message["data"] if data["prompt_id"] == prompt_id: if data["node"] is None: - break # Execution done + break # Ejecución terminada current_node = data["node"] else: - # Binary frame — image data from SaveImageWebsocket + # Frame binario: datos de imagen de SaveImageWebsocket if current_node == "save_image_websocket_node": images_output = output_images.get(current_node, []) - # The first 8 bytes are type/meta, rest is image data + # Los primeros 8 bytes son tipo/meta, el resto son datos de imagen images_output.append(out[8:]) output_images[current_node] = images_output @@ -282,7 +284,7 @@ if __name__ == "__main__": print(f"Received {len(images)} image(s) via WebSocket.") - # Display (requires Pillow): + # Mostrar (requiere Pillow): # for image_data in images.get("save_image_websocket_node", []): # from PIL import Image # import io @@ -299,15 +301,15 @@ if __name__ == "__main__": ## ¿Qué método debería usar? - - **Envía y olvida.** Úsalo cuando no necesites resultados inmediatos o cuando puedas recuperar los resultados más tarde. + + **Envía y olvídate.** Úsalo cuando no necesites la salida de inmediato o cuando obtener los resultados más tarde sea aceptable. - - **RECOMENDADO.** Espera a que termine y luego descarga las salidas. El mejor equilibrio entre simplicidad y fiabilidad. + + **Recomendado.** Espera a que termine y luego descarga las salidas. Es el mejor equilibrio entre simplicidad y fiabilidad. - **Imágenes en tiempo real.** Lo mejor para aplicaciones interactivas en las que quieres recibir imágenes sin escribir en disco. + **Imágenes en tiempo real.** Ideal para aplicaciones interactivas en las que quieres recibir las imágenes sin escribir en disco. -Para ver la referencia completa de la API (endpoints, formatos de payload, manejo de errores), consulta las páginas [Server Routes](/es/development/comfyui-server/comms_routes) y [Server Messages](/es/development/comfyui-server/comms_messages). +Para consultar la referencia completa de la API (endpoints, formatos de payload y manejo de errores), revisa las páginas [Server Routes](/es/development/comfyui-server/comms_routes) y [Server Messages](/es/development/comfyui-server/comms_messages). 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..3fea731c12 100644 --- a/es/development/comfyui-server/startup-flags.mdx +++ b/es/development/comfyui-server/startup-flags.mdx @@ -3,28 +3,33 @@ 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 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). - 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. + 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. -Ejecuta `python main.py --help` en tu directorio de ComfyUI para ver el texto de ayuda integrado. Combina varios flags según necesites: +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 @@ -34,20 +39,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 +62,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 +74,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 +106,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 +120,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 +158,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 +256,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 +289,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 +310,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 +317,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/deploy/cloud-usage.mdx b/es/development/deploy/cloud-usage.mdx index 2c386e6f7e..463e3a5fff 100644 --- a/es/development/deploy/cloud-usage.mdx +++ b/es/development/deploy/cloud-usage.mdx @@ -3,7 +3,7 @@ title: "Uso y límites" sidebarTitle: "Uso y límites" description: "Conoce los créditos de Comfy Cloud, las tareas simultáneas y los límites al ejecutar flujos de trabajo desde el SDK." icon: "gauge" -translationSourceHash: 4bda5429 +translationSourceHash: 811a6c4e translationFrom: development/deploy/cloud-usage.mdx --- @@ -13,9 +13,9 @@ Los flujos de trabajo enviados a través de la API de Comfy Cloud usan los mismo Las solicitudes a la API consumen la misma asignación mensual de créditos que la interfaz web de Comfy Cloud. No hay un grupo de créditos independiente para la API. Los créditos incluidos en cada plan, las opciones de recarga y los límites de tiempo de ejecución por flujo de trabajo se aplican a las tareas de la API igual que a las tareas de la interfaz. -Consulta la [página de precios](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api) para ver los importes mensuales de créditos y las opciones de recarga. Puedes comprar recargas desde el panel de tu cuenta. +Consulta la [página de precios](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api) para ver los montos mensuales de créditos y las opciones de recarga. Puedes comprar recargas desde el panel de tu cuenta. -## Tareas simultáneas +## Límites de simultaneidad 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 plan de suscripción: 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/interface/features/subgraph.mdx b/es/interface/features/subgraph.mdx index 52ca9b4ba9..9efa93f7c1 100644 --- a/es/interface/features/subgraph.mdx +++ b/es/interface/features/subgraph.mdx @@ -3,15 +3,16 @@ title: "Subgrafo - Simplifica tu flujo de trabajo" description: "Una introducción a la función Subgrafo en ComfyUI, incluyendo cómo crear, navegar y administrar subgrafos." sidebarTitle: "Subgrafo" icon: "share-nodes" -translationSourceHash: 98ec4b8b +translationSourceHash: 57c2004c translationFrom: interface/features/subgraph.mdx translationBlockHashes: - "_intro": 334a5761 + "_intro": bd71a43e "Creating a Subgraph": 6d897c6c "Working with Subgraphs": e3232751 "Unpack Subgraphs to Nodes": 2fb4b38f "Subgraph Blueprint": 98873b2f --- + La función de subgrafo requiere la versión 1.24.3 o posterior del frontend de ComfyUI. Si no ves esta función, consulta: [Cómo actualizar ComfyUI](/es/installation/update_comfyui) - Las imágenes de este documento se crearon con la versión nocturna del frontend; consulta la interfaz real. diff --git a/es/interface/settings/overview.mdx b/es/interface/settings/overview.mdx index d4f7290516..85c113a081 100644 --- a/es/interface/settings/overview.mdx +++ b/es/interface/settings/overview.mdx @@ -1,13 +1,13 @@ --- title: "Descripción general de las configuraciones de ComfyUI" -description: "Índice de las categorías de Configuraciones: cuenta, interfaz, editor y ajustes de Desktop, cada una con enlace a su guía." +description: "Índice de las categorías de configuraciones de ComfyUI: cuenta, interfaz, editor y Comfy Desktop, con enlaces a sus guías." icon: "book" sidebarTitle: "Descripción general" -translationSourceHash: 740258ae +translationSourceHash: 5d9d4761 translationFrom: interface/settings/overview.mdx --- -Esta sección cubre las descripciones detalladas de las configuraciones en el menú de configuraciones del frontend de ComfyUI. Todas las configuraciones de usuario se guardan automáticamente en el archivo `ComfyUI/user/default/comfy.settings.json`. +Esta sección describe en detalle las configuraciones del menú de configuraciones del frontend de ComfyUI. Todas las configuraciones de usuario se guardan automáticamente en el archivo `ComfyUI/user/default/comfy.settings.json`. Puedes usar el atajo de teclado `Ctrl + ,` para abrir el panel de configuraciones y luego hacer clic en las opciones de configuración correspondientes para ajustarlas. @@ -38,7 +38,7 @@ Dado que los nodos personalizados también pueden registrar sus propias categor Algunas opciones de configuración para la inicialización de nodos 3D - Configuraciones de actualización del escritorio, configuraciones de espejo, etc. (solo tienen efecto en Comfy Desktop) + Configuraciones de actualización de Comfy Desktop, configuraciones de espejo, etc. (solo tienen efecto en Comfy Desktop) Ajusta las preferencias de uso del editor de máscara 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'] 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 diff --git a/es/tutorials/3d/hunyuan3D-2.mdx b/es/tutorials/3d/hunyuan3D-2.mdx index 577a584714..fa6044727f 100644 --- a/es/tutorials/3d/hunyuan3D-2.mdx +++ b/es/tutorials/3d/hunyuan3D-2.mdx @@ -2,7 +2,7 @@ title: "Hunyuan3D 2.0 y 2.1 en ComfyUI: flujos de imagen a malla 3D" description: "Genera mallas 3D en ComfyUI desde una imagen o cuatro vistas consistentes con los modelos open source Hunyuan3D 2.0, 2.1 y turbo de Tencent." sidebarTitle: "Hunyuan3D-2" -translationSourceHash: c1132014 +translationSourceHash: 6f829cc4 translationFrom: tutorials/3d/hunyuan3D-2.mdx translationBlockHashes: "_intro": 659765dd @@ -11,7 +11,9 @@ translationBlockHashes: "Hunyuan3D-2 Single View Workflow": 46e82b79 "Hunyuan3D 2.1 Single View Workflow": 5a8b9bc8 "Community Resources": d12dc58a + "Hunyuan3D 2.0 Open-Source Model Series": 363ff037 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" # Introducción a Hunyuan3D 2.0 @@ -20,7 +22,7 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" ![Hunyuan 3D 2](https://raw.githubusercontent.com/Tencent/Hunyuan3D-2/main/assets/images/e2e-2.gif) [Hunyuan3D 2.0](https://github.com/Tencent/Hunyuan3D-2) es un modelo de generación de recursos 3D de código abierto publicado por Tencent, capaz de generar modelos 3D de alta fidelidad con mapas de textura de alta resolución a partir de texto o imágenes. -Hunyuan3D 2.0 adopta un enfoque de generación en dos etapas: primero genera un modelo de geometría sin texturas y después sintetiza mapas de textura de alta resolución. Así separa de forma efectiva la complejidad de la generación de forma y de textura. A continuación se presentan los dos componentes principales de Hunyuan3D 2.0: +Hunyuan3D 2.0 adopta un enfoque de generación en dos etapas: primero genera un modelo de geometría sin texturas y después sintetiza mapas de textura de alta resolución. Esto separa de forma efectiva la complejidad de la generación de forma y textura. A continuación se presentan los dos componentes principales de Hunyuan3D 2.0: 1. **Modelo de generación de geometría (Hunyuan3D-DiT)**: basado en una arquitectura Transformer de difusión por flujo, genera modelos geométricos sin textura que coinciden con precisión con las condiciones de entrada. 2. **Modelo de generación de texturas (Hunyuan3D-Paint)**: combina condiciones geométricas y técnicas de difusión multivista para añadir texturas de alta resolución a los modelos, con soporte para materiales PBR. @@ -101,7 +103,7 @@ Descarga las imágenes de abajo, las usaremos como imágenes de entrada. ![imagen de entrada](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/back.png) -En este ejemplo, las imágenes de entrada ya vienen preprocesadas para eliminar el exceso de fondo. En el uso real, puedes usar Nodos personalizados como [ComfyUI_essentials](https://github.com/cubiq/ComfyUI_essentials) para eliminar automáticamente el exceso de fondo. +En este ejemplo, las imágenes de entrada ya vienen preprocesadas para eliminar el exceso de fondo. En la práctica, puedes usar nodos personalizados como [ComfyUI_essentials](https://github.com/cubiq/ComfyUI_essentials) para eliminar automáticamente el exceso de fondo. ### 2. Instalación manual del modelo @@ -176,7 +178,7 @@ Descarga las siguientes imágenes, ya que las usaremos como imágenes de entrada ![input image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/front.png) ![input image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/right.png) -### 2. Instalación manual del modelo +### 2. Instalar el modelo manualmente Descarga el siguiente modelo y guárdalo en la carpeta correspondiente de ComfyUI @@ -252,13 +254,13 @@ ComfyUI/ ![ComfyUI hunyuan3d_2](/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2_non_multiview.jpg) -1. Asegúrate de que el nodo `Image Only Checkpoint Loader(img2vid model)` haya cargado el modelo `hunyuan3d-dit-v2.safetensors` que renombramos +1. Asegúrate de que el nodo `Image Only Checkpoint Loader(img2vid model)` haya cargado nuestro modelo `hunyuan3d-dit-v2.safetensors` renombrado 2. Carga la imagen en el nodo `Load Image` 3. Haz clic en el botón `Queue`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo ## Flujo de trabajo de vista única de Hunyuan3D 2.1 -Hunyuan3D 2.1 es el modelo de forma posterior de Tencent, lanzado en junio de 2025. Refina la calidad geométrica de Hunyuan3D 2.0, y el checkpoint de ComfyUI reempaqueta el pipeline de forma en un solo archivo, así que este flujo de trabajo necesita una sola descarga de modelo en lugar de archivos DiT y VAE separados. Al igual que los otros flujos de trabajo de esta página, genera una malla sin textura. +Hunyuan3D 2.1 es el modelo de forma sucesor de Tencent, lanzado en junio de 2025. Refina la calidad geométrica de Hunyuan3D 2.0, y el checkpoint de ComfyUI reempaqueta el pipeline de forma en un solo archivo, así que este flujo de trabajo necesita una sola descarga de modelo en lugar de archivos DiT y VAE separados. Al igual que los otros flujos de trabajo de esta página, genera una malla sin textura. ### HY 3D 2.1 {#3d_hunyuan3d-v2.1} @@ -321,26 +323,26 @@ A continuación, encontrarás recursos de la comunidad de ComfyUI relacionados c ## Serie de modelos de código abierto Hunyuan3D 2.0 -Actualmente, Hunyuan3D 2.0 ha publicado como código abierto varios modelos que cubren todo el proceso de generación 3D. Puedes visitar [Hunyuan3D-2](https://github.com/Tencent/Hunyuan3D-2) para obtener más información. +Actualmente, Hunyuan3D 2.0 tiene varios modelos de código abierto que cubren el proceso completo de generación 3D. Puedes visitar [Hunyuan3D-2](https://github.com/Tencent/Hunyuan3D-2) para obtener más información. **Serie Hunyuan3D-2mini** -| Modelo | Descripción | Fecha | Parámetros | Huggingface | -|-----------------------|-------------------------------|------------|------------|-------------------------------------------------------------------------------------------| -| Hunyuan3D-DiT-v2-mini | Modelo mini de imagen a forma | 2025-03-18 | 0.6B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main/hunyuan3d-dit-v2-mini) | +| Modelo | Descripción | Fecha | Parámetros | Huggingface | +|-----------------------|-------------------------------|------------|------------|--------------------------------------------------------------------------------------------| +| Hunyuan3D-DiT-v2-mini | Modelo mini de imagen a forma | 2025-03-18 | 0.6B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main/hunyuan3d-dit-v2-mini) | **Serie Hunyuan3D-2mv** -| Modelo | Descripción | Fecha | Parámetros | Huggingface | -|--------------------------|-----------------------------------------------------------------------------------------------------------------------|------------|------------|--------------------------------------------------------------------------------------------| -| Hunyuan3D-DiT-v2-mv-Fast | Versión de destilación de guía; puede reducir a la mitad el tiempo de inferencia del DIT | 2025-03-18 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv-fast) | -| Hunyuan3D-DiT-v2-mv | Modelo de imagen multivista a forma, adecuado para la creación 3D que requiere varios ángulos para entender la escena | 2025-03-18 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv) | +| Modelo | Descripción | Fecha | Parámetros | Huggingface | +|--------------------------|----------------------------------------------------------------------------------------------------------------|------------|------------|------------------------------------------------------------------------------------------| +| Hunyuan3D-DiT-v2-mv-Fast | Versión de destilación de orientación, puede reducir a la mitad el tiempo de inferencia del DIT | 2025-03-18 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv-fast) | +| Hunyuan3D-DiT-v2-mv | Modelo de imagen a forma multivista, adecuado para creaciones 3D que requieren varios ángulos para entender la escena | 2025-03-18 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv) | **Serie Hunyuan3D-2** -| Modelo | Descripción | Fecha | Parámetros | Huggingface | -|-------------------------|----------------------------------|------------|------------|-----------------------------------------------------------------------------------------| -| Hunyuan3D-DiT-v2-0-Fast | Modelo de destilación de guía | 2025-02-03 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast) | -| Hunyuan3D-DiT-v2-0 | Modelo de imagen a forma | 2025-01-21 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0) | -| Hunyuan3D-Paint-v2-0 | Modelo de generación de texturas | 2025-01-21 | 1.3B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0) | -| Hunyuan3D-Delight-v2-0 | Modelo Delight de imagen | 2025-01-21 | 1.3B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-delight-v2-0) | +| Modelo | Descripción | Fecha | Parámetros | Huggingface | +|-------------------------|-----------------------------------------------|------------|------------|---------------------------------------------------------------------------------------| +| Hunyuan3D-DiT-v2-0-Fast | Modelo de destilación de orientación | 2025-02-03 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast) | +| Hunyuan3D-DiT-v2-0 | Modelo de imagen a forma | 2025-01-21 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0) | +| Hunyuan3D-Paint-v2-0 | Modelo de generación de texturas | 2025-01-21 | 1.3B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0) | +| Hunyuan3D-Delight-v2-0 | Modelo de delight de imagen | 2025-01-21 | 1.3B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-delight-v2-0) | diff --git a/es/tutorials/audio/ace-step/ace-step-v1-5.mdx b/es/tutorials/audio/ace-step/ace-step-v1-5.mdx index 279be37524..d5d2a50e74 100644 --- a/es/tutorials/audio/ace-step/ace-step-v1-5.mdx +++ b/es/tutorials/audio/ace-step/ace-step-v1-5.mdx @@ -2,18 +2,22 @@ title: "ACE-Step 1.5 en ComfyUI: generación local de música con IA" description: "Genera canciones completas en local en ComfyUI con ACE-Step 1.5, un modelo de música de código abierto que convierte texto y letras opcionales en audio." sidebarTitle: "ACE-Step 1.5" -translationSourceHash: b87771b2 +translationSourceHash: c298c7bc translationFrom: tutorials/audio/ace-step/ace-step-v1-5.mdx translationBlockHashes: "_intro": 87ce48db + "Option 1: All-in-One Checkpoint (Recommended)": 6eebe82d + "Option 2: Split Model Files": eae7244e + "ACE-Step 1.5 Key Features in ComfyUI": 54de35d3 "Coming Soon to ComfyUI": 3b837315 "ACE-Step 1.5 ComfyUI Related Resources": 518b9b68 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; ACE-Step 1.5 es un modelo de generación de música de código abierto de ACE Studio y StepFun que convierte una descripción de texto y letras opcionales en una canción completa. ComfyUI lo ejecuta de forma nativa, así que puedes generar pistas completas localmente, desde bucles de 10 segundos hasta composiciones de varios minutos. -En el núcleo del modelo hay un planificador de modelo de lenguaje combinado con un decodificador de audio Diffusion Transformer (DiT). El planificador expande una consulta simple en un plano de canción, sintetizando estructura, metadatos, letras y descripciones mediante razonamiento de cadena de pensamiento, y el DiT renderiza el audio. La alineación se apoya en los mecanismos internos del propio modelo en lugar de un modelo de recompensa externo o datos de preferencia humana. +En el núcleo del modelo hay un planificador de modelo de lenguaje emparejado con un decodificador de audio Diffusion Transformer (DiT). El planificador expande una consulta simple en un plano de canción, sintetizando estructura, metadatos, letras y descripciones mediante razonamiento de cadena de pensamiento, y el DiT renderiza el audio. La alineación se apoya en los mecanismos internos del propio modelo en lugar de un modelo de recompensa externo o datos de preferencia humana. La generación es lo bastante rápida para sesiones interactivas: menos de 2 segundos para una canción completa en una A100 y menos de 10 segundos en una RTX 3090. La configuración de menos de 4 GB de VRAM ejecuta solo el DiT con el planificador LM desactivado. Entrenar un LoRA con unas pocas canciones es suficiente para capturar tu propio estilo. @@ -23,23 +27,23 @@ La generación es lo bastante rápida para sesiones interactivas: menos de 2 seg - **Calidad de nivel comercial**: Calidad superior a la de la mayoría de los modelos de música comerciales, con una puntuación de coherencia musical de 4.72 - **Generación rápida**: Una canción completa en menos de 2 segundos en una A100, o menos de 10 segundos en una RTX 3090 -- **Salida de formato largo**: Duraciones desde 10 segundos hasta 10 minutos -- **Más de 50 idiomas**: Buen soporte para inglés, chino, japonés, coreano, español, alemán, francés, portugués, italiano y ruso +- **Salida de larga duración**: Duraciones desde 10 segundos hasta 10 minutos +- **Más de 50 idiomas**: Sólido soporte para inglés, chino, japonés, coreano, español, alemán, francés, portugués, italiano y ruso - **Ajuste fino con LoRA**: Personalización ligera mediante entrenamiento de LoRA en ComfyUI ## Opción 1: Checkpoint todo en uno (recomendado) -La versión AIO empaqueta todos los modelos en un único archivo de checkpoint, lo que facilita su descarga y gestión. +La versión AIO empaqueta todos los modelos en un solo archivo checkpoint, lo que facilita su descarga y administración. ### ACE-Step 1.5 Music Generation AIO {#audio_ace_step_1_5_checkpoint} -Introduce etiquetas de estilo y una letra para generar una canción completa. El flujo de trabajo usa el modelo ACE-Step 1.5 para producir música con calidad comercial en menos de 10 segundos en hardware de consumo. +Ingresa etiquetas de estilo y letras para generar una canción completa. El flujo de trabajo usa el modelo ACE-Step 1.5 para producir música de calidad comercial en menos de 10 segundos en hardware de consumo. - + Abrir en Comfy Cloud - + Descarga el JSON o busca "ACE-Step 1.5 Music Generation AIO" en la Biblioteca de plantillas @@ -47,7 +51,7 @@ Introduce etiquetas de estilo y una letra para generar una canción completa. El ### Descarga del modelo AIO - Archivo de checkpoint todo en uno (recomendado para la mayoría de los usuarios). + Archivo checkpoint todo en uno (recomendado para la mayoría de los usuarios). **Ubicación de almacenamiento del modelo AIO** @@ -58,14 +62,13 @@ Introduce etiquetas de estilo y una letra para generar una canción completa. El │ └── 📂 checkpoints/ │ └── ace_step_1.5_turbo_aio.safetensors ``` +## Opción 2: archivos de modelo separados -## Opción 2: Archivos de modelo separados - -La versión dividida te permite descargar cada componente del modelo por separado. +La versión separada te permite descargar cada componente del modelo por individual. -### ACE-Step 1.5 Music Generation Workflow {#audio_ace_step_1_5_split} +### Flujo de trabajo de generación de música ACE-Step 1.5 {#audio_ace_step_1_5_split} -Introduce un prompt de texto que describa el estilo musical y, opcionalmente, una letra. Genera una canción de audio completa y de alta calidad en menos de 10 segundos en hardware de consumo. +Introduce un prompt de texto que describa el estilo musical y, opcionalmente, la letra. Genera una canción de audio completa y de alta calidad en menos de 10 segundos en hardware de consumo. @@ -76,7 +79,7 @@ Introduce un prompt de texto que describa el estilo musical y, opcionalmente, un -### Descargas de los modelos separados +### Descargas de modelos separados @@ -109,23 +112,22 @@ Introduce un prompt de texto que describa el estilo musical y, opcionalmente, un │ └── 📂 vae/ │ └── ace_1.5_vae.safetensors ``` - ## Características clave de ACE-Step 1.5 en ComfyUI ### Planificación con Chain-of-Thought -El modelo ACE-Step 1.5 sintetiza metadatos, letra y captions mediante razonamiento Chain-of-Thought para guiar el proceso de difusión, lo que da como resultado composiciones largas más coherentes. +El modelo ACE-Step 1.5 sintetiza metadatos, letras y descripciones mediante razonamiento Chain-of-Thought para guiar el proceso de diffusion, lo que da como resultado composiciones de larga duración más coherentes. ### Arquitectura híbrida LM + DiT -ACE-Step 1.5 combina un modelo de lenguaje que planifica la estructura de la canción con un Diffusion Transformer (DiT) que se encarga de la síntesis de audio, todo ejecutándose de forma nativa en ComfyUI. +ACE-Step 1.5 combina un modelo de lenguaje que planifica la estructura de la canción con un Diffusion Transformer (DiT) que se encarga de la síntesis de audio, y todo se ejecuta de forma nativa en ComfyUI. ## Próximamente en ComfyUI Estas funciones están disponibles en ACE-Step 1.5, pero aún no son compatibles con ComfyUI: -- **Cover**: Dale al modelo cualquier canción como entrada junto con un nuevo prompt y una letra, y reimaginará la pista en un estilo completamente diferente -- **Repaint**: Selecciona un segmento, regenera solo esa sección y el modelo la vuelve a integrar mientras mantiene todo lo demás intacto +- **Cover**: Dale al modelo cualquier canción como entrada junto con un nuevo prompt y una letra, y reimaginará la pista en un estilo completamente distinto. +- **Repaint**: Selecciona un segmento, vuelve a generar solo esa parte y el modelo la integra de nuevo mientras mantiene todo lo demás intacto. ## Recursos relacionados de ACE-Step 1.5 en ComfyUI diff --git a/es/tutorials/audio/ace-step/ace-step-v1.mdx b/es/tutorials/audio/ace-step/ace-step-v1.mdx index f63994ddc9..7cf28d3834 100644 --- a/es/tutorials/audio/ace-step/ace-step-v1.mdx +++ b/es/tutorials/audio/ace-step/ace-step-v1.mdx @@ -2,17 +2,19 @@ title: "Ejemplo nativo de ACE-Step en ComfyUI" description: "Generación de música con ACE-Step en ComfyUI: flujos de texto a música y edición musical con el modelo de código abierto Apache-2.0 de StepFun y ACE Studio." sidebarTitle: "ACE-Step 1.0" -translationSourceHash: 189304f5 +translationSourceHash: b3044926 translationFrom: tutorials/audio/ace-step/ace-step-v1.mdx translationBlockHashes: "_intro": 56ef7364 + "ACE-Step ComfyUI Text-to-Audio Generation Workflow Example": 3f211bda "ACE-Step ComfyUI Audio-to-Audio Workflow": 06b425cb "ACE-Step Prompt Guide": 90bf0bf7 "ACE-Step Related Resources": f74e2db9 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -ACE-Step es un modelo fundacional de generación de música de código abierto desarrollado conjuntamente por el equipo chino StepFun y ACE Studio, cuyo objetivo es ofrecer a los creadores musicales herramientas de generación y edición de música eficientes, flexibles y de alta calidad. +ACE-Step es un modelo fundacional de generación musical de código abierto desarrollado conjuntamente por el equipo chino StepFun y ACE Studio, cuyo objetivo es ofrecer a los creadores musicales herramientas de generación y edición de música eficientes, flexibles y de alta calidad. El modelo se publica bajo la [licencia Apache-2.0](https://github.com/ace-step/ACE-Step?tab=readme-ov-file#-license) y es gratis para uso comercial. @@ -27,77 +29,77 @@ Puedes visitar su [GitHub](https://github.com/ace-step/ACE-Step?tab=readme-ov-fi ## Ejemplo de flujo de trabajo de generación de texto a audio con ACE-Step en ComfyUI -### 1. Descarga el flujo de trabajo y los modelos relacionados +### 1. Descargar el flujo de trabajo y los modelos relacionados -Haz clic en el botón de abajo para descargar el archivo del flujo de trabajo correspondiente. Arrástralo a ComfyUI para cargar la información del flujo de trabajo. El flujo de trabajo incluye la información de descarga de los modelos. +Haz clic en el botón de abajo para descargar el archivo de flujo de trabajo correspondiente. Arrástralo a ComfyUI para cargar la información del flujo de trabajo. El flujo de trabajo incluye la información de descarga de los modelos. -

Descargar el archivo de flujo de trabajo en formato JSON

+

Descargar archivo de flujo de trabajo en formato Json

También puedes descargar manualmente [ace_step_v1_3.5b.safetensors](https://huggingface.co/Comfy-Org/ACE-Step_ComfyUI_repackaged/blob/main/all_in_one/ace_step_v1_3.5b.safetensors) y guardarlo en la carpeta `ComfyUI/models/checkpoints` -### 2. Completa el flujo de trabajo paso a paso +### 2. Completar el flujo de trabajo paso a paso -![Guía de pasos](/images/tutorial/audio/ace_step/ace_step_1_t2a_step_guide.jpg) +![Step Guide](/images/tutorial/audio/ace_step/ace_step_1_t2a_step_guide.jpg) 1. Asegúrate de que el nodo `Load Checkpoints` haya cargado el modelo `ace_step_v1_3.5b.safetensors` -2. (Opcional) En el nodo `EmptyAceStepLatentAudio` puedes definir la duración de la música que se va a generar -3. (Opcional) En el nodo `LatentOperationTonemapReinhard` puedes ajustar el `multiplier` para controlar el volumen de la voz (valores más altos hacen que la voz destaque más) -4. (Opcional) Introduce los estilos musicales correspondientes, etc., en el campo `tags` de `TextEncodeAceStepAudio` +2. (Opcional) En el nodo `EmptyAceStepLatentAudio`, puedes establecer la duración de la música que se va a generar +3. (Opcional) En el nodo `LatentOperationTonemapReinhard`, puedes ajustar el `multiplier` para controlar el volumen de las voces (los números más altos dan como resultado voces más prominentes) +4. (Opcional) Introduce los estilos de música correspondientes, etc. en el campo `tags` de `TextEncodeAceStepAudio` 5. (Opcional) Introduce la letra correspondiente en el campo `lyrics` de `TextEncodeAceStepAudio` -6. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter`, para ejecutar la generación de audio -7. Cuando el flujo de trabajo termine,, puedes escuchar el audio generado en el nodo `Save Audio`. Puedes hacer clic para reproducirlo, y el audio también se guardará en `ComfyUI/output/audio` (el subdirectorio lo determina el nodo `Save Audio`). +6. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de audio +7. Cuando el flujo de trabajo termine, puedes previsualizar el audio generado en el nodo `Save Audio`. Puedes hacer clic para reproducirlo y escucharlo, y el audio también se guardará en `ComfyUI/output/audio` (el subdirectorio lo determina el nodo `Save Audio`). ## Flujo de trabajo de audio a audio con ACE-Step en ComfyUI -De forma similar a los flujos de trabajo de imagen a imagen, puedes ingresar un fragmento de música y usar el flujo de trabajo de abajo para remuestrear y generar música. También puedes ajustar la diferencia respecto al audio original controlando el parámetro `denoise` en el `Ksampler`. +De forma similar a los flujos de trabajo de imagen a imagen, puedes introducir una pieza musical y usar el flujo de trabajo de abajo para volver a muestrear y generar música. También puedes ajustar la diferencia respecto al audio original controlando el parámetro `denoise` del `Ksampler`. ### 1. Descargar el archivo del flujo de trabajo Haz clic en el botón de abajo para descargar el archivo del flujo de trabajo correspondiente. Arrástralo a ComfyUI para cargar la información del flujo de trabajo. -

Descargar archivo de flujo de trabajo en formato JSON

+

Descargar el archivo de flujo de trabajo en formato JSON

Descarga el siguiente archivo de audio como audio de entrada: -

Descargar archivo de audio de ejemplo para la entrada

+

Descargar el archivo de audio de ejemplo para la entrada

### 2. Completar el flujo de trabajo paso a paso -![Guía paso a paso de ACE-Step](/images/tutorial/audio/ace_step/ace_step_1_m2m_step_guide.jpg) +![Guía de pasos de ACE-Step](/images/tutorial/audio/ace_step/ace_step_1_m2m_step_guide.jpg) 1. Asegúrate de que el nodo `Load Checkpoints` haya cargado el modelo `ace_step_v1_3.5b.safetensors` 2. Sube el archivo de audio proporcionado en el nodo `LoadAudio` -3. (Opcional) Ingresa los estilos musicales y la letra correspondientes en los campos `tags` y `lyrics` de `TextEncodeAceStepAudio`. Proporcionar la letra es muy importante para la edición de audio -4. (Opcional) Modifica el parámetro `denoise` del nodo `Ksampler` para ajustar el ruido que se añade durante el muestreo y así controlar la similitud con el audio original (los valores más pequeños dan como resultado una mayor similitud con el audio original; establecerlo en `1.00` equivale aproximadamente a no tener entrada de audio) +3. (Opcional) Introduce los estilos musicales y la letra correspondientes en los campos `tags` y `lyrics` de `TextEncodeAceStepAudio`. Proporcionar la letra es muy importante para la edición de audio +4. (Opcional) Modifica el parámetro `denoise` del nodo `Ksampler` para ajustar el ruido añadido durante el muestreo y controlar la similitud con el audio original (los valores más pequeños dan como resultado una mayor similitud con el audio original; establecerlo en `1.00` equivale aproximadamente a no tener entrada de audio) 5. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de audio 6. Cuando el flujo de trabajo termine, puedes previsualizar el audio generado en el nodo `Save Audio`. Puedes hacer clic para reproducirlo y escucharlo, y el audio también se guardará en `ComfyUI/output/audio` (el subdirectorio lo determina el nodo `Save Audio`). -También puedes usar la funcionalidad de modificación y edición de la letra de la página del proyecto ACE-Step, modificando la letra original para cambiar el efecto del audio. +También puedes implementar la funcionalidad de modificación y edición de la letra de la página del proyecto ACE-Step, modificando la letra original para cambiar el efecto del audio. ### 3. Notas adicionales sobre el flujo de trabajo -1. En el flujo de trabajo de ejemplo, puedes cambiar los `tags` de `TextEncodeAceStepAudio` de `male voice` a `female voice` para generar voces femeninas. -2. También puedes modificar los `lyrics` de `TextEncodeAceStepAudio` para cambiar la letra y, con ello, el audio generado. Consulta los ejemplos de la página del proyecto ACE-Step para más detalles. +1. En el flujo de trabajo de ejemplo, puedes cambiar `tags` en `TextEncodeAceStepAudio` de `male voice` a `female voice` para generar voces femeninas. +2. También puedes modificar `lyrics` en `TextEncodeAceStepAudio` para cambiar la letra y, con ello, el audio generado. Consulta los ejemplos de la página del proyecto ACE-Step para ver más detalles. ## Guía de prompts de ACE-Step -Actualmente, ACE usa dos tipos de prompts: `tags` y `lyrics`. +ACE actualmente usa dos tipos de prompts: `tags` y `lyrics`. -- `tags`: se usan principalmente para describir estilos musicales, escenas, etc. De forma similar a los prompts que usamos en otras generaciones, describen sobre todo el estilo general y los requisitos del audio, y se separan con comas en inglés. -- `lyrics`: se usan principalmente para describir la letra y admiten etiquetas de estructura como [verse], [chorus] y [bridge] para distinguir las distintas partes de la letra. También puedes escribir nombres de instrumentos para música puramente instrumental. +- `tags`: se usan principalmente para describir estilos musicales, escenas, etc. De forma similar a los prompts que usamos para otras generaciones, describen sobre todo el estilo general y los requisitos del audio, y se separan con comas en inglés. +- `lyrics`: se usan principalmente para describir la letra y admiten etiquetas de estructura como [verse], [chorus] y [bridge] para distinguir las distintas partes de la letra. También puedes introducir nombres de instrumentos para música puramente instrumental. -Puedes encontrar abundantes ejemplos de `tags` y `lyrics` en la [página del modelo ACE-Step](https://ace-step.github.io/). Puedes consultar esos ejemplos para probar los prompts correspondientes. La guía de prompts de este documento está organizada a partir del proyecto para ayudarte a probar combinaciones rápidamente y lograr el efecto que buscas. +Puedes encontrar abundantes ejemplos de `tags` y `lyrics` en la [página principal del modelo ACE-Step](https://ace-step.github.io/). Puedes consultar estos ejemplos para probar los prompts correspondientes. La guía de prompts de este documento está organizada a partir del proyecto para ayudarte a probar combinaciones rápidamente y conseguir el efecto que deseas. ### Etiquetas (prompt) -#### Estilos musicales populares +#### Estilos musicales convencionales -Usa combinaciones cortas de etiquetas para generar estilos musicales concretos +Usa combinaciones cortas de etiquetas para generar estilos musicales específicos - electronic - rock @@ -131,8 +133,8 @@ Combina situaciones de uso y atmósferas concretas para generar música que enca - clean vocals #### Términos profesionales -Usa algunos términos habituales del mundo de la música para controlar con precisión el resultado musical -- 110 bpm (110 pulsaciones por minuto) +Usa algunos términos profesionales habituales en la música para controlar con precisión el resultado musical +- 110 bpm (beats per minute is 110) - fast tempo - slow tempo @@ -145,9 +147,9 @@ Usa algunos términos habituales del mundo de la música para controlar con prec - variance=0.3 (controla el grado de diferencia entre la música generada y el estilo original) */} {/* - Edición de la letra: - - editar la letra: 'When I was young' -> 'When you were kid' (ejemplo de edición de la letra) */} + - edit lyrics: 'When I was young' -> 'When you were kid' (ejemplo de edición de la letra) */} -### Letras +### Letra #### Etiquetas de estructura de la letra @@ -158,9 +160,9 @@ Usa algunos términos habituales del mundo de la música para controlar con prec #### Soporte multilingüe -- ACE-Step V1 admite varios idiomas. Al usarlo, ACE-Step convierte los distintos idiomas a letras del alfabeto inglés y luego genera la música. -- En ComfyUI, todavía no hemos implementado por completo la conversión de todos los idiomas a letras del alfabeto inglés. Por ahora, solo están implementados los [caracteres japoneses hiragana y katakana](https://github.com/Comfy-Org/ComfyUI/commit/5d3cc85e13833aeb6ef9242cdae243083e30c6fc). -Así que, si necesitas usar varios idiomas para generar música, primero debes convertir el idioma correspondiente a letras del alfabeto inglés y luego escribir la abreviatura del código de idioma al comienzo de `lyrics`, como el chino `[zh]`, el coreano `[ko]`, etc. +- ACE-Step V1 admite varios idiomas. Al usarlo, ACE-Step convierte los distintos idiomas a letras del alfabeto inglés y después genera la música. +- En ComfyUI no hemos implementado por completo la conversión de todos los idiomas a letras del alfabeto inglés. Actualmente solo están implementados los [caracteres japoneses hiragana y katakana](https://github.com/Comfy-Org/ComfyUI/commit/5d3cc85e13833aeb6ef9242cdae243083e30c6fc). +Así que si necesitas usar varios idiomas para generar música, primero debes convertir el idioma correspondiente a letras del alfabeto inglés y luego introducir la abreviatura del código de idioma al principio de `lyrics`, por ejemplo chino `[zh]`, coreano `[ko]`, etc. Por ejemplo: @@ -193,7 +195,7 @@ Por ejemplo: [fr]un amour profond qui ne s'éloignera jamais ``` -Actualmente, ACE-Step admite 19 idiomas, pero los siguientes diez tienen mejor soporte: +Actualmente, ACE-Step admite 19 idiomas, pero los diez siguientes tienen mejor soporte: - Inglés - Chino: [zh] - Ruso: [ru] diff --git a/es/tutorials/audio/minimax/minimax-music-3.mdx b/es/tutorials/audio/minimax/minimax-music-3.mdx index e073e34608..40e0a6f30d 100644 --- a/es/tutorials/audio/minimax/minimax-music-3.mdx +++ b/es/tutorials/audio/minimax/minimax-music-3.mdx @@ -2,19 +2,21 @@ title: "MiniMax Music 3 en ComfyUI: generación de música con IA" description: "Aprende a usar MiniMax Music 3 en ComfyUI para generar canciones completas de hasta 5 minutos a partir de un caption musical estructurado y una letra." sidebarTitle: "MiniMax Music 3" -translationSourceHash: dd9d217b +translationSourceHash: 02b650c1 translationFrom: tutorials/audio/minimax/minimax-music-3.mdx translationBlockHashes: "_intro": 883223ea "Key features": 7a913ea4 "Getting started": e1d3e891 + "MiniMax Music 3 Text to Music workflow": 822050b7 "Output": a0e21d03 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; MiniMax Music 3 -[MiniMax Music 3](https://github.com/MiniMax-AI/MiniMax-Music3) es el modelo de generación musical de MiniMax para crear canciones completas de hasta **cinco minutos** de duración. Condicionado por una letra y una descripción musical detallada, produce canciones estructuralmente coherentes con voces expresivas, arreglos que evolucionan y una calidad de audio estable en formatos largos. Puedes explorar ejemplos generados en la [página de demostración oficial](https://minimax-ai.github.io/music3-demo/). +[MiniMax Music 3](https://github.com/MiniMax-AI/MiniMax-Music3) es el modelo de generación musical de MiniMax para crear canciones completas de hasta **cinco minutos** de duración. Condicionado por una letra y una descripción musical detallada, produce canciones estructuralmente coherentes con voces expresivas, arreglos que evolucionan y una calidad de audio estable en piezas largas. Puedes explorar ejemplos generados en la [página de demostración oficial](https://minimax-ai.github.io/music3-demo/). MiniMax Music 3 utiliza una arquitectura autoregresiva jerárquica con un LLM global de 8B para la estructura musical de largo alcance, un LLM local de 0.6B para el detalle acústico a nivel de fotograma y un sistema de síntesis de estados ocultos continuos basado en Flow Matching y un Flow-VAE. Genera audio estéreo de 32 kHz y 16 bits. Los pesos del modelo están disponibles bajo la [Licencia Comunitaria de MiniMax-Music3](https://huggingface.co/MiniMaxAI/MiniMax-Music3/blob/main/LICENSE). @@ -30,7 +32,7 @@ La [Licencia Comunitaria](https://huggingface.co/MiniMaxAI/MiniMax-Music3/blob/m - **Canciones completas**: Genera pistas completas de hasta 5 minutos con intro, verso, preestribillo, estribillo, puente, interludio instrumental y outro - **Control de dos entradas**: Una **Caption** estructurada define el estilo musical, el estado de ánimo, las voces y el arreglo, mientras que **Lyrics**, con etiquetas de sección (`[Intro]`, `[Verse]`, `[Chorus]`, `[Bridge]`, `[Instrumental]`, `[Outro]`), controla la estructura de la canción - **Coherencia de largo alcance**: Mantiene los temas musicales, el ritmo, la identidad vocal y la progresión del arreglo a lo largo de secuencias largas -- **Voces expresivas**: Síntesis vocal natural con control sobre la melodía, la pronunciación y las armonías superpuestas +- **Voces expresivas**: Síntesis vocal natural con control sobre la melodía, la pronunciación y las armonías por capas - **Pesos abiertos**: Ejecútalo localmente en ComfyUI con control total sobre cada parámetro ## Primeros pasos @@ -39,13 +41,13 @@ MiniMax Music 3 es compatible con ComfyUI con pesos abiertos. Para empezar: 1. Actualiza ComfyUI a la última versión 2. Ve a **Biblioteca de plantillas** > **Audio** > elige el flujo de trabajo **MiniMax Music 3** -3. Sigue la ventana emergente para descargar los modelos y ejecutar el flujo de trabajo +3. Sigue las indicaciones de la ventana emergente para descargar los modelos y ejecutar el flujo de trabajo Los archivos de modelo listos para ComfyUI (modelo de difusión reempaquetado, text encoder y VAE) están alojados en Hugging Face en el repositorio [Comfy-Org/MiniMax-Music-3](https://huggingface.co/Comfy-Org/MiniMax-Music-3). Los pesos originales del modelo están disponibles en el repositorio [MiniMaxAI/MiniMax-Music3](https://huggingface.co/MiniMaxAI/MiniMax-Music3). ## Flujo de trabajo de texto a música de MiniMax Music 3 -Genera una canción completa a partir de un caption musical estructurado y una letra. +Genera una canción completa a partir de una descripción musical estructurada y una letra. Vista previa del flujo de trabajo de texto a música de MiniMax Music 3 @@ -54,21 +56,21 @@ Genera una canción completa a partir de un caption musical estructurado y una l Abrir en Comfy Cloud
- Descarga el JSON o busca "MiniMax Music 3" en la Biblioteca de plantillas + Descargar el JSON o buscar "MiniMax Music 3" en la biblioteca de plantillas
-El flujo de trabajo toma dos entradas de texto y produce una canción terminada. El text encoder genera la secuencia de conditioning acústico a partir del caption y la letra, el modelo de difusión sintetiza el latent de audio y el VAE de audio lo decodifica en una pista estéreo de 32 kHz guardada como MP3. +El flujo de trabajo toma dos entradas de texto y produce una canción finalizada. El codificador de texto genera la secuencia de acondicionamiento acústico a partir de la descripción y la letra, el modelo de difusión sintetiza el latente de audio y el VAE de audio lo decodifica en una pista estéreo de 32 kHz guardada como MP3. **Controles del flujo de trabajo**: -- **Caption**: La descripción musical. Escríbela en tres secciones: **Global Metadata** (género, BPM, tonalidad, escala, progresión emocional, contexto de escucha, perfil de producción), **Vocal Details** (género de la voz, timbre, estilo interpretativo, armonías, efectos vocales) y **Arrangement** (instrumentos principales y secundarios, groove, bajo, percusión, texturas, efectos espaciales). Cuanto más específico seas, más cerca quedará el resultado -- **Lyrics**: La letra que se va a cantar, con etiquetas de sección como `[Intro]`, `[Verse]`, `[Chorus]`, `[Bridge]`, `[Instrumental]` y `[Outro]`. Las etiquetas son las instrucciones estructurales; el texto de la letra transmite el estado de ánimo -- **max_duration**: Duración objetivo de la canción en segundos (la plantilla usa 60 segundos por defecto; el modelo admite hasta unos 300 segundos / 5 minutos). Las canciones más largas consumen más tiempo y VRAM -- **seed**: Semilla aleatoria de la generación. Mantenla fija para reproducir la misma canción; cámbiala para obtener otra versión -- **tiled_decode**: Decodifica el VAE de audio en mosaicos superpuestos para reducir el uso de VRAM, útil en canciones largas con GPU de poca VRAM. Es algo más lento y con un pequeño riesgo de costuras en los bordes de los mosaicos. Desactívalo en GPU con mucha VRAM para obtener la mejor calidad +- **Caption**: La descripción musical. Escríbela en tres secciones: **Global Metadata** (género, BPM, tonalidad, escala, progresión emocional, escenario de escucha, perfil de producción), **Vocal Details** (género vocal, timbre, estilo de interpretación, armonías, efectos vocales) y **Arrangement** (instrumentos principales y secundarios, groove, bajo, percusión, texturas, efectos espaciales). Cuanto más específica sea, más se acercará el resultado +- **Lyrics**: La letra que se cantará, con etiquetas de sección como `[Intro]`, `[Verse]`, `[Chorus]`, `[Bridge]`, `[Instrumental]` y `[Outro]`. Las etiquetas son las instrucciones estructurales; el texto de la letra transmite el estado de ánimo +- **max_duration**: Duración objetivo de la canción en segundos (la plantilla usa 60 segundos por defecto; el modelo admite hasta unos 300 segundos / 5 minutos). Las canciones más largas tardan más y consumen más VRAM +- **seed**: Semilla aleatoria para la generación. Mantenla fija para reproducir la misma canción; cámbiala para obtener una versión diferente +- **tiled_decode**: Decodifica el VAE de audio en mosaicos superpuestos para reducir el uso de VRAM, útil para canciones largas en GPU con poca VRAM. Es un poco más lento y tiene un pequeño riesgo de costuras en los límites de los mosaicos. Desactívalo en GPU con mucha VRAM para obtener la mejor calidad -### Descarga de modelos +### Descargas de modelos @@ -101,21 +103,20 @@ Coloca los archivos en los siguientes directorios: ### Consejos para escribir prompts -1. **Estructura el caption en tres secciones**: Global Metadata, Vocal Details y Arrangement. El modelo no solo sigue un estilo global, sino también el desarrollo musical de la canción a lo largo del tiempo +1. **Estructura la descripción en tres secciones**: Global Metadata, Vocal Details y Arrangement. El modelo sigue no solo un estilo global, sino también el desarrollo musical de la canción a lo largo del tiempo 2. **Usa etiquetas de sección en la letra**: `[Intro]`, `[Verse]`, `[Pre-Chorus]`, `[Chorus]`, `[Post-Chorus]`, `[Bridge]`, `[Instrumental]`, `[Solo]` y `[Outro]` le dan al modelo un control estructural explícito -3. **Deja las etiquetas como las únicas instrucciones estructurales**: las etiquetas son ejecutables; el texto de la letra por sí mismo transmite el estado de ánimo, no la estructura -4. **Equilibra duración y recursos**: las canciones más largas consumen más tiempo y VRAM. Usa el modelo de difusión INT8 y la decodificación por mosaicos para canciones largas en GPU de poca VRAM +3. **Mantén las etiquetas como las únicas instrucciones estructurales**: Las etiquetas son ejecutables; el texto de la letra en sí transmite el estado de ánimo, no la estructura +4. **Equilibra la duración y los recursos**: Las canciones más largas tardan más y consumen más VRAM. Usa el modelo de difusión INT8 y la decodificación en mosaicos para canciones largas en GPU con poca VRAM #### Guía para escribir prompts -La [página de demos oficial](https://minimax-ai.github.io/music3-demo/) muestra 26 pistas de ejemplo de 11 géneros (pop, rock, R&B, hip-hop, dance pop, country, soul, funk, blues, bossa nova y urbano), cada una con su caption estructurado completo escrito en el formato Global Metadata / Vocal Details / Arrangement. Úsalas como referencia para escribir tus propios captions. +La [página de demostración oficial](https://minimax-ai.github.io/music3-demo/) muestra 26 pistas de ejemplo de 11 géneros (pop, rock, R&B, hip-hop, dance pop, country, soul, funk, blues, bossa nova y urbano), cada una con su descripción estructurada completa escrita en el formato Global Metadata / Vocal Details / Arrangement. Úsalas como referencia para escribir tus propias descripciones. -MiniMax también publica una [skill oficial de reescritura de captions musicales](https://github.com/MiniMax-AI/MiniMax-Music3) que convierte una descripción musical breve y una letra con etiquetas opcional en un caption estructurado detallado de Music 3.0. La skill construye un arreglo coherente sección por sección, con metadatos globales, detalles vocales y descripciones del arreglo, y respeta las restricciones musicales explícitas mientras mantiene el texto de la letra en la entrada de lyrics. Instálala con: +MiniMax también publica una [habilidad oficial de reescritura de descripciones musicales](https://github.com/MiniMax-AI/MiniMax-Music3) que convierte una breve descripción musical y una letra etiquetada opcional en una descripción estructurada detallada de Music 3.0. La habilidad construye un arreglo coherente sección por sección con metadatos globales, detalles vocales y descripciones del arreglo, preservando las restricciones musicales explícitas y manteniendo el texto de la letra en la entrada de letra. Instálala con: ```bash npx skills add MiniMax-AI/MiniMax-Music3 --skill music-caption-rewriter ``` - ## Salida -La canción generada se guarda en `ComfyUI/output/audio/audio_minimax_music3.mp3` (o con el nombre de archivo definido en el nodo SaveAudioAdvanced). +ComfyUI guarda la canción generada en `ComfyUI/output/audio/audio_minimax_music3.mp3` (o con el nombre de archivo definido en el nodo SaveAudioAdvanced). diff --git a/es/tutorials/audio/yue2/yue2.mdx b/es/tutorials/audio/yue2/yue2.mdx index ab078c8dad..497ffbe966 100644 --- a/es/tutorials/audio/yue2/yue2.mdx +++ b/es/tutorials/audio/yue2/yue2.mdx @@ -2,15 +2,17 @@ title: "Guía de generación de música con YuE2 en ComfyUI" description: "Genera canciones completas con voces en ComfyUI con el modelo de código abierto YuE2: texto a música con planificación ABC y covers que conservan la melodía con SheetSage2." sidebarTitle: "YuE2" -translationSourceHash: 7197dbf5 +translationSourceHash: d90032ab translationFrom: tutorials/audio/yue2/yue2.mdx translationBlockHashes: "_intro": bae5280d "Text to Music {#audio_yue2_text2music}": a539576d + "Music Cover {#audio_yue2_music_cover}": 1915b2c2 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -YuE2 es un modelo de generación musical de código abierto de Multimodal Art Projection (m-a-p) que convierte un prompt de estilo y una letra en una canción completa con voces y acompañamiento instrumental. Es un modelo de 3B de parámetros, genera estructuras de canción completas con secciones como intro, verso, estribillo, puente y outro, y admite varios idiomas de canto, incluidos el inglés, el chino y el japonés. +YuE2 es un modelo de generación musical de código abierto de Multimodal Art Projection (m-a-p) que convierte un prompt de estilo y una letra en una canción completa con voces y acompañamiento instrumental. Es un modelo de 3B de parámetros que genera estructuras de canción completas con secciones como intro, verso, estribillo, puente y outro, y admite varios idiomas de canto, incluidos el inglés, el chino y el japonés. Lo que distingue a YuE2 de la mayoría de los sistemas de texto a música es su paso de composición editable. Antes de generar el audio, YuE2 puede escribir primero un plan musical simbólico en notación ABC: una melodía, opcionalmente con acordes, que puedes inspeccionar y editar. La canción final se renderiza a partir de ese plan. Esto hace que los resultados sean más fáciles de dirigir que la generación de audio en una sola pasada, y también habilita el flujo de trabajo de cover que aparece más abajo, donde una canción de referencia se transcribe a la misma notación y se vuelve a cantar con un nuevo estilo y una nueva letra. @@ -19,7 +21,7 @@ YuE2 es compatible de forma nativa con ComfyUI. Actualiza a la última versión - YuE2 aún no está disponible en Comfy Cloud. Ambos flujos de trabajo de esta página se ejecutan en una instalación local de ComfyUI, así que no hay ninguna plantilla de Cloud que abrir para ellos. + YuE2 aún no está disponible en Comfy Cloud. Ambos flujos de trabajo de esta página se ejecutan en una instalación local de ComfyUI, así que no hay ninguna plantilla de Cloud que abrir para ninguno de los dos. ## Texto a música {#audio_yue2_text2music} @@ -117,19 +119,19 @@ El nodo **YuE2 Generate Music** tiene una opción avanzada `cfg_scale` (de 0 a 1 - `1.0` desactiva la orientación, lo que coincide con el flujo de trabajo ABC. Las plantillas incluidas mantienen este valor predeterminado - `1.01` coincide con la escala de orientación que el modelo usaba antes de añadir esta opción, para ejecuciones con la planificación desactivada (`abc` vacío) -## Versión de una canción existente (Music Cover) {#audio_yue2_music_cover} +## Cover musical {#audio_yue2_music_cover} -Crea una nueva versión de una canción existente. Este flujo de trabajo usa SheetSage2 para transcribir la melodía de un audio de referencia a una partitura ABC editable y luego usa YuE2 para regenerar la canción con un estilo y una letra nuevos. +Crea una nueva versión de una canción existente. Este flujo de trabajo usa SheetSage2 para transcribir la melodía de un audio de referencia a una partitura ABC editable, y luego usa YuE2 para regenerar la canción con un nuevo estilo y letra. -Vista previa del flujo de trabajo de Music Cover de YuE2 +Vista previa del flujo de trabajo de cover musical de YuE2 {/* TODO: Enable Cloud template when audio_yue2_music_cover is available on Comfy Cloud */} - {/**/} - {/* Abrir en Comfy Cloud*/} + {/**/} + {/* Open in Comfy Cloud*/} {/**/} - Descarga el JSON o busca "YuE2: Music Cover" en la Biblioteca de plantillas + Descarga el JSON o busca "YuE2: Music Cover" en Template Library @@ -139,7 +141,7 @@ Sube este archivo al nodo `LoadAudio` correspondiente: - Nodo `LoadAudio` · `yue2_reference_song.flac` + nodo `LoadAudio` · `yue2_reference_song.flac` @@ -147,18 +149,18 @@ Sube este archivo al nodo `LoadAudio` correspondiente: 1. Carga una canción de referencia en **Audio** 2. Describe la nueva dirección musical en **Style** -3. Introduce la letra que quieres que se cante en **Lyrics** -4. Encola el flujo de trabajo para generar una nueva versión +3. Introduce la letra que quieres cantar en **Lyrics** +4. Pon en cola el flujo de trabajo para generar una nueva versión de cover -El audio de referencia aporta la melodía, mientras que YuE2 crea una nueva interpretación y un nuevo arreglo a partir de tu Style y tu Lyrics. +El audio de referencia proporciona la melodía, mientras que YuE2 crea una nueva interpretación y arreglo basados en tu Style y Lyrics. -### 2. Descarga de modelos +### 2. Descargas de modelos - + yue2_3b_int8_convrot.safetensors - + sheetsage2_bf16.safetensors @@ -174,9 +176,9 @@ Coloca los archivos en los siguientes directorios: │ └── sheetsage2_bf16.safetensors ``` -### 3. Cómo funciona la versión +### 3. Cómo funciona el cover -El flujo de trabajo no pasa el audio de referencia directamente a YuE2. En su lugar: +El flujo de trabajo no alimenta directamente el audio de referencia a YuE2. En su lugar: ``` Reference Audio @@ -188,12 +190,12 @@ Melody ABC score YuE2 (generation with new Style and Lyrics) ``` -Como el vínculo con la canción original es la melodía, las versiones funcionan mejor cuando la letra nueva se mantiene razonablemente cerca de la frase y del número de sílabas del original. +Dado que la conexión con la canción original es la melodía, los covers funcionan mejor cuando la nueva letra se mantiene razonablemente cerca de la fraseología y el número de sílabas originales. -### 4. Escribir el Style y la letra +### 4. Escribir el estilo y la letra -Describe con claridad el estilo musical objetivo. Los elementos útiles incluyen género, tipo de voz, idioma, tempo, instrumentos y ambiente: +Describe claramente el estilo musical objetivo. Los elementos útiles incluyen género, tipo de voz, idioma, tempo, instrumentos y estado de ánimo: -> English, soulful jazz-pop, expressive male vocal, relaxed 88 BPM, Rhodes piano, upright bass, brushed drums, warm saxophone, intimate late-night atmosphere +> Inglés, jazz-pop con alma, voz masculina expresiva, 88 BPM relajado, piano Rhodes, contrabajo, batería con escobillas, saxofón cálido, ambiente íntimo de madrugada -Usa las mismas etiquetas de sección `[Verse]` / `[Chorus]` / `[Bridge]` / `[Outro]` que en el flujo de trabajo de texto a música. Para que la melodía encaje mejor, mantén la letra nueva con una longitud similar a la de los versos originales. +Usa las mismas etiquetas de sección `[Verse]` / `[Chorus]` / `[Bridge]` / `[Outro]` que el flujo de trabajo de texto a música. Para lograr una mejor coincidencia de la melodía, mantén la nueva letra con una longitud similar a las líneas originales. diff --git a/es/tutorials/basic/text-to-image.mdx b/es/tutorials/basic/text-to-image.mdx index ae26c06616..56189f835e 100644 --- a/es/tutorials/basic/text-to-image.mdx +++ b/es/tutorials/basic/text-to-image.mdx @@ -2,24 +2,26 @@ title: "Flujo de trabajo de texto a imagen en ComfyUI" description: "Crea un flujo de trabajo de texto a imagen en ComfyUI: carga el flujo predeterminado, instala un checkpoint SD1.5, escribe prompts y aprende qué hace cada nodo." sidebarTitle: "Texto a imagen" -translationSourceHash: c01b7291 +translationSourceHash: af5280d9 translationFrom: tutorials/basic/text-to-image.mdx translationBlockHashes: "_intro": 7f6b5c90 "What is text-to-image in ComfyUI? {#about-text-to-image}": 4bc00444 + "ComfyUI Text to Image Workflow Example Guide": d5496194 "How does text-to-image work? {#text-to-image-working-principles}": 827d5189 "ComfyUI Text to Image Workflow Node Explanation": 1978408d "Introduction to SD1.5 Model": cd91e138 --- + Esta guía tiene como objetivo presentarte el flujo de trabajo de texto a imagen de ComfyUI y ayudarte a comprender la funcionalidad y el uso de los distintos nodos de ComfyUI. En este documento, vamos a: - Completar un flujo de trabajo de texto a imagen - Obtener una comprensión básica de los principios de los modelos de difusión -- Conocer las funciones y los roles de los nodos del flujo de trabajo +- Conocer las funciones y el papel de los nodos del flujo de trabajo - Obtener una comprensión inicial del modelo SD1.5 -Comenzaremos ejecutando un flujo de trabajo de texto a imagen y, a continuación, explicaremos los conceptos relacionados. Elige las secciones relevantes según tus necesidades. +Comenzaremos ejecutando un flujo de trabajo de texto a imagen y, a continuación, explicaremos los conceptos relacionados. Elige las secciones que necesites. ## ¿Qué es texto a imagen en ComfyUI? {#about-text-to-image} @@ -36,53 +38,53 @@ Puedes entender este proceso de generación de texto a imagen simplemente como d ### 1. Preparación -Asegúrate de tener al menos un archivo de modelo SD1.5 en tu carpeta `ComfyUI/models/checkpoints`, como [v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors) +Asegúrate de tener al menos un archivo de modelo SD1.5 en tu carpeta `ComfyUI/models/checkpoints`, por ejemplo [v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors) -Si todavía no lo has instalado, consulta la sección de instalación de modelos en [Primeros pasos con la generación de arte con IA de ComfyUI](/es/get_started/first_generation). +Si aún no lo has instalado, consulta la sección de instalación de modelos en [Primeros pasos con la generación de arte con IA de ComfyUI](/es/get_started/first_generation). -### 2. Cargar el flujo de trabajo de texto a imagen +### 2. Cargar el flujo de trabajo Texto a imagen -Descarga la imagen de abajo y **arrástrala a ComfyUI** para cargar el flujo de trabajo: +Descarga la imagen que aparece a continuación y **arrástrala a ComfyUI** para cargar el flujo de trabajo: -Flujo de trabajo de texto a imagen de ComfyUI +Flujo de trabajo Texto a imagen de ComfyUI -Las imágenes que llevan el JSON del flujo de trabajo en sus metadatos se pueden arrastrar directamente a ComfyUI o cargar con el menú `Workflows` -> `Open (ctrl+o)`. +Puedes arrastrar directamente a ComfyUI las imágenes que contengan el JSON del flujo de trabajo en sus metadatos, o cargarlas con el menú `Workflows` -> `Open (ctrl+o)`. ### 3. Cargar el modelo y generar tu primera imagen -Después de instalar el modelo de imagen, sigue los pasos de la imagen de abajo para cargar el modelo y generar tu primera imagen +Después de instalar el modelo de imagen, sigue los pasos de la imagen a continuación para cargar el modelo y generar tu primera imagen -![Generación de imágenes](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/image/basic/text-to-image-workflow.png) +![Generación de imagen](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/image/basic/text-to-image-workflow.png) Sigue estos pasos según los números de la imagen: -1. En el nodo **Load Checkpoint**, usa las flechas o haz clic en el área de texto para asegurarte de que **v1-5-pruned-emaonly-fp16.safetensors** está seleccionado y de que las flechas izquierda/derecha no muestran el texto **null** -2. Haz clic en el botón `Queue` o usa el atajo `Ctrl + Enter` para ejecutar la generación de imágenes +1. En el nodo **Load Checkpoint**, usa las flechas o haz clic en el área de texto para asegurarte de que **v1-5-pruned-emaonly-fp16.safetensors** esté seleccionado y de que las flechas izquierda/derecha no muestren el texto **null** +2. Haz clic en el botón `Queue` o usa el atajo `Ctrl + Enter` para ejecutar la generación de la imagen -Cuando termine el proceso, deberías ver la imagen resultante en la interfaz del nodo **Save Image**, donde puedes hacer clic derecho para guardarla localmente +Cuando el proceso termine, deberías ver la imagen resultante en la interfaz del nodo **Save Image**, y puedes hacer clic derecho sobre ella para guardarla localmente -![Resultado de la primera generación de imágenes con ComfyUI](/images/tutorial/gettingstarted/result.png) +![Resultado de la primera generación de imagen con ComfyUI](/images/tutorial/gettingstarted/result.png) -Si no estás satisfecho con el resultado, prueba a ejecutar la generación varias veces. Cada vez que la ejecutes, **KSampler** usará una semilla aleatoria distinta según el parámetro `seed`, así que cada generación producirá resultados diferentes +Si no estás satisfecho con el resultado, prueba a ejecutar la generación varias veces. Cada vez que la ejecutes, **KSampler** usará una semilla aleatoria diferente según el parámetro `seed`, así que cada generación producirá resultados distintos -### 4. Empieza a experimentar +### 4. Comenzar a experimentar -Prueba a modificar el texto del **CLIP Text Encoder** +Intenta modificar el texto en el **CLIP Text Encoder** ![CLIP Text Encoder](/images/comfy_core/conditioning/clip_text_encode.jpg) -La conexión `Positive` con el nodo KSampler representa los prompts positivos, mientras que la conexión `Negative` representa los prompts negativos +La conexión `Positive` al nodo KSampler representa los prompts positivos, mientras que la conexión `Negative` representa los prompts negativos Estos son algunos principios básicos para escribir prompts con el modelo SD1.5: - Usa inglés siempre que sea posible - Separa los prompts con comas en inglés `,` - Usa frases en lugar de oraciones largas - Usa descripciones específicas -- Usa expresiones como `(golden hour:1.2)` para aumentar el peso de una palabra clave concreta y hacer que aparezca más fácilmente en la imagen. `1.2` es el peso y `golden hour` es la palabra clave +- Usa expresiones como `(golden hour:1.2)` para aumentar el peso de palabras clave concretas y lograr que aparezcan con más probabilidad en la imagen. `1.2` es el peso y `golden hour` es la palabra clave - Usa palabras clave como `masterpiece, best quality, 4k` para mejorar la calidad de la generación -Aquí tienes varios ejemplos de prompts que puedes probar, o usa tus propios prompts para generar: +Aquí tienes varios ejemplos de prompts que puedes probar, o puedes usar tus propios prompts para generar: **1. Estilo anime** @@ -114,7 +116,7 @@ Prompts negativos: (deformed, cartoon, anime, doll, plastic skin, overexposed, blurry, extra fingers) ``` -**3. Estilo de un artista concreto** +**3. Estilo de un artista específico** Prompts positivos: ``` @@ -125,10 +127,9 @@ Prompts negativos: ``` blurry, low detail, cartoonish, unrealistic anatomy, out of focus, cluttered, flat lighting ``` - ## ¿Cómo funciona el texto a imagen? {#text-to-image-working-principles} -Todo el proceso de texto a imagen puede entenderse como un **proceso de difusión inversa**. El [v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors) que descargamos es un modelo preentrenado que puede **generar imágenes objetivo a partir de ruido gaussiano puro**. Solo hace falta introducir nuestros prompts y puede generar imágenes objetivo mediante la eliminación de ruido aleatorio. +Todo el proceso de texto a imagen se puede entender como un **proceso de difusión inversa**. El [v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors) que descargamos es un modelo preentrenado que puede **generar imágenes objetivo a partir de ruido gaussiano puro**. Solo tenemos que introducir nuestros prompts y puede generar imágenes objetivo eliminando el ruido aleatorio. ```mermaid graph LR @@ -141,10 +142,10 @@ G --> B ``` Necesitamos entender dos conceptos: -1. **Espacio latente:** el espacio latente es un método abstracto de representación de datos en los modelos de difusión. Convertir las imágenes del espacio de píxeles al espacio latente reduce el espacio de almacenamiento, facilita el entrenamiento de los modelos de difusión y reduce la complejidad de la eliminación de ruido. Es como los arquitectos que usan planos (espacio latente) para diseñar en lugar de diseñar directamente sobre el edificio (espacio de píxeles): mantienen las características estructurales y a la vez reducen de forma significativa los costos de modificación. -2. **Espacio de píxeles:** el espacio de píxeles es el espacio de almacenamiento de las imágenes, es decir, la imagen final que vemos, y se usa para almacenar los valores de píxeles. +1. **Espacio latente:** el espacio latente es un método abstracto de representación de datos en los modelos de difusión. Convertir las imágenes del espacio de píxeles al espacio latente reduce el espacio de almacenamiento y facilita el entrenamiento de los modelos de difusión, además de reducir la complejidad del denoising. Es como los arquitectos que usan planos (espacio latente) para diseñar en lugar de diseñar directamente sobre el edificio (espacio de píxeles): mantienen las características estructurales y reducen significativamente los costos de modificación. +2. **Espacio de píxeles:** el espacio de píxeles es el espacio de almacenamiento de las imágenes, es decir, la imagen final que vemos, y se usa para almacenar los valores de los píxeles. -Si quieres aprender más sobre los modelos de difusión, puedes leer estos artículos: +Si quieres aprender más acerca de los modelos de difusión, puedes leer estos artículos: - [Denoising Diffusion Probabilistic Models (DDPM)](https://arxiv.org/pdf/2006.11239) - [Denoising Diffusion Implicit Models (DDIM)](https://arxiv.org/pdf/2010.02502) - [High-Resolution Image Synthesis with Latent Diffusion Models](https://arxiv.org/pdf/2112.10752) @@ -159,15 +160,15 @@ Si quieres aprender más sobre los modelos de difusión, puedes leer estos artí Este nodo se usa normalmente para cargar el modelo de generación de imágenes. Un `checkpoint` suele contener tres componentes: `MODEL (UNet)`, `CLIP` y `VAE` -- `MODEL (UNet)`: el modelo UNet encargado de predecir el ruido y generar la imagen durante el proceso de difusión -- `CLIP`: el codificador de texto que convierte tus prompts en vectores que el modelo puede entender, ya que el modelo no comprende directamente los prompts de texto -- `VAE`: el AutoEncoder Variacional que convierte las imágenes entre el espacio de píxeles y el espacio latente, ya que los modelos de difusión trabajan en el espacio latente mientras que las imágenes están en el espacio de píxeles +- `MODEL (UNet)`: el modelo UNet responsable de la predicción del ruido y de la generación de la imagen durante el proceso de difusión +- `CLIP`: el codificador de texto que convierte nuestros prompts en vectores que el modelo puede entender, ya que el modelo no puede comprender directamente los prompts de texto +- `VAE`: el Variational AutoEncoder que convierte las imágenes entre el espacio de píxeles y el espacio latente, ya que los modelos de difusión trabajan en el espacio latente mientras que nuestras imágenes están en el espacio de píxeles ### B. Nodo Empty Latent Image ![Empty Latent Image](/images/comfy_core/latent/empty_latent_image.jpg) -Define un espacio latente que se envía al nodo KSampler. El nodo Empty Latent Image construye una **imagen latente de ruido puro** +Define un espacio latente que se envía al nodo KSampler. El nodo Empty Latent Image construye un **espacio latente de ruido puro** Puedes pensar en su función como la de definir el tamaño del lienzo, que determina las dimensiones de la imagen final generada @@ -175,17 +176,17 @@ Puedes pensar en su función como la de definir el tamaño del lienzo, que deter ![CLIP Text Encoder](/images/comfy_core/conditioning/clip_text_encode.jpg) -Sirve para codificar los prompts, es decir, tus requisitos para la imagen -- La entrada de acondicionamiento `Positive` conectada al nodo KSampler representa los prompts positivos (los elementos que quieres en la imagen) -- La entrada de acondicionamiento `Negative` conectada al nodo KSampler representa los prompts negativos (los elementos que no quieres en la imagen) +Se usa para codificar los prompts, que son tus requisitos para la imagen +- La entrada de condición `Positive` conectada al nodo KSampler representa los prompts positivos (los elementos que quieres en la imagen) +- La entrada de condición `Negative` conectada al nodo KSampler representa los prompts negativos (los elementos que no quieres en la imagen) -El componente `CLIP` del nodo `Load Checkpoint` codifica los prompts en vectores semánticos y los envía como acondicionamientos al nodo KSampler +El componente `CLIP` del nodo `Load Checkpoint` codifica los prompts en vectores semánticos y los envía como condiciones al nodo KSampler ### D. Nodo KSampler ![KSampler](/images/comfy_core/sampling/k_sampler.png) -El **KSampler** es el núcleo de todo el flujo de trabajo: en él ocurre todo el proceso de eliminación de ruido y, al final, entrega una imagen en el espacio latente +El **KSampler** es el núcleo de todo el flujo de trabajo: en él ocurre todo el proceso de eliminación de ruido y al final genera una imagen en el espacio latente ```mermaid graph LR @@ -195,31 +196,31 @@ D[CLIP Semantic Vectors] --> B B --> E[Denoised Latent] ``` -Aquí tienes una explicación de los parámetros del nodo KSampler: +A continuación, se explican los parámetros del nodo KSampler: -| Nombre del parámetro | Descripción | Función | -|----------------------------|----------------------------------------------|----------------------------------------------------------------------------------------------------------------------| -| **model** | Modelo de difusión usado para eliminar ruido | Determina el estilo y la calidad de las imágenes generadas | -| **positive** | Codificación del acondicionamiento positivo | Orienta la generación para incluir los elementos especificados | -| **negative** | Codificación del acondicionamiento negativo | Suprime el contenido no deseado | -| **latent_image** | Imagen en espacio latente a la que se quita el ruido | Actúa como soporte de entrada para inicializar el ruido | -| **seed** | Semilla aleatoria para generar el ruido | Controla la aleatoriedad de la generación | -| **control_after_generate** | Modo de control de la semilla tras generar | Determina el patrón de variación de la semilla en la generación por lotes | -| **steps** | Número de iteraciones de eliminación de ruido| Más pasos significan más detalles, pero también más tiempo de procesamiento | -| **cfg** | Escala de orientación sin clasificador | Controla la fuerza de la restricción del prompt (un valor demasiado alto provoca sobreajuste) | -| **sampler_name** | Nombre del algoritmo de muestreo | Determina el método matemático de la trayectoria de eliminación de ruido | -| **scheduler** | Tipo de scheduler | Controla la tasa de decaimiento del ruido y la asignación del tamaño del paso | -| **denoise** | Coeficiente de fuerza de eliminación de ruido| Controla la fuerza del ruido añadido al espacio latente: 0.0 conserva las características originales de la entrada y 1.0 es ruido completo | +| Nombre del parámetro | Descripción | Función | +|-----------------------------|----------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------| +| **model** | Modelo de difusión usado para eliminar el ruido | Determina el estilo y la calidad de las imágenes generadas | +| **positive** | Codificación de la condición del prompt positivo | Guía la generación para incluir los elementos especificados | +| **negative** | Codificación de la condición del prompt negativo | Suprime el contenido no deseado | +| **latent_image** | Imagen del espacio latente a la que se quitará el ruido | Sirve como soporte de entrada para la inicialización del ruido | +| **seed** | Semilla aleatoria para generar el ruido | Controla la aleatoriedad de la generación | +| **control_after_generate** | Modo de control de la semilla después de generar | Determina el patrón de variación de la semilla en la generación por lotes | +| **steps** | Número de iteraciones de eliminación de ruido | Más pasos implican detalles más finos, pero mayor tiempo de procesamiento | +| **cfg** | Escala de orientación sin clasificador | Controla la fuerza de la restricción del prompt (un valor demasiado alto provoca sobreajuste) | +| **sampler_name** | Nombre del algoritmo de muestreo | Determina el método matemático de la trayectoria de eliminación de ruido | +| **scheduler** | Tipo de planificador | Controla la tasa de decaimiento del ruido y la asignación del tamaño de paso | +| **denoise** | Coeficiente de fuerza de la eliminación de ruido | Controla la fuerza del ruido que se añade al espacio latente: 0.0 conserva las características de la entrada original y 1.0 es ruido completo | -En el nodo KSampler, el espacio latente usa `seed` como parámetro de inicialización para construir el ruido aleatorio, y los vectores semánticos `Positive` y `Negative` se envían como acondicionamientos al modelo de difusión +En el nodo KSampler, el espacio latente usa `seed` como parámetro de inicialización para construir ruido aleatorio, y los vectores semánticos `Positive` y `Negative` entran como condiciones al modelo de difusión -Después, según el número de pasos de eliminación de ruido indicado por el parámetro `steps`, se ejecuta la eliminación de ruido. Cada paso usa el coeficiente de fuerza de eliminación de ruido indicado por el parámetro `denoise` para quitar ruido al espacio latente y generar una nueva imagen en el espacio latente +Después, el nodo elimina ruido durante el número de pasos que indica el parámetro `steps`. Cada paso de eliminación de ruido usa el coeficiente de fuerza que especifica el parámetro `denoise` para eliminar el ruido del espacio latente y generar una nueva imagen en el espacio latente ### E. Nodo VAE Decode ![VAE Decode](/images/comfy_core/latent/vae_decode.jpg) -Convierte la imagen en espacio latente que entrega el **KSampler** en una imagen en el espacio de píxeles +Convierte la imagen del espacio latente que genera el **KSampler** en una imagen del espacio de píxeles ### F. Nodo Save Image @@ -229,18 +230,19 @@ Previsualiza y guarda en la carpeta local `ComfyUI/output` la imagen decodificad ## Introducción al modelo SD1.5 -**SD1.5 (Stable Diffusion 1.5)** es un modelo de generación de imágenes con IA desarrollado por [Stability AI](https://stability.ai/). Es la versión fundacional de la serie Stable Diffusion, entrenada con imágenes de resolución **512×512**, lo que la hace especialmente buena generando imágenes a esa resolución. Con un tamaño de unos 4 GB, funciona sin problemas en **GPUs de consumo (por ejemplo, 6 GB de VRAM)**. Actualmente, SD1.5 cuenta con un ecosistema muy rico, con soporte para diversos plugins (como ControlNet, LoRA) y herramientas de optimización. -Como modelo emblemático en la generación de arte con IA, SD1.5 sigue siendo la mejor opción para empezar gracias a su naturaleza de código abierto, su arquitectura ligera y su rico ecosistema. Aunque se han publicado versiones más recientes como SDXL/SD3, su valor para hardware de consumo sigue siendo inigualable. +**SD1.5 (Stable Diffusion 1.5)** es un modelo de generación de imágenes con IA desarrollado por [Stability AI](https://stability.ai/). Es la versión fundacional de la serie Stable Diffusion, entrenada con imágenes de **512×512** de resolución, lo que la hace especialmente buena para generar imágenes a esa resolución. Con un tamaño de unos 4GB, funciona sin problemas en **GPUs de consumo (por ejemplo, 6GB de VRAM)**. Actualmente, SD1.5 cuenta con un ecosistema rico que admite varios plugins (como ControlNet, LoRA) y herramientas de optimización. + +Como modelo hito en la generación de arte con IA, SD1.5 sigue siendo la mejor opción de entrada gracias a su naturaleza de código abierto, su arquitectura ligera y su rico ecosistema. Aunque se han lanzado versiones más recientes como SDXL/SD3, su valor para el hardware de consumo sigue siendo inigualable. ### Información básica - **Fecha de lanzamiento**: octubre de 2022 -- **Arquitectura principal**: basada en Latent Diffusion Model (LDM) +- **Arquitectura principal**: basada en el modelo de difusión latente (LDM) - **Datos de entrenamiento**: conjunto de datos LAION-Aesthetics v2.5 (aproximadamente 590M pasos de entrenamiento) - **Características de código abierto**: modelo, código y datos de entrenamiento totalmente abiertos ### Ventajas y limitaciones Ventajas del modelo: -- Ligero: tamaño pequeño, solo unos 4 GB, funciona sin problemas en GPUs de consumo +- Ligero: tamaño pequeño, solo unos 4GB, funciona sin problemas en GPUs de consumo - Barrera de entrada baja: admite una amplia gama de plugins y herramientas de optimización - Ecosistema maduro: amplio soporte de plugins y herramientas - Generación rápida: funcionamiento fluido en GPUs de consumo diff --git a/es/tutorials/flux/flux-1-uso.mdx b/es/tutorials/flux/flux-1-uso.mdx index 576d0cb3a3..b49bea67c2 100644 --- a/es/tutorials/flux/flux-1-uso.mdx +++ b/es/tutorials/flux/flux-1-uso.mdx @@ -1,15 +1,15 @@ --- -title: "ByteDance USO en ComfyUI: flujos de referencia de estilo y sujeto" +title: "ByteDance USO en ComfyUI: flujos de trabajo de referencia de estilo y sujeto" description: "Ejecuta ByteDance USO sobre FLUX.1-dev en ComfyUI para mantener la identidad de un sujeto, transferir un estilo de referencia o combinar ambos." sidebarTitle: "ByteDance USO" -translationSourceHash: 5b3c5241 +translationSourceHash: 970fff4a translationFrom: tutorials/flux/flux-1-uso.mdx --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' **USO (Unified Style-Subject Optimized)** es un modelo desarrollado por el equipo UXO de ByteDance que unifica las tareas de generación guiadas por estilo y por sujeto. -Construido sobre la arquitectura FLUX.1-dev, el modelo logra tanto similitud de estilo como consistencia del sujeto mediante aprendizaje desacoplado y aprendizaje con recompensa de estilo (SRL). +Basado en la arquitectura FLUX.1-dev, el modelo logra tanto similitud de estilo como consistencia del sujeto mediante aprendizaje desacoplado y aprendizaje con recompensa de estilo (SRL). USO admite tres enfoques principales: - **Guiado por sujeto**: coloca al sujeto en escenas nuevas mientras mantienes la consistencia de su identidad @@ -117,7 +117,7 @@ Descarga todos los modelos y colócalos en los siguientes directorios: 1. Solo referencia de estilo: -También incluimos una versión que solo usa la referencia de estilo dentro del mismo flujo de trabajo que proporcionamos. +También proporcionamos un flujo de trabajo que solo usa la referencia de estilo dentro del mismo flujo de trabajo que proporcionamos. ![Flujo de trabajo](/images/tutorial/flux/flux1_uso_reference_image_gen_style_reference_only.jpg) La única diferencia es que reemplazamos el nodo `content reference` y solo usamos un nodo `Empty Latent Image`. diff --git a/es/tutorials/flux/flux-3-klein.mdx b/es/tutorials/flux/flux-3-klein.mdx index ff263a9586..78d720e518 100644 --- a/es/tutorials/flux/flux-3-klein.mdx +++ b/es/tutorials/flux/flux-3-klein.mdx @@ -2,19 +2,21 @@ title: "FLUX 3 Image Klein en ComfyUI: texto a imagen y edición" description: "Ejecuta FLUX.3 [klein] en local en ComfyUI: texto a imagen con pesos abiertos y edición por instrucciones, con un checkpoint destilado para 4–16 pasos." sidebarTitle: "FLUX 3 Klein" -translationSourceHash: 5c435b1b +translationSourceHash: 7cedfbb4 translationFrom: tutorials/flux/flux-3-klein.mdx translationBlockHashes: "_intro": 3e9c5a21 "About FLUX.3 [klein]": 1d7659ce "FLUX 3 Image Klein Workflows": d0941358 + "FLUX 3 Image Klein Model Downloads": 0170574c "Prompting and reference tips": 43ad4a36 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' ## Acerca de FLUX.3 [klein] -FLUX.3 [klein] es el modelo de imágenes FLUX.3 de pesos abiertos de Black Forest Labs para ComfyUI local: texto a imagen y edición de imágenes guiada por instrucciones en una misma familia, con un checkpoint completo y una variante destilada por pasos para ejecuciones más rápidas de 4–16 pasos. Los pesos están disponibles en Hugging Face bajo la licencia FLUX Kommunity. Descárgalo una vez y ejecútalo en tu propia GPU, sin clave API ni créditos por imagen. +FLUX.3 [klein] es el modelo de imágenes FLUX.3 de pesos abiertos de Black Forest Labs para ComfyUI local: texto a imagen y edición de imágenes guiada por instrucciones en una misma familia, con un checkpoint completo y una variante destilada por pasos para ejecuciones más rápidas de 4–16 pasos. Los pesos se publican en Hugging Face bajo la Licencia FLUX Kommunity. Descárgalo una vez, ejecútalo en tu propia GPU, sin clave API ni créditos por imagen. ¿Prefieres la ruta alojada? FLUX.3 también se ejecuta como Partner Node mediante [FLUX 3 Image](/es/tutorials/partner-nodes/black-forest-labs/flux-3-image) (con cobro por imagen). Usa los pesos locales de klein en tu GPU; usa el Partner Node cuando quieras el modelo alojado sin descarga. @@ -23,7 +25,7 @@ FLUX.3 [klein] es el modelo de imágenes FLUX.3 de pesos abiertos de Black Fores - Texto a imagen y edición de imágenes con los mismos pesos; las ediciones usan un prompt de instrucción e imágenes de referencia - Dos checkpoints: FLUX 3 Image Klein completo y Distilled para muestreo sin orientación en 4–16 pasos - Prompts con múltiples referencias mediante ``, ``, etc. -- Ampliador de prompts Qwen3.5 9B opcional que expande solicitudes breves a descripciones completas antes de la generación +- Upsampler de prompts Qwen3.5 9B opcional que expande solicitudes breves en descripciones completas antes de la generación - Checkpoints de archivo único en bf16, int8 (convrot) y nvfp4, con un codificador de texto Qwen3-VL-4B y el VAE de FLUX.2 **Licencia**: [FLUX Kommunity License](https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy/blob/main/LICENSE.md) @@ -36,7 +38,7 @@ FLUX.3 [klein] es el modelo de imágenes FLUX.3 de pesos abiertos de Black Fores ### FLUX 3 Image Klein: Texto a imagen {#image_flux3_klein_t2i} -Genera una imagen solo a partir de un prompt, sin archivos de entrada. El flujo de trabajo es un subgrafo: ábrelo para acceder a los cargadores, al sampler y al tamaño del lienzo. +Genera una imagen a partir de un prompt, sin archivos de entrada. El flujo de trabajo es un subgrafo: ábrelo para acceder a los cargadores, al sampler y al tamaño del lienzo. Vista previa del flujo de trabajo de texto a imagen de FLUX 3 Image Klein @@ -50,16 +52,16 @@ Genera una imagen solo a partir de un prompt, sin archivos de entrada. El flujo 1. Escribe tu prompt en el widget de prompt positivo del subgrafo -2. Configura `width` y `height`, o elige un formato en `ResolutionSelector` (1:1 cuadrado por defecto) -3. Ajusta `steps` (50 por defecto) y `cfg` (3.5 por defecto) -4. El upsampler de prompt está activado por defecto, así que un prompt corto se expande con el upsampler Qwen3.5 9B antes del muestreo. Desactiva `enable_prompt_upsampler` para generar a partir de tus propias palabras +2. Define `width` y `height`, o elige un formato en `ResolutionSelector` (1:1 cuadrado de forma predeterminada) +3. Ajusta `steps` (50 de forma predeterminada) y `cfg` (3.5 de forma predeterminada) +4. El ampliador de prompts está activado de forma predeterminada, así que un prompt corto se amplía con el ampliador Qwen3.5 9B antes del muestreo. Desactiva `enable_prompt_upsampler` para generar a partir de tus propias palabras 5. Haz clic en **Queue**. El nodo `SaveImage` guarda la imagen en `ComfyUI/output/` ### FLUX 3 Image Klein Distilled: Texto a imagen {#image_flux3_klein_distilled_t2i} -Genera una imagen a partir de un prompt con el checkpoint destilado por pasos, que se ejecuta en 16 pasos sin orientación. El sobremuestreo del prompt está activado de forma predeterminada, así que un prompt corto se expande a una descripción completa antes del muestreo. +Genera una imagen a partir de un prompt con el checkpoint destilado por pasos, que se ejecuta en 16 pasos sin orientación. La ampliación del prompt está activada de forma predeterminada, por lo que un prompt corto se expande a una descripción completa antes del muestreo. -Vista previa del flujo de trabajo de FLUX 3 Image Klein Distilled de texto a imagen +Vista previa del flujo de trabajo de texto a imagen de FLUX 3 Image Klein Distilled @@ -70,18 +72,18 @@ Genera una imagen a partir de un prompt con el checkpoint destilado por pasos, q -1. Escribe tu prompt. La plantilla lo sobremuestrea primero, así que basta con una descripción corta -2. Define `steps` entre 4 y 16 (16 de forma predeterminada). El checkpoint destilado se ejecuta con `cfg` 1, así que aumentar `cfg` no ayuda -3. Elige un fotograma en `ResolutionSelector` +1. Escribe tu prompt. La plantilla lo amplía primero, así que basta con una descripción corta +2. Configura `steps` entre 4 y 16 (16 de forma predeterminada). El checkpoint destilado se ejecuta con `cfg` 1, así que aumentar `cfg` no ayuda +3. Elige un tamaño de `ResolutionSelector` 4. Haz clic en **Queue** para generar **Ejemplo de salida** -![Ejemplo de FLUX 3 Image Klein Distilled de texto a imagen](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux3_klein_distilled_t2i.png) +![Ejemplo de texto a imagen de FLUX 3 Image Klein Distilled](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux3_klein_distilled_t2i.png) ### FLUX 3 Image Klein: edición de imágenes {#image_flux3_klein_image_edit} -Edita una foto a partir de un prompt de instrucción, con la imagen original conectada como referencia. La instrucción reemplaza el contenido de la referencia: aquí el prompt cambia el color del vestido a rojo mientras todo lo demás se mantiene igual. +Edita una foto a partir de un prompt de instrucción, con la imagen original conectada como referencia. La instrucción reemplaza el contenido de la referencia: aquí el prompt cambia el color del vestido a rojo mientras todo lo demás permanece igual. Vista previa del flujo de trabajo de edición de imágenes de FLUX 3 Image Klein @@ -110,22 +112,22 @@ Sube este archivo al nodo `LoadImage` correspondiente: 1. Carga tu imagen fuente en el nodo `LoadImage` 2. Conéctala a `Set Reference Multi Latent`. La primera referencia es `` en el prompt, la siguiente es ``, y así sucesivamente -3. Escribe la edición como una descripción completa del resultado. En el ejemplo incluido el prompt es `In , change the dress color to red` +3. Escribe la edición como una descripción completa del resultado. En el ejemplo incluido, el prompt es `In , change the dress color to red` 4. Ajusta el lienzo con `Empty Flux 2 Latent` (1024 x 1024 en la plantilla) si quieres un tamaño de salida diferente -5. Haz clic en **Queue**. `ImageCompare` muestra la entrada y el resultado uno al lado del otro +5. Haz clic en **Queue**. `ImageCompare` muestra la entrada y el resultado en paralelo **Salida de ejemplo**
Imagen de entrada - Salida de ejemplo de edición de imágenes de FLUX 3 Image Klein + Ejemplo de salida de la edición de imágenes de FLUX 3 Image Klein
-### FLUX 3 Image Klein Distilled: Image Edit {#image_flux3_klein_distilled_image_edit} +### FLUX 3 Image Klein Distilled: edición de imágenes {#image_flux3_klein_distilled_image_edit} -Edita una imagen con el checkpoint destilado por pasos: una imagen de referencia, un prompt de instrucción, 16 pasos y sin orientación. +Edita una imagen con el checkpoint destilado en pasos: una imagen de referencia, un prompt de instrucción, 16 pasos y sin orientación. -Vista previa del flujo de trabajo de edición de imágenes FLUX 3 Image Klein Distilled +Vista previa del flujo de trabajo de edición de imágenes de FLUX 3 Image Klein Distilled @@ -142,7 +144,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - nodo `LoadImage` 11 · `woman_gold_earring_teal_top_portrait.png` + Nodo `LoadImage` 11 · `woman_gold_earring_teal_top_portrait.png` @@ -151,21 +153,21 @@ Sube este archivo al nodo `LoadImage` correspondiente:
1. Carga la imagen que quieres editar y conéctala a `Set Reference Multi Latent` -2. Escribe el prompt de edición. El ejemplo incluido reemplaza un arete y describe el nuevo con detalle, incluido lo que no debe aparecer +2. Escribe el prompt de edición. El ejemplo incluido reemplaza un arete y describe el nuevo con detalle, incluyendo lo que no debe aparecer 3. Mantén `steps` en el rango de 4 a 16 y deja `cfg` en 1 4. Haz clic en **Queue** y compara la entrada con el resultado en `ImageCompare` -## Descargas de modelos de FLUX 3 Image Klein +## Descargas del modelo FLUX 3 Image Klein -Los pesos de FLUX 3 Klein están en el repositorio con acceso restringido [black-forest-labs/flux-3-image-klein-comfy](https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy). Ábrelo, acepta el acuerdo de licencia y luego descarga los archivos. Las plantillas usan los checkpoints int8 (convrot) de un solo archivo; las versiones bf16 y nvfp4 de esos mismos checkpoints están en el mismo repositorio. +Los pesos de FLUX 3 Klein están en el repositorio con acceso restringido [black-forest-labs/flux-3-image-klein-comfy](https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy). Ábrelo, acepta el acuerdo de licencia y luego descarga los archivos. Las plantillas usan los checkpoints de archivo único int8 (convrot); las versiones bf16 y nvfp4 de esos mismos checkpoints están en el mismo repositorio. -Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo de memoria. Con más de 24 GB de VRAM, cambia a la compilación bf16 del mismo checkpoint (`flux3-image-klein-base-bf16.safetensors`, o `flux3-image-klein-bf16.safetensors` para el checkpoint destilado) y al upsampler de prompt bf16: siguen los prompts largos con más fidelidad. +Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo de memoria. Si tienes más de 24 GB de VRAM, cambia a la compilación bf16 del mismo checkpoint (`flux3-image-klein-base-bf16.safetensors`, o `flux3-image-klein-bf16.safetensors` para el checkpoint destilado) y al upsampler de prompt bf16: siguen con más fidelidad los prompts largos. - Modelo de difusión, checkpoint completo de FLUX 3 Image Klein. Las plantillas de texto a imagen y de edición de imagen cargan este archivo. + Modelo de difusión, checkpoint completo de FLUX 3 Image Klein. Las plantillas de Texto a imagen y de edición de imagen cargan este archivo. Modelo de difusión, checkpoint destilado por pasos para 4 a 16 pasos. @@ -174,7 +176,7 @@ Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo d Codificador de texto para ambos checkpoints. Cárgalo con `CLIPLoader` de tipo `flux3`. - Upsampler de prompt que usan las plantillas de texto a imagen. + Upsampler de prompt que usan las plantillas de Texto a imagen. VAE para FLUX 3 Klein. El VAE de FLUX.2. @@ -195,11 +197,10 @@ Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo d │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` - ## Consejos para prompts y referencias -- **Escribe el resultado, no el cambio.** Las plantillas de edición de imagen esperan una descripción completa de la imagen finalizada con la edición integrada, por eso los ejemplos describen el nuevo objeto en detalle en lugar de decir «cambia esto». -- **Las referencias se añaden a ambos conditioning.** Conecta imágenes adicionales a `Set Reference Multi Latent` en orden, llámalas ``, `` y así sucesivamente, y añade cada una tanto al prompt positivo como al negativo, igual que hace el pipeline de referencia. -- **El tamaño de la referencia es un control de costo.** Las plantillas redimensionan cada referencia a aproximadamente 1 megapíxel y el latente de salida toma ese tamaño. Mantener las referencias en su tamaño nativo, que es lo que hace el pipeline propio de Black Forest Labs hasta unos 16 megapíxeles, conserva más detalle en la edición a un costo mayor. -- **La cantidad de pasos depende del checkpoint.** El checkpoint completo se ejecuta con 50 pasos en las plantillas, con orientación 3.5 en texto a imagen y 1 en edición de imagen. El checkpoint destilado por pasos se ejecuta con 16 pasos y orientación fija en 1, y es el que debes usar cuando quieras una pasada rápida. -- **Las plantillas incluyen un nodo `Create Bounding Boxes`.** Dibuja cajas sobre la imagen fuente para planificar ediciones regionales, y su lista de cajas se muestra en el nodo `Preview Any` para que puedas integrar las regiones en el prompt. +- **Escribe el resultado, no el cambio.** Las plantillas de edición de imágenes esperan una descripción completa de la imagen final con la edición incorporada, y por eso los ejemplos describen el objeto nuevo en detalle en lugar de decir «cambia esto». +- **Las referencias se añaden a los dos conditioning.** Conecta imágenes adicionales a `Set Reference Multi Latent` en orden, refiérete a ellas como ``, `` y así sucesivamente, y añade cada una tanto al prompt positivo como al negativo, tal como lo hace el pipeline de referencia. +- **El tamaño de las referencias es un control de costo.** Las plantillas redimensionan cada referencia a aproximadamente 1 megapixel y el latente de salida toma ese tamaño. Mantener las referencias en su tamaño nativo, que es lo que hace el pipeline de Black Forest Labs hasta unos 16 megapíxeles, conserva más detalle en la edición a un costo mayor. +- **El número de pasos depende del checkpoint.** El checkpoint completo se ejecuta con 50 pasos en las plantillas, con orientación 3.5 en texto a imagen y 1 en edición de imagen. El checkpoint destilado por pasos se ejecuta con 16 pasos y la orientación fija en 1, y es el que debes usar cuando quieras una pasada rápida. +- **Las plantillas incluyen un nodo `Create Bounding Boxes`.** Dibuja cajas sobre la imagen fuente para planificar ediciones regionales, y su lista de cajas aparece en el nodo `Preview Any` para que puedas incorporar las regiones al prompt. diff --git a/es/tutorials/image/anima/anima.mdx b/es/tutorials/image/anima/anima.mdx index 21732d6b1c..1217d7c413 100644 --- a/es/tutorials/image/anima/anima.mdx +++ b/es/tutorials/image/anima/anima.mdx @@ -2,25 +2,27 @@ title: "Ejemplo de flujo de trabajo de Anima Base v1 en ComfyUI" description: "Anima es un modelo de texto a imagen de 2B parámetros de CircleStone Labs / Comfy Org, optimizado para generar ilustraciones anime y no fotorrealistas." sidebarTitle: "Anima Base v1" -translationSourceHash: a44df082 +translationSourceHash: fd32bd6f translationFrom: tutorials/image/anima/anima.mdx translationBlockHashes: "_intro": 8946174e "Available workflows": 0808b70c + "Anima model downloads": b7845ddf "Limitations": d56a055f --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Anima** es un modelo abierto de texto a imagen de [CircleStone Labs](https://huggingface.co/circlestone-labs/Anima) en colaboración con Comfy Org. Con **2 mil millones** de parámetros, está diseñado para generar imágenes de **anime y no fotorrealistas** de alta calidad, ideales para personajes, escenas y arte conceptual. +**Anima** es un modelo abierto de texto a imagen de [CircleStone Labs](https://huggingface.co/circlestone-labs/Anima) en colaboración con Comfy Org. Con **2 mil millones** de parámetros, está diseñado para generar imágenes de alta calidad de **anime y no fotorrealistas**, ideal para personajes, escenas y arte conceptual. **Aspectos destacados del modelo**: - **Enfoque en anime e ilustración artística**: ajustado para estilos de arte no fotorrealistas -- **Compatibilidad nativa con ComfyUI**: se carga con los nodos estándar UNETLoader, CLIPLoader y VAELoader -- **Codificador de texto Qwen-3 0.6B**: ofrece una sólida comprensión del lenguaje y adherencia al prompt +- **Soporte nativo en ComfyUI**: usa los nodos estándar UNETLoader, CLIPLoader y VAELoader +- **Codificador de texto Qwen-3 0.6B**: ofrece una sólida comprensión del lenguaje y una fuerte adherencia al prompt - **No se necesita imagen de entrada**: generación pura de texto a imagen -- **Tamaño compacto**: modelo de difusión de 2B, funciona sin problemas en GPUs de consumo +- **Tamaño compacto**: modelo de 2B basado en diffusion, funciona sin problemas en GPUs de consumo **Enlaces relacionados**: - [Hugging Face (Anima)](https://huggingface.co/circlestone-labs/Anima) @@ -31,11 +33,11 @@ Anima ofrece dos flujos de trabajo: la versión base para uso estándar y una ve Ambos flujos de trabajo usan un nodo **Subgraph** para gestionar el pipeline de generación de texto a imagen. Puedes abrir el subgrafo para inspeccionar o personalizar los nodos internos. - + Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y extender el flujo de trabajo. -### Anima Base v1: Texto a imagen {#image_anima_base_v1} +### Anima Base v1: texto a imagen {#image_anima_base_v1} Introduce un prompt de texto que describa una ilustración de anime o artística. Genera una imagen no fotorrealista centrada en conceptos, personajes o estilos de anime. @@ -46,7 +48,7 @@ Introduce un prompt de texto que describa una ilustración de anime o artística Abrir en Comfy Cloud - Descarga el JSON o busca "Anima Base v1" en la biblioteca de plantillas + Descarga el JSON o busca "Anima Base v1" en Template Library @@ -59,9 +61,9 @@ Introduce un prompt de texto que describa una ilustración de anime o artística 1. Actualiza ComfyUI a la última versión o usa [Comfy Cloud](https://cloud.comfy.org/?template=image_anima_base_v1&utm_source=docs&utm_medium=referral&utm_campaign=anima) 2. Ve a **Template** y busca **Anima Base v1** 3. Selecciona el flujo de trabajo **Anima Base v1: Text to Image** -4. Descarga los modelos faltantes (consulta las [descargas de modelos](#descargas-de-modelos-de-anima)), introduce tu prompt y haz clic en **Queue** +4. Descarga los modelos faltantes (consulta las [descargas de modelos](#descargas-del-modelo-anima)), introduce tu prompt y haz clic en **Queue** -### Anima Preview: Generación de texto a imagen de anime {#image_anima_preview} +### Anima Preview: generación de texto a imagen de anime {#image_anima_preview} Introduce un prompt de texto para generar una imagen de estilo anime con el modelo Anima. Configura ajustes como los pasos y la escala CFG para controlar la salida. @@ -72,7 +74,7 @@ Introduce un prompt de texto para generar una imagen de estilo anime con el mode Abrir en Comfy Cloud
- Descarga el JSON o busca "Anima Preview" en la biblioteca de plantillas + Descarga el JSON o busca "Anima Preview" en Template Library @@ -85,22 +87,22 @@ Introduce un prompt de texto para generar una imagen de estilo anime con el mode 1. Actualiza ComfyUI a la última versión o usa [Comfy Cloud](https://cloud.comfy.org/?template=image_anima_preview&utm_source=docs&utm_medium=referral&utm_campaign=anima) 2. Ve a **Template** y busca **Anima Preview** 3. Selecciona el flujo de trabajo **Anima Anime Text-to-Image Generation** -4. Descarga los modelos faltantes (consulta las [descargas de modelos](#descargas-de-modelos-de-anima)), introduce tu prompt y haz clic en **Queue** +4. Descarga los modelos faltantes (consulta las [descargas de modelos](#descargas-del-modelo-anima)), introduce tu prompt y haz clic en **Queue** -## Descargas de modelos de Anima +## Descargas del modelo Anima -Puedes encontrar todos los archivos del modelo en [circlestone-labs/Anima](https://huggingface.co/circlestone-labs/Anima), en Hugging Face. +Puedes encontrar todos los archivos del modelo en [circlestone-labs/Anima](https://huggingface.co/circlestone-labs/Anima) en Hugging Face. Modelo de difusión (2B) para Anima Base v1. - Codificador de texto (Qwen-3 0.6B) compartido por los dos flujos de trabajo. + Codificador de texto (Qwen-3 0.6B) compartido por ambos flujos de trabajo. - VAE compartido por los dos flujos de trabajo. + VAE compartido por ambos flujos de trabajo. **Ubicación de almacenamiento de los modelos** @@ -118,7 +120,7 @@ Puedes encontrar todos los archivos del modelo en [circlestone-labs/Anima](https ### Modelo de vista previa -Si usas el flujo de trabajo Preview, descarga en su lugar el modelo de difusión de vista previa: +Si usas el flujo de trabajo de Preview, descarga en su lugar el modelo de difusión de vista previa: Modelo de difusión (2B) para Anima Preview. @@ -132,7 +134,6 @@ Si usas el flujo de trabajo Preview, descarga en su lugar el modelo de difusión │ └── 📂 diffusion_models/ │ └── anima-preview3-base.safetensors ``` - ## Limitaciones - **Sin realismo**: el modelo está diseñado intencionalmente para estilos de anime e ilustración; las representaciones realistas quedan fuera de su alcance diff --git a/es/tutorials/image/ernie-image/ernie-image.mdx b/es/tutorials/image/ernie-image/ernie-image.mdx index fe2932942b..23867fda50 100644 --- a/es/tutorials/image/ernie-image/ernie-image.mdx +++ b/es/tutorials/image/ernie-image/ernie-image.mdx @@ -2,63 +2,67 @@ title: "Ejemplo de flujo de trabajo de ERNIE-Image en ComfyUI" description: "ERNIE-Image es el modelo texto a imagen Diffusion Transformer 8B de Baidu para ComfyUI, con renderizado de texto preciso y un Prompt Enhancer integrado." sidebarTitle: "ERNIE-Image" -translationSourceHash: 49d68941 +translationSourceHash: bb9c1c5c translationFrom: tutorials/image/ernie-image/ernie-image.mdx translationBlockHashes: "_intro": 070dc9dc + "ERNIE-Image text-to-image workflow": 0273e958 + "ERNIE-Image-Turbo": 7d92aa5d "Available models": 8043d3ec + "Examples": 0e2eb115 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' **ERNIE-Image** es un modelo de texto a imagen abierto de Baidu, con licencia Apache-2.0. Construido sobre un Diffusion Transformer (DiT) de **8B** parámetros, ofrece generación de imágenes de alta calidad con renderizado de texto preciso, un sólido seguimiento de instrucciones y generación visual estructurada. -El modelo incluye un **Prompt Enhancer** integrado (3B) que amplía entradas cortas y las convierte en prompts más ricos para obtener mejores resultados. +El modelo incluye un **Prompt Enhancer** integrado (3B) que amplía las entradas cortas y las convierte en prompts más ricos para obtener mejores resultados. **Aspectos destacados del modelo**: -- **Renderizado de texto preciso**: texto denso y sensible al diseño en inglés, chino y más idiomas -- **Sólido seguimiento de instrucciones**: maneja prompts complejos, relaciones entre varios objetos y descripciones con mucho conocimiento +- **Renderizado de texto preciso**: texto denso y sensible al diseño en inglés, chino y otros idiomas +- **Sólido seguimiento de instrucciones**: maneja prompts complejos, relaciones entre varios objetos y descripciones con mucho conocimiento específico - **Generación visual estructurada**: pósteres, storyboards de manga/anime, composiciones de varios paneles - **Amplio alcance estilístico**: desde fotografía realista hasta estética cinematográfica -- **Compacto y desplegable**: 8B parámetros, funciona con 24 GB de VRAM -- **Prompt Enhancer integrado**: modelo de 3B que amplía entradas cortas y las convierte en prompts más ricos +- **Compacto y fácil de desplegar**: 8B parámetros, funciona con 24 GB de VRAM +- **Prompt Enhancer integrado**: modelo de 3B que amplía las entradas cortas y las convierte en prompts más ricos **Enlaces relacionados**: - [Hugging Face (ERNIE-Image)](https://huggingface.co/Baidu/ERNIE-Image) - [Hugging Face (soporte de ComfyUI)](https://huggingface.co/Comfy-Org/ERNIE-Image) -## Flujo de trabajo de texto a imagen de ERNIE-Image +## Flujo de trabajo texto a imagen de ERNIE-Image -### Ernie Image: Text to Image {#image_ernie_image} +### Ernie Image: texto a imagen {#image_ernie_image} -Genera imágenes a partir de prompts de texto con el modelo ERNIE-Image. Introduce una descripción de texto para producir imágenes detalladas y estructuradas con una amplia variedad estilística. +Genera imágenes a partir de prompts de texto con el modelo ERNIE-Image. Ingresa una descripción de texto para producir visuales detallados y estructurados con una amplia variedad estilística. -Vista previa del flujo de trabajo de texto a imagen de ERNIE-Image +Vista previa del flujo de trabajo texto a imagen de ERNIE-Image Ejecuta este flujo de trabajo directamente en Comfy Cloud - Descarga el archivo JSON del flujo de trabajo de texto a imagen de ERNIE-Image + Descarga el archivo JSON del flujo de trabajo texto a imagen de ERNIE-Image -**Salida de ejemplo** +**Ejemplo de salida** ![Ejemplo de salida de ERNIE-Image](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_ernie_image.png) ### Empezar 1. Actualiza ComfyUI a la última versión o usa [Comfy Cloud](https://cloud.comfy.org/?template=image_ernie_image&utm_source=docs&utm_medium=referral&utm_campaign=ernie-image) -2. Ve a **Template** y busca **ERNIE-Image** +2. Ve a **Plantillas** y busca **ERNIE-Image** 3. Selecciona el flujo de trabajo **ERNIE-Image** -4. Descarga los modelos que falten, actualiza el prompt y haz clic en **Run** +4. Descarga los modelos faltantes, actualiza el prompt y haz clic en **Run** ### Descargas de modelos de ERNIE-Image -Todos los archivos de modelo reempaquetados están en [Comfy-Org/ERNIE-Image](https://huggingface.co/Comfy-Org/ERNIE-Image) en Hugging Face. +Puedes encontrar todos los archivos de modelo reempaquetados en [Comfy-Org/ERNIE-Image](https://huggingface.co/Comfy-Org/ERNIE-Image) en Hugging Face. @@ -88,19 +92,18 @@ Todos los archivos de modelo reempaquetados están en [Comfy-Org/ERNIE-Image](ht │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` - ## ERNIE-Image-Turbo -[ERNIE-Image-Turbo](https://huggingface.co/Baidu/ERNIE-Image-Turbo) es una variante más rápida, optimizada con DMD y RL, que genera imágenes en solo **8 pasos** frente a los ~50 pasos que necesita el modelo estándar. +[ERNIE-Image-Turbo](https://huggingface.co/Baidu/ERNIE-Image-Turbo) es una variante más rápida optimizada con DMD y RL, que genera imágenes en solo **8 pasos** frente a los ~50 pasos que requiere el modelo estándar. -### Ernie Image Turbo: Text To Image {#image_ernie_image_turbo} +### ERNIE-Image-Turbo: texto a imagen {#image_ernie_image_turbo} -Genera imágenes a partir de prompts de texto con el modelo turbo ERNIE-Image. Introduce una descripción de texto y obtén una imagen de alta calidad con un renderizado de texto preciso. +Genera imágenes a partir de prompts de texto con el modelo turbo ERNIE-Image. Introduce una descripción de texto y recibe una imagen de alta calidad con un renderizado de texto preciso. Vista previa del flujo de trabajo de texto a imagen de ERNIE-Image-Turbo - + Ejecuta este flujo de trabajo directamente en Comfy Cloud @@ -110,9 +113,9 @@ Genera imágenes a partir de prompts de texto con el modelo turbo ERNIE-Image. I **Salida de ejemplo** -![Ejemplo de salida de ERNIE-Image-Turbo](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_ernie_image_turbo.png) +![Salida de ejemplo de ERNIE-Image-Turbo](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_ernie_image_turbo.png) -### Descargas de modelos de ERNIE-Image-Turbo +### Descargas del modelo ERNIE-Image-Turbo @@ -122,7 +125,7 @@ Genera imágenes a partir de prompts de texto con el modelo turbo ERNIE-Image. I Codificador de texto para ERNIE-Image-Turbo. - Codificador de texto del Prompt Enhancer para ERNIE-Image-Turbo. + Codificador de texto Prompt Enhancer para ERNIE-Image-Turbo. VAE para ERNIE-Image-Turbo. @@ -142,19 +145,18 @@ Genera imágenes a partir de prompts de texto con el modelo turbo ERNIE-Image. I │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` - ## Modelos disponibles | Modelo | Descripción | Pasos de inferencia | Enlace | |-------|-------------|-----------------|------| -| ERNIE-Image | Modelo SFT principal: mayor calidad y fidelidad a las instrucciones | ~50 | [Hugging Face](https://huggingface.co/Baidu/ERNIE-Image) | -| ERNIE-Image-Turbo | Modelo Turbo optimizado con DMD y RL: generación más rápida | 8 | [Hugging Face](https://huggingface.co/Baidu/ERNIE-Image-Turbo) | +| ERNIE-Image | Modelo SFT principal: mejor calidad y fidelidad a las instrucciones | ~50 | [Hugging Face](https://huggingface.co/Baidu/ERNIE-Image) | +| ERNIE-Image-Turbo | Modelo turbo optimizado con DMD y RL: generación más rápida | 8 | [Hugging Face](https://huggingface.co/Baidu/ERNIE-Image-Turbo) | ## Ejemplos -### Renderizado de texto y diseños +### Renderizado de texto y composiciones de diseño -![Infografía del proceso de preparación del café](https://substack-post-media.s3.amazonaws.com/public/images/1cc1c3e6-e556-45b4-b6a9-205e5610d022_1360x768.png) +![Infografía del proceso de elaboración del café](https://substack-post-media.s3.amazonaws.com/public/images/1cc1c3e6-e556-45b4-b6a9-205e5610d022_1360x768.png) ```text @@ -171,7 +173,7 @@ The four corners of the image are decorated with hand-drawn coffee leaves and co ``` -![Ficha de aprendizaje de idioma con estilo ukiyo-e japonés](https://substack-post-media.s3.amazonaws.com/public/images/913c7f5e-f1fe-4f19-b811-ad777ed430b7_768x1360.png) +![Tarjeta de aprendizaje de idioma japonés estilo Ukiyo-e](https://substack-post-media.s3.amazonaws.com/public/images/913c7f5e-f1fe-4f19-b811-ad777ed430b7_768x1360.png) ```text @@ -193,7 +195,7 @@ Split-screen conceptual poster with vertical split composition, left half repres ### Estética cinematográfica y estilizada -![Escena de calle urbana de noche](https://substack-post-media.s3.amazonaws.com/public/images/d4f27467-4d1f-4f6d-8c15-ebc92983c29d_1360x768.png) +![Escena callejera urbana nocturna](https://substack-post-media.s3.amazonaws.com/public/images/d4f27467-4d1f-4f6d-8c15-ebc92983c29d_1360x768.png) ```text @@ -236,7 +238,7 @@ Panel 5: Monarch butterfly on a flower. Header: "MONARCH BUTTERFLY" Fact: "Migra ``` -![Página de cómic de 6 viñetas](https://substack-post-media.s3.amazonaws.com/public/images/adc8fe73-f431-4bdd-8578-1a18d717d4d7_1360x768.png) +![Página de cómic de 6 paneles](https://substack-post-media.s3.amazonaws.com/public/images/adc8fe73-f431-4bdd-8578-1a18d717d4d7_1360x768.png) ```text diff --git a/es/tutorials/image/hidream/hidream-e1.mdx b/es/tutorials/image/hidream/hidream-e1.mdx index 1316d37011..faea930271 100644 --- a/es/tutorials/image/hidream/hidream-e1.mdx +++ b/es/tutorials/image/hidream/hidream-e1.mdx @@ -2,18 +2,20 @@ title: "HiDream-E1 y E1.1 en ComfyUI: edición de imágenes por instrucciones" sidebarTitle: "HiDream-e1" description: "Edita imágenes con lenguaje natural con HiDream-E1 y E1.1 en ComfyUI. E1.1 mejora la calidad y se complementa con la generación texto a imagen de HiDream-I1." -translationSourceHash: 2f8a24fd +translationSourceHash: 0afdf711 translationFrom: tutorials/image/hidream/hidream-e1.mdx translationBlockHashes: "_intro": 6829ae90 + "HiDream E1 and E1.1 Workflow Related Models": f046f07a "HiDream E1.1 ComfyUI Native Workflow Example": a8994ce2 "HiDream E1 ComfyUI Native Workflow Example": 6a459f20 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' ![Demostración de HiDream-E1](https://raw.githubusercontent.com/HiDream-ai/HiDream-E1/refs/heads/main/assets/demo.jpg) -HiDream-E1 es un gran modelo interactivo de edición de imágenes que HiDream-ai publicó oficialmente como código abierto, construido a partir de HiDream-I1. +HiDream-E1 es un modelo grande e interactivo de edición de imágenes que HiDream-ai publicó oficialmente como código abierto, construido a partir de HiDream-I1. Te permite editar imágenes usando lenguaje natural. El modelo se distribuye bajo la [Licencia MIT](https://github.com/HiDream-ai/HiDream-E1?tab=MIT-1-ov-file), lo que permite usarlo en proyectos personales, investigación científica y aplicaciones comerciales. Combinado con el [hidream-i1](/es/tutorials/image/hidream/hidream-i1) publicado anteriormente, habilita **capacidades creativas que van desde la generación de imágenes hasta la edición**. @@ -27,16 +29,16 @@ Combinado con el [hidream-i1](/es/tutorials/image/hidream/hidream-i1) publicado -## Modelos relacionados con los flujos de trabajo de HiDream E1 y E1.1 +## Modelos relacionados para los flujos de trabajo de HiDream E1 y E1.1 -Todos los modelos que intervienen en esta guía están disponibles [aquí](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/tree/main/split_files). Salvo el modelo de difusión, E1 y E1.1 usan los mismos modelos. -Los archivos de flujo de trabajo correspondientes también incluyen la información de modelo pertinente. Puedes elegir descargar y guardar los modelos manualmente, o seguir las indicaciones del flujo de trabajo para descargarlos después de cargarlo. Se recomienda usar E1.1. +Todos los modelos que se usan en esta guía están disponibles [aquí](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/tree/main/split_files). Excepto por el modelo de difusión, E1 y E1.1 usan los mismos modelos. +Los archivos de flujo de trabajo correspondientes también incluyen la información de los modelos relevantes. Puedes descargar y guardar los modelos manualmente, o seguir las indicaciones del flujo de trabajo para descargarlos después de cargarlo. Se recomienda usar E1.1. -Este modelo necesita una gran cantidad de VRAM para ejecutarse. Consulta las secciones correspondientes para conocer los requisitos concretos de VRAM. +Este modelo requiere una gran cantidad de VRAM para ejecutarse. Consulta las secciones correspondientes para conocer los requisitos de VRAM específicos. **Modelo de difusión** -No es necesario descargar los dos modelos. Como E1.1 es una versión iterativa basada en E1, nuestras pruebas muestran que su calidad y rendimiento mejoran notablemente en comparación con E1. +No necesitas descargar ambos modelos. Como E1.1 es una versión iterativa basada en E1, nuestras pruebas muestran que su calidad y rendimiento mejoran significativamente en comparación con E1. - [hidream_e1_1_bf16.safetensors (Recomendado)](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_e1_1_bf16.safetensors) 34.2GB - [hidream_e1_full_bf16.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_e1_full_bf16.safetensors) 34.2GB @@ -49,9 +51,9 @@ No es necesario descargar los dos modelos. Como E1.1 es una versión iterativa b **VAE** - [ae.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/vae/ae.safetensors) 319.77MB -> Este es el modelo VAE de FLUX. Si ya has usado antes el flujo de trabajo de FLUX, es posible que ya tengas descargado este archivo. +> Este es el modelo VAE de FLUX. Si ya has usado el flujo de trabajo de FLUX, es posible que ya hayas descargado este archivo. -Ubicación de almacenamiento de los modelos +Ubicación donde guardar los modelos ``` 📂 ComfyUI/ @@ -67,8 +69,7 @@ Ubicación de almacenamiento de los modelos │ ├── hidream_e1_1_bf16.safetensors │ └── hidream_e1_full_bf16.safetensors ``` - -## Ejemplo de flujo de trabajo nativo de HiDream E1.1 en ComfyUI +## Ejemplo de flujo de trabajo nativo de ComfyUI con HiDream E1.1 ### Edición de imágenes con HiDream E1.1 {#hidream_e1_1} @@ -101,10 +102,10 @@ Sube este archivo al nodo `LoadImage` correspondiente: ### 1. Flujo de trabajo de HiDream E1.1 y materiales relacionados -Descarga la imagen de abajo y arrástrala a ComfyUI con el flujo de trabajo y los modelos correspondientes cargados: +Descarga la imagen a continuación y arrástrala a ComfyUI con el flujo de trabajo y los modelos correspondientes cargados: ![Flujo de trabajo de HiDream E1.1](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/image/hidream/e1.1/hidream_e1_1.png) -Descarga la imagen de abajo como entrada: +Descarga la imagen a continuación como entrada: ![Entrada del flujo de trabajo de HiDream E1.1](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/image/hidream/e1.1/input.webp) ### 2. Guía paso a paso para ejecutar el flujo de trabajo de HiDream-e1 @@ -118,15 +119,15 @@ Sigue estos pasos para ejecutar el flujo de trabajo: - t5xxl_fp8_e4m3fn_scaled.safetensors - llama_3.1_8b_instruct_fp8_scaled.safetensors 3. Asegúrate de que el nodo `Load VAE` use el archivo `ae.safetensors`. -4. En el nodo `Load Image`, carga la imagen de entrada proporcionada o la imagen que desees. -5. En el nodo `Empty Text Encoder(Positive)`, escribe **las modificaciones que quieres hacer a la imagen**. -6. En el nodo `Empty Text Encoder(Negative)`, escribe **el contenido que no quieres que aparezca en la imagen**. -7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de la imagen. +4. En el nodo `Load Image`, carga la entrada proporcionada o la imagen que desees. +5. En el nodo `Empty Text Encoder(Positive)`, ingresa **las modificaciones que quieres hacer a la imagen**. +6. En el nodo `Empty Text Encoder(Negative)`, ingresa **el contenido que no quieres que aparezca en la imagen**. +7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de imágenes. ### 3. Notas adicionales sobre el flujo de trabajo -- Como HiDream E1.1 admite entrada dinámica con un total de 1 millón de píxeles, el flujo de trabajo usa `Scale Image to Total Pixels` para procesar y convertir todas las imágenes de entrada, lo que puede hacer que la relación de aspecto difiera de la imagen de entrada original. -- Al usar la versión fp16 del modelo, en las pruebas reales la versión completa agotó la memoria tanto en una A100 de 40 GB como en una 4090D de 24 GB, por lo que el flujo de trabajo está configurado por defecto para usar `fp8_e4m3fn_fast` en la inferencia. +- Como HiDream E1.1 admite entradas dinámicas con un total de 1 millón de píxeles, el flujo de trabajo usa `Scale Image to Total Pixels` para procesar y convertir todas las imágenes de entrada, lo que puede hacer que la relación de aspecto difiera de la imagen de entrada original. +- Al usar la versión fp16 del modelo, en pruebas reales la versión completa se quedó sin memoria tanto en una A100 de 40 GB como en una 4090D de 24 GB, así que el flujo de trabajo está configurado por defecto para usar `fp8_e4m3fn_fast` en la inferencia. ## Ejemplo de flujo de trabajo nativo de HiDream E1 en ComfyUI @@ -141,7 +142,7 @@ Edita imágenes con HiDream E1. Modelo profesional de edición de imágenes con Abrir en Comfy Cloud - Descarga el JSON o busca "HiDream E1 Full" en la biblioteca de plantillas + Descarga el JSON o busca "HiDream E1 Full" en la Biblioteca de plantillas @@ -169,19 +170,19 @@ Sube este archivo al nodo `LoadImage` correspondiente: E1 es un modelo publicado el 28 de abril de 2025. -Como referencia, este flujo de trabajo tarda unos 500s en la primera ejecución y 370s en la segunda, con 28 pasos de muestreo en Google Colab L4 con 22.5GB de VRAM. +A modo de referencia, este flujo de trabajo tarda unos 500 s en la primera ejecución y 370 s en la segunda, con 28 pasos de muestreo en Google Colab L4 con 22.5 GB de VRAM. ### 1. Flujo de trabajo de HiDream-e1 -Descarga la imagen de abajo y arrástrala a ComfyUI. El flujo de trabajo ya contiene la información de descarga de los modelos y, tras cargarla, te pedirá que descargues los modelos correspondientes. +Descarga la imagen de abajo y arrástrala a ComfyUI. El flujo de trabajo ya incluye la información de descarga de los modelos y, después de cargarlo, te pedirá que descargues los modelos correspondientes. ![Flujo de trabajo nativo de HiDream-e1 en ComfyUI](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_e1/hidream_e1_full.png) -Descarga esta imagen a continuación como entrada: +Descarga esta imagen de abajo para usarla como entrada: ![Entrada del flujo de trabajo nativo de HiDream-e1 en ComfyUI](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_e1/input.webp) -### 2. Completar el flujo de trabajo de HiDream-e1 paso a paso +### 2. Completa el flujo de trabajo de HiDream-e1 paso a paso ![hidream_e1_full_step_guide](/images/tutorial/advanced/hidream/hidream_e1_full_step_guide.jpg) @@ -193,12 +194,12 @@ Sigue estos pasos para completar el flujo de trabajo: - t5xxl_fp8_e4m3fn_scaled.safetensors - llama_3.1_8b_instruct_fp8_scaled.safetensors 3. Asegúrate de que el nodo `Load VAE` use el archivo `ae.safetensors` -4. Carga la imagen de entrada que descargamos antes en el nodo `Load Image` -5. (Importante) Introduce **el prompt para indicar cómo quieres modificar la imagen** en el nodo `Empty Text Encoder(Positive)` -6. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para generar la imagen +4. Carga en el nodo `Load Image` la imagen de entrada que descargamos antes +5. (Importante) Introduce **el prompt de cómo quieres modificar la imagen** en el nodo `Empty Text Encoder(Positive)` +6. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter`, para generar la imagen ### Notas adicionales sobre el flujo de trabajo de HiDream-e1 en ComfyUI - Es posible que tengas que modificar el prompt varias veces o generar varias veces para obtener mejores resultados -- Este modelo tiene dificultades para mantener la consistencia al cambiar el estilo de las imágenes, así que intenta que tus prompts sean lo más completos posible -- Como el modelo admite una resolución de 768*768, en las pruebas reales con otras dimensiones el rendimiento de la imagen es deficiente o incluso notablemente distinto en otras dimensiones +- Este modelo tiene dificultades para mantener la coherencia al cambiar el estilo de la imagen, así que intenta que tus prompts sean lo más completos posible +- Como el modelo admite una resolución de 768*768, en pruebas reales con otras dimensiones el rendimiento de la imagen es deficiente o incluso notablemente distinto con otras dimensiones diff --git a/es/tutorials/image/hidream/hidream-i1.mdx b/es/tutorials/image/hidream/hidream-i1.mdx index c086c039ea..da7abb6f44 100644 --- a/es/tutorials/image/hidream/hidream-i1.mdx +++ b/es/tutorials/image/hidream/hidream-i1.mdx @@ -2,17 +2,19 @@ title: "Ejemplo de flujo de trabajo de texto a imagen con HiDream-I1 nativo de ComfyUI" sidebarTitle: "HiDream-I1" description: "Guía paso a paso para completar un ejemplo de flujo de trabajo de texto a imagen con HiDream-I1 nativo de ComfyUI" -translationSourceHash: 5a7d8ea0 +translationSourceHash: 3fdbf410 translationFrom: tutorials/image/hidream/hidream-i1.mdx translationBlockHashes: "_intro": 59935bb2 "Model Features": 3ec455b0 "About This Workflow Example": 90c5d2b3 + "HiDream-I1 Workflow": 1c05160f "Other Related Resources": e794d9ef --- + ![HiDream-I1 Demo](https://raw.githubusercontent.com/HiDream-ai/HiDream-I1/main/assets/demo.jpg) -HiDream-I1 es un modelo de texto a imagen publicado como código abierto oficialmente por HiDream-ai el 7 de abril de 2025. El modelo tiene 17B parámetros y se distribuye bajo la [licencia MIT](https://github.com/HiDream-ai/HiDream-I1/blob/main/LICENSE), lo que permite su uso en proyectos personales, investigación científica y uso comercial. +HiDream-I1 es un modelo de texto a imagen que HiDream-ai publicó como código abierto el 7 de abril de 2025. El modelo tiene 17B parámetros y se distribuye bajo la [licencia MIT](https://github.com/HiDream-ai/HiDream-I1/blob/main/LICENSE), lo que permite su uso en proyectos personales, investigación científica y uso comercial. Actualmente ofrece un rendimiento excelente en múltiples pruebas de referencia. ## Características del modelo @@ -36,53 +38,52 @@ HiDream-ai ofrece tres versiones del modelo HiDream-I1 para cubrir distintas nec | Nombre del modelo | Descripción | Pasos de inferencia | Enlace al repositorio | |-----------------|----------------|-----------------|------------------------------------------------------------------------| | HiDream-I1-Full | Versión completa | 50 | [🤗 HiDream-I1-Full](https://huggingface.co/HiDream-ai/HiDream-I1-Full)| -| HiDream-I1-Dev | Dev destilada | 28 | [🤗 HiDream-I1-Dev](https://huggingface.co/HiDream-ai/HiDream-I1-Dev) | -| HiDream-I1-Fast | Fast destilada | 16 | [🤗 HiDream-I1-Fast](https://huggingface.co/HiDream-ai/HiDream-I1-Fast)| +| HiDream-I1-Dev | Versión dev destilada | 28 | [🤗 HiDream-I1-Dev](https://huggingface.co/HiDream-ai/HiDream-I1-Dev) | +| HiDream-I1-Fast | Versión fast destilada | 16 | [🤗 HiDream-I1-Fast](https://huggingface.co/HiDream-ai/HiDream-I1-Fast)| ## Acerca de este ejemplo de flujo de trabajo En este ejemplo, usaremos la versión reempaquetada de ComfyOrg. Puedes encontrar todos los archivos de modelo que usaremos en este ejemplo en el repositorio [HiDream-I1_ComfyUI](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/). -Antes de comenzar, actualiza la versión de ComfyUI y asegúrate de que sea al menos posterior a este [commit](https://github.com/Comfy-Org/ComfyUI/commit/9ad792f92706e2179c58b2e5348164acafa69288) para que tu ComfyUI tenga soporte nativo para HiDream. +Antes de comenzar, actualiza tu versión de ComfyUI y asegúrate de que sea al menos posterior a este [commit](https://github.com/Comfy-Org/ComfyUI/commit/9ad792f92706e2179c58b2e5348164acafa69288) para que tu ComfyUI tenga soporte nativo para HiDream. ## Flujo de trabajo de HiDream-I1 -Los requisitos de modelo de los distintos flujos de trabajo nativos de HiDream-I1 en ComfyUI son básicamente los mismos; solo cambian los archivos de [modelos de difusión](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/tree/main/split_files/diffusion_models). +Los requisitos de modelo para los distintos flujos de trabajo nativos de HiDream-I1 en ComfyUI son básicamente los mismos; solo cambian los archivos de [modelos de difusión](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/tree/main/split_files/diffusion_models). -Si no sabes qué versión elegir, consulta las siguientes recomendaciones: +Si no sabes qué versión elegir, consulta las siguientes sugerencias: -- **HiDream-I1-Full** puede generar las imágenes de mayor calidad +- **HiDream-I1-Full** puede generar imágenes de la más alta calidad - **HiDream-I1-Dev** equilibra la generación de imágenes de alta calidad con la velocidad -- **HiDream-I1-Fast** puede generar imágenes en solo 16 pasos, ideal para casos que requieren iteración en tiempo real +- **HiDream-I1-Fast** puede generar imágenes en solo 16 pasos, ideal para escenarios que requieren iteración en tiempo real -En las versiones **dev** y **fast** no hacen falta prompts negativos, así que establece el parámetro `cfg` en `1.0` durante el muestreo. Hemos anotado los ajustes de parámetros correspondientes en los flujos de trabajo relevantes. +Para las versiones **dev** y **fast** no se necesitan prompts negativos, así que configura el parámetro `cfg` en `1.0` durante el muestreo. Hemos anotado las configuraciones de parámetros correspondientes en los flujos de trabajo relevantes. -Las versiones completas de las tres variantes requieren mucha VRAM: puede que necesites más de 27 GB para ejecutarlas con fluidez. En los tutoriales de los flujos de trabajo correspondientes, -usaremos la versión **fp8** como ejemplo de demostración para asegurarnos de que la mayoría de los usuarios puedan ejecutarla sin problemas. -Aun así, seguiremos incluyendo enlaces de descarga de las distintas versiones del modelo en los ejemplos correspondientes, y puedes elegir el archivo adecuado según tu VRAM. +Las versiones full de las tres variantes requieren mucha VRAM: es posible que necesites más de 27 GB de VRAM para ejecutarlas sin problemas. En los tutoriales de los flujos de trabajo correspondientes usaremos la versión **fp8** como ejemplo de demostración, para que la mayoría de los usuarios pueda ejecutarla sin problemas. +Sin embargo, en los ejemplos correspondientes seguiremos proporcionando enlaces de descarga de las distintas versiones del modelo, y puedes elegir el archivo adecuado según tu situación de VRAM. -### Instalación de los modelos +### Instalar los modelos -Los siguientes archivos de modelo son los archivos comunes que vamos a usar. -Haz clic en los enlaces correspondientes para descargarlos y guárdalos según la ubicación de guardado de los archivos de modelo. -Te guiaremos para descargar los **modelos de difusión** correspondientes en cada flujo de trabajo. +Los siguientes archivos de modelo son archivos comunes que vamos a usar. +Haz clic en los enlaces correspondientes para descargarlos y guardarlos según la ubicación de guardado de los archivos de modelo. +En los flujos de trabajo correspondientes te guiaremos para descargar los **modelos de difusión** correspondientes. -**text_encoders**: +**text_encoders**: - [clip_l_hidream.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/clip_l_hidream.safetensors) - [clip_g_hidream.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/clip_g_hidream.safetensors) -- [t5xxl_fp8_e4m3fn_scaled.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/t5xxl_fp8_e4m3fn_scaled.safetensors) Este modelo se ha usado en muchos flujos de trabajo, así que es posible que ya hayas descargado este archivo. +- [t5xxl_fp8_e4m3fn_scaled.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/t5xxl_fp8_e4m3fn_scaled.safetensors) Este modelo se ha usado en muchos flujos de trabajo, es posible que ya hayas descargado este archivo. - [llama_3.1_8b_instruct_fp8_scaled.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/text_encoders/llama_3.1_8b_instruct_fp8_scaled.safetensors) **VAE** -- [ae.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/vae/ae.safetensors) Este es el modelo VAE de Flux; si has usado antes un flujo de trabajo de Flux, es posible que ya hayas descargado este archivo. +- [ae.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/vae/ae.safetensors) Este es el modelo VAE de Flux; si has usado antes el flujo de trabajo de Flux, es posible que ya hayas descargado este archivo. -**Modelos de difusión** -Te guiaremos para descargar los archivos de modelo correspondientes en cada flujo de trabajo. +**modelos de difusión** +Te guiaremos para descargar los archivos de modelo correspondientes en los flujos de trabajo correspondientes. Ubicación de guardado de los archivos de modelo ``` @@ -98,17 +99,18 @@ Ubicación de guardado de los archivos de modelo │ └── 📂 diffusion_models/ │ └── ... # We will guide you to install in the corresponding version workflow ``` -### Flujo de trabajo de la versión Full de HiDream I1 + +### Flujo de trabajo de la versión completa de HiDream I1 ### HiDream I1 Full {#hidream_i1_full} -Genera imágenes con HiDream I1 Full. Versión completa con 50 pasos de inferencia para obtener la máxima calidad. +Genera imágenes con HiDream I1 Full. Versión completa con 50 pasos de inferencia para obtener la máxima calidad de salida. Vista previa del flujo de trabajo HiDream I1 Full - Ejecuta este flujo de trabajo en Comfy Cloud sin configurar nada + Ejecuta este flujo de trabajo en Comfy Cloud sin ninguna configuración Descarga el archivo JSON del flujo de trabajo @@ -117,39 +119,39 @@ Genera imágenes con HiDream I1 Full. Versión completa con 50 pasos de inferenc **Salida de ejemplo** -![Ejemplo de salida de HiDream I1 Full](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/hidream_i1_full.png) +![Salida de ejemplo de HiDream I1 Full](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/hidream_i1_full.png) -#### 1. Descarga del archivo de modelo +#### 1. Descargar el archivo del modelo -Elige la versión adecuada según tu hardware. Haz clic en el enlace y descarga el archivo de modelo correspondiente para guardarlo en la carpeta `ComfyUI/models/diffusion_models/`. +Selecciona la versión adecuada según tu hardware. Haz clic en el enlace y descarga el archivo de modelo correspondiente para guardarlo en la carpeta `ComfyUI/models/diffusion_models/`. - Versión FP8: [hidream_i1_full_fp8.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_full_fp8.safetensors?download=true) requiere más de 16 GB de VRAM - Versión completa: [hidream_i1_full_f16.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_full_fp16.safetensors?download=true) requiere más de 27 GB de VRAM -#### 2. Descarga del archivo de flujo de trabajo +#### 2. Descargar el archivo del flujo de trabajo Descarga la imagen de abajo y arrástrala a ComfyUI para cargar el flujo de trabajo correspondiente -![Flujo de trabajo de la versión Full de HiDream-I1](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_i1/hidream_i1_full.png) +![Flujo de trabajo de la versión completa de HiDream-I1](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_i1/hidream_i1_full.png) -#### 3. Completa el flujo de trabajo paso a paso +#### 3. Completar el flujo de trabajo paso a paso -![Diagrama de flujo de la versión Full de HiDream-I1](/images/tutorial/advanced/hidream/hidream_i1_full_flow_diagram.jpg) +![Diagrama de flujo de la versión completa de HiDream-I1](/images/tutorial/advanced/hidream/hidream_i1_full_flow_diagram.jpg) Completa la ejecución del flujo de trabajo paso a paso 1. Asegúrate de que el nodo `Load Diffusion Model` esté usando el archivo `hidream_i1_full_fp8.safetensors` -2. Asegúrate de que los cuatro codificadores de texto correspondientes de `QuadrupleCLIPLoader` estén cargados correctamente +2. Asegúrate de que los cuatro text encoders correspondientes en `QuadrupleCLIPLoader` estén cargados correctamente - clip_l_hidream.safetensors - clip_g_hidream.safetensors - t5xxl_fp8_e4m3fn_scaled.safetensors - llama_3.1_8b_instruct_fp8_scaled.safetensors 3. Asegúrate de que el nodo `Load VAE` esté usando el archivo `ae.safetensors` -4. Para la versión **full**, debes establecer el parámetro `shift` de `ModelSamplingSD3` en `3.0` -5. Para el nodo `Ksampler`, debes hacer los siguientes ajustes +4. Para la versión **completa**, debes establecer el parámetro `shift` en `ModelSamplingSD3` a `3.0` +5. Para el nodo `Ksampler`, debes aplicar las siguientes configuraciones - Establece `steps` en `50` - Establece `cfg` en `5.0` - (Opcional) Establece `sampler` en `lcm` - (Opcional) Establece `scheduler` en `normal` -6. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de imágenes +6. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de la imagen ### Flujo de trabajo de la versión Dev de HiDream-I1 @@ -161,7 +163,7 @@ Genera imágenes con HiDream I1 Dev. Versión equilibrada con 28 pasos de infere - Ejecuta este flujo de trabajo en Comfy Cloud sin configurar nada + Ejecuta este flujo de trabajo en Comfy Cloud sin configuración previa Descarga el archivo JSON del flujo de trabajo @@ -170,49 +172,49 @@ Genera imágenes con HiDream I1 Dev. Versión equilibrada con 28 pasos de infere **Salida de ejemplo** -![Ejemplo de salida de HiDream I1 Dev](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/hidream_i1_dev.png) +![Salida de ejemplo de HiDream I1 Dev](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/hidream_i1_dev.png) -#### 1. Descarga del archivo de modelo -Elige la versión adecuada según tu hardware, haz clic en el enlace y descarga el archivo de modelo correspondiente para guardarlo en la carpeta `ComfyUI/models/diffusion_models/`. +#### 1. Descargar los archivos de modelo +Selecciona la versión adecuada según tu hardware, haz clic en el enlace y descarga el archivo de modelo correspondiente para guardarlo en la carpeta `ComfyUI/models/diffusion_models/`. -- Versión FP8: [hidream_i1_dev_fp8.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_dev_fp8.safetensors?download=true) requiere más de 16 GB de VRAM -- Versión completa: [hidream_i1_dev_bf16.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_dev_bf16.safetensors?download=true) requiere más de 27 GB de VRAM +- Versión FP8: [hidream_i1_dev_fp8.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_dev_fp8.safetensors?download=true) requiere más de 16GB de VRAM +- Versión completa: [hidream_i1_dev_bf16.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_dev_bf16.safetensors?download=true) requiere más de 27GB de VRAM -#### 2. Descarga del archivo de flujo de trabajo +#### 2. Descargar el archivo del flujo de trabajo Descarga la imagen de abajo y arrástrala a ComfyUI para cargar el flujo de trabajo correspondiente ![Flujo de trabajo de la versión Dev de HiDream-I1](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_i1/hidream_i1_dev.png) -#### 3. Completa el flujo de trabajo paso a paso +#### 3. Completar el flujo de trabajo paso a paso ![Diagrama de flujo de la versión Dev de HiDream-I1](/images/tutorial/advanced/hidream/hidream_i1_dev_flow_diagram.jpg) Completa la ejecución del flujo de trabajo paso a paso 1. Asegúrate de que el nodo `Load Diffusion Model` esté usando el archivo `hidream_i1_dev_fp8.safetensors` -2. Asegúrate de que los cuatro codificadores de texto correspondientes de `QuadrupleCLIPLoader` estén cargados correctamente +2. Asegúrate de que los cuatro codificadores de texto correspondientes en `QuadrupleCLIPLoader` estén cargados correctamente - clip_l_hidream.safetensors - clip_g_hidream.safetensors - t5xxl_fp8_e4m3fn_scaled.safetensors - llama_3.1_8b_instruct_fp8_scaled.safetensors 3. Asegúrate de que el nodo `Load VAE` esté usando el archivo `ae.safetensors` 4. Para la versión **dev**, debes establecer el parámetro `shift` de `ModelSamplingSD3` en `6.0` -5. Para el nodo `Ksampler`, debes hacer los siguientes ajustes +5. Para el nodo `Ksampler`, debes aplicar las siguientes configuraciones - Establece `steps` en `28` - (Importante) Establece `cfg` en `1.0` - (Opcional) Establece `sampler` en `lcm` - (Opcional) Establece `scheduler` en `normal` -6. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de imágenes +6. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de la imagen -### Flujo de trabajo de la versión Fast de HiDream-I1 +### Flujo de trabajo de la versión rápida de HiDream-I1 ### HiDream I1 Fast {#hidream_i1_fast} -Genera imágenes rápidamente con HiDream I1 Fast. Versión ligera con 16 pasos de inferencia, ideal para previsualizaciones rápidas en hardware modesto. +Genera imágenes rápidamente con HiDream I1 Fast. Es una versión ligera con 16 pasos de inferencia, ideal para vistas previas rápidas en hardware de gama baja. Vista previa del flujo de trabajo HiDream I1 Fast - Ejecuta este flujo de trabajo en Comfy Cloud sin configurar nada + Ejecuta este flujo de trabajo en Comfy Cloud sin configuración Descarga el archivo JSON del flujo de trabajo @@ -221,39 +223,38 @@ Genera imágenes rápidamente con HiDream I1 Fast. Versión ligera con 16 pasos **Salida de ejemplo** -![Ejemplo de salida de HiDream I1 Fast](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/hidream_i1_fast.png) +![Salida de ejemplo de HiDream I1 Fast](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/hidream_i1_fast.png) -#### 1. Descarga del archivo de modelo -Elige la versión adecuada según tu hardware, haz clic en el enlace y descarga el archivo de modelo correspondiente para guardarlo en la carpeta `ComfyUI/models/diffusion_models/`. +#### 1. Descargar el archivo del modelo +Selecciona la versión adecuada según tu hardware, haz clic en el enlace y descarga el archivo del modelo correspondiente para guardarlo en la carpeta `ComfyUI/models/diffusion_models/`. -- Versión FP8: [hidream_i1_fast_fp8.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_fast_fp8.safetensors?download=true) requiere más de 16 GB de VRAM -- Versión completa: [hidream_i1_fast_bf16.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_fast_bf16.safetensors?download=true) requiere más de 27 GB de VRAM +- Versión FP8: [hidream_i1_fast_fp8.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_fast_fp8.safetensors?download=true) requiere más de 16GB de VRAM +- Versión completa: [hidream_i1_fast_bf16.safetensors](https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/blob/main/split_files/diffusion_models/hidream_i1_fast_bf16.safetensors?download=true) requiere más de 27GB de VRAM -#### 2. Descarga del archivo de flujo de trabajo -Descarga la imagen de abajo y arrástrala a ComfyUI para cargar el flujo de trabajo correspondiente +#### 2. Descargar el archivo del flujo de trabajo +Descarga la imagen de abajo y arrástrala a ComfyUI para cargar el flujo de trabajo correspondiente. ![Flujo de trabajo de la versión Fast de HiDream-I1](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hidream_i1/hidream_i1_fast.png) -#### 3. Completa el flujo de trabajo paso a paso +#### 3. Completar el flujo de trabajo paso a paso ![Diagrama de flujo de la versión Fast de HiDream-I1](/images/tutorial/advanced/hidream/hidream_i1_fast_flow_diagram.jpg) Completa la ejecución del flujo de trabajo paso a paso 1. Asegúrate de que el nodo `Load Diffusion Model` esté usando el archivo `hidream_i1_fast_fp8.safetensors` -2. Asegúrate de que los cuatro codificadores de texto correspondientes de `QuadrupleCLIPLoader` estén cargados correctamente +2. Asegúrate de que los cuatro codificadores de texto correspondientes en `QuadrupleCLIPLoader` estén cargados correctamente - clip_l_hidream.safetensors - clip_g_hidream.safetensors - t5xxl_fp8_e4m3fn_scaled.safetensors - llama_3.1_8b_instruct_fp8_scaled.safetensors 3. Asegúrate de que el nodo `Load VAE` esté usando el archivo `ae.safetensors` 4. Para la versión **fast**, debes establecer el parámetro `shift` de `ModelSamplingSD3` en `3.0` -5. Para el nodo `Ksampler`, debes hacer los siguientes ajustes +5. Para el nodo `Ksampler`, debes aplicar las siguientes configuraciones - Establece `steps` en `16` - (Importante) Establece `cfg` en `1.0` - (Opcional) Establece `sampler` en `lcm` - (Opcional) Establece `scheduler` en `normal` -6. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de imágenes - +6. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de la imagen ## Otros recursos relacionados ### Modelos en versión GGUF @@ -261,7 +262,7 @@ Completa la ejecución del flujo de trabajo paso a paso - [HiDream-I1-Full-gguf](https://huggingface.co/city96/HiDream-I1-Full-gguf) - [HiDream-I1-Dev-gguf](https://huggingface.co/city96/HiDream-I1-Dev-gguf) -Debes usar el nodo “Unet Loader (GGUF)” de [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF) de City96 para reemplazar el nodo “Load Diffusion Model”. +Debes usar el nodo `Unet Loader (GGUF)` de [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF) de City96 para reemplazar el nodo `Load Diffusion Model`. ### Modelos en versión NF4 - [HiDream-I1-nf4](https://github.com/hykilpikonna/HiDream-I1-nf4) diff --git a/es/tutorials/image/krea/krea-2.mdx b/es/tutorials/image/krea/krea-2.mdx index 51df01f91c..2780c220f5 100644 --- a/es/tutorials/image/krea/krea-2.mdx +++ b/es/tutorials/image/krea/krea-2.mdx @@ -2,21 +2,24 @@ title: "Ejemplo de flujo de trabajo de Krea-2 en ComfyUI" description: "Krea 2 es un modelo de texto a imagen diseñado para lograr alta calidad estética y diversidad estilística. Viene en dos variantes: RAW (base) y Turbo (destilada)." sidebarTitle: "Krea 2" -translationSourceHash: e58c16b2 +translationSourceHash: a1a40706 translationFrom: tutorials/image/krea/krea-2.mdx translationBlockHashes: "_intro": 7dcc4be5 "Watch the Launch Event": 5863543e "Available Model Weights": 39b56045 + "Krea-2 Turbo text-to-image workflow": 3f9e59bc + "Krea-2 Turbo style reference workflow": cd74e362 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" **Krea 2** es un modelo de generación de imágenes de [Krea AI](https://www.krea.ai), entrenado desde cero y enfocado en la exploración creativa y estilística. -Krea 2 se distribuye como dos modelos diseñados para trabajar juntos: **entrena LoRAs en RAW y ejecuta la inferencia en Turbo**: -- **Krea 2 RAW**: el modelo base con muestreo de pasos completos (52 pasos). Sin destilación, diverso y altamente moldeable, ideal para ajuste fino y entrenamiento de LoRA. +Krea 2 se distribuye como dos modelos diseñados para trabajar juntos: **entrena tus LoRA en RAW y ejecuta la inferencia en Turbo**: +- **Krea 2 RAW**: el modelo base con muestreo de pasos completos (52 pasos). Sin destilación, diverso y muy moldeable, ideal para el ajuste fino y el entrenamiento de LoRA. - **Krea 2 Turbo**: un checkpoint destilado de 8 pasos para una generación rápida y de alta calidad. Los LoRA entrenados en RAW se aplican sin problemas a Turbo. **Licencia**: [Krea AI Community License](https://www.krea.ai/krea-2-licensing) @@ -30,8 +33,8 @@ Para aprender más acerca de Krea 2, la historia detrás de su desarrollo, sus c ## Pesos de modelo disponibles Krea 2 está disponible en dos variantes: -- **Krea 2 RAW**: el modelo base con muestreo de pasos completos (52 pasos). Diseñado para ofrecer diversidad y flexibilidad; ideal para fine-tuning y entrenamiento de LoRA. -- **Krea 2 Turbo**: un checkpoint destilado de 8 pasos creado para una generación rápida y de alta calidad. Los LoRA entrenados en RAW se aplican sin problemas en Turbo. +- **Krea 2 RAW**: el modelo base con muestreo de pasos completos (52 pasos). Diseñado para la diversidad y la maleabilidad; ideal para fine-tuning y entrenamiento de LoRA. +- **Krea 2 Turbo**: un checkpoint destilado de 8 pasos creado para una generación rápida y de alta calidad. Los LoRA entrenados en RAW se aplican sin problemas a Turbo. **Enlaces relacionados**: - [Krea 2 en Hugging Face (RAW)](https://huggingface.co/krea/Krea-2-Raw) @@ -41,13 +44,13 @@ Krea 2 está disponible en dos variantes: - [Guías de prompting](https://github.com/krea-ai/krea-2/blob/main/docs/prompting.md) - [Informe técnico](https://www.krea.ai/blog/krea-2-technical-report) -## Flujo de trabajo de texto a imagen de Krea-2 Turbo +## Flujo de trabajo de texto a imagen con Krea-2 Turbo ### Krea-2: Texto a imagen {#image_krea2_turbo_t2i} -Genera imágenes a partir de prompts de texto con Krea 2, un modelo fundacional pensado para la calidad estética y el control creativo. Se centra en generar imágenes expresivas y estilísticamente diversas. +Genera imágenes a partir de prompts de texto con Krea 2, un modelo fundacional creado para la calidad estética y el control creativo. Se enfoca en generar imágenes expresivas y estilísticamente diversas. -Vista previa del flujo de trabajo de texto a imagen de Krea-2 Turbo +Vista previa del flujo de trabajo de texto a imagen con Krea-2 Turbo @@ -62,18 +65,18 @@ Genera imágenes a partir de prompts de texto con Krea 2, un modelo fundacional El flujo de trabajo se organiza en varias partes: -1. **Text to Image (Krea-2 Turbo) subgrafo**: el pipeline de generación principal, que incluye la carga de modelos, el manejo del prompt, el muestreo y la decodificación del VAE -2. **ResolutionSelector**: elige la resolución de salida que quieras. Krea 2 admite salidas de 1K a 2K. Establece el valor de megapíxeles en 2.0 para obtener resolución 2K. -3. **CustomCombo (selector de LoRA)**: un selector de palabras de activación ya preparado para las LoRA de estilo disponibles. Si descargas LoRA adicionales, puedes personalizar este selector y emparejarlas con los archivos de LoRA correspondientes. +1. **Text to Image (Krea-2 Turbo) subgraph**: el pipeline principal de generación, que contiene la carga del modelo, el manejo del prompt, el muestreo y la decodificación VAE +2. **ResolutionSelector**: elige la resolución de salida deseada. Krea 2 admite salidas de 1K a 2K. Establece el valor de megapíxeles en 2.0 para obtener una resolución de 2K. +3. **CustomCombo (selector de LoRA)**: un selector de palabras de activación predefinido para las LoRA de estilo disponibles. Si descargas LoRA adicionales, puedes personalizar este selector y emparejarlas con los archivos LoRA correspondientes. 4. **SaveImage**: guarda la imagen generada - - Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. + + Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y extender el flujo de trabajo. ### Generación con un solo clic -En el caso más simple, basta con introducir un prompt de texto en el subgrafo, elegir una resolución y hacer clic en **Queue Prompt**. Los valores predeterminados (8 pasos, mejora del prompt activada, sin LoRA) producen una imagen de alta calidad con una configuración mínima. +En el caso más sencillo, solo introduce un prompt de texto en el subgrafo, selecciona una resolución y haz clic en **Queue Prompt**. Los valores predeterminados (8 pasos, mejora del prompt activada, sin LoRA) producen una imagen de alta calidad con una configuración mínima. ### Controles del flujo de trabajo @@ -82,38 +85,38 @@ El subgrafo **Text to Image (Krea-2 Turbo)** expone los siguientes controles: | Control | Descripción | |---------|-------------| | **Text String (User Prompt)** | El prompt de texto que describe la imagen que quieres generar | -| **prompt_enhance** | Activa o desactiva la expansión del prompt con un LLM | -| **LLM_max_token** | Longitud máxima en tokens para la mejora del prompt | +| **prompt_enhance** | Activa o desactiva la expansión del prompt con LLM | +| **LLM_max_token** | Longitud máxima de tokens para la mejora del prompt | | **Width / Height** | Resolución de salida (controlada por ResolutionSelector) | -| **Seed** | Semilla aleatoria para poder reproducir el resultado | +| **Seed** | Semilla aleatoria para la reproducibilidad | | **enable_lora?** | Activa o desactiva la LoRA de estilo | | **LoRA Strength** | Fuerza de la LoRA de estilo aplicada | -| **LoRA Trigger Word** | Palabra de activación que se rellena automáticamente para la LoRA seleccionada | +| **LoRA Trigger Word** | Palabra de activación rellenada automáticamente para la LoRA seleccionada | ### LoRA de estilo -Krea también publicó una colección de LoRA de estilo para Krea 2. Selecciona una en el nodo **CustomCombo** y activa `enable_lora?` en el subgrafo para aplicar el estilo: +Krea también lanzó una colección de LoRA de estilo para Krea 2. Selecciona una en el nodo **CustomCombo** y activa `enable_lora?` en el subgrafo para aplicar el estilo: -| LoRA | Palabra de activación | Fuerza recomendada | Descarga | +| LoRA | Palabra de activación | Fuerza recomendada | Descargar | |------|-------------|:-------------------:|----------| -| krea2_darkbrush | estilo de aguada de tinta monocroma | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_darkbrush.safetensors) | -| krea2_dotmatrix | estilo de punteado monocromo | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_dotmatrix.safetensors) | +| krea2_darkbrush | estilo de aguada monocromática | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_darkbrush.safetensors) | +| krea2_dotmatrix | estilo de punteado monocromático | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_dotmatrix.safetensors) | | krea2_kidsdrawing | estilo de boceto expresivo naíf | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_kidsdrawing.safetensors) | | krea2_neondrip | estilo abstracto texturizado | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_neondrip.safetensors) | | krea2_rainywindow | estilo de ventana lluviosa | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_rainywindow.safetensors) | -| krea2_retroanime | estilo retro anime púrpura | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_retroanime.safetensors) | +| krea2_retroanime | estilo de anime retro morado | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_retroanime.safetensors) | | krea2_softwatercolor | estilo de acuarela art déco | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_softwatercolor.safetensors) | | krea2_sunsetblur | estilo de desenfoque de movimiento etéreo | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_sunsetblur.safetensors) | | krea2_vintagetarot | estilo de tarot vintage | 1.0 | [Descargar](https://huggingface.co/Comfy-Org/Krea-2/blob/main/loras/krea2_vintagetarot.safetensors) | -Guarda los archivos `.safetensors` en `ComfyUI/models/loras/`. +Coloca los archivos `.safetensors` en `ComfyUI/models/loras/`. ### Descargas de modelos Para uso local, descarga los archivos de modelo optimizados para ComfyUI desde [Comfy-Org/Krea-2](https://huggingface.co/Comfy-Org/Krea-2). - + krea2_turbo_fp8_scaled.safetensors: Turbo FP8 (recomendado para la mayoría de los usuarios) @@ -123,11 +126,11 @@ Para uso local, descarga los archivos de modelo optimizados para ComfyUI desde [ qwen_image_vae.safetensors - Consulta todas las LoRA de estilo en Hugging Face + Ver todas las LoRA de estilo en Hugging Face -También hay otras variantes del modelo (BF16, NVFP4, MXFP8) para usuarios con hardware de gama alta. +También hay otras variantes del modelo (BF16, NVFP4, MXFP8) disponibles para usuarios con hardware de gama alta. #### Ubicación de almacenamiento de los modelos @@ -143,12 +146,11 @@ También hay otras variantes del modelo (BF16, NVFP4, MXFP8) para usuarios con h │ └── 📂 loras/ │ └── krea2_softwatercolor.safetensors (and other style LoRAs) ``` - ## Flujo de trabajo de referencia de estilo de Krea-2 Turbo ### Krea-2 Int8: referencia de estilo de imagen {#image_krea2_turbo_int8_image_style_reference} -Genera imágenes con el modelo Krea-2 Turbo tomando como referencia el estilo de 1–2 imágenes subidas, con el formato Int8 Convrot de alto rendimiento para una inferencia rápida. +Genera imágenes con el modelo Krea-2 Turbo tomando como referencia el estilo de 1 o 2 imágenes subidas, usando el formato Int8 Convrot de alto rendimiento para una inferencia rápida. Vista previa del flujo de trabajo de referencia de estilo de Krea-2 Turbo @@ -157,7 +159,7 @@ Genera imágenes con el modelo Krea-2 Turbo tomando como referencia el estilo de Abrir en Comfy Cloud - Descarga el JSON o busca "Krea-2 Style Reference" en la Biblioteca de plantillas + Descarga el JSON o busca "Krea-2 Style Reference" en la biblioteca de plantillas @@ -177,13 +179,13 @@ Sube este archivo al nodo `LoadImage` correspondiente: **Salida de ejemplo** -![Ejemplo de salida de la referencia de estilo de Krea-2](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_krea2_turbo_int8_image_style_reference.png) +![Salida de ejemplo de referencia de estilo de Krea-2](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_krea2_turbo_int8_image_style_reference.png) -El flujo de trabajo con referencia de estilo se basa en el pipeline de Krea-2 Turbo añadiendo el condicionamiento por imagen de referencia. Sube una o más imágenes de referencia para influir en el estilo estético, el ambiente y la dirección visual del resultado generado. +El flujo de trabajo de referencia de estilo se basa en la pipeline de Krea-2 Turbo y añade el acondicionamiento con imágenes de referencia. Sube una o más imágenes de referencia para influir en el estilo estético, el ambiente y la dirección visual de la salida generada. El flujo de trabajo se organiza en varias partes: -1. **Image Style Reference (Krea-2 Turbo) subgrafo**: el pipeline de generación principal con soporte para referencia de estilo, que incluye la carga de modelos, el condicionamiento por imagen de referencia, el manejo del prompt y el muestreo +1. **Subgrafo Image Style Reference (Krea-2 Turbo)**: la pipeline de generación principal con soporte de referencia de estilo, que incluye la carga del modelo, el acondicionamiento de las imágenes de referencia, el manejo del prompt y el muestreo 2. **LoadImage**: sube tus imágenes de referencia de estilo 3. **ResolutionSelector**: elige la resolución de salida que quieras. Krea 2 admite salidas de 1K a 2K. 4. **SaveImage**: guarda la imagen generada @@ -191,12 +193,12 @@ El flujo de trabajo se organiza en varias partes: ### Usar la referencia de estilo 1. **Sube las imágenes de referencia**: usa el nodo **LoadImage** para cargar una o más imágenes de referencia de estilo -2. **Escribe tu prompt**: introduce una descripción de texto en la entrada de prompt del usuario del subgrafo -3. **Selecciona una variante del modelo**: elige el checkpoint en el selector de modelo del subgrafo -4. **Ajusta la configuración**: establece la resolución, la semilla y, si quieres, activa la mejora del prompt +2. **Introduce tu prompt**: escribe una descripción de texto en la entrada de prompt del usuario del subgrafo +3. **Selecciona una variante del modelo**: elige el checkpoint del modelo en el selector de modelo del subgrafo +4. **Ajusta las configuraciones**: configura la resolución, la semilla y, de forma opcional, activa la mejora del prompt 5. **Haz clic en Queue**: pulsa `Ctrl+Enter` para generar -Este flujo de trabajo de referencia de estilo usa un modelo de difusión y una LoRA dedicados. El codificador de texto y el VAE se comparten con el flujo de trabajo de texto a imagen. +Este flujo de trabajo de referencia de estilo usa un modelo de difusión y un LoRA dedicados. El codificador de texto y el VAE se comparten con el flujo de trabajo de texto a imagen. @@ -213,7 +215,7 @@ Este flujo de trabajo de referencia de estilo usa un modelo de difusión y una L -Guarda los archivos en los siguientes directorios: +Coloca los archivos en los siguientes directorios: ``` 📂 ComfyUI/ diff --git a/es/tutorials/image/lens/lens.mdx b/es/tutorials/image/lens/lens.mdx index 68a6cc4a97..4027eeccd8 100644 --- a/es/tutorials/image/lens/lens.mdx +++ b/es/tutorials/image/lens/lens.mdx @@ -2,23 +2,25 @@ title: "Lens en ComfyUI: modelo open source de texto a imagen de 3.8B" description: "Ejecuta Lens, el modelo open source de texto a imagen de 3.8B de Microsoft en ComfyUI, con flujos estándar y Turbo sobre MMDiT de doble flujo y VAE de FLUX.2." sidebarTitle: "Lens" -translationSourceHash: e909f89c +translationSourceHash: 7385b700 translationFrom: tutorials/image/lens/lens.mdx translationBlockHashes: "_intro": 48b7db5c "Lens text-to-image workflow": 35c2bf24 + "Lens model downloads": b3f66783 "Available models": ff3bbfee --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Lens** es un modelo de texto a imagen abierto de **Microsoft**, con licencia MIT. Con **3800 millones** de parámetros, usa una arquitectura **MMDiT de doble flujo** con características del codificador de texto **GPT-OSS-20B** y el **VAE semántico de FLUX.2** para ofrecer una calidad de imagen competitiva con mucho menos cómputo de entrenamiento que modelos T2I más grandes. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Lens** es un modelo abierto de texto a imagen de **Microsoft**, con licencia MIT. Con **3800 millones** de parámetros, usa una arquitectura **MMDiT de doble flujo** con características del codificador de texto **GPT-OSS-20B** y el **VAE semántico de FLUX.2** para ofrecer una calidad de imagen competitiva con mucho menos cómputo de entrenamiento que modelos T2I más grandes. **Aspectos destacados del modelo**: - **Arquitectura MMDiT de doble flujo**: procesamiento conjunto de imagen y texto para una generación coherente - **Características de texto multicapa de GPT-OSS-20B**: comprensión avanzada del texto para seguir con precisión el prompt - **VAE semántico de FLUX.2**: representación latente de alta fidelidad - **Entrenamiento con resolución mixta**: admite varias relaciones de aspecto sin recortar -- **Tamaño compacto de 3.8B**: se ejecuta en GPU de consumo con 24 GB de VRAM +- **Tamaño compacto de 3.8B**: funciona en GPU de consumo con 24 GB de VRAM **Enlaces relacionados**: - [Artículo (arXiv)](https://arxiv.org/abs/2605.21573) @@ -42,7 +44,7 @@ Ingresa un prompt de texto y selecciona la resolución y la relación de aspecto - Descarga el JSON o busca "Lens" en Biblioteca de plantillas + Descarga el JSON o busca "Lens" en la Biblioteca de plantillas {/* TODO: Enable Cloud template when Lens is available on Comfy Cloud */} {/**/} @@ -52,7 +54,7 @@ Ingresa un prompt de texto y selecciona la resolución y la relación de aspecto **Salida de ejemplo** -![Salida de ejemplo del flujo de trabajo de texto a imagen de Lens](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_lens_t2i.png) +![Salida de ejemplo de texto a imagen de Lens](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_lens_t2i.png) @@ -62,7 +64,7 @@ Ingresa un prompt de texto y selecciona la resolución y la relación de aspecto {/* TODO: Add Cloud option when template is available */} 2. Ve a **Template** y busca **Lens** 3. Selecciona el flujo de trabajo **Lens** -4. Descarga los modelos faltantes (consulta [descargas de modelos](#descargas-de-modelos-de-lens)), ingresa tu prompt y haz clic en **Queue** +4. Descarga los modelos faltantes (consulta [descargas de modelos](#descargas-de-modelos-lens)), ingresa tu prompt y haz clic en **Queue** ### Lens Turbo: Texto a imagen {#image_lens_turbo_t2i} @@ -72,7 +74,7 @@ Ingresa un prompt de texto y selecciona la resolución, la relación de aspecto - Descarga el JSON o busca "Lens Turbo" en Biblioteca de plantillas + Descarga el JSON o busca "Lens Turbo" en la Biblioteca de plantillas {/* TODO: Enable Cloud template when Lens Turbo is available on Comfy Cloud */} {/**/} @@ -82,7 +84,7 @@ Ingresa un prompt de texto y selecciona la resolución, la relación de aspecto **Salida de ejemplo** -![Salida de ejemplo del flujo de trabajo de texto a imagen de Lens Turbo](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_lens_turbo_t2i.png) +![Salida de ejemplo de texto a imagen de Lens Turbo](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_lens_turbo_t2i.png) #### Empezar @@ -90,11 +92,11 @@ Ingresa un prompt de texto y selecciona la resolución, la relación de aspecto {/* TODO: Add Cloud option when template is available */} 2. Ve a **Template** y busca **Lens Turbo** 3. Selecciona el flujo de trabajo **Lens Turbo** -4. Descarga los modelos faltantes (consulta [descargas de modelos](#descargas-de-modelos-de-lens)), ingresa tu prompt y haz clic en **Queue** +4. Descarga los modelos faltantes (consulta [descargas de modelos](#descargas-de-modelos-lens)), ingresa tu prompt y haz clic en **Queue** -## Descargas de modelos de Lens +## Descargas de modelos Lens -Puedes encontrar todos los archivos del modelo en [Comfy-Org/Lens](https://huggingface.co/Comfy-Org/Lens), en Hugging Face. +Puedes encontrar todos los archivos de modelo en [Comfy-Org/Lens](https://huggingface.co/Comfy-Org/Lens) en Hugging Face. @@ -107,7 +109,7 @@ Puedes encontrar todos los archivos del modelo en [Comfy-Org/Lens](https://huggi - Codificador de texto (GPT-OSS-20B) compartido por Lens y Lens Turbo. + Text encoder (GPT-OSS-20B) compartido por Lens y Lens Turbo. VAE (FLUX.2) compartido por Lens y Lens Turbo. @@ -127,10 +129,9 @@ Puedes encontrar todos los archivos del modelo en [Comfy-Org/Lens](https://huggi │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` - ## Modelos disponibles | Modelo | Descripción | Pasos de inferencia | Enlace | |-------|-------------|-----------------|------| -| Lens | Modelo estándar de 3.8B: mayor calidad, más pasos | ~50 | [Hugging Face](https://huggingface.co/microsoft/Lens) | +| Lens | Modelo estándar de 3.8B: mayor calidad y más pasos | ~50 | [Hugging Face](https://huggingface.co/microsoft/Lens) | | Lens Turbo | Variante destilada: generación más rápida con menos pasos | ~8 | [Hugging Face](https://huggingface.co/microsoft/Lens) | diff --git a/es/tutorials/image/mage-flow/mage-flow.mdx b/es/tutorials/image/mage-flow/mage-flow.mdx index e4d81aeb92..0288663128 100644 --- a/es/tutorials/image/mage-flow/mage-flow.mdx +++ b/es/tutorials/image/mage-flow/mage-flow.mdx @@ -2,17 +2,19 @@ title: "Mage-Flow en ComfyUI: texto a imagen y edición por instrucciones" description: "Ejecuta el stack Mage-Flow de 4B de Microsoft en ComfyUI: texto a imagen y edición por instrucciones en resoluciones nativas de hasta 2K." sidebarTitle: "Mage-Flow" -translationSourceHash: 8a5898f9 +translationSourceHash: e9e74016 translationFrom: tutorials/image/mage-flow/mage-flow.mdx translationBlockHashes: "_intro": e97822e8 "Mage-Flow text-to-image workflow": 3c28ff07 "Mage-Flow Turbo text-to-image workflow": e7182b3d "Mage-Flow-Edit image edit workflow": cedd5e1d + "Mage-Flow-Edit Turbo image edit workflow": e09ae756 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Mage-Flow** es un stack generativo compacto de escala 4B de Microsoft Research para la generación eficiente de imágenes a partir de texto y la edición de imágenes basada en instrucciones. El stack se construye a partir de dos componentes codiseñados: [Mage-VAE](https://huggingface.co/microsoft/Mage-VAE), un tokenizer latente ligero de alta fidelidad, y un Native-Resolution Multimodal Diffusion Transformer (NR-MMDiT) entrenado con rectified flow matching. Junto con el empaquetado a resolución nativa, este stack compartido impulsa dos instancias del modelo: Mage-Flow para texto a imagen y Mage-Flow-Edit para la edición de imágenes basada en instrucciones. Cada una se distribuye en variantes Base, alineada con RL y Turbo de 4 pasos. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Mage-Flow** es un conjunto generativo compacto de escala 4B de Microsoft Research para la generación eficiente de texto a imagen y la edición de imágenes basada en instrucciones. El conjunto se construye a partir de dos componentes codiseñados: [Mage-VAE](https://huggingface.co/microsoft/Mage-VAE), un tokenizer latente ligero de alta fidelidad, y un Native-Resolution Multimodal Diffusion Transformer (NR-MMDiT) entrenado con rectified flow matching. Junto con el empaquetado a resolución nativa, este conjunto compartido impulsa dos instancias del modelo: Mage-Flow para la generación de texto a imagen y Mage-Flow-Edit para la edición de imágenes basada en instrucciones. Cada una se distribuye en variantes Base, alineada con RL y Turbo de 4 pasos. Mage-Flow admite resoluciones nativas de 512 a 2048 píxeles por lado en cualquier relación de aspecto, incluidas dimensiones extremas como 4:1. @@ -55,7 +57,7 @@ En el caso más simple, solo escribe un prompt de texto en el subgrafo, define l ### Usar el flujo de trabajo 1. **Escribe un prompt**: escribe una descripción de texto en la entrada de prompt del subgrafo -2. **Define la resolución**: ajusta el ancho y el alto según el tamaño de salida que quieras. Mage-Flow admite resoluciones nativas de 512 a 2048 píxeles por lado. +2. **Define la resolución**: ajusta el ancho y el alto según el tamaño de salida que quieras. Mage-Flow admite resoluciones nativas de 512 a 2048 píxeles por lado 3. **Ajusta las configuraciones**: configura la semilla y el prompt negativo según sea necesario 4. **Haz clic en Queue**: presiona `Ctrl+Enter` para generar @@ -72,7 +74,7 @@ En el caso más simple, solo escribe un prompt de texto en el subgrafo, define l -La variante Turbo usa un checkpoint destilado de 4 pasos para generar más rápido sin perder calidad. La estructura y los controles del flujo de trabajo son idénticos a los del flujo de trabajo base de texto a imagen, pero utiliza el modelo de difusión Turbo para una inferencia con menor latencia. +La variante Turbo usa un checkpoint destilado de 4 pasos para generar más rápido sin perder calidad. La estructura y los controles del flujo de trabajo son idénticos a los del flujo de trabajo base de texto a imagen, pero utiliza el modelo diffusion Turbo para una inferencia con menor latencia. ## Flujo de trabajo de edición de imágenes Mage-Flow-Edit @@ -95,8 +97,8 @@ El flujo de trabajo de edición de imágenes usa Mage-Flow-Edit, un modelo basad El flujo de trabajo se organiza en varias partes: 1. **LoadImage**: sube tus imágenes de referencia (hasta 3) -2. **Subgrafo Image Edit (Mage-Flow-Edit)**: el pipeline principal de edición que contiene la carga del modelo, el acondicionamiento de las imágenes de referencia, el manejo del prompt y el muestreo -3. **ImageCompare**: una comparación lado a lado de la imagen original y la editada +2. **Subgrafo Image Edit (Mage-Flow-Edit)**: el pipeline principal de edición, que contiene la carga del modelo, el acondicionamiento de las imágenes de referencia, el manejo del prompt y el muestreo +3. **ImageCompare**: una comparación lado a lado de la imagen original y la imagen editada 4. **SaveImage**: guarda el resultado editado ### Usar la edición de imágenes @@ -115,14 +117,14 @@ El flujo de trabajo se organiza en varias partes: Abrir en Comfy Cloud - Descarga el JSON o busca "Mage-Flow-Edit Turbo" en la Biblioteca de plantillas + Descargar JSON o buscar "Mage-Flow-Edit Turbo" en la biblioteca de plantillas - Descarga la imagen de entrada de ejemplo de este flujo de trabajo + Obtén la imagen de entrada de ejemplo para este flujo de trabajo -La variante Turbo del flujo de trabajo de edición usa un checkpoint destilado de 4 pasos para editar más rápido. La estructura y los controles coinciden con el flujo de trabajo de edición principal, pero con menos pasos de muestreo. +La variante Turbo del flujo de trabajo de edición usa un checkpoint destilado de 4 pasos para editar más rápido. La estructura y los controles coinciden con el flujo de trabajo de edición base, pero con menos pasos de muestreo. ### Descargas de modelos @@ -135,21 +137,21 @@ Para uso local, descarga los archivos de modelo optimizados para ComfyUI desde [ mage_flow_vae_bf16.safetensors - - mage_flow_int8_convrot.safetensors: modelo base usado en el flujo de trabajo de texto a imagen + + mage_flow_int8_convrot.safetensors: modelo base usado en el flujo de trabajo T2I - - mage_flow_turbo_int8_convrot.safetensors: modelo Turbo usado en el flujo de trabajo de texto a imagen Turbo + + mage_flow_turbo_int8_convrot.safetensors: modelo Turbo usado en el flujo de trabajo T2I Turbo - + mage_flow_edit_int8_convrot.safetensors: modelo Edit usado en el flujo de trabajo de edición - + mage_flow_edit_turbo_int8_convrot.safetensors: modelo Edit Turbo usado en el flujo de trabajo de edición Turbo -También hay otras variantes del modelo (BF16, FP8) para usuarios con configuraciones de hardware distintas. +También hay otras variantes del modelo (BF16, FP8) disponibles para usuarios con distintas configuraciones de hardware. Coloca los archivos en los siguientes directorios: diff --git a/es/tutorials/image/moss-image/moss-image.mdx b/es/tutorials/image/moss-image/moss-image.mdx index 0a522c08db..fe508a71f2 100644 --- a/es/tutorials/image/moss-image/moss-image.mdx +++ b/es/tutorials/image/moss-image/moss-image.mdx @@ -2,29 +2,32 @@ title: "MOSS-Image en ComfyUI: flujos de trabajo de texto a imagen y de diseño guiado" description: "Ejecuta MOSS-Image en ComfyUI: modelo de texto a imagen de 5B con mejora de prompt y generación guiada por diseño desde cuadros delimitadores." sidebarTitle: "MOSS-Image" -translationSourceHash: 8f11d7e1 +translationSourceHash: d5e93e3e translationFrom: tutorials/image/moss-image/moss-image.mdx translationBlockHashes: "_intro": 3e9c5a21 "About MOSS-Image": 7fc34b88 - "MOSS-Image workflows": 6f1e95e3 + "MOSS-Image workflows": 16679f12 "MOSS-Image model downloads": 76439d38 - "Prompting tips": 1b1feeb6 + "Prompting tips": 43980e35 + "Going above 2 MP": 8dac1045 + "Reference images and the prompt enhancer": 5c2c22aa --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' ## Acerca de MOSS-Image -MOSS-Image es el modelo texto a imagen de pesos abiertos de OpenMOSS: un DiT de un solo flujo de 5B que convierte una descripción completa de la escena en una imagen finalizada. Destaca donde el texto y la ubicación importan, porque renderiza tipografía en inglés y chino, acepta prompts de hasta unos 4K tokens y puede leer un diseño JSON que indica dónde va cada objeto y cada línea de texto. Los pesos se distribuyen bajo Apache 2.0, así que descargas una vez y ejecutas en tu propia GPU sin clave API ni créditos por imagen. +MOSS-Image es el modelo texto a imagen de pesos abiertos de OpenMOSS: un DiT de un solo flujo de 5B que convierte una descripción completa de la escena en una imagen finalizada. Destaca donde el texto y la ubicación importan, porque renderiza tipografía en inglés y chino, acepta prompts de hasta unos 4K tokens y puede leer una composición JSON que indica dónde va cada objeto y cada línea de texto. Los pesos se distribuyen bajo Apache 2.0, así que descargas una vez y ejecutas en tu propia GPU sin clave API ni créditos por imagen. -La familia tiene dos checkpoints. El checkpoint **SFT**, ajustado con instrucciones, es el que cargan las plantillas: agrupa el texto y distribuye las escenas de forma más limpia. El checkpoint **Base** no tiene posentrenamiento ni destilación CFG, lo que lo convierte en el punto de partida para los LoRA de la comunidad. Ambos se ejecutan en el mismo gráfico, así que cambiar de checkpoint solo implica cambiar el nodo de carga. +La familia tiene dos checkpoints. El checkpoint **SFT**, ajustado con instrucciones, es el que cargan las plantillas: agrupa el texto y distribuye las escenas de forma más limpia. El checkpoint **Base** no tiene posentrenamiento ni destilación CFG, lo que lo convierte en el punto de partida para los LoRA de la comunidad. Ambos se ejecutan en el mismo gráfico, así que cambiar de checkpoint solo implica cambiar el cargador. En ComfyUI el modelo se ejecuta desde checkpoints de archivo único en int8 y bf16, con un codificador de texto Qwen3.5 9B cargado como tipo `moss_image` y el VAE small de FLUX.2. Las plantillas de Texto a imagen también incluyen un mejorador de prompts que reescribe una petición corta en una descripción completa antes del muestreo, usando el mismo codificador de texto que el modelo ya necesita. **Aspectos destacados del modelo:** - DiT de un solo flujo de 5B con renderizado de texto bilingüe en inglés y chino -- Orientación de composición nativa: dibuja cajas, dale un texto a cada caja y las cajas de texto renderizan su propio texto +- Orientación de composición nativa: dibuja cajas, dale una descripción a cada caja y las cajas de texto renderizan su propio texto - Mejorador de prompts integrado en las plantillas de Texto a imagen, para que baste con una idea de una línea - Dos checkpoints: SFT para composiciones más limpias, Base para ajuste fino y trabajo con LoRA - Prompts largos de aproximadamente 4K tokens y cualquier relación de aspecto en múltiplos de 16 @@ -43,15 +46,15 @@ En ComfyUI el modelo se ejecuta desde checkpoints de archivo único en int8 y bf ## Flujos de trabajo de MOSS-Image -Las cuatro plantillas ejecutan el mismo subgrafo. Ábrelo para acceder a los cargadores, el sampler y el tamaño del lienzo. +Las cuatro plantillas ejecutan el mismo Subgraph. Ábrelo para acceder a los cargadores, el sampler y el tamaño del lienzo. - + Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. ### MOSS-Image: Text to Image {#image_moss_image_t2i} -Genera una imagen solo a partir de un prompt, sin archivos de entrada. El potenciador de prompts está activado, así que una descripción breve se amplía a un caption completo antes de llegar al modelo. El caption que realmente se usa aparece en `Preview Any`. +Genera una imagen solo a partir de un prompt, sin archivos de entrada. El potenciador de prompts está activado, así que una descripción breve se amplía a una descripción completa antes de llegar al modelo. La descripción que realmente se usa aparece en `Preview Any`. Vista previa del flujo de trabajo MOSS-Image de texto a imagen @@ -61,7 +64,7 @@ Genera una imagen solo a partir de un prompt, sin archivos de entrada. El potenc {/* TODO: Habilitar la plantilla de Cloud cuando MOSS-Image esté disponible en Comfy Cloud */} {/**/} - {/* Open in Comfy Cloud*/} + {/* Abrir en Comfy Cloud*/} {/**/} @@ -101,13 +104,13 @@ El mismo gráfico con el checkpoint Base cargado. Úsalo para comparar la salida 4. Descarga los modelos que aparecen en [descargas de modelos](#descargas-de-modelos-de-moss-image), incluido `moss_image_base_int8_convrot.safetensors` 5. Escribe tu idea en el prompt positivo y haz clic en **Queue** -### MOSS-Image: Layout-Guided Text to Image {#image_moss_image_t2i_bboxes} +### MOSS-Image: texto a imagen guiado por diseño {#image_moss_image_t2i_bboxes} -Genera una imagen a partir de un prompt y un diseño que dibujes tú. Abre `Create Bounding Boxes` y arrastra una caja para cada elemento; cada caja lleva su propio texto descriptivo, y las cajas marcadas como texto muestran ese texto dentro de ellas. `MOSS-Image Layout Prompt` convierte las cajas en el prompt de diseño que lee el modelo, así que se usan tanto el texto de la caja como el prompt de tu escena. +Genera una imagen a partir de un prompt y un diseño que dibujes tú. Abre `Create Bounding Boxes` y arrastra una caja para cada elemento; cada caja lleva su propia descripción, y las cajas marcadas como texto muestran ese texto dentro de ellas. `MOSS-Image Layout Prompt` convierte las cajas en el prompt de diseño que lee el modelo, así que el modelo usa tanto la descripción de la caja como el prompt de tu escena. -Dibuja primero la caja del fondo y deja para el final los elementos en primer plano: las cajas se emiten en el orden en que las dibujas. Cada caja se etiqueta como `text` si la marcas como texto y, si no, como `object`. Para etiquetar como personaje una caja que contiene una persona, anota su número del panel de vista previa de `Create Bounding Boxes` en `character_boxes` del nodo `MOSS-Image Layout Prompt`, por ejemplo `1, 3`. Los números que apuntan a una caja de texto no tienen efecto. Las dos plantillas de layout traen este campo ya relleno (`2` en SFT y `1` en Base), así que compruébalo con tus propias cajas antes de encolar. +Dibuja primero la caja del fondo y deja los elementos en primer plano para el final: las cajas salen en el orden en que las dibujas. Cada caja lleva la etiqueta `text` si la marcas como texto; si no, lleva `object`. Para etiquetar como personaje una caja que contiene una persona, anota su número del panel de vista previa de `Create Bounding Boxes` en `character_boxes` del nodo `MOSS-Image Layout Prompt`, por ejemplo `1, 3`. Los números que apuntan a una caja de texto no tienen efecto. Ambas plantillas de diseño incluyen este campo ya rellenado (`2` en SFT y `1` en Base), así que compruébalo con tus propias cajas antes de ponerlo en cola. -Con al menos una caja conectada, `MOSS-Image Layout Prompt` genera un prompt JSON: un caption de la escena más un elemento por cada caja. Las plantillas de layout traen `enable_prompt_enhancer` desactivado, así que ese JSON llega al modelo sin cambios. Si lo activas, el mejorador de prompts reescribe el texto y puede perder las cajas. +Con al menos una caja conectada, `MOSS-Image Layout Prompt` genera un prompt JSON: una descripción de la escena más un elemento por cada caja. Las plantillas de diseño traen `enable_prompt_enhancer` desactivado, así que ese JSON llega al modelo sin cambios. Si lo activas, dejas que el mejorador de prompt reescriba el texto, lo que puede descartar las cajas. Vista previa del flujo de trabajo de MOSS-Image de texto a imagen guiado por diseño @@ -130,14 +133,14 @@ Con al menos una caja conectada, `MOSS-Image Layout Prompt` genera un prompt JSO 1. Actualiza ComfyUI a 0.42.0 o una versión posterior 2. Ve a **Template**, busca **MOSS-Image** y elige la variante de diseño 3. Descarga los modelos que se indican en [descargas de modelos](#descargas-de-modelos-de-moss-image) -4. Dibuja una caja por elemento en `Create Bounding Boxes` y luego escribe un texto descriptivo para cada caja. Para una caja de texto, escribe el texto que quieres que se renderice +4. Dibuja una caja por elemento en `Create Bounding Boxes` y luego escribe una descripción para cada caja. Para una caja de texto, escribe el texto que quieres que se renderice 5. Describe la escena completa en el prompt y haz clic en **Queue** ### MOSS-Image Base: Layout-Guided Text to Image {#image_moss_image_base_t2i_bboxes} -El flujo de trabajo de layout con el checkpoint Base. Útil cuando quieres comparar cómo los dos checkpoints siguen el mismo layout de cajas. +El flujo de trabajo de disposición con el checkpoint Base. Es útil cuando quieres comparar cómo los dos checkpoints siguen la misma disposición de cajas. -Vista previa del flujo de trabajo de texto a imagen guiado por layout de MOSS-Image Base +Vista previa del flujo de trabajo de texto a imagen guiado por disposición de MOSS-Image Base @@ -151,26 +154,26 @@ El flujo de trabajo de layout con el checkpoint Base. Útil cuando quieres compa **Salida de ejemplo** -![Ejemplo de salida de texto a imagen guiado por layout de MOSS-Image Base](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_moss_image_t2i_bboxes_base.png) +![Ejemplo de salida de texto a imagen guiado por disposición de MOSS-Image Base](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_moss_image_t2i_bboxes_base.png) #### Empezar 1. Actualiza ComfyUI a la versión 0.42.0 o posterior -2. Ve a **Template**, busca **MOSS-Image Base** y elige la variante de layout +2. Ve a **Template**, busca **MOSS-Image Base** y elige la variante de disposición 3. Descarga los modelos enumerados en [descargas de modelos](#descargas-de-modelos-de-moss-image), incluido `moss_image_base_int8_convrot.safetensors` 4. Dibuja las cajas, escribe un título para cada una y redacta el prompt de la escena -5. Haz clic en **Queue** +5. Haz clic en **Cola** ## Descargas de modelos de MOSS-Image -Todos los archivos están en [Comfy-Org/MOSS-Image](https://huggingface.co/Comfy-Org/MOSS-Image) en Hugging Face. Las plantillas cargan los checkpoints int8; las versiones bf16 de ambos checkpoints están en el mismo repositorio para más VRAM. +Todos los archivos están en [Comfy-Org/MOSS-Image](https://huggingface.co/Comfy-Org/MOSS-Image) en Hugging Face. Las plantillas cargan los checkpoints int8; las versiones bf16 de ambos checkpoints están en el mismo repositorio para quienes dispongan de más VRAM. - Modelo de difusión, checkpoint ajustado con instrucciones. Lo cargan ambas plantillas SFT. + Modelo de difusión, checkpoint ajustado con instrucciones. Ambas plantillas SFT lo cargan. - Modelo de difusión, checkpoint Base. Lo cargan ambas plantillas Base. + Modelo de difusión, checkpoint Base. Ambas plantillas Base lo cargan. Codificador de texto para todas las plantillas. Cárgalo con `CLIPLoader` de tipo `moss_image`. @@ -195,37 +198,37 @@ Todos los archivos están en [Comfy-Org/MOSS-Image](https://huggingface.co/Comfy ``` -Las versiones bf16 `moss_image_sft_bf16.safetensors` y `moss_image_base_bf16.safetensors` están en el mismo repositorio. Cambia el checkpoint en `UNET Loader` si tienes la VRAM necesaria para ellas. +Las versiones bf16 `moss_image_sft_bf16.safetensors` y `moss_image_base_bf16.safetensors` están en el mismo repositorio. Cambia el checkpoint en `UNET Loader` si tienes la VRAM necesaria para usarlas. ## Consejos para escribir prompts -- **Describe la imagen finalizada, no la solicitud.** El modelo se entrenó con descripciones, así que escribe cómo se ve la imagen en lugar de una instrucción como «hazme un póster». El mejorador sigue la misma regla, por eso un prompt corto sigue funcionando. -- **Base lee secuencias de etiquetas.** Con el mejorador desactivado, MOSS-Image-Base acepta etiquetas separadas por comas además de descripciones, en el orden documentado: calidad, puntuación, meta, año, personaje, serie, artista y luego las etiquetas generales; por ejemplo `best quality, highres, hatsune miku, vocaloid, @foo bar, 1girl, blue hair`. -- **Desactiva el mejorador para controlar la redacción.** Establece `enable_prompt_enhancer` en `false` en el nodo del subgrafo y tu prompt llegará al modelo sin cambios. Con el mejorador activado, `prompt_enhancer_seed` cambia cómo se reescribe el prompt. Ambas configuraciones muestran el resultado en `Preview Any`, así que puedes comparar. +- **Describe la imagen finalizada, no la solicitud.** El modelo se entrenó con descripciones, así que escribe cómo se ve la imagen en lugar de una instrucción como «hazme un póster». El mejorador de prompts sigue la misma regla, por eso un prompt corto sigue funcionando. +- **Base lee secuencias de etiquetas.** Con el mejorador de prompts desactivado, MOSS-Image-Base acepta etiquetas separadas por comas además de descripciones, en el orden documentado: calidad, puntuación, meta, año, personaje, serie, artista y luego las etiquetas generales; por ejemplo `best quality, highres, hatsune miku, vocaloid, @foo bar, 1girl, blue hair`. +- **Desactiva el mejorador de prompts para controlar la redacción.** Establece `enable_prompt_enhancer` en `false` en el nodo del subgrafo y tu prompt llegará al modelo sin cambios. Con el mejorador activado, `prompt_enhancer_seed` cambia cómo se reescribe el prompt. Ambas configuraciones muestran el resultado en `Preview Any`, así que puedes comparar. - **Controla los saltos de línea tú mismo.** Los saltos automáticos pueden no quedar donde quieres. Coloca saltos de línea reales o `\n` en el texto que quieres que se renderice cuando importe la posición de un salto. - **Usa el flujo de trabajo de diseño cuando importe la colocación.** Las cajas le dan al modelo una posición explícita para cada elemento y cada bloque de texto, lo cual es más fiable que describir posiciones en prosa. -- **Mantén el lienzo en el alcance recomendado.** `ResolutionSelector` elige la relación de aspecto y la cantidad de megapíxeles (1 MP por defecto). MOSS-Image está pensado para 1 MP a 2 MP y extrapola desde aproximadamente 0.25 MP hasta 4 MP; el ancho y el alto deben ser múltiplos de 16. -- **Parte de las configuraciones de la plantilla y luego ve más despacio para conseguir el aspecto oficial.** Las plantillas ejecutan 25 pasos con CFG 2.5 y el sampler `er_sde` para ir más rápido. Los ajustes oficiales de Base son 50 pasos con CFG 3 y el sampler `euler`, así que pruébalos si un resultado queda crudo. Las configuraciones oficiales son 50 pasos con CFG 3, así que pruébalas si un resultado se queda corto. -- **Sube el CFG para prompts cortos en Base.** El rango oficial de CFG para MOSS-Image-Base va de 3.0 a 6.0, por encima del 2.5 que traen las plantillas. Desactiva el mejorador con un prompt corto para llegar al modelo tal cual, mantén 3.0 con uno largo y súbelo según sea necesario. +- **Mantén el lienzo en el alcance recomendado.** `ResolutionSelector` elige la relación de aspecto y la cantidad de megapíxeles (1 MP por defecto). De 1 MP a 2 MP es el alcance de salida recomendado y el modelo extrapola desde aproximadamente 0.25 MP hasta 4 MP; el ancho y el alto deben ser múltiplos de 16. +- **Parte de las configuraciones de la plantilla y luego ve más despacio para conseguir el aspecto oficial.** Las plantillas ejecutan 25 pasos con CFG 2.5 y el sampler `er_sde`. Las configuraciones oficiales de Base son 50 pasos con CFG 3 y el sampler `euler`, así que pruébalas si un resultado se queda corto. +- **Sube el CFG para prompts cortos en Base.** El rango oficial de CFG para MOSS-Image-Base va de 3.0 a 6.0, por encima del 2.5 que traen las plantillas. Desactiva el mejorador de prompts con un prompt corto para llegar al modelo tal cual, mantén 3.0 con uno largo y súbelo según sea necesario. - **Mantén el prompt negativo corto.** Las plantillas incluyen `nsfw, worst quality, bad anatomy, watermark, jpeg artifact`. -- **La orientación con salto de capas está activada en la capa 22.** El nodo del subgrafo incluye un interruptor `SLG`, y la orientación se ejecuta en la capa 22 oficial. Desactivarla puede dar un aspecto más realista, pero puede contraer el detalle; a las demás capas solo se puede acceder dentro del subgrafo. +- **La orientación de salto de capas se ejecuta en la capa 22.** El nodo del subgrafo incluye un interruptor `SLG`, y 22 es la capa oficial. Desactivarla puede dar un aspecto más realista, pero puede contraer el detalle; a las demás capas solo se puede acceder dentro del subgrafo. - **Base es para el ajuste fino.** Cuando entrenes una LoRA en MOSS-Image, congela el codificador de texto. ## Superar los 2 MP -El alcance de salida recomendado va de 1 MP a 2 MP, y el modelo extrapola hasta unos 4 MP. Cualquier tamaño mayor queda fuera de ese alcance, así que construye las imágenes grandes con pasadas sucesivas en lugar de un solo lienzo grande. +El rango de salida recomendado es de 1 MP a 2 MP, y el modelo extrapola hasta unos 4 MP. Todo lo que supere ese rango queda fuera, así que construye imágenes grandes mediante pasadas sucesivas en lugar de un solo lienzo grande. -Las plantillas alimentan al sampler con un `Empty Flux 2 Latent` fijo, así que esto requiere una edición dentro del subgrafo: +Las plantillas envían un `Empty Flux 2 Latent` fijo al sampler, así que esto requiere una edición dentro del subgrafo: 1. Renderiza la primera pasada a 1 MP o 2 MP. -2. Decodifica el resultado, redimensiónalo en el espacio de píxeles con `Upscale Image` y vuelve a codificarlo con `VAE Encode`. Ampliar el latente lo remuestrea directamente y pierde detalle que la segunda pasada no puede recuperar. -3. Alimenta al sampler con el latente codificado en lugar de `Empty Flux 2 Latent` y establece `denoise` en alrededor de 0.6 para un paso de 1.5x. Un valor más bajo mantiene intacta la primera pasada; uno más alto rehace la composición. +2. Decodifica el resultado, redimensiónalo en el espacio de píxeles con `Upscale Image` y luego vuelve a codificarlo con `VAE Encode`. Ampliar el latente lo remuestrea directamente y pierde detalle que la segunda pasada no puede recuperar. +3. Alimenta el sampler con el latente codificado en lugar de `Empty Flux 2 Latent` y ajusta `denoise` a aproximadamente 0.6 para un paso de 1.5x. Un valor más bajo mantiene intacta la primera pasada; uno más alto rehace la composición. -Repite la redimensión y el nuevo render en lugar de saltar al tamaño final. Un solo salto de 2 MP a 8K tiende a repetir detalle en vez de agregarlo, y un lienzo de 8K necesita `VAE Decode (Tiled)`. +Repite el redimensionado y la nueva renderización en lugar de saltar directamente al tamaño final. Un solo salto de 2 MP a 8K tiende a repetir el detalle en lugar de añadirlo, y un lienzo de 8K necesita `VAE Decode (Tiled)`. -## Imágenes de referencia y el mejorador de prompts +## Imágenes de referencia y el mejorador de prompt -El nodo del subgrafo tiene una entrada opcional `ref_image (for llm)`. Llega al mejorador de prompts, no al modelo de difusión: MOSS-Image no tiene entrada de imagen, así que no puede copiar una referencia. Con el mejorador activado, la imagen da forma a la descripción que escribe; con el mejorador desactivado, la imagen se ignora. +El nodo del subgrafo tiene una entrada opcional `ref_image (for llm)`. Llega al mejorador de prompt, no al modelo de diffusion: MOSS-Image no tiene entrada de imagen, así que no puede copiar una referencia. Con el mejorador de prompt activado, la imagen da forma a la descripción que escribe; con el mejorador de prompt desactivado, la imagen se ignora. -El mejorador de prompts se ejecuta sobre el codificador de texto Qwen3.5 que el modelo ya carga, mediante `Generate Text`, con un prompt de sistema escrito a partir de la skill oficial del mejorador de prompts de MOSS-Image. Su longitud de salida es `max_length`, 4096 tokens en las plantillas. En las plantillas `MOSS-Image: Text to Image` y `MOSS-Image Base: Text to Image`, `prompt_enhancer_seed` reproduce una descripción, y `Preview Any` muestra el texto que realmente llega al sampler. +El mejorador de prompt se ejecuta en el codificador de texto Qwen3.5 que el modelo ya carga, mediante `Generate Text`, con un prompt de sistema escrito a partir de la skill oficial del mejorador de prompt de MOSS-Image. Su longitud de salida es `max_length`, 4096 tokens en las plantillas. En las plantillas `MOSS-Image: Text to Image` y `MOSS-Image Base: Text to Image`, `prompt_enhancer_seed` reproduce una descripción, y `Preview Any` muestra el texto que realmente llega al sampler. diff --git a/es/tutorials/image/ovis/ovis-image.mdx b/es/tutorials/image/ovis/ovis-image.mdx index 711aaa02c8..ed4566c58d 100644 --- a/es/tutorials/image/ovis/ovis-image.mdx +++ b/es/tutorials/image/ovis/ovis-image.mdx @@ -2,7 +2,7 @@ title: "Ovis-Image en ComfyUI: modelo de renderizado de texto de 7B" description: "Ejecuta Ovis-Image en ComfyUI para renderizar texto nítido en chino e inglés en pósteres, banners, logos y maquetas de UI desde un prompt de texto." sidebarTitle: "Ovis-Image" -translationSourceHash: 8be09652 +translationSourceHash: 9721a07a translationFrom: tutorials/image/ovis/ovis-image.mdx --- diff --git a/es/tutorials/image/pixeldit/pixeldit.mdx b/es/tutorials/image/pixeldit/pixeldit.mdx index 7b147b0ab6..a89abe4702 100644 --- a/es/tutorials/image/pixeldit/pixeldit.mdx +++ b/es/tutorials/image/pixeldit/pixeldit.mdx @@ -2,13 +2,15 @@ title: "PixelDiT en ComfyUI: texto a imagen en espacio de píxeles de NVIDIA" description: "Ejecuta NVIDIA PixelDiT en ComfyUI para generar imágenes de texto a 1024px directamente en el espacio de píxeles, sin codificación ni decodificación VAE." sidebarTitle: "PixelDiT" -translationSourceHash: 65a41708 +translationSourceHash: 92812e84 translationFrom: tutorials/image/pixeldit/pixeldit.mdx translationBlockHashes: "_intro": eb9c0ba9 "PixelDiT text-to-image workflow": af3a6805 + "Model downloads": 52281af2 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' **PixelDiT** es el transformer de difusión en espacio de píxeles de NVIDIA para la generación de texto a imagen a 1024px. A diferencia de los modelos de difusión tradicionales que operan en el espacio latente, PixelDiT genera imágenes directamente en el espacio de píxeles mediante una arquitectura DiT de dos niveles: un DiT a nivel de parche combinado con un DiT a nivel de píxel, con fusión MM-DiT para la atención conjunta entre tokens de texto e imagen. @@ -40,8 +42,8 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" El flujo de trabajo consta de tres nodos principales: -1. **ResolutionSelector**: elige la resolución de salida deseada -2. **Subgrafo Text to Image (PixelDiT)**: el nodo de generación principal con controles expuestos para el prompt, la semilla, la selección del modelo y la resolución +1. **ResolutionSelector**: elige la resolución de salida que quieras +2. **Subgrafo Text to Image (PixelDiT)**: el nodo de generación principal, con controles expuestos para el prompt, la semilla, la selección del modelo y la resolución 3. **SaveImage**: guarda la imagen generada @@ -61,14 +63,14 @@ Los controles expuestos en el nodo de subgrafo **Text to Image (PixelDiT)** incl ## Descargas de modelos -PixelDiT usa dos archivos de modelo: un codificador de texto y el modelo de difusión. +PixelDiT usa dos archivos de modelo: un codificador de texto y el modelo de diffusion. gemma_2_2b_it_elm_bf16.safetensors: codificador de texto Gemma-2-2B-IT - - pixeldit_1300m_1024px_bf16.safetensors: modelo de difusión PixelDiT 1300M 1024px + + pixeldit_1300m_1024px_bf16.safetensors: modelo de diffusion PixelDiT 1300M 1024px ### Ubicación de almacenamiento de los modelos diff --git a/es/tutorials/image/qwen/qwen-image-2512.mdx b/es/tutorials/image/qwen/qwen-image-2512.mdx index 0ff29b3f4b..accac8da4c 100644 --- a/es/tutorials/image/qwen/qwen-image-2512.mdx +++ b/es/tutorials/image/qwen/qwen-image-2512.mdx @@ -2,13 +2,15 @@ title: "Qwen-Image-2512 en ComfyUI: texto a imagen fotorrealista" description: "Genera imágenes en 7 relaciones de aspecto en ComfyUI con la actualización de diciembre de Qwen-Image, para realismo humano, detalle natural y texto preciso." sidebarTitle: "Qwen-Image-2512" -translationSourceHash: 537e6509 +translationSourceHash: 26d99ccd translationFrom: tutorials/image/qwen/qwen-image-2512.mdx translationBlockHashes: "_intro": db22951d "Supported Aspect Ratios": 018121b0 + "Qwen-Image-2512 ComfyUI Native Workflow Example": e93092aa --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' **Qwen-Image-2512** es la actualización de diciembre del modelo fundacional de texto a imagen de Qwen-Image. En comparación con el modelo base Qwen-Image lanzado en agosto, Qwen-Image-2512 presenta mejoras significativas en la calidad de imagen y el realismo. @@ -36,15 +38,15 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" | 3:2 | 1584x1056 | | 2:3 | 1056x1584 | -## Ejemplo de flujo de trabajo nativo de ComfyUI para Qwen-Image-2512 +## Ejemplo de flujo de trabajo nativo de Qwen-Image-2512 en ComfyUI ### Qwen Image 2512 {#image_qwen_Image_2512} -Modelo de texto a imagen con mayor realismo humano, detalles naturales más finos y mejor renderizado de texto. +Modelo de texto a imagen con realismo humano mejorado, detalles naturales más finos y mejor representación de texto. -Vista previa del flujo de trabajo de Qwen-Image-2512 +Vista previa del flujo de trabajo Qwen-Image-2512 @@ -55,19 +57,19 @@ Modelo de texto a imagen con mayor realismo humano, detalles naturales más fino -**Ejemplo de salida** +**Salida de ejemplo** -![Ejemplo de salida de Qwen-Image-2512](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_qwen_Image_2512.png) +![Salida de ejemplo de Qwen-Image-2512](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_qwen_Image_2512.png) ### 1. Archivo del flujo de trabajo Después de actualizar ComfyUI, puedes encontrar el archivo del flujo de trabajo en las plantillas, o arrastrar la vista previa del flujo de trabajo de arriba a ComfyUI para cargarlo. El flujo de trabajo incluye dos subgrafos: -- **Text to Image (Qwen-Image 2512)**: generación estándar de 50 pasos -- **Text to Image (Qwen-Image 2512 4steps)**: generación acelerada de 4 pasos usando el LoRA Lightning +- **Texto a imagen (Qwen-Image 2512)**: generación estándar de 50 pasos +- **Texto a imagen (Qwen-Image 2512 4steps)**: generación acelerada de 4 pasos con Lightning LoRA -### 2. Descarga del modelo +### 2. Descarga de modelos **Codificadores de texto** @@ -79,7 +81,7 @@ El flujo de trabajo incluye dos subgrafos: **Modelos de difusión** -- [qwen_image_2512_fp8_e4m3fn.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/blob/main/split_files/diffusion_models/qwen_image_2512_fp8_e4m3fn.safetensors) (Recomendado para la mayoría de usuarios) +- [qwen_image_2512_fp8_e4m3fn.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/blob/main/split_files/diffusion_models/qwen_image_2512_fp8_e4m3fn.safetensors) (Recomendado para la mayoría de los usuarios) - [qwen_image_2512_bf16.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/blob/main/split_files/diffusion_models/qwen_image_2512_bf16.safetensors) (Si tienes suficiente VRAM y quieres mejor calidad) **VAE** diff --git a/es/tutorials/image/qwen/qwen-image-edit.mdx b/es/tutorials/image/qwen/qwen-image-edit.mdx index 82e0b67d88..f73811983b 100644 --- a/es/tutorials/image/qwen/qwen-image-edit.mdx +++ b/es/tutorials/image/qwen/qwen-image-edit.mdx @@ -2,23 +2,25 @@ title: "Ejemplo de flujo de trabajo nativo de ComfyUI para Qwen-Image-Edit" description: "Qwen-Image-Edit es la versión de edición de Qwen-Image, entrenada sobre el modelo de 20B, con edición precisa de texto y edición semántica y de apariencia." sidebarTitle: "Qwen-Image-Edit" -translationSourceHash: 0faaeb7a +translationSourceHash: 86e42be2 translationFrom: tutorials/image/qwen/qwen-image-edit.mdx translationBlockHashes: "_intro": eee08e9a "ComfyOrg Qwen-Image-Edit Live Stream": 6e70a462 "Qwen-Image-Edit ComfyUI Native Workflow Example": 530f43f2 + "Qwen Image Edit 2509 {#image_qwen_image_edit_2509}": 2b273573 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Qwen-Image-Edit** es la versión de edición de imágenes de Qwen-Image. Está entrenado adicionalmente a partir del modelo Qwen-Image de 20B, y logra extender las capacidades únicas de renderizado de texto de Qwen-Image a las tareas de edición, lo que permite una edición precisa del texto. Además, Qwen-Image-Edit introduce la imagen de entrada tanto en Qwen2.5-VL (para el control semántico visual) como en el VAE Encoder (para el control de apariencia visual), y así consigue capacidades de edición tanto semántica como de apariencia. +**Qwen-Image-Edit** es la versión de edición de imágenes de Qwen-Image. Se entrena adicionalmente sobre el modelo Qwen-Image de 20B y extiende con éxito las capacidades únicas de renderizado de texto de Qwen-Image a las tareas de edición, lo que permite una edición precisa del texto. Además, Qwen-Image-Edit alimenta la imagen de entrada tanto en Qwen2.5-VL (para el control semántico visual) como en el VAE Encoder (para el control de apariencia visual), logrando así capacidades de edición tanto semánticas como de apariencia. **Características del modelo** Las características incluyen: - Edición precisa de texto: Qwen-Image-Edit admite la edición de texto bilingüe (chino e inglés), lo que permite añadir, eliminar y modificar texto directamente en las imágenes conservando el tamaño, la fuente y el estilo originales. -- Edición dual semántica y de apariencia: Qwen-Image-Edit admite no solo la edición visual de bajo nivel (como la transferencia de estilo, la adición, la eliminación o la modificación de elementos), sino también la edición semántica visual de alto nivel (como la creación de IP, la rotación de objetos, etc.). -- Rendimiento sólido en múltiples benchmarks: las evaluaciones en varios benchmarks públicos muestran que Qwen-Image-Edit alcanza el estado del arte (SOTA) en tareas de edición, lo que lo convierte en un modelo base potente para la generación de imágenes. +- Edición dual semántica y de apariencia: Qwen-Image-Edit admite no solo la edición visual de bajo nivel (como transferencia de estilo, adición, eliminación, modificación, etc.), sino también la edición semántica visual de alto nivel (como creación de IP, rotación de objetos, etc.). +- Rendimiento sólido en múltiples benchmarks: las evaluaciones en varios benchmarks públicos muestran que Qwen-Image-Edit alcanza SOTA en tareas de edición, lo que lo convierte en un modelo base potente para la generación de imágenes. **Enlaces oficiales**: - [Repositorio de GitHub](https://github.com/QwenLM/Qwen-Image) @@ -122,7 +124,7 @@ Ubicación de almacenamiento de los modelos - Asegúrate de que el nodo `Load CLIP` cargue `qwen_2.5_vl_7b_fp8_scaled.safetensors` - Asegúrate de que el nodo `Load VAE` cargue `qwen_image_vae.safetensors` 2. Carga de imagen - - Asegúrate de que el nodo `Load Image` tenga subida la imagen que quieres editar + - Asegúrate de que en el nodo `Load Image` subas la imagen que quieres editar 3. Configuración del prompt - Define el prompt en el nodo `CLIP Text Encoder` 4. El nodo `Scale Image to Total Pixels` escalará tu imagen de entrada a un total de un millón de píxeles, @@ -134,22 +136,22 @@ Ubicación de almacenamiento de los modelos ## Qwen Image Edit 2509 {#image_qwen_image_edit_2509} -Qwen-Image-Edit-2509 es la siguiente iteración de Qwen-Image-Edit. Mantiene la edición precisa de texto bilingüe del modelo original y agrega entrada de varias imágenes, ediciones más consistentes a lo largo de una serie de imágenes y compatibilidad con ControlNet, así que puedes editar una imagen tomando otras como referencia. +Qwen-Image-Edit-2509 es la siguiente iteración de Qwen-Image-Edit. Mantiene la edición de texto bilingüe precisa del modelo original y añade entrada de varias imágenes, ediciones más consistentes en una serie de imágenes y soporte de ControlNet, para que puedas editar una imagen mientras haces referencia a otras. -Vista previa del flujo de trabajo de Qwen Image Edit 2509 +Qwen Image Edit 2509 workflow preview Abrir en Comfy Cloud - Descarga el JSON o busca "Qwen Image Edit 2509" en la biblioteca de plantillas + Descargar JSON o buscar "Qwen Image Edit 2509" en la biblioteca de plantillas **Materiales de entrada** -Sube este archivo al nodo `LoadImage` que corresponda: +Sube este archivo al nodo `LoadImage` correspondiente: @@ -157,7 +159,7 @@ Sube este archivo al nodo `LoadImage` que corresponda: -### Descarga de modelos +### Descargar el modelo **Modelo de difusión** @@ -175,7 +177,7 @@ Sube este archivo al nodo `LoadImage` que corresponda: - [qwen_image_vae.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/blob/main/split_files/vae/qwen_image_vae.safetensors) -Ubicación de almacenamiento de los modelos +**Ubicación de almacenamiento de los modelos** ``` 📂 ComfyUI/ diff --git a/es/tutorials/image/qwen/qwen-image-layered.mdx b/es/tutorials/image/qwen/qwen-image-layered.mdx index 12b0820ff2..1dfe92707f 100644 --- a/es/tutorials/image/qwen/qwen-image-layered.mdx +++ b/es/tutorials/image/qwen/qwen-image-layered.mdx @@ -2,21 +2,23 @@ title: "Qwen-Image-Layered en ComfyUI: descomposición en capas de imagen" description: "Descompone una imagen en varias capas RGBA con Qwen-Image-Layered y luego recolorea, sustituye, redimensiona o reubica cada capa de forma independiente." sidebarTitle: "Qwen-Image-Layered" -translationSourceHash: 801175a4 +translationSourceHash: 0f254c67 translationFrom: tutorials/image/qwen/qwen-image-layered.mdx translationBlockHashes: "_intro": 9e032d88 "Qwen-Image-Layered workflow": 309e8412 + "Model links": 053c337d "FP8 version": 6bffdd17 "Layers and output": 1b020f3c "Workflow settings": 098636f1 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Qwen-Image-Layered** es un modelo desarrollado por el equipo Qwen de Alibaba que puede descomponer una imagen en varias capas RGBA. Esta representación por capas habilita una editabilidad inherente: cada capa se puede manipular de forma independiente sin afectar el contenido de las demás. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Qwen-Image-Layered** es un modelo desarrollado por el equipo Qwen de Alibaba que puede descomponer una imagen en varias capas RGBA. Esta representación por capas habilita una capacidad de edición inherente: cada capa se puede manipular de forma independiente sin afectar el contenido de las demás. **Características principales**: -- **Editabilidad inherente**: cada capa se puede manipular de forma independiente sin afectar el contenido de las demás +- **Capacidad de edición inherente**: cada capa se puede manipular de forma independiente sin afectar el contenido de las demás - **Operaciones elementales de alta fidelidad**: admite cambiar el tamaño, la posición y el color con aislamiento físico de los componentes semánticos - **Descomposición en cantidad variable de capas**: no se limita a un número fijo de capas; descompón en 3, 4, 8 o más capas según lo necesites - **Descomposición recursiva**: cualquier capa se puede descomponer aún más, lo que permite una profundidad de descomposición infinita @@ -32,7 +34,7 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" ### Descomposición con Qwen-Image-Layered {#image_qwen_image_layered} -Descompón una imagen en capas RGBA editables para flujos de trabajo de recoloreado, reemplazo, redimensionado y reposicionado. +Descompón una imagen en capas RGBA editables para recolorar, reemplazar, redimensionar y reposicionar. Vista previa del flujo de trabajo Qwen-Image-Layered @@ -83,20 +85,19 @@ Sube este archivo al nodo `LoadImage` **74**: │ └── 📂 vae/ │ └── qwen_image_layered_vae.safetensors ``` - ## Versión FP8 -De forma predeterminada usamos bf16, que requiere mucha VRAM. Si quieres reducir el uso de VRAM, puedes usar la versión fp8: +Por defecto usamos bf16, que requiere mucha VRAM. Si necesitas un uso de VRAM menor, puedes usar la versión fp8: - [qwen_image_layered_fp8mixed.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-Layered_ComfyUI/blob/main/split_files/diffusion_models/qwen_image_layered_fp8mixed.safetensors) -Luego, actualiza el nodo **Cargar modelo de difusión** dentro del [Subgraph](/es/interface/features/subgraph) para usarla. +Después, actualiza el nodo **Load Diffusion model** dentro del [Subgraph](/es/interface/features/subgraph) para usarla. ## Capas y salida -El número de capas lo define el widget `layers` del nodo **Empty Qwen Image Layered Latent**, dentro del [Subgraph](/es/interface/features/subgraph). +El número de capas lo define el widget `layers` del nodo **Latente Qwen Image en capas vacío**, dentro del [Subgraph](/es/interface/features/subgraph). -Este modelo regenera la imagen completa además de las capas, así que una generación siempre se decodifica en `layers + 1` imágenes: +Este modelo regenera la imagen completa además de las capas, así que una generación siempre decodifica `layers + 1` imágenes: | `layers` | Imágenes decodificadas | Contenido | | --- | --- | --- | @@ -104,28 +105,28 @@ Este modelo regenera la imagen completa además de las capas, así que una gener | `2` (valor predeterminado de la plantilla) | 3 | La imagen completa y luego 2 capas | | `5` | 6 | La imagen completa y luego 5 capas | -**La primera imagen es la imagen completa, no una capa.** El flujo de trabajo de imagen a capas la descarta automáticamente con un nodo `LatentCut` (`dim` `t`, `index` `1`) antes de la división del lote, de modo que la plantilla genera `layers` imágenes. Si construyes un gráfico personalizado sin ese nodo, descarta la primera imagen cuando solo quieras las capas. `layers` acepta `0`, lo que te da esa imagen por sí sola. +**La primera imagen es la imagen completa, no una capa.** El flujo de trabajo de imagen a capas la descarta automáticamente con un nodo `Cortar latente` (`dim` `t`, `index` `1`) antes de la división del lote, por lo que la plantilla genera `layers` imágenes. Si construyes un gráfico personalizado sin ese nodo, descarta la primera imagen cuando solo quieras las capas. `layers` acepta `0`, lo que te da esa imagen por sí sola. -**Si compones todas las capas de nuevo, vuelves a crear la imagen completa.** Úsalo como comprobación: si al apilar las capas no se reproduce la primera imagen, la descomposición no hizo lo que buscabas. +**Recomponer todas las capas vuelve a crear la imagen completa.** Úsalo como comprobación: si al apilar las capas no se reproduce la primera imagen, la descomposición no hizo lo que querías. -### Cómo se convierten las capas en imágenes separadas +### Cómo las capas se convierten en imágenes separadas -El nodo **Empty Qwen Image Layered Latent** asigna un latente 5D con forma `[batch_size, 16, layers + 1, height // 8, width // 8]`. Las capas ocupan el tercer eje, el mismo eje temporal que los modelos de video usan para los fotogramas. El nodo **LatentCutToBatch** con `dim` en `t` mueve ese eje a la dimensión del lote, así que después de **VAE Decode** cada capa es una imagen separada dentro del lote. La plantilla inserta un nodo `LatentCut` (`dim` `t`, `index` `1`) antes de `LatentCutToBatch` para descartar la entrada de la imagen completa, de modo que el lote decodificado solo contiene las capas. +El nodo **Latente Qwen Image en capas vacío** asigna un latente 5D con forma `[batch_size, 16, layers + 1, height // 8, width // 8]`. Las capas ocupan el tercer eje, el mismo eje temporal que los modelos de video usan para los fotogramas. El nodo **Cortar latente a lote** con `dim` en `t` mueve ese eje a la dimensión del lote, de modo que después de la **Decodificación VAE** cada capa es una imagen separada dentro del lote. La plantilla inserta un nodo `Cortar latente` (`dim` `t`, `index` `1`) antes de **Cortar latente a lote** para descartar la entrada de la imagen completa, así que el lote decodificado contiene solo las capas. -Por lo tanto, la posición de una capa en la pila es su índice en el lote, contando desde la imagen completa en el índice 0. No hay campo de z-index ni metadatos por capa que lleven ese orden, así que reordenar o filtrar el lote reordena las capas. +La posición de una capa en la pila es, por lo tanto, su índice en el lote, contando desde la imagen completa en el índice 0. No existe un campo de z-index ni metadatos por capa que lleven ese orden, así que reordenar o filtrar el lote reordena las capas. -El VAE de Qwen-Image-Layered decodifica a 4 canales, así que las capas decodificadas llevan un canal alfa. +El VAE de Qwen-Image-Layered decodifica a 4 canales, por lo que las capas decodificadas llevan un canal alfa. ## Configuraciones del flujo de trabajo ### Configuraciones del sampler -Este modelo es lento. Las configuraciones de muestreo originales son steps: 50 y CFG: 4.0, lo que al menos duplicará el tiempo de generación. +Este modelo es lento. Las configuraciones de muestreo originales son steps: 50 y CFG: 4.0, lo que como mínimo duplica el tiempo de generación. ### Tamaño de entrada -Para el tamaño de entrada, se recomienda 640px. Usa 1024px para una salida de alta resolución. +Para el tamaño de entrada se recomienda 640px. Usa 1024px para una salida de alta resolución. ### Prompt (opcional) -El prompt de texto está pensado para describir el contenido general de la imagen de entrada, incluidos los elementos que pueden estar parcialmente ocultos (por ejemplo, puedes especificar el texto que está detrás de un objeto en primer plano). No está diseñado para controlar explícitamente el contenido semántico de cada capa. +El prompt de texto sirve para describir el contenido general de la imagen de entrada, incluidos los elementos que pueden estar parcialmente ocluidos (por ejemplo, puedes especificar el texto oculto detrás de un objeto en primer plano). No está diseñado para controlar de forma explícita el contenido semántico de cada capa. diff --git a/es/tutorials/image/z-image/z-image-turbo.mdx b/es/tutorials/image/z-image/z-image-turbo.mdx index 0d0a554811..17adc4743b 100644 --- a/es/tutorials/image/z-image/z-image-turbo.mdx +++ b/es/tutorials/image/z-image/z-image-turbo.mdx @@ -2,21 +2,24 @@ title: "Z-Image-Turbo en ComfyUI: texto a imagen en 8 pasos" description: "Un modelo destilado de texto a imagen de 6B que renderiza en 8 pasos con 16GB de VRAM, con renderizado preciso de texto en chino e inglés en ComfyUI." sidebarTitle: "Z-Image-Turbo" -translationSourceHash: 3ba96151 +translationSourceHash: 33113227 translationFrom: tutorials/image/z-image/z-image-turbo.mdx translationBlockHashes: "_intro": 7084d4ab + "Z-Image-Turbo text-to-image workflow": b88a686f + "Z-Image-Turbo Fun Union ControlNet workflow": abab6a04 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' **Z-Image (造相)** es un modelo de generación de imágenes potente y muy eficiente con **6B** parámetros, desarrollado por Tongyi Lab de Alibaba. Utiliza una arquitectura **Scalable Single-Stream DiT** (S3-DiT) en la que los tokens de texto, los tokens semánticos visuales y los tokens del VAE de imagen se concatenan a nivel de secuencia para formar un único flujo de entrada, maximizando la eficiencia de los parámetros. **Variantes del modelo**: -- 🚀 **Z-Image-Turbo**: una versión destilada que iguala o supera a los principales competidores con solo **8 NFE** (Number of Function Evaluations). Ofrece una **latencia de inferencia inferior a un segundo** en GPUs H800 de clase empresarial y cabe en **dispositivos de consumo con 16 GB de VRAM**. +- 🚀 **Z-Image-Turbo**: una versión destilada que iguala o supera a los principales competidores con solo **8 NFE** (Number of Function Evaluations). Ofrece una **latencia de inferencia inferior a un segundo** en GPUs H800 de clase empresarial y cabe en **dispositivos de consumo con 16GB de VRAM**. - 🧱 **Z-Image-Base**: el modelo base sin destilar, pensado para el ajuste fino impulsado por la comunidad y el desarrollo personalizado. -- ✍️ **Z-Image-Edit**: una variante ajustada para tareas de edición de imágenes, con una capacidad notable para seguir instrucciones. +- ✍️ **Z-Image-Edit**: una variante ajustada para tareas de edición de imágenes, con una notable capacidad para seguir instrucciones. **Aspectos destacados del modelo**: - **Calidad fotorrealista**: ofrece una sólida generación de imágenes fotorrealistas sin perder una excelente calidad estética @@ -30,28 +33,28 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -## Flujo de trabajo de texto a imagen de Z-Image-Turbo +## Flujo de trabajo de texto a imagen con Z-Image-Turbo -### Z-Image-Turbo: Text to Image {#image_z_image_turbo} +### Z-Image-Turbo: Texto a imagen {#image_z_image_turbo} -Un modelo fundacional eficiente de generación de imágenes con Single-Stream Diffusion Transformer; admite inglés y chino. +Un modelo fundacional eficiente de generación de imágenes con Diffusion Transformer de flujo único, compatible con inglés y chino. -Vista previa del flujo de trabajo de texto a imagen de Z-Image-Turbo +Vista previa del flujo de trabajo de texto a imagen con Z-Image-Turbo - + Ejecuta este flujo de trabajo directamente en Comfy Cloud - Descarga el archivo JSON del flujo de trabajo de texto a imagen de Z-Image-Turbo + Descarga el archivo JSON del flujo de trabajo de texto a imagen con Z-Image-Turbo -**Ejemplo de salida** +**Salida de ejemplo** -![Ejemplo de salida de Z-Image-Turbo](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_z_image_turbo.png) +![Salida de ejemplo de Z-Image-Turbo](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_z_image_turbo.png) -### Descargas de modelos de Z-Image-Turbo +### Descargas del modelo Z-Image-Turbo @@ -64,7 +67,7 @@ Un modelo fundacional eficiente de generación de imágenes con Single-Stream Di VAE para Z-Image-Turbo. -**Ubicación de almacenamiento de los modelos de Z-Image-Turbo** +**Ubicación de almacenamiento del modelo Z-Image-Turbo** ``` 📂 ComfyUI/ @@ -76,21 +79,20 @@ Un modelo fundacional eficiente de generación de imágenes con Single-Stream Di │ └── 📂 vae/ │ └── ae.safetensors ``` - -## Flujo de trabajo de ControlNet Fun Union de Z-Image-Turbo +## Flujo de trabajo de Z-Image-Turbo Fun Union ControlNet ### Z-Image-Turbo Fun Union ControlNet {#image_z_image_turbo_fun_union_controlnet} -ControlNet multi-control compatible con Canny, HED, Depth, Pose y MLSD para Z-Image-Turbo. +ControlNet de control múltiple compatible con Canny, HED, Depth, Pose y MLSD para Z-Image-Turbo. -Vista previa del flujo de trabajo de ControlNet Fun Union de Z-Image-Turbo +Vista previa del flujo de trabajo de Z-Image-Turbo Fun Union ControlNet Ejecuta este flujo de trabajo directamente en Comfy Cloud - Descarga el archivo JSON del flujo de trabajo de ControlNet Fun Union de Z-Image-Turbo + Descarga el archivo JSON del flujo de trabajo de Z-Image-Turbo Fun Union ControlNet @@ -100,7 +102,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - Nodo `LoadImage` 58 · `image_z_image_turbo_fun_union_controlnet_input_image.png` + `LoadImage` nodo 58 · `image_z_image_turbo_fun_union_controlnet_input_image.png` diff --git a/es/tutorials/image/z-image/z-image.mdx b/es/tutorials/image/z-image/z-image.mdx index c47464a94c..926bf4af68 100644 --- a/es/tutorials/image/z-image/z-image.mdx +++ b/es/tutorials/image/z-image/z-image.mdx @@ -2,17 +2,19 @@ title: "Z-Image en ComfyUI: modelo base de texto a imagen de 6B" description: "Genera imágenes fotorrealistas en ComfyUI con Z-Image (造相), el modelo open source de 6B de Tongyi Lab, con texto chino/inglés preciso y razonamiento de prompts." sidebarTitle: "Z-Image" -translationSourceHash: ef8f0cce +translationSourceHash: 613b8f98 translationFrom: tutorials/image/z-image/z-image.mdx translationBlockHashes: "_intro": e00a79e0 "Z-Image text-to-image workflow": 49b8d4a9 + "Z-Image model downloads": 02a933e1 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Z-Image (造相)** es un modelo de generación de imágenes potente y altamente eficiente con **6B** parámetros, desarrollado por Tongyi Lab de Alibaba. Utiliza una arquitectura **Scalable Single-Stream DiT** (S3-DiT), en la que los tokens de texto, los tokens semánticos visuales y los tokens VAE de imagen se concatenan a nivel de secuencia para formar un flujo de entrada unificado, lo que maximiza la eficiencia de los parámetros. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' -Z-Image (Base) es el modelo base no destilado diseñado para el ajuste fino impulsado por la comunidad y el desarrollo personalizado. +**Z-Image (造相)** es un modelo de generación de imágenes potente y muy eficiente, con **6B** parámetros, desarrollado por Tongyi Lab de Alibaba. Emplea una arquitectura **Scalable Single-Stream DiT** (S3-DiT) en la que los tokens de texto, los tokens semánticos visuales y los tokens de imagen del VAE se concatenan a nivel de secuencia para formar un flujo de entrada unificado, lo que maximiza la eficiencia de los parámetros. + +Z-Image (Base) es el modelo base no destilado, diseñado para el ajuste fino impulsado por la comunidad y el desarrollo personalizado. **Puntos destacados del modelo**: - **Calidad fotorrealista**: ofrece una potente generación de imágenes fotorrealistas y mantiene una excelente calidad estética. @@ -31,7 +33,7 @@ Z-Image (Base) es el modelo base no destilado diseñado para el ajuste fino impu ### Z-Image: Texto a imagen {#image_z_image} -La base para la libertad creativa. Estética diversa con una calidad fotorrealista excepcional; ideal para fine-tuning; responde a los prompts negativos; alta diversidad de generación. +La base para la libertad creativa. Estéticas diversas con una calidad fotorrealista excepcional; ideal para el ajuste fino; responde a los prompts negativos; alta diversidad de generación. Vista previa del flujo de trabajo de texto a imagen con Z-Image @@ -55,14 +57,14 @@ La base para la libertad creativa. Estética diversa con una calidad fotorrealis Codificador de texto para Z-Image. - Modelo de difusión para Z-Image. + Modelo de diffusion para Z-Image. VAE para Z-Image. -**Ubicación de almacenamiento de los modelos** +**Ubicación de almacenamiento de modelos** ``` 📂 ComfyUI/ diff --git a/es/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx b/es/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx index e2fcd83b9d..5fe2f50596 100644 --- a/es/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx +++ b/es/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx @@ -2,7 +2,7 @@ title: "FLUX.1 Kontext en ComfyUI: edición de imágenes con Pro y Max" description: "Edita imágenes en ComfyUI con los nodos asociados FLUX.1 Kontext Pro y Max: cambios de objetos y estilo, fondo, consistencia de personajes y texto." sidebarTitle: "FLUX 1 Kontext" -translationSourceHash: a0162ebb +translationSourceHash: 6e33d2c1 translationFrom: tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx translationBlockHashes: "_intro": f46b0e5e @@ -11,7 +11,9 @@ translationBlockHashes: "Use it": 994ca527 "FLUX.1 Kontext Multiple Image Input Workflow": 5cb24d5f "FLUX.1 Kontext Pro Image Partner Nodes Workflow": 73d4e4eb + "FLUX.1 Kontext Max Image Partner Nodes Workflow": 9e7b7cf6 --- + import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import PromptTechniques from "/snippets/es/tutorials/flux/prompt-techniques.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; @@ -28,7 +30,7 @@ Actualmente, ComfyUI es compatible con dos modelos de FLUX.1 Kontext: ## En qué destaca FLUX.1 Kontext - **Edición versátil sin descripciones complejas**: modificación de objetos, transferencia de estilo, reemplazo de fondo, edición con consistencia de personaje y edición de texto -- **Comprensión del contexto**: la comprensión inteligente del contexto de la imagen permite realizar ediciones precisas y específicas +- **Comprensión del contexto**: la comprensión inteligente del contexto de la imagen permite hacer ediciones precisas y específicas - **Consistencia de personaje**: las características del personaje y la disposición de la composición se mantienen estables incluso después de varias iteraciones de edición - **Entrada de varias imágenes**: el nodo `Image Stitch` combina varias imágenes en una sola para editarla con FLUX.1 Kontext - **Dos niveles de modelo**: Kontext Pro para editar, componer y remezclar; Kontext Max para tipografía, precisión del prompt y velocidad @@ -47,20 +49,20 @@ Edición de imágenes con Kontext Max, que lleva al límite la tipografía, la p ![Ejemplo de edición de imágenes con FLUX.1 Kontext Max](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_max_image.png) -## Úsalo +## Usarlo - + Llama a Kontext Pro o Max por HTTP a través de Comfy Router, con fragmentos de Python, TypeScript, Swift y cURL listos para pegar -Esto se ejecuta en la misma cuenta de Comfy y se factura con los mismos créditos que ejecutarlo en ComfyUI más abajo. Consulta [Precios de los Nodos asociados](/es/tutorials/partner-nodes/pricing) para ver las tarifas por modelo y [Límites de concurrencia](/es/tutorials/partner-nodes/concurrency-limits) para saber cuántas solicitudes puedes tener en curso. +Esto se ejecuta en la misma cuenta de Comfy y se factura con los mismos créditos que ejecutarlo en ComfyUI más abajo. Consulta [Créditos de Nodos de Socio](/es/tutorials/partner-nodes/pricing) para ver las tarifas por modelo y [Límites de concurrencia](/es/tutorials/partner-nodes/concurrency-limits) para saber cuántas solicitudes puedes tener en curso. ## Flujo de trabajo con múltiples imágenes de entrada de FLUX.1 Kontext -Recientemente actualizamos el soporte para flujos de trabajo con múltiples imágenes de entrada. Con el nuevo nodo `Image Stitch`, puedes unir varias imágenes en una sola y editarla con FLUX.1 Kontext. +Hace poco actualizamos el soporte para flujos de trabajo con múltiples imágenes de entrada. Con el nuevo nodo `Image Stitch`, puedes unir varias imágenes en una sola y editarla con FLUX.1 Kontext. ### 1. Descargar el archivo del flujo de trabajo @@ -96,7 +98,7 @@ Puedes seguir los pasos numerados de la imagen para completar el flujo de trabaj ### 1. Descargar el archivo de flujo de trabajo -Los `metadata` de la imagen a continuación contienen la información del flujo de trabajo. Descárgala y arrástrala a ComfyUI para cargar el flujo de trabajo correspondiente. +Los metadatos (`metadata`) de la imagen a continuación contienen la información del flujo de trabajo. Descárgala y arrástrala a ComfyUI para cargar el flujo de trabajo correspondiente. ![Flujo de trabajo de nodos asociados de FLUX.1 Kontext Pro Image de ComfyUI](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_pro_image.png) @@ -114,21 +116,21 @@ Puedes seguir los pasos numerados de la imagen para completar el flujo de trabaj 3. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la edición de la imagen 4. Después de esperar a que la API devuelva los resultados, puedes ver la imagen editada en el nodo `Save Image`, y la imagen correspondiente también se guardará en el directorio `ComfyUI/output/` -## Flujo de trabajo de nodos asociados de FLUX.1 Kontext Max Image +## Flujo de trabajo con Nodos asociados de FLUX.1 Kontext Max Image -### 1. Descargar el archivo de flujo de trabajo +### 1. Descargar el archivo del flujo de trabajo -Los `metadata` de la imagen a continuación contienen la información del flujo de trabajo. Descárgala y arrástrala a ComfyUI para cargar el flujo de trabajo correspondiente. +La `metadata` de la imagen a continuación contiene la información del flujo de trabajo. Descárgala y arrástrala a ComfyUI para cargar el flujo de trabajo correspondiente. -![Flujo de trabajo de nodos asociados de FLUX.1 Kontext Max Image de ComfyUI](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_max_image.png) +![Flujo de trabajo con Nodos asociados de FLUX.1 Kontext Max Image de ComfyUI](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_max_image.png) -Descarga la imagen a continuación como entrada o usa tu propia imagen como demostración: +Descarga la imagen a continuación como entrada o usa tu propia imagen para la demostración: -![Flujo de trabajo de nodos asociados de FLUX.1 Kontext Max Image de ComfyUI](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_max_image_input.png) +![Flujo de trabajo con Nodos asociados de FLUX.1 Kontext Max Image de ComfyUI](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_max_image_input.png) ### 2. Completar el flujo de trabajo paso a paso -![Pasos del flujo de trabajo de nodos asociados de FLUX.1 Kontext Max Image de ComfyUI](/images/tutorial/api_nodes/bfl/flux_1_kontext_max_image_step_guide.jpg) +![Pasos del flujo de trabajo con Nodos asociados de FLUX.1 Kontext Max Image de ComfyUI](/images/tutorial/api_nodes/bfl/flux_1_kontext_max_image_step_guide.jpg) Puedes seguir los pasos numerados de la imagen para completar el flujo de trabajo: 1. Carga la imagen que quieres editar en el nodo `Load Image` diff --git a/es/tutorials/partner-nodes/bytedance/seedream-5-flash.mdx b/es/tutorials/partner-nodes/bytedance/seedream-5-flash.mdx new file mode 100644 index 0000000000..850331ad6f --- /dev/null +++ b/es/tutorials/partner-nodes/bytedance/seedream-5-flash.mdx @@ -0,0 +1,90 @@ +--- +title: "ByteDance Seedream 5.0 Flash: generación rápida de imágenes en ComfyUI" +description: "Genera y edita imágenes de hasta 2K con Seedream 5.0 Flash en ComfyUI, el nivel de tarifa plana de la familia de imágenes Seedream 5.0 de ByteDance" +sidebarTitle: "Seedream 5 Flash" +translationSourceHash: 3e4940a0 +translationFrom: tutorials/partner-nodes/bytedance/seedream-5-flash.mdx +translationBlockHashes: + "_intro": 53e0e20c + "What Seedream 5.0 Flash is good at": c14c7331 + "Example outputs": 525e4e25 + "Seedream 5.0 Flash text-to-image workflow": a67673e6 + "Seedream 5.0 Flash image edit workflow": 453a0ae7 + "Get started": 12679413 +--- +import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; +import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; + + +Seedream 5.0 Flash es el nivel rápido de la familia de imágenes Seedream 5.0 de ByteDance, junto con Seedream 5.0 Pro y Seedream 5.0 Lite. Genera una imagen a partir de un prompt de texto y edita una imagen existente a partir de una sola instrucción en el mismo nodo, y cobra una tarifa plana por imagen generada en todas las resoluciones que admite. + +Cada ejecución devuelve una imagen de entre 1K y 2K, con ocho relaciones de aspecto disponibles en cada uno de los niveles 1K, 1.5K y 2K. Puedes adjuntar hasta 10 imágenes de referencia para composiciones con varias referencias, como una foto de producto colocada en un nuevo diseño. El mismo modelo también se puede seleccionar en el nodo de separación de capas, que divide una imagen plana en capas transparentes editables. + +## En qué destaca Seedream 5.0 Flash + +- **Tarifa plana en todas las resoluciones**: un solo precio por imagen generada en 1K, 1.5K y 2K, así que la resolución que elijas no cambia el costo +- **Generación y edición en un solo nodo**: genera a partir de un prompt o adjunta una imagen de referencia y describe el cambio en una frase +- **Entrada con múltiples referencias**: acepta hasta 10 imágenes de referencia, suficiente para combinar varios sujetos, productos o estilos en una sola composición +- **Renderizado de texto**: maneja leyendas, etiquetas y texto de composición dentro de la imagen generada +- **Una imagen por ejecución**: cada ejecución devuelve una imagen. Las opciones de generación por lote y secuencial disponibles en otros modelos Seedream no están expuestas para este modelo +- **Separación de capas**: se puede seleccionar como el modelo en el nodo de separación de capas para convertir una imagen plana en una pila de capas editable + +## Salidas de ejemplo + +Generación de texto a imagen, produciendo una imagen con el tamaño predefinido seleccionado: + +![Ejemplo de texto a imagen con Seedream 5.0 Flash](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_bytedance_seedream_5_0_flash_t2i.png) + +Edición de imagen a partir de una sola imagen de referencia y una instrucción de texto: + +![Ejemplo de edición de imagen con Seedream 5.0 Flash](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_bytedance_seedream_5_0_flash_image_edit.png) + + + + +## Flujo de trabajo de texto a imagen con Seedream 5.0 Flash + +Genera una imagen a partir de un prompt de texto. El flujo de trabajo devuelve una sola imagen con el tamaño preestablecido seleccionado en el nodo. + +Vista previa del flujo de trabajo de texto a imagen con Seedream 5.0 Flash + + + + Abrir en Comfy Cloud + + + Descarga el JSON o busca "Seedream 5.0 Flash" en la Biblioteca de plantillas + + + +## Flujo de trabajo de edición de imagen con Seedream 5.0 Flash + +Edita una imagen existente con una instrucción de texto. Conecta la imagen de origen a la entrada `image_1` del nodo y describe el cambio que deseas, desde cambiar el fondo hasta reconstruir un set de producto alrededor del sujeto de la referencia. + +Vista previa del flujo de trabajo de edición de imagen con Seedream 5.0 Flash + + + + Abrir en Comfy Cloud + + + Descarga el JSON o busca "Seedream 5.0 Flash" en la Biblioteca de plantillas + + + +
+Materiales de entrada + +Descarga esta imagen de entrada de ejemplo para probar el flujo de trabajo: + + + + Descargar imagen de entrada de ejemplo + + +
+ +## Empezar + +1. Actualiza ComfyUI a la versión 0.37.3 o posterior +2. Ve a Template Library y busca `Seedream 5.0 Flash` diff --git a/es/tutorials/partner-nodes/bytedance/seedream-5-pro.mdx b/es/tutorials/partner-nodes/bytedance/seedream-5-pro.mdx index b5022f3620..3dc5b5947f 100644 --- a/es/tutorials/partner-nodes/bytedance/seedream-5-pro.mdx +++ b/es/tutorials/partner-nodes/bytedance/seedream-5-pro.mdx @@ -2,7 +2,7 @@ title: "ByteDance Seedream 5.0 Pro - Generación profesional de imágenes con IA" description: "Genera imágenes de alta calidad con mejor seguimiento de instrucciones, edición precisa y resultados profesionales con Seedream 5.0 Pro en ComfyUI" sidebarTitle: "Seedream 5 Pro" -translationSourceHash: 2ea701f2 +translationSourceHash: 1a800b2f translationFrom: tutorials/partner-nodes/bytedance/seedream-5-pro.mdx translationBlockHashes: "_intro": 7da8abcf @@ -10,9 +10,10 @@ translationBlockHashes: "Example outputs": 8e9ad94f "Seedream 5.0 Pro text-to-image workflow": 87df7263 "Seedream 5.0 Pro image edit workflow": faaa6452 - "Seedream 5.0 Pro layer separation workflow": a6084e3e + "Seedream 5.0 Pro layer separation workflow": 245a59fb "Get started": 709ac7fd --- + import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; @@ -94,7 +95,7 @@ Descarga esta imagen de entrada de ejemplo para probar el flujo de trabajo: ## Flujo de trabajo de separación de capas de Seedream 5.0 Pro -La separación de capas es el pilar de descomposición por capas de la edición interactiva de precisión de Seedream 5.0 Pro. Divide una sola imagen plana en una pila editable: una imagen base (placa de fondo) más hasta 16 capas transparentes independientes, cada una con su orden de apilamiento, coordenadas de caja delimitadora, nombre y descripción semántica. El modelo rellena mediante inpainting las regiones ocultas detrás de los sujetos extraídos, de modo que cada capa y la base que queda debajo es un recurso de diseño completo e independiente, listo para arrastrar, escalar y recomponer. +La separación de capas es el pilar de descomposición por capas de la edición interactiva de precisión de Seedream 5.0 Pro. Divide una sola imagen plana en una pila editable: una imagen base (placa de fondo) más hasta 16 capas transparentes independientes, cada una con su orden de apilamiento, coordenadas de caja delimitadora, nombre y descripción semántica. Las regiones ocultas detrás de los sujetos extraídos se rellenan con inpainting de forma imperceptible, así que cada capa y la base que queda debajo es un recurso de diseño completo e independiente, listo para arrastrar, escalar y recomponer. Sin ningún prompt, el modelo identifica automáticamente todos los elementos principales: bloques de texto, sujetos, decoraciones y fondo. Un solo póster puede generar más de 10 capas, con una separación de texto de calidad de diseño que admite titulares multilingües y fuentes CJK. También puedes describir los elementos en lenguaje natural para controlar la separación, o apuntar a regiones exactas con etiquetas de caja delimitadora. Este flujo de trabajo es ideal para diseño de marca, creación de recursos de comercio electrónico, iteración de pósters y cualquier tarea en la que un mapa de bits plano deba convertirse en un documento por capas editable. La plantilla incluye el modelo **Seedream 5.0 Flash** seleccionado. Cambia el modelo en el nodo a `seedream 5.0 pro` para ejecutar la separación con Seedream 5.0 Pro. diff --git a/es/tutorials/partner-nodes/google/gemini.mdx b/es/tutorials/partner-nodes/google/gemini.mdx index 9e9ed57244..d9428f55ca 100644 --- a/es/tutorials/partner-nodes/google/gemini.mdx +++ b/es/tutorials/partner-nodes/google/gemini.mdx @@ -2,15 +2,17 @@ title: "Google Gemini en ComfyUI: chat y comprensión de imágenes" description: "Usa el nodo asociado Google Gemini en ComfyUI para chat multimodal, interpretar imágenes y convertirlas en un prompt de dibujo." sidebarTitle: "Gemini" -translationSourceHash: e42322ac +translationSourceHash: de47c5bd translationFrom: tutorials/partner-nodes/google/gemini.mdx translationBlockHashes: "_intro": e647e8c8 "What Google Gemini is good at": b9861953 "Use it": ec2e265f + "Google Gemini {#api_google_gemini}": 88cf62a5 "Complete the workflow execution step by step": 23d136c2 "Additional Notes": 479b788f --- + import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; @@ -29,7 +31,7 @@ Google Gemini es un potente modelo de IA desarrollado por Google que admite func Llámalo por HTTP a través de Comfy Router, con fragmentos de Python, TypeScript, Swift y cURL listos para copiar y pegar
-Esto se ejecuta en la misma cuenta de Comfy y se factura con los mismos créditos que ejecutarlo en ComfyUI más abajo. Consulta [Precios de los Nodos asociados](/es/tutorials/partner-nodes/pricing) para ver las tarifas por modelo y [Límites de concurrencia](/es/tutorials/partner-nodes/concurrency-limits) para saber cuántas solicitudes puedes tener en curso. +Esto se ejecuta en la misma cuenta de Comfy y se factura con los mismos créditos que ejecutarlo en ComfyUI más abajo. Consulta [Créditos de Nodos de Socio](/es/tutorials/partner-nodes/pricing) para ver las tarifas por modelo y [Límites de concurrencia](/es/tutorials/partner-nodes/concurrency-limits) para saber cuántas solicitudes puedes tener en curso. @@ -38,7 +40,7 @@ Esto se ejecuta en la misma cuenta de Comfy y se factura con los mismos crédito Experimenta con la IA multimodal de Google y las capacidades de razonamiento de Gemini. -Google Gemini workflow preview +Vista previa del flujo de trabajo de Google Gemini @@ -63,7 +65,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: example.png -## Completar la ejecución del flujo de trabajo paso a paso +## Completa la ejecución del flujo de trabajo paso a paso ![Guía paso a paso de OpenAI Chat](/images/tutorial/api_nodes/google/tripo_image_to_model_step_guide.jpg) @@ -73,11 +75,11 @@ En la plantilla correspondiente, hemos creado un prompt para analizar y generar Puedes guiarte por los números de la imagen para completar la ejecución básica del flujo de trabajo de texto a imagen: 1. En el nodo `Load Image`, carga la imagen que necesitas que la IA interprete -2. (Opcional) Si es necesario, puedes modificar el prompt en `Google Gemini` para que la IA ejecute tareas específicas -3. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la conversación. +2. (Opcional) Si lo necesitas, puedes modificar el prompt en `Google Gemini` para que la IA ejecute tareas específicas +3. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la conversación. 4. Después de esperar a que la API devuelva los resultados, puedes ver el contenido correspondiente devuelto por la IA en el nodo `Preview Any`. ## Notas adicionales -- Actualmente, el nodo de entrada de archivos `Gemini Input Files` requiere que primero cargues los archivos en el directorio `ComfyUI/input/`. Este nodo está en proceso de mejora y modificaremos la plantilla después de las actualizaciones -- El flujo de trabajo incluye un ejemplo que usa `Batch Images` como entrada. Si tienes varias imágenes que necesitan interpretación de la IA, puedes consultar el diagrama de pasos y usar el clic derecho para establecer el modo del nodo correspondiente en `Always` y habilitarlo +- Actualmente, el nodo de entrada de archivos `Gemini Input Files` requiere que primero cargues los archivos en el directorio `ComfyUI/input/`. Este nodo se está mejorando y modificaremos la plantilla después de las actualizaciones. +- El flujo de trabajo incluye un ejemplo que usa `Batch Images` como entrada. Si tienes varias imágenes que necesitan la interpretación de la IA, puedes consultar el diagrama de pasos y usar el clic derecho para establecer el modo del nodo correspondiente en `Always` y habilitarlo. diff --git a/es/tutorials/partner-nodes/ideogram/ideogram-v3.mdx b/es/tutorials/partner-nodes/ideogram/ideogram-v3.mdx new file mode 100644 index 0000000000..c4f94d033b --- /dev/null +++ b/es/tutorials/partner-nodes/ideogram/ideogram-v3.mdx @@ -0,0 +1,53 @@ +--- +title: "Ideogram 3.0 en ComfyUI: texto a imagen y edición de imágenes" +description: "Ejecuta Ideogram 3.0 con los Nodos asociados de ComfyUI: genera imágenes fotorrealistas con texto preciso o edita un área enmascarada desde un prompt." +sidebarTitle: "Ideogram 3.0" +translationSourceHash: 452067eb +translationFrom: tutorials/partner-nodes/ideogram/ideogram-v3.mdx +--- + +import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; +import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; + +Ideogram 3.0 es un potente modelo de texto a imagen de Ideogram, conocido por su calidad fotorrealista, su representación precisa del texto y su control de estilo constante. + +El nodo Ideogram V3 actualmente admite dos modos: +- Modo texto a imagen +- Modo edición de imágenes (cuando proporcionas las entradas de imagen y máscara) + + + + +## Modo texto a imagen de los nodos asociados de Ideogram 3.0 + +Cuando usas Ideogram V3 sin las entradas de imagen y máscara, el nodo funciona en modo texto a imagen. + +### 1. Descargar el archivo del flujo de trabajo + +Descarga y arrastra el siguiente archivo a ComfyUI para cargar el flujo de trabajo: + +![Ideogram 3.0 ComfyUI Workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/ideogram/v3/ideogram_v3_t2i.png) + +### 2. Completar los pasos del flujo de trabajo + +![Ideogram 3.0 Workflow Steps](/images/tutorial/api_nodes/ideogram/ideogram_v3_t2i.jpg) + +Sigue los pasos numerados para completar el flujo de trabajo básico: +1. Ingresa la descripción de tu imagen en el campo `prompt` del nodo `Ideogram V3` +2. Haz clic en `Run` o usa el atajo `Ctrl(cmd) + Enter` para generar la imagen +3. Cuando la API devuelva los resultados, mira la imagen generada en el nodo `Save Image`. Las imágenes se guardan en el directorio `ComfyUI/output/` + +## Modo edición de imágenes de los nodos asociados de Ideogram 3.0 + +Conecta las entradas `image` y `mask` del nodo `Ideogram V3` para cambiarlo al modo edición de imágenes. El nodo regenera el área enmascarada a partir de tu prompt y mantiene el resto de la imagen sin cambios. + +1. Carga la imagen que quieres editar con un nodo `Load Image` y luego conéctala a la entrada `image` del nodo `Ideogram V3` +2. Haz clic derecho en la imagen cargada, elige **Open in MaskEditor** y pinta el área que quieres cambiar +3. Conecta la salida de la máscara a la entrada `mask` del nodo `Ideogram V3`. Las áreas pintadas (blancas) se reemplazan y todo lo que queda fuera de la máscara se conserva +4. Ingresa la instrucción de edición en el campo `prompt`, describiendo lo que debe aparecer dentro del área enmascarada +5. Haz clic en `Run` o usa el atajo `Ctrl(cmd) + Enter` para generar la imagen editada +6. Mira el resultado en el nodo `Save Image`. La imagen editada también se guarda en el directorio `ComfyUI/output/` + + +El nodo solo usa el modo edición cuando `image` y `mask` están conectadas. Si conectas solo una de ellas, el nodo funciona en modo texto a imagen. + \ No newline at end of file diff --git a/es/tutorials/partner-nodes/luma/luma-uni-1.mdx b/es/tutorials/partner-nodes/luma/luma-uni-1.mdx index 20390d4317..996bf36f23 100644 --- a/es/tutorials/partner-nodes/luma/luma-uni-1.mdx +++ b/es/tutorials/partner-nodes/luma/luma-uni-1.mdx @@ -2,7 +2,7 @@ title: "Guía de Luma Uni-1" description: "Usa los nodos asociados de Luma Uni-1 en ComfyUI para flujos de trabajo de imagen de Create y Modify." sidebarTitle: "Luma Uni 1" -translationSourceHash: f66e59c6 +translationSourceHash: 83a60329 translationFrom: tutorials/partner-nodes/luma/luma-uni-1.mdx translationBlockHashes: "_intro": 89c69a78 @@ -11,6 +11,7 @@ translationBlockHashes: "The core distinction: Create vs Modify": c3ea208f "Available workflows": d8e43b04 "Core parameters": b43ac975 + "Working with reference images": d20d34ae "Prompting guidelines": ba9ac50d "Aspect ratios": d56acf10 "Seeds: control and reproducibility": 0a278508 @@ -20,25 +21,26 @@ translationBlockHashes: "The golden rules": b1bc370a "Key takeaway": 77d51b1d --- + import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -En **ComfyUI**, Luma **Uni-1** aparece como **Nodos asociados** para el trabajo unificado con imágenes: los grafos **Create** generan imágenes nuevas a partir de prompts (con referencias opcionales); los grafos **Modify** toman una imagen existente como entrada y la editan en el mismo sitio. Ambos se manejan con el flujo de trabajo habitual: conecta **Load Image** y **Save Image**, define prompts, semillas, relación de aspecto y ranuras de referencia en el nodo de Luma, y luego pon el grafo en cola de forma local o abre una plantilla en **Comfy Cloud**. +En **ComfyUI**, Luma **Uni-1** aparece como **Nodos asociados** (Partner Nodes) de Luma para el trabajo unificado con imágenes: los grafos **Create** generan imágenes nuevas a partir de prompts (con referencias opcionales); los grafos **Modify** toman una imagen existente como entrada y la editan en el mismo sitio. Ambos se manejan con el flujo de trabajo habitual: conecta **Load Image** y **Save Image**, define prompts, semillas, relación de aspecto y ranuras de referencia en el nodo de Luma, y luego pon el grafo en cola de forma local o abre una plantilla en **Comfy Cloud**. -Luma describe Uni-1 como un modelo autorregresivo que no usa diffusion y que solo tiene decodificador, y que razona sobre tu prompt antes de dibujar. En el lienzo, lo más importante es elegir entre **Create** y **Modify**, etiquetar las referencias con claridad e iterar con semillas. +Luma describe Uni-1 como un modelo autorregresivo sin diffusion y solo con decodificador, que razona sobre tu prompt antes de dibujar. En el lienzo, lo más importante es elegir entre **Create** y **Modify**, etiquetar las referencias con claridad e iterar con semillas. ## Qué hace diferente a Uni-1 - **Dos modos claros**: Create Image (generar algo nuevo) y Modify Image (editar algo existente) - **Hasta 9 imágenes de referencia**, cada una con un rol definido -- **Control sólido sobre estilos visuales específicos y de nicho** +- **Control sólido sobre estilos visuales de nicho y muy específicos** - **Soporte de semilla** para reproducibilidad e iteración controlada - **Nueve relaciones de aspecto**, de ultra vertical a ultra horizontal -- **Renderizado de texto** que sea realmente legible -- **Anclaje en búsqueda web** para contexto del mundo real +- **Renderizado de texto** que realmente es legible +- **Fundamentado en búsqueda web** para contexto del mundo real - **Prompts multilingües** -- **Salida multipanel** con consistencia temporal +- **Salida de varios paneles** con consistencia temporal Si entiendes los modos y cómo controlar las referencias, entiendes Uni-1. @@ -53,7 +55,7 @@ Uni-1 sobresale en una amplia variedad de tareas: - **Renderizado de texto**: texto legible dentro de las imágenes, ideal para infografías y carteles - **Edición de imágenes** y refinamiento en varios turnos - **Generación guiada por referencias** con preservación de la identidad -- **Salida de varios paneles**: personajes y escenas coherentes entre paneles +- **Salida de varios paneles**: personajes y escenas coherentes en varios cuadros @@ -83,7 +85,7 @@ Si tienes dudas: Prueba el flujo de trabajo Image Create al instante en Comfy Cloud. - Descarga el JSON o busca "Luma UNI-1 Image Create" en Biblioteca de plantillas + Descarga el JSON o busca "Luma UNI-1 Image Create" en la Biblioteca de plantillas @@ -108,7 +110,7 @@ Descarga esta imagen de entrada de ejemplo para probar el flujo de trabajo: Prueba el flujo de trabajo Image Edit al instante en Comfy Cloud.
- Descarga el JSON o busca "Luma UNI-1 Image Edit" en Biblioteca de plantillas + Descarga el JSON o busca "Luma UNI-1 Image Edit" en la Biblioteca de plantillas
@@ -132,13 +134,13 @@ El flujo de trabajo es simple: **prompt → evaluar → refinar**. Deja la semil | --- | --- | | **Prompt** | Tu control principal. Hasta 6,000 caracteres. Sé preciso. | | **Relación de aspecto** | Controla el encuadre, no la calidad. Elige según el caso de uso. | -| **Semilla** | Misma semilla + mismo prompt → mismo resultado. Misma semilla + prompt cambiado → variación controlada. Sin semilla → exploración. | +| **Semilla** | Misma semilla + mismo prompt → mismo resultado. Misma semilla + prompt modificado → variación controlada. Sin semilla → exploración. | | **Imágenes de referencia** (Create) | Hasta 9 imágenes para guiar distintos aspectos. | -| **Imagen de origen** (Modify) | La imagen que estás editando. Las dimensiones se conservan automáticamente. | +| **Imagen fuente** (Modify) | La imagen que estás editando. Conserva las dimensiones automáticamente. | ## Trabajar con imágenes de referencia -Las referencias solo funcionan si le dices al modelo para qué sirven. Usa esta estructura: +Las referencias solo funcionan si le dices al modelo para qué son. Usa esta estructura: ```text Use IMAGE1 ([description]) as a [ROLE] reference. @@ -146,7 +148,7 @@ Use IMAGE1 ([description]) as a [ROLE] reference. Roles posibles: **Style**, **Character**, **Composition**, **Color palette**, **Lighting**, **Texture**, **Mood**. -Sin roles, el modelo adivina, y las conjeturas no son fiables. +Sin roles, el modelo adivina, y las conjeturas no son confiables. ### Ejemplos del modo Create @@ -177,7 +179,7 @@ at night. ### Ejemplos del modo Modify -En el modo Modify, la claridad lo es todo. Indica siempre **qué cambiar** y **qué debe quedar intacto**. +En el modo Modify, la claridad lo es todo. Especifica siempre **qué cambiar** y **qué debe permanecer intacto**. ```text Change the time of day to golden hour. Update sky, light direction, @@ -189,21 +191,20 @@ unchanged. Make the rain heavier and add reflections on the ground. Keep all other elements unchanged. ``` - -## Pautas para el prompt +## Pautas para los prompts Longitudes recomendadas: - **Texto a imagen** → 80–250 palabras - **Guiado por referencia** → 100–300 palabras -- **Modificar** → 30–100 palabras +- **Modify** → 30–100 palabras -Evita términos vagos ("hermoso", "asombroso"), frases redundantes e instrucciones en conflicto. En su lugar, usa estéticas específicas y con nombre: +Evita términos vagos ("hermoso", "increíble"), frases redundantes e instrucciones en conflicto. En su lugar, usa estéticas específicas y con nombre propio: - `Golden hour, 85mm lens, shallow depth of field` - `1970s Italian giallo film poster, high-contrast color blocking` -La precisión supera a la generalidad. +La precisión vence a la generalidad. ## Relaciones de aspecto @@ -211,12 +212,12 @@ Elige según dónde se mostrará la imagen: | Relación | Caso de uso | | --- | --- | -| 1:1 | Publicaciones para redes sociales | -| 9:16 | video vertical | +| 1:1 | Publicaciones en redes sociales | +| 9:16 | Video vertical | | 16:9 | Pantalla ancha | | 3:2 / 2:3 | Fotografía | -| 2:1 / 3:1 | Cinemático / panorámico | -| 1:2 / 1:3 | Ultra alto | +| 2:1 / 3:1 | Cinematográfico / panorámico | +| 1:2 / 1:3 | Ultra vertical | En el modo Modify, la relación de aspecto queda fijada a la imagen de origen. @@ -230,9 +231,9 @@ Las semillas convierten la experimentación en sistemas. Flujo de trabajo: 1. Explora sin semilla -2. Encuentra un buen resultado +2. Encuentra un resultado sólido 3. Fija la semilla -4. Cambia una sola variable a la vez +4. Cambia una variable a la vez Guarda tu prompt y tu semilla juntos. Esa es tu receta reutilizable. @@ -244,7 +245,7 @@ Guarda tu prompt y tu semilla juntos. Esa es tu receta reutilizable. 2. Reutilízala como `IMAGE1 (CHARACTER)` en cada escena 3. Mantén la etiqueta idéntica en todos los prompts -### Arquitectura de múltiples referencias +### Arquitectura con múltiples referencias Asigna un rol por imagen: @@ -261,13 +262,13 @@ Treat each reference as having authority over its assigned layer only. ### Cadena Create → Modify -Usa Create para explorar composiciones y luego Modify para refinar detalles. Este es uno de los flujos de trabajo más potentes. +Usa Create para explorar composiciones y luego Modify para refinar los detalles. Este es uno de los flujos de trabajo más potentes. ### Refinamiento iterativo 1. Explora (sin semilla) 2. Fija la semilla -3. Cambia una sola variable por generación +3. Cambia una variable por generación 4. Documenta los resultados Parece más lento, pero en realidad es más rápido, porque siempre sabes qué cambió. @@ -276,12 +277,12 @@ Parece más lento, pero en realidad es más rápido, porque siempre sabes qué c | Problema | Solución | | --- | --- | -| Referencias ignoradas | Etiqueta cada una claramente | +| Se ignoran las referencias | Etiqueta cada una claramente | | Modify cambia demasiado | Indica explícitamente qué debe permanecer sin cambios | | Salidas inconsistentes | Fija la semilla | -| El prompt se ignora parcialmente | Elimina los conflictos o divide en pasos | -| La salida se parece a la imagen de referencia | Es posible que estés en el modo Modify | -| Inconsistencia del personaje | Reutiliza una imagen de referencia canónica | +| El prompt se ignora parcialmente | Elimina los conflictos o divídelo en pasos | +| La salida se parece a la imagen de referencia | Puede que estés en modo Modify | +| Inconsistencia de personajes | Reutiliza una imagen de referencia canónica | ## Referencia rápida @@ -300,11 +301,11 @@ Parece más lento, pero en realidad es más rápido, porque siempre sabes qué c ## Las reglas de oro 1. Etiqueta cada referencia -2. En el modo Modify, indica siempre qué **no** debe cambiar -3. Cambia una sola variable a la vez al refinar -4. Guarda el prompt y la semilla para poder reproducirlo +2. En el modo Modify, indica siempre lo que **no** debe cambiar +3. Cambia una sola variable a la vez cuando refines +4. Guarda el prompt + la semilla para poder reproducir el resultado 5. Create = escenas nuevas, Modify = ediciones -## Punto clave +## Idea clave -Dominar Uni-1 se reduce a tres cosas: **elige el modo correcto → controla tus referencias → itera con intención**. Una vez que tengas eso en su lugar, ya no estarás adivinando, estarás dirigiendo. +Dominar Uni-1 se reduce a tres cosas: **elige el modo correcto → controla tus referencias → itera con intención**. Cuando tengas eso claro, ya no estarás adivinando: estarás dirigiendo. diff --git a/es/tutorials/partner-nodes/magnific/overview.mdx b/es/tutorials/partner-nodes/magnific/overview.mdx index 2a6c3cf508..c60912cc49 100644 --- a/es/tutorials/partner-nodes/magnific/overview.mdx +++ b/es/tutorials/partner-nodes/magnific/overview.mdx @@ -1,15 +1,15 @@ --- title: "Magnific AI en ComfyUI: ampliación y herramientas creativas" -description: "Amplía imágenes hasta 16x con los modos Precise o Creative y aplica transferencia de estilo, relight y mejora de piel en ComfyUI." +description: "Amplía imágenes hasta 16x con los modos Precise o Creative y aplica transferencia de estilo, Relight y mejora de piel en ComfyUI." sidebarTitle: "Magnific AI" -translationSourceHash: 3b527aba +translationSourceHash: 63834680 translationFrom: tutorials/partner-nodes/magnific/overview.mdx --- import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -Magnific AI es una plataforma de mejora de imágenes de nivel profesional, ahora integrada de forma nativa en ComfyUI. Ofrece ampliación **Precise** y **Creative** (hasta 16x), transferencia de estilo, relight y mejora de piel, lo que lleva el posprocesado con calidad de estudio directamente a tu flujo de trabajo. +Magnific AI es una plataforma de mejora de imágenes de nivel profesional, ahora integrada de forma nativa en ComfyUI. Ofrece ampliación **Precise** y **Creative** (hasta 16x), transferencia de estilo, Relight y mejora de piel, lo que lleva el posprocesado con calidad de estudio directamente a tu flujo de trabajo. diff --git a/es/tutorials/partner-nodes/openai/dall-e-2.mdx b/es/tutorials/partner-nodes/openai/dall-e-2.mdx new file mode 100644 index 0000000000..3c3c59bf58 --- /dev/null +++ b/es/tutorials/partner-nodes/openai/dall-e-2.mdx @@ -0,0 +1,129 @@ +--- +title: "OpenAI DALL·E 2 en ComfyUI: referencia del nodo retirado" +description: "OpenAI descontinuó DALL·E 2 y eliminó su nodo socio de ComfyUI. Esta referencia conserva sus parámetros y remite al nodo GPT Image." +sidebarTitle: "Dall E 2" +icon: "image" +translationSourceHash: 7ac6e06c +translationFrom: tutorials/partner-nodes/openai/dall-e-2.mdx +translationBlockHashes: + "_intro": 91dc3db1 + "What DALL·E 2 is good at": c23d3c01 + "Example outputs": f895b34e + "Parameter Description": 20ac288b + "Workflow Examples": 9c7f54e4 + "FAQs": 2b8e1938 +--- +import Faq from "/snippets/es/tutorials/partner-nodes/faq.mdx"; +import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; +import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; + + + **Obsoleto**: OpenAI ha descontinuado el modelo DALL·E 2. El nodo **OpenAI DALL·E 2** se ha retirado y eliminado de ComfyUI. Usa el nodo **GPT Image** en su lugar. Esta página se conserva solo como referencia. + + +![Captura de pantalla del nodo OpenAI DALL·E 2](/images/comfy_core/api_nodes/openai-dall-e-2.jpg) + +OpenAI DALL·E 2 forma parte de la serie de Nodos asociados de ComfyUI, que permite a los usuarios generar imágenes mediante el modelo **DALL·E 2** de OpenAI. + +El nodo **OpenAI DALL·E 2** genera imágenes de forma síncrona a través de la API de generación de imágenes de OpenAI. Recibe prompts de texto y devuelve imágenes que coinciden con la descripción. + +## Para qué es bueno DALL·E 2 + +- Generación de texto a imagen +- Funcionalidad de edición de imágenes (Relleno inteligente mediante máscaras) + +## Ejemplos de salida + +Generación de texto a imagen a partir de un solo prompt de texto: + +![Flujo de trabajo de ComfyUI openai-dall-e-2](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/openai-dall-e-2/text2image.png) + +Relleno inteligente: reemplaza un área enmascarada de una imagen de entrada según un prompt de texto: + +![Flujo de trabajo de ComfyUI openai-dall-e-2](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/openai-dall-e-2/inpainting.png) + + + + +## Descripción de parámetros + +### Parámetros requeridos + +| Parámetro | Descripción | +|-----------|---------------------------------------------------------------| +| `prompt` | Texto de prompt que describe el contenido de la imagen que quieres generar | + +### Parámetros de widget + +| Parámetro | Descripción | Opciones/Rango | Valor predeterminado | +|-----------|----------------------------------------------------------------------------|-----------------------------------|---------------| +| `seed` | Valor de semilla para la generación de imágenes (actualmente no implementado en el backend) | 0 a 2^31-1 | 0 | +| `size` | Dimensiones de la imagen de salida | "256x256", "512x512", "1024x1024" | "1024x1024" | +| `n` | Número de imágenes a generar | 1 a 8 | 1 | + +### Parámetros opcionales + +| Parámetro | Descripción | Opciones/Rango | Valor predeterminado | +|-----------|----------------------------------------------------------------------------|-----------------------------------|---------------| +| `image` | Imagen de referencia opcional para la edición de imágenes | Cualquier entrada de imagen | Ninguno | +| `mask` | Máscara opcional para relleno inteligente local | Entrada de máscara | Ninguno | + +## Ejemplos de flujos de trabajo + +Este nodo Socio actualmente admite dos flujos de trabajo: + +- Texto a imagen +- Relleno inteligente + + +El flujo de trabajo Imagen a imagen no es compatible + + +### Ejemplo de texto a imagen + +La imagen a continuación contiene un flujo de trabajo simple de texto a imagen. Descarga la imagen correspondiente y arrástrala a ComfyUI para cargar el flujo de trabajo. +![ComfyUI openai-dall-e-2 workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/openai-dall-e-2/text2image.png) + +El ejemplo correspondiente es muy simple +![ComfyUI openai-dall-e-2 workflow example](/images/tutorial/api_nodes/openai/openai-dall-e-2/text2image.jpg) + +Solo necesitas cargar el nodo `OpenAI DALL·E 2`, ingresar en el nodo `prompt` la descripción de la imagen que quieres generar, conectar un nodo `Save Image` y luego ejecutar el flujo de trabajo. + +### Flujo de trabajo de relleno inteligente + +DALL·E 2 admite la funcionalidad de edición de imágenes, lo que te permite usar una máscara para especificar el área que se va a reemplazar. A continuación tienes un ejemplo simple de flujo de trabajo de relleno inteligente: + +#### 1. Descargar el archivo del flujo de trabajo + +Descarga la imagen a continuación y arrástrala a ComfyUI para cargar el flujo de trabajo correspondiente. + +![ComfyUI openai-dall-e-2 workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/openai-dall-e-2/inpainting.png) + +Usaremos la siguiente imagen como entrada: +![ComfyUI openai-dall-e-2 workflow input](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/openai-dall-e-2/input.jpg) + +#### 2. Instrucciones de uso del archivo del flujo de trabajo + +![ComfyUI openai-dall-e-2 workflow example](/images/tutorial/api_nodes/openai/openai-dall-e-2/inpainting.jpg) + +Como este flujo de trabajo es relativamente simple, si quieres implementar manualmente el flujo de trabajo correspondiente, puedes seguir estos pasos: + +1. Usa el nodo `Load Image` para cargar la imagen +2. Haz clic derecho en el nodo Load Image y selecciona `MaskEditor` +3. En el editor de máscara, usa el pincel para dibujar el área que quieres volver a dibujar +4. Conecta la imagen cargada a la entrada `image` del nodo **OpenAI DALL·E 2** +5. Conecta la máscara a la entrada `mask` del nodo **OpenAI DALL·E 2** +6. Edita el prompt en el nodo `prompt` +7. Ejecuta el flujo de trabajo + +**Notas** + +- Si quieres usar la funcionalidad de edición de imágenes, debes proporcionar tanto una imagen como una máscara (ambas son obligatorias) +- La máscara y la imagen deben ser del mismo tamaño +- Al ingresar imágenes grandes, el nodo redimensiona automáticamente la imagen a un tamaño adecuado +- Las URL que devuelve la API son válidas por un período corto, así que guarda los resultados lo antes posible +- Cada generación consume créditos, que se cobran según el tamaño y la cantidad de imágenes + +## Preguntas frecuentes + + diff --git a/es/tutorials/partner-nodes/openai/dall-e-3.mdx b/es/tutorials/partner-nodes/openai/dall-e-3.mdx new file mode 100644 index 0000000000..e1c0abfca4 --- /dev/null +++ b/es/tutorials/partner-nodes/openai/dall-e-3.mdx @@ -0,0 +1,82 @@ +--- +title: "OpenAI DALL·E 3 en ComfyUI: referencia del nodo retirado" +description: "OpenAI descontinuó DALL·E 3 y retiró su nodo socio de ComfyUI. Esta referencia describe los parámetros del nodo retirado y remite al nodo GPT Image." +sidebarTitle: "Dall E 3" +icon: "image" +translationSourceHash: fffa22a8 +translationFrom: tutorials/partner-nodes/openai/dall-e-3.mdx +translationBlockHashes: + "_intro": 87be3e05 + "What DALL·E 3 is good at": 91e67bec + "Example outputs": fc930c43 + "Parameter Details": 66c93a93 + "Usage Examples": 6c8fb9ee + "FAQs": 2b8e1938 +--- +import Faq from "/snippets/es/tutorials/partner-nodes/faq.mdx"; +import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; +import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; + + + **Obsoleto**: OpenAI ha descontinuado el modelo DALL·E 3. El nodo **OpenAI DALL·E 3** se retiró y se eliminó de ComfyUI. Usa el nodo **GPT Image** en su lugar. Esta página se conserva solo como referencia. + + +OpenAI DALL·E 3 forma parte de la serie de Nodos asociados de ComfyUI y permite a los usuarios generar imágenes con el modelo **DALL·E 3** de OpenAI. Este nodo admite la funcionalidad de generación de texto a imagen. + +![Captura de pantalla del nodo OpenAI DALL·E 3](/images/built-in-nodes/api_nodes/openai/openai-dall-e-3.jpg) + +DALL·E 3 es el modelo de generación de imágenes más reciente de OpenAI y puede crear imágenes detalladas y de alta calidad a partir de prompts de texto. A través de este nodo en ComfyUI, puedes acceder directamente a las capacidades de generación de DALL·E 3 sin salir de la interfaz de ComfyUI. + +El nodo **OpenAI DALL·E 3** genera imágenes de forma síncrona mediante la API de generación de imágenes de OpenAI. Recibe prompts de texto y devuelve imágenes que coinciden con la descripción. + +## Para qué sirve DALL·E 3 + +- **Generación de texto a imagen**: crea imágenes detalladas y de alta calidad a partir de prompts de texto, con soporte para prompts de varias líneas que describen el contenido de la imagen en detalle +- **Control de calidad**: elige entre salida standard y hd, donde hd genera imágenes de mayor calidad +- **Control de estilo**: elige vivid para imágenes hiperrealistas y dramáticas, o natural para imágenes más naturales y menos exageradas +- **Tamaños flexibles**: genera imágenes cuadradas o rectangulares en distintas orientaciones (1024x1024, 1024x1792, 1792x1024) + +## Ejemplos de salida + +Generación de texto a imagen a partir de un solo prompt de texto: + +![Flujo de trabajo de ComfyUI openai-dall-e-3](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/openai-dall-e-3/text2image.png) + + + + +## Detalles de los parámetros + +### Parámetros requeridos + +| Parámetro | Tipo | Descripción | +|-----------|------|------------------------------------------------------------------------------------------------------------------------------| +| prompt | Texto | Prompt de texto para generar imágenes. Admite entrada de varias líneas y puedes describir en detalle el contenido de la imagen que quieres generar. | + +### Parámetros de widget + +| Parámetro | Tipo | Opciones | Valor predeterminado | Descripción | +|-----------|-----------|---------------------------------|---------------|-------------------------------------------------------------------------------------------------------------------------------------------| +| seed | Entero | 0-2147483647 | 0 | Semilla aleatoria que se usa para controlar el resultado de la generación | +| quality | Opción | standard, hd | standard | Ajuste de calidad de la imagen. La opción "hd" genera imágenes de mayor calidad, pero puede requerir más recursos de cómputo | +| style | Opción | natural, vivid | natural | Estilo de la imagen. "Vivid" tiende a generar imágenes hiperrealistas y dramáticas, mientras que "natural" produce imágenes más naturales y menos exageradas | +| size | Opción | 1024x1024, 1024x1792, 1792x1024 | 1024x1024 | Tamaño de la imagen generada. Puedes elegir imágenes cuadradas o rectangulares en diferentes orientaciones | + +## Ejemplos de uso + +Puedes descargar la imagen a continuación y arrastrarla a ComfyUI para cargar el flujo de trabajo correspondiente. + +![Flujo de trabajo de ComfyUI openai-dall-e-3](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/openai-dall-e-3/text2image.png) + +Como el flujo de trabajo correspondiente es muy simple, también puedes agregar directamente el nodo **OpenAI DALL·E 3** en ComfyUI, ingresar la descripción de la imagen que quieres generar y luego ejecutar el flujo de trabajo. + +![Flujo de trabajo de ComfyUI openai-dall-e-3](/images/tutorial/api_nodes/openai/openai-dall-e-3/text2image.jpg) + +1. Agrega el nodo **OpenAI DALL·E 3** en ComfyUI +2. Ingresa en el cuadro de texto del prompt la descripción de la imagen que quieres generar +3. Ajusta los parámetros opcionales según sea necesario (calidad, estilo, tamaño, etc.) +4. Ejecuta el flujo de trabajo para generar la imagen + +## Preguntas frecuentes + + diff --git a/es/tutorials/partner-nodes/overview.mdx b/es/tutorials/partner-nodes/overview.mdx index a4f6a44bf2..7a31f5646c 100644 --- a/es/tutorials/partner-nodes/overview.mdx +++ b/es/tutorials/partner-nodes/overview.mdx @@ -2,7 +2,7 @@ title: "Nodos asociados" description: "Los Nodos asociados llaman a modelos de código cerrado como OpenAI, Kling y Luma mediante solicitudes API dentro de ComfyUI: qué son, créditos y cómo usarlos." sidebarTitle: "Descripción general" -translationSourceHash: 3877a9f6 +translationSourceHash: 48c39fa1 translationFrom: tutorials/partner-nodes/overview.mdx translationBlockHashes: "_intro": 9eeacfb4 @@ -13,47 +13,49 @@ translationBlockHashes: "Pricing": 4e0967da "Model Providers": ebd9e0e5 "About Open Source and Opt-in": 77eda030 + "How to disable partner nodes completely": 6d65d936 "Use Cases": dcc9082c "FAQs": 2b8e1938 --- + import Requirements from "/snippets/es/tutorials/partner-nodes/requirements.mdx"; import Faq from "/snippets/es/tutorials/partner-nodes/faq.mdx"; -Los Nodos asociados son la nueva forma de ComfyUI de llamar a modelos de código cerrado mediante solicitudes a la API, y le dan acceso a los usuarios de ComfyUI a modelos de IA externos de última generación sin necesidad de una configuración compleja de claves API. +Los Nodos asociados son la nueva forma de ComfyUI de llamar a modelos de código cerrado mediante solicitudes a la API, y dan a los usuarios de ComfyUI acceso a modelos de IA externos de última generación sin necesidad de configurar claves API de forma compleja. ## ¿Qué son los Nodos asociados? -Los Nodos asociados son un conjunto de nodos especiales que se conectan a servicios de API externos, lo que te permite usar modelos de IA de código cerrado o alojados por terceros directamente en tus flujos de trabajo de ComfyUI. Estos nodos están diseñados para integrar sin problemas las capacidades de los modelos externos mientras se mantiene la naturaleza de código abierto del núcleo de ComfyUI. +Los Nodos asociados son un conjunto de nodos especiales que se conectan a servicios de API externos y te permiten usar modelos de IA de código cerrado o alojados por terceros directamente en tus flujos de trabajo de ComfyUI. Estos nodos están pensados para integrar las capacidades de los modelos externos sin fricción y, al mismo tiempo, conservar la naturaleza de código abierto del núcleo de ComfyUI. ## Iniciar sesión con la Clave API de la cuenta de ComfyUI en sitios web que no están en la lista blanca Actualmente, contamos con una lista blanca que restringe los sitios web donde puedes iniciar sesión en tu cuenta de ComfyUI. -Si necesitas iniciar sesión en tu cuenta de ComfyUI en sitios web que no están en la lista blanca, consulta la sección de administración de cuentas para obtener información sobre cómo iniciar sesión con una Clave API. +Si necesitas iniciar sesión en tu cuenta de ComfyUI en sitios web que no están en la lista blanca, consulta la sección de administración de cuentas para aprender a iniciar sesión con una Clave API. En este caso, el sitio web correspondiente no necesita estar en nuestra lista blanca. - + Aprende a iniciar sesión con la Clave API de la cuenta de ComfyUI ![Seleccionar el inicio de sesión con la Clave API de Comfy](/images/interface/setting/user/user-login-api-1.jpg) -## Usar la integración de claves API de la cuenta de ComfyUI para llamar a nodos asociados de modelos de pago +## Usar la integración de la clave API de la cuenta de ComfyUI para llamar a Nodos asociados de modelos de pago -Actualmente, admitimos el acceso a nuestros servicios mediante la integración de claves API de ComfyUI para llamar a nodos asociados de modelos de pago. Consulta la sección Integración de claves API para obtener información sobre cómo usar la integración de claves API para llamar a nodos asociados de modelos de pago. +Actualmente, ofrecemos soporte para acceder a nuestros servicios mediante la integración de la clave API de ComfyUI y así llamar a Nodos asociados de modelos de pago. Consulta la sección Integración de la clave API para aprender a usar la integración de la clave API y llamar a Nodos asociados de modelos de pago. - **Importante:** La clave API que se trata aquí es tu **Clave API de la cuenta de ComfyUI** (se usa para acceder a los nodos asociados de pago en los flujos de trabajo). **NO** es la misma que la **Clave API de publicación en el registro** que usan los desarrolladores para publicar nodos personalizados en el registro. Si deseas publicar nodos personalizados, consulta [Publicar nodos](/es/registry/publishing). + **Importante:** La clave API de la que hablamos aquí es tu **Clave API de la cuenta de ComfyUI** (se usa para acceder a los Nodos asociados de pago en los flujos de trabajo). **NO** es la misma que la **Clave API de publicación en el registro** que usan los desarrolladores para publicar nodos personalizados en el registro. Si quieres publicar nodos personalizados, consulta [Publicar nodos](/es/registry/publishing). - -Consulta la sección Integración de claves API para obtener información sobre cómo usar la integración de claves API para llamar a nodos asociados de modelos de pago + +Consulta la sección Integración de la clave API para aprender a usar la integración de la clave API y llamar a Nodos asociados de modelos de pago -## Ventajas de los Nodos asociados +## Ventajas de los nodos asociados -Los Nodos asociados ofrecen varias ventajas importantes para los usuarios de ComfyUI: +Los nodos asociados ofrecen varias ventajas importantes para los usuarios de ComfyUI: - **Acceso a modelos de código cerrado**: Usa modelos de IA de última generación sin tener que desplegarlos tú mismo - **Integración perfecta**: Los nodos asociados son totalmente compatibles con otros nodos de ComfyUI y puedes combinarlos para crear flujos de trabajo complejos @@ -62,23 +64,23 @@ Los Nodos asociados ofrecen varias ventajas importantes para los usuarios de Com ## Precios - -Consulta la página de precios para ver los precios correspondientes de los Nodos asociados + +Consulta la página de precios para ver los precios correspondientes de cada socio ## Proveedores de modelos -Consulta el estado de verificación, las licencias comerciales y la residencia de datos de los proveedores de modelos que hay detrás de los Nodos asociados +Consulta el estado de verificación, las licencias comerciales y la residencia de datos de los proveedores de modelos que respaldan los Nodos asociados -## Acerca del código abierto y la participación voluntaria +## Acerca del código abierto y la participación opcional -Es importante tener en cuenta que **los nodos asociados son completamente opcionales**. ComfyUI siempre seguirá siendo totalmente de código abierto y gratis para los usuarios locales. Los nodos asociados están diseñados como una función "opt-in", que brinda comodidad a quienes desean acceder a modelos externos SOTA (de última generación). +Es importante tener en cuenta que **los nodos asociados son completamente opcionales**. ComfyUI siempre seguirá siendo totalmente de código abierto y gratis para los usuarios locales. Los nodos asociados están pensados como una función de participación opcional, que ofrece comodidad a quienes quieren acceder a modelos externos SOTA (de última generación). -## Cómo desactivar por completo los nodos asociados +## Desactivar los Nodos asociados por completo -Puedes añadir el argumento de inicio `--disable-partner-nodes` para desactivar todos los Nodos asociados en ComfyUI. Usa `--offline` en su lugar si además quieres impedir que el frontend se comunique con internet. +Puedes agregar el argumento de inicio `--disable-partner-nodes` para desactivar todos los Nodos asociados en ComfyUI. Usa `--offline` en su lugar si también quieres evitar que el frontend se comunique con internet. **Para instalación manual:** @@ -94,16 +96,15 @@ Actualiza tu archivo `run_xxx.bat`: .\python_embeded\python.exe -s ComfyUI\main.py --listen --windows-standalone-build --disable-partner-nodes pause ``` - ## Casos de uso Una aplicación potente de los Nodos asociados es combinar la salida de modelos externos con nodos locales. Por ejemplo: -- Usar GPT-Image-1 para generar una imagen base y luego transformarla en video con un nodo `wan` local -- Combinar imágenes generadas externamente con nodos locales de ampliación o transferencia de estilo -- Crear flujos de trabajo híbridos que aprovechen las ventajas tanto de los modelos de código cerrado como de los de código abierto +- Usar GPT-Image-1 para generar una imagen base y luego transformarla en video con un nodo local `wan` +- Combinar imágenes generadas externamente con nodos locales de ampliación o de transferencia de estilo +- Crear flujos de trabajo híbridos que aprovechen las ventajas de los modelos de código cerrado y de código abierto -Esta flexibilidad hace de ComfyUI una interfaz de IA generativa verdaderamente universal, que integra diversas capacidades de IA en un flujo de trabajo unificado y abre más posibilidades. +Esta flexibilidad convierte a ComfyUI en una interfaz verdaderamente universal de IA generativa, que integra diversas capacidades de IA en un flujo de trabajo unificado y abre más posibilidades. ## Preguntas frecuentes diff --git a/es/tutorials/partner-nodes/pixverse/overview.mdx b/es/tutorials/partner-nodes/pixverse/overview.mdx index e29e95c0a8..e93b766b95 100644 --- a/es/tutorials/partner-nodes/pixverse/overview.mdx +++ b/es/tutorials/partner-nodes/pixverse/overview.mdx @@ -2,14 +2,14 @@ title: "PixVerse AI en ComfyUI: video de texto, imagen y plantilla" description: "Genera video en ComfyUI con PixVerse V5.6, V6, C1 y R1, desde un prompt de texto, una sola imagen o una plantilla de movimiento." sidebarTitle: "PixVerse AI" -translationSourceHash: 6a19477b +translationSourceHash: 604fbb7c translationFrom: tutorials/partner-nodes/pixverse/overview.mdx --- import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -PixVerse es una plataforma de generación de video con IA que produce videos cinematográficos a partir de texto e imágenes, ahora integrada como nodos asociados en ComfyUI. Con soporte para los modelos **V5.6**, **V6**, **C1** y **R1**, habilita los modos **Texto a video**, **Imagen a video** y **Imagen a video con plantilla** para crear videos de forma rápida y repetible, sin necesidad de claves de API separadas ni configuración externa. +PixVerse es una plataforma de generación de video con IA que produce videos cinematográficos a partir de texto e imágenes, ahora integrada como nodos asociados en ComfyUI. Con soporte para los modelos **V5.6**, **V6**, **C1** y **R1**, habilita los modos **Texto a video**, **Imagen a video** e **Imagen a video con plantilla** para crear videos de forma rápida y repetible, sin necesidad de claves de API separadas ni configuración externa. diff --git a/es/tutorials/partner-nodes/quiver/overview.mdx b/es/tutorials/partner-nodes/quiver/overview.mdx index 1436c24ff9..a4bf6b908d 100644 --- a/es/tutorials/partner-nodes/quiver/overview.mdx +++ b/es/tutorials/partner-nodes/quiver/overview.mdx @@ -2,14 +2,14 @@ title: "Quiver AI en ComfyUI: texto e imagen a vectores SVG" description: "Genera gráficos vectoriales SVG editables en ComfyUI desde prompts de texto o imágenes raster con los modelos Quiver Arrow 1.1 y Arrow 1.1 Max." sidebarTitle: "Quiver AI" -translationSourceHash: 61b6d0cf +translationSourceHash: 83dfe7a5 translationFrom: tutorials/partner-nodes/quiver/overview.mdx --- import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -Quiver es una plataforma de gráficos vectoriales impulsada por IA que genera SVG de alta calidad a partir de descripciones de texto e imágenes raster, ahora disponible como nodos asociados en ComfyUI. Con modelos desde **Arrow 1.1** (rápido) hasta **Arrow 1.1 Max** (alta fidelidad) y **Arrow Preview** (experimental), produce ilustraciones vectoriales independientes de la resolución sin necesidad de edición manual. +Quiver es una plataforma de gráficos vectoriales impulsada por IA que genera SVG de alta calidad a partir de descripciones de texto e imágenes raster, y ahora está disponible como nodos asociados en ComfyUI. Con modelos que van desde **Arrow 1.1** (rápido) hasta **Arrow 1.1 Max** (alta fidelidad) y **Arrow Preview** (experimental), produce gráficos vectoriales independientes de la resolución sin necesidad de edición manual. diff --git a/es/tutorials/partner-nodes/topaz/overview.mdx b/es/tutorials/partner-nodes/topaz/overview.mdx index b54b5643d6..52aefc2bfc 100644 --- a/es/tutorials/partner-nodes/topaz/overview.mdx +++ b/es/tutorials/partner-nodes/topaz/overview.mdx @@ -2,21 +2,21 @@ title: "Topaz Labs en ComfyUI: mejora de imagen y video" description: "Mejora y amplía imágenes y video en ComfyUI con Topaz Labs: ampliación guiada por prompt con Reimagine, mejora de rostros, Starlight y Apollo." sidebarTitle: "Topaz Labs" -translationSourceHash: 8e0ad9e8 +translationSourceHash: f1695036 translationFrom: tutorials/partner-nodes/topaz/overview.mdx --- import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -Topaz Labs lleva a ComfyUI la mejora de imágenes y video con IA de nivel empresarial, en la que confían profesionales de todo el mundo. Su suite cubre la **mejora de imágenes**, la **ampliación de paisajes**, la **ampliación de ilustraciones** y la **mejora de video**, todo impulsado por ComfyCloud y sin necesidad de una GPU local. +Topaz Labs trae a ComfyUI la mejora de imágenes y video con IA de nivel empresarial, con la confianza de profesionales de todo el mundo. Su suite cubre la **mejora de imágenes**, la **ampliación de paisajes**, la **ampliación de ilustraciones** y la **mejora de video**, todo impulsado por ComfyCloud y sin necesidad de una GPU local. ## Capacidades clave - **Ampliación creativa con Reimagine**: guía el proceso de ampliación con prompts de texto para reinterpretar y mejorar las imágenes de forma creativa, no solo agrandarlas. -- **Mejora de rostros**: modelo dedicado a la reconstrucción del detalle facial que detecta y define los rostros en imágenes y video, preservando la textura natural de la piel y la expresión. +- **Mejora de rostros**: modelo dedicado a la reconstrucción del detalle facial que detecta y realza los rostros en imágenes y video, preservando la textura natural de la piel y la expresión. - **Soporte de salida en 8K**: amplía imágenes y cuadros de video hasta la resolución ultra alta de 8K manteniendo la nitidez y la coherencia visual. -- **Ampliador de difusión Starlight**: ampliación basada en difusión optimizada para fotografía de paisajes, que genera detalle realista como follaje, texturas de roca y nubes. +- **Ampliador por difusión Starlight**: ampliación basada en difusión optimizada para fotografía de paisajes, que genera detalle realista como follaje, texturas de roca y nubes. - **Interpolación de cuadros Apollo**: genera cuadros intermedios suaves entre los cuadros de video existentes para efectos de cámara lenta o conversión de frecuencia de cuadros. - **Ampliación optimizada para ilustraciones**: modelo especializado en ilustraciones digitales, line art y obras de colores planos que preserva los bordes definidos y los degradados limpios. - **Flujo de trabajo de mejora de video**: procesamiento de video completo que incluye reducción de ruido, desentrelazado, estabilización y ampliación inteligente cuadro por cuadro. diff --git a/es/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx b/es/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx index 124e78ab9f..13dd88ad21 100644 --- a/es/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx +++ b/es/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx @@ -2,7 +2,7 @@ title: "Topaz Starlight Precise 2.5 - Ampliación de video con IA" description: "Amplía videos con Topaz Starlight Precise 2.5 en ComfyUI: salida 4K más nítida y con menos artefactos para material de acción real." sidebarTitle: "Starlight Precise 2.5" -translationSourceHash: 512ec885 +translationSourceHash: 43c2d2a4 translationFrom: tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx --- import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; @@ -11,11 +11,11 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; Topaz Starlight Precise 2.5 es un modelo de ampliación de video disponible en ComfyUI a través de los nodos asociados de Topaz. Amplía videos MP4 hasta resolución 4K con resultados más nítidos y menos artefactos. -## Para qué sirve Topaz Starlight Precise 2.5 +## En qué destaca Topaz Starlight Precise 2.5 - **Ampliación a 4K**: amplía videos MP4 hasta resolución 4K - **Mayor nitidez**: una salida más nítida con menos artefactos -- **Metraje de acción real**: los pocos artefactos lo hacen ideal para video de acción real +- **Metraje de acción real**: la reducción de artefactos lo hace ideal para video de acción real - **Opciones de resolución**: salida en FullHD (1080p) o 4K (2160p) ## Salidas de ejemplo diff --git a/es/tutorials/partner-nodes/wavespeed/overview.mdx b/es/tutorials/partner-nodes/wavespeed/overview.mdx index 987ad27644..aa8819f97a 100644 --- a/es/tutorials/partner-nodes/wavespeed/overview.mdx +++ b/es/tutorials/partner-nodes/wavespeed/overview.mdx @@ -2,7 +2,7 @@ title: "WaveSpeed en ComfyUI: ampliación de imagen y video" description: "Amplía video y restaura imágenes en ComfyUI con WaveSpeed: ampliación temporal de video FLSH-VSR, restauración de fotos SeedVR2 y ampliación general." sidebarTitle: "WaveSpeed" -translationSourceHash: f7e72a84 +translationSourceHash: 39f7198f translationFrom: tutorials/partner-nodes/wavespeed/overview.mdx --- @@ -13,7 +13,7 @@ WaveSpeed es una plataforma de mejora de contenido multimedia con IA de alto ren ## Funciones principales -- **Ampliación de video con FLSH-VSR**: superresolución de video con IA y coherencia temporal que mantiene un detalle uniforme entre fotogramas, ideal para archivo, mejora de video con IA y conversión de SD a HD. +- **Ampliación de video con FLSH-VSR**: superresolución de video con IA y coherencia temporal que mantiene un detalle uniforme entre fotogramas, ideal para archivado, mejora de video con IA y conversión de SD a HD. - **Ampliación general de imágenes**: aumento de tamaño y mejora de calidad para múltiples propósitos, que abarca fotografías, arte digital, renders y capturas de pantalla. - **SeedVR2 AI image fix**: modelo de restauración basado en diffusion para recuperar imágenes dañadas, degradadas o de baja calidad, incluida la reparación de fotos antiguas, la eliminación de ruido y artefactos, y la reconstrucción de detalles perdidos. - **Sin necesidad de GPU local**: todo el procesamiento se ejecuta en la infraestructura de ComfyCloud, lo que mantiene tu hardware local libre para la generación y la composición. diff --git a/es/tutorials/utility/depth-anything-3.mdx b/es/tutorials/utility/depth-anything-3.mdx index ef8450f36f..e0a5286621 100644 --- a/es/tutorials/utility/depth-anything-3.mdx +++ b/es/tutorials/utility/depth-anything-3.mdx @@ -2,14 +2,16 @@ title: "Depth Anything 3 en ComfyUI: profundidad, pose y reconstrucción 3D" description: "Ejecuta Depth Anything 3 en ComfyUI para estimación de profundidad monocular y multivista, pose de cámara y reconstrucción 3D desde imágenes y video." sidebarTitle: "Depth Anything 3" -translationSourceHash: 9a994be7 +translationSourceHash: 3af6ec89 translationFrom: tutorials/utility/depth-anything-3.mdx translationBlockHashes: "_intro": 78aa4267 + "Model Installation": 42fa683f "Example Workflows": e8325fd8 "Model Variants": c09e7471 "Community Resources": 4ade7e72 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" # Introducción a ComfyUI Depth Anything 3 @@ -19,7 +21,7 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" Capacidades clave: - **Profundidad monocular y multivista unificada**: estima la profundidad a partir de una sola imagen o de varias vistas -- **Estimación de pose de cámara**: recupera las posiciones de cámara a partir de conjuntos de imágenes sin orden +- **Estimación de pose de cámara**: recupera las posiciones de cámara a partir de conjuntos de imágenes no ordenados - **Reconstrucción 3D** a partir de entradas multivista - **Estimación de profundidad en video**: secuencias de profundidad por fotograma para entradas de video - **Múltiples variantes de modelo**: Small, Base, Mono/Metric Large @@ -32,12 +34,12 @@ ComfyUI ya es compatible de forma nativa con los nodos de Depth Anything 3. Aseg ## Instalación del modelo -Descarga los checkpoints de Depth Anything 3 y guárdalos en la carpeta correspondiente de ComfyUI: +Descarga los checkpoint(s) de Depth Anything 3 y guárdalos en la carpeta correspondiente de ComfyUI: -- **Small** ([depth_anything_3_small.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/blob/main/geometry_estimation/depth_anything_3_small.safetensors)): Ligero, inferencia rápida -- **Base** ([depth_anything_3_base.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/blob/main/geometry_estimation/depth_anything_3_base.safetensors)): Rendimiento equilibrado -- **Mono-Large** ([depth_anything_3_mono_large.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/blob/main/geometry_estimation/depth_anything_3_mono_large.safetensors)): La mejor opción para profundidad monocular, incluye detección de cielo -- **Metric-Large** ([depth_anything_3_metric_large.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/blob/main/geometry_estimation/depth_anything_3_metric_large.safetensors)): Profundidad a escala métrica en metros, incluye detección de cielo +- **Small** ([depth_anything_3_small.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/blob/main/geometry_estimation/depth_anything_3_small.safetensors)): ligero, inferencia rápida +- **Base** ([depth_anything_3_base.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/blob/main/geometry_estimation/depth_anything_3_base.safetensors)): rendimiento equilibrado +- **Mono-Large** ([depth_anything_3_mono_large.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/blob/main/geometry_estimation/depth_anything_3_mono_large.safetensors)): la mejor opción para profundidad monocular, incluye detección de cielo +- **Metric-Large** ([depth_anything_3_metric_large.safetensors](https://huggingface.co/Comfy-Org/Depth-Anything-3/blob/main/geometry_estimation/depth_anything_3_metric_large.safetensors)): profundidad a escala métrica en metros, incluye detección de cielo ``` ComfyUI/ @@ -48,10 +50,9 @@ ComfyUI/ │ │ ├── depth_anything_3_mono_large.safetensors │ │ └── depth_anything_3_metric_large.safetensors ``` - ## Flujos de trabajo de ejemplo -### Depth Anything 3: estimación de profundidad de imagen {#utility_depth_anything3_image_depth_estimation} +### Depth Anything 3: Estimación de profundidad de imagen {#utility_depth_anything3_image_depth_estimation} Sube una imagen y genera un mapa de profundidad con Depth Anything 3. Consulta una comparación lado a lado de la imagen original y la salida de profundidad. @@ -62,7 +63,7 @@ Sube una imagen y genera un mapa de profundidad con Depth Anything 3. Consulta u Abrir en Comfy Cloud - Descargar JSON o buscar "Depth Anything 3: Image Depth Estimation" en la Biblioteca de plantillas + Descarga el JSON o busca "Depth Anything 3: Image Depth Estimation" en la Biblioteca de plantillas
@@ -72,7 +73,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - nodo `LoadImage` 85 · `retro_futuristic_home.png` + Nodo `LoadImage` 85 · `retro_futuristic_home.png` @@ -84,16 +85,16 @@ Sube este archivo al nodo `LoadImage` correspondiente: 1. **LoadImage**: carga tu imagen de entrada 2. **LoadDA3Model**: selecciona una variante de Depth Anything 3 -3. **Run**: haz clic en Queue o usa `Cmd+Enter` +3. **Run**: haz clic en Cola o usa `Cmd+Enter` 4. El flujo de trabajo genera un mapa de profundidad y una comparación lado a lado - - Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y extender el flujo de trabajo. + + Este flujo de trabajo usa nodos Subgraph para un procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. -### Depth Anything 3: estimación de profundidad de video {#utility_depth_anything3_video_depth_estimation} +### Depth Anything 3: Estimación de profundidad de video {#utility_depth_anything3_video_depth_estimation} -Sube un video para generar una secuencia de profundidad por fotograma. Dentro del subgrafo, **GetVideoComponents** divide el video de entrada en fotogramas, **LoadDA3Model** carga el modelo y **SetVideoComponents** vuelve a ensamblar los fotogramas de profundidad en un video de salida. +Sube un video para generar una secuencia de profundidad por fotograma. Dentro del subgraph, **GetVideoComponents** divide el video de entrada en fotogramas, **LoadDA3Model** carga el modelo y **SetVideoComponents** vuelve a unir los fotogramas de profundidad en un video de salida. Vista previa del flujo de trabajo de estimación de profundidad de video con Depth Anything 3 @@ -102,7 +103,7 @@ Sube un video para generar una secuencia de profundidad por fotograma. Dentro de Abrir en Comfy Cloud - Descargar JSON o buscar "Depth Anything 3: Video Depth Estimation" en la Biblioteca de plantillas + Descarga el JSON o busca "Depth Anything 3: Video Depth Estimation" en la Biblioteca de plantillas
@@ -112,7 +113,7 @@ Sube este archivo al nodo `LoadVideo` correspondiente: - nodo `LoadVideo` 87 · `empty_room_assembly.mp4` + Nodo `LoadVideo` 87 · `empty_room_assembly.mp4` @@ -125,27 +126,27 @@ Sube este archivo al nodo `LoadVideo` correspondiente: ### Pasos para ejecutar 1. **LoadVideo**: carga tu video de entrada -2. **Seleccionar modelo**: elige entre **Small**, **Base**, **Mono-Large** o **Metric-Large** -3. **Run**: haz clic en Queue o usa `Cmd+Enter` +2. **Select Model**: elige entre **Small**, **Base**, **Mono-Large** o **Metric-Large** +3. **Run**: haz clic en Cola o usa `Cmd+Enter` 4. El flujo de trabajo genera un video con mapas de profundidad por fotograma - - Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y extender el flujo de trabajo. + + Este flujo de trabajo usa nodos Subgraph para un procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. ## Variantes del modelo | Variante | head_type | has_sky | has_confidence | camera_decoder | Ideal para | |---------|-----------|:-------:|:--------------:|:--------------:|----------| -| **Small** | dualdpt | ❌ | ✅ | ✅ | Inferencia rápida, móvil/edge | +| **Small** | dualdpt | ❌ | ✅ | ✅ | Inferencia rápida, móvil y edge | | **Base** | dualdpt | ❌ | ✅ | ✅ | Rendimiento equilibrado | | **Mono-Large** | dpt | ✅ | ❌ | ❌ | Profundidad monocular con detección de cielo | | **Metric-Large** | dpt | ✅ | ❌ | ❌ | Profundidad métrica física en metros | -- **Small** y **Base** usan el tipo de head `dualdpt` con estimación de confianza y soporte del decodificador de cámara para aplicaciones multivista. -- **Mono-Large** y **Metric-Large** usan el tipo de head `dpt` con detección de cielo. Metric-Large genera profundidad sin procesar en metros. +- **Small** y **Base** usan el tipo de cabeza `dualdpt` con estimación de confianza y soporte del decodificador de cámara para aplicaciones multivista. +- **Mono-Large** y **Metric-Large** usan el tipo de cabeza `dpt` con detección de cielo. Metric-Large genera profundidad en bruto en metros. ## Recursos de la comunidad -- [Depth Anything 3 GitHub (ByteDance-Seed)](https://github.com/ByteDance-Seed/Depth-Anything-3): artículo de investigación y código +- [Depth Anything 3 en GitHub (ByteDance-Seed)](https://github.com/ByteDance-Seed/Depth-Anything-3): artículo de investigación y código - [Comfy-Org/Depth-Anything-3](https://huggingface.co/Comfy-Org/Depth-Anything-3): pesos oficiales del modelo para ComfyUI diff --git a/es/tutorials/utility/marigold-v2.mdx b/es/tutorials/utility/marigold-v2.mdx index 099fd4e109..9488e928d3 100644 --- a/es/tutorials/utility/marigold-v2.mdx +++ b/es/tutorials/utility/marigold-v2.mdx @@ -2,16 +2,20 @@ title: "Guía de estimación de profundidad, normales y albedo con Marigold V2 en ComfyUI" description: "Estima profundidad, normales y albedo de una sola imagen en ComfyUI con Marigold V2: transformers de difusión Qwen-Image Edit con LoRAs dedicadas." sidebarTitle: "Marigold V2" -translationSourceHash: 0c18f35c +translationSourceHash: 8e359643 translationFrom: tutorials/utility/marigold-v2.mdx translationBlockHashes: "_intro": 0bf716f6 "Model Installation": 94dd4b48 + "Depth Estimation {#image_marigold_v2_depth_estimation}": cc9d0c86 + "Surface Normal Estimation {#image_marigold_v2_surface_normal_estimation}": 18c0257f + "Albedo Estimation {#image_marigold_v2_albedo_estimation}": d9b6b8f9 "Marigold V2 Post-Process Node": a2806428 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -Marigold V2 es una familia de modelos de estimación monocular de Huawei Bayer Lab que reutilizan un diffusion transformer (Qwen-Image Edit 2509) para la estimación de geometría e imágenes intrínsecas. A partir de una sola imagen RGB, los modelos predicen un mapa de profundidad, normales de superficie o albedo, dando continuidad al Marigold original (CVPR 2024), que reutilizó Stable Diffusion para esa misma tarea. Los modelos V2 se distribuyen como LoRA sobre un modelo de difusión base compartido, lo que mantiene pequeña cada descarga y hace que la estructura del flujo de trabajo sea idéntica en las tres tareas. +Marigold V2 es una familia de modelos de estimación monocular de Huawei Bayer Lab que reutilizan un diffusion transformer (Qwen-Image Edit 2509) para la estimación de geometría e imágenes intrínsecas. A partir de una sola imagen RGB, los modelos predicen un mapa de profundidad, normales de superficie o albedo, dando continuidad al Marigold original (CVPR 2024), que reutilizó Stable Diffusion para esa misma tarea. Los modelos V2 se distribuyen como LoRAs sobre un modelo de difusión base compartido, lo que mantiene pequeña cada descarga y hace que la estructura del flujo de trabajo sea idéntica en las tres tareas. En comparación con las redes de profundidad clásicas, el enfoque basado en difusión produce predicciones nítidas y conscientes de los bordes, y generaliza a imágenes de dominio abierto sin reentrenamiento. Entre los usos típicos están el control guiado por profundidad para la generación de imágenes y video, los pipelines de reconstrucción de escenas 3D, el relighting y la edición de materiales a partir del albedo estimado. @@ -33,7 +37,7 @@ Si planeas ejecutar las tres tareas, descarga los LoRA, VAE y embeddings de acon ## Estimación de profundidad {#image_marigold_v2_depth_estimation} -Predice un mapa de profundidad a partir de una sola imagen. La predicción decodificada se normaliza para que las superficies cercanas aparezcan claras. +Predice un mapa de profundidad a partir de una sola imagen. La predicción decodificada se normaliza para que las superficies cercanas aparezcan brillantes. Vista previa del flujo de trabajo de estimación de profundidad de Marigold V2 @@ -59,7 +63,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: ### 1. Pasos para ejecutar 1. Carga tu imagen de entrada en el nodo `LoadImage` -2. Encola el flujo de trabajo: el modelo base se ejecuta con la LoRA de profundidad y el nodo Marigold V2 Post-Process normaliza la predicción decodificada +2. Pon en cola el flujo de trabajo: el modelo base se ejecuta con el LoRA de profundidad y el nodo Posprocesado de Marigold V2 normaliza la predicción decodificada 3. Guarda o previsualiza el mapa de profundidad resultante ### 2. Descargas de modelos @@ -71,7 +75,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: marigold_v2_depth_log_stage2_vae.safetensors → ComfyUI/models/vae/ - + marigold_v2_depth_conditioning.safetensors → ComfyUI/models/embeddings/
@@ -86,10 +90,9 @@ Sube este archivo al nodo `LoadImage` correspondiente: │ └── 📂 embeddings/ │ └── marigold_v2_depth_conditioning.safetensors ``` - ## Estimación de normales de superficie {#image_marigold_v2_surface_normal_estimation} -Predice normales de superficie por píxel a partir de una sola imagen. La salida asigna a cada píxel la dirección hacia la que mira la superficie, algo útil para el relighting y el análisis de geometría. +Predice las normales de superficie por píxel a partir de una sola imagen. La salida asigna a cada píxel la dirección hacia la que mira la superficie, lo que resulta útil para volver a iluminar la escena y para el análisis de geometría. Vista previa del flujo de trabajo de estimación de normales de superficie de Marigold V2 @@ -115,7 +118,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: ### 1. Pasos para ejecutar 1. Carga tu imagen de entrada en el nodo `LoadImage` -2. Encola el flujo de trabajo con la LoRA de normales cargada +2. Encola el flujo de trabajo con el LoRA de normales cargado 3. Guarda o previsualiza el mapa de normales resultante ### 2. Descargas de modelos @@ -127,7 +130,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: marigold_v2_normals_vae.safetensors → ComfyUI/models/vae/ - + marigold_v2_normals_conditioning.safetensors → ComfyUI/models/embeddings/
@@ -142,16 +145,15 @@ Sube este archivo al nodo `LoadImage` correspondiente: │ └── 📂 embeddings/ │ └── marigold_v2_normals_conditioning.safetensors ``` - ## Estimación de albedo {#image_marigold_v2_albedo_estimation} -Predice el albedo (el color intrínseco) de una sola imagen, separando el color del material de la iluminación y el sombreado. El nodo Marigold V2 Post-Process convierte la salida a sRGB. +Predice el albedo (color intrínseco) de una sola imagen, separando el color del material de la iluminación y el sombreado. La salida se convierte a sRGB con el nodo Marigold V2 Post-Process. Vista previa del flujo de trabajo de estimación de albedo de Marigold V2 - - Abrir en Comfy Cloud + + Open in Comfy Cloud Descarga el JSON o busca "Albedo Estimation: Marigold V2" en la Biblioteca de plantillas @@ -171,7 +173,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: ### 1. Pasos para ejecutar 1. Carga tu imagen de entrada en el nodo `LoadImage` -2. Encola el flujo de trabajo con la LoRA de albedo cargada +2. Pon el flujo de trabajo en cola con el LoRA de albedo cargado 3. Guarda o previsualiza la imagen de albedo resultante ### 2. Descargas de modelos @@ -183,7 +185,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: marigold_v2_albedo_vae.safetensors → ComfyUI/models/vae/ - + marigold_v2_albedo_conditioning.safetensors → ComfyUI/models/embeddings/ @@ -198,11 +200,10 @@ Sube este archivo al nodo `LoadImage` correspondiente: │ └── 📂 embeddings/ │ └── marigold_v2_albedo_conditioning.safetensors ``` - ## Nodo de posprocesado de Marigold V2 -Todos los flujos de trabajo terminan en el nodo **Marigold V2 Post-Process**, que convierte la predicción decodificada sin procesar en una imagen que puedes ver. La opción **prediction** debe coincidir con la tarea: +Todos los flujos de trabajo terminan en el nodo **Posprocesado de Marigold V2**, que convierte la predicción decodificada sin procesar en una imagen que puedes ver. La opción **prediction** debe coincidir con la tarea: -- **depth**: normaliza la predicción para que las superficies cercanas aparezcan claras +- **depth**: normaliza la predicción para que las superficies cercanas se vean brillantes - **normals**: asigna los valores sin procesar a normales de superficie unitarias - **albedo**: convierte la predicción a sRGB diff --git a/es/tutorials/utility/pose-detection-sdpose.mdx b/es/tutorials/utility/pose-detection-sdpose.mdx index 24d6779649..3ff963177d 100644 --- a/es/tutorials/utility/pose-detection-sdpose.mdx +++ b/es/tutorials/utility/pose-detection-sdpose.mdx @@ -2,17 +2,19 @@ title: "SDPose: detección de poses en ComfyUI" sidebarTitle: "Detección de poses con SDPose" description: "Aprende a extraer keypoints y mapas de pose de imágenes y videos con SDPose, compatible de forma nativa en ComfyUI" -translationSourceHash: e0b4f649 +translationSourceHash: 94a8830d translationFrom: tutorials/utility/pose-detection-sdpose.mdx translationBlockHashes: "_intro": c207bd95 + "SDPose Workflows": e093cabd "Additional Notes": 1f0c5965 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -SDPose es un modelo de detección de pose de cuerpo completo que extrae keypoints humanos de imágenes y videos. Combinado con el detector de objetos RT-DETRv4, admite detección de varias personas y estimación de pose fuera de dominio (OOD), lo que lo convierte en una herramienta versátil para pipelines de animación, generación guiada por pose y flujos de trabajo de seguimiento de movimiento. +SDPose es un modelo de detección de pose de cuerpo completo que extrae keypoints humanos de imágenes y videos. Combinado con el detector de objetos RT-DETRv4, admite la detección de varias personas y la estimación de pose fuera de dominio (OOD), lo que lo convierte en una herramienta versátil para pipelines de animación, generación guiada por pose y flujos de trabajo de seguimiento de movimiento. SDPose + RT-DETRv4 son compatibles de forma nativa con ComfyUI (PR [#12748](https://github.com/Comfy-Org/ComfyUI/pull/12748)). Los pesos del modelo están disponibles en Hugging Face. @@ -39,15 +41,15 @@ Hay cuatro flujos de trabajo disponibles según tu caso de uso: | OOD Image to Pose | Una sola imagen | Mapa de pose | Transferencia de estilo / imagen a pose | | OOD Video to Pose Map | Video | Mapa de pose por fotograma | Animación de video a pose | -### 1. Descargar los flujos de trabajo +### 1. Descargar flujos de trabajo Actualiza tu ComfyUI a la última versión, luego ve a `Workflow` -> `Browse Templates` y busca los flujos de trabajo de SDPose en la categoría Utility. -### SDPose: Image Multi-Person Detection {#utility_sdpose_multi_person} +### SDPose: detección de varias personas en una imagen {#utility_sdpose_multi_person} -Sube una imagen para detectar poses humanas. Admite la detección de una sola persona y de varias personas en la misma escena. +Sube una imagen para detectar poses humanas. Admiten detección tanto para una sola persona como para varias personas dentro de la misma escena. -Vista previa del flujo de trabajo de detección de varias personas en imagen de SDPose +Vista previa del flujo de trabajo de detección de varias personas en una imagen con SDPose @@ -72,18 +74,18 @@ Sube este archivo al nodo `LoadImage` correspondiente: Imagen de entrada -### SDPose: Video Multi-Person Detection {#utility_sdpose_multi_person_video} +### SDPose: detección de varias personas en video {#utility_sdpose_multi_person_video} -Sube un video para detectar poses humanas. Admite la detección de una sola persona y de varias personas en la misma escena. +Sube un video para detectar poses humanas. Admite la detección tanto de una sola persona como de varias personas dentro de la misma escena. -Vista previa del flujo de trabajo de detección de varias personas en video de SDPose +Vista previa del flujo de trabajo de detección de varias personas en video con SDPose Abrir en Comfy Cloud - Descarga el JSON o busca "SDPose: Video Multi-Person Detection" en la Biblioteca de plantillas + Descarga el JSON o busca "SDPose: Video Multi-Person Detection" en la biblioteca de plantillas @@ -93,7 +95,7 @@ Sube este archivo al nodo `LoadVideo` correspondiente: - Nodo `LoadVideo` 694 · `man_playing_violin.mp4` + nodo `LoadVideo` 694 · `man_playing_violin.mp4` @@ -103,18 +105,18 @@ Sube este archivo al nodo `LoadVideo` correspondiente: -### SDPose-OOD: Image to Pose Map {#utility_sdpose_ood_image_to_pose} +### SDPose-OOD: de imagen a mapa de pose {#utility_sdpose_ood_image_to_pose} -Sube una imagen para extraer los keypoints de la pose y generar el mapa de pose correspondiente con el modelo SDPose-OOD. +Sube una imagen para extraer los puntos clave de la pose y generar un mapa de pose correspondiente con el modelo SDPose-OOD. -Vista previa del flujo de trabajo de imagen a mapa de pose de SDPose-OOD +Vista previa del flujo de trabajo de imagen a mapa de pose con SDPose-OOD Abrir en Comfy Cloud - Descarga el JSON o busca "SDPose-OOD: Image to Pose Map" en la Biblioteca de plantillas + Descarga el JSON o busca "SDPose-OOD: Image to Pose Map" en la biblioteca de plantillas @@ -132,21 +134,21 @@ Sube este archivo al nodo `LoadImage` correspondiente:
Imagen de entrada - Ejemplo de salida del mapa de pose de SDPose-OOD + Salida de ejemplo del flujo de trabajo de imagen a mapa de pose con SDPose-OOD
-### SDPose-OOD: Video to Pose Map {#utility_sdpose_ood_video_to_pose_map} +### SDPose-OOD: De video a mapa de pose {#utility_sdpose_ood_video_to_pose_map} -Sube un video para extraer los keypoints de la pose y generar un mapa de pose. El flujo de trabajo admite la detección de varias personas y usa un modelo SDPose mejorado para extraer las características de todo el cuerpo con precisión. +Sube un video para extraer los puntos clave de la pose y generar un mapa de pose. El flujo de trabajo admite la detección de varias personas y usa un modelo SDPose mejorado para una extracción precisa de las características de todo el cuerpo. -Vista previa del flujo de trabajo de video a mapa de pose de SDPose-OOD +Vista previa del flujo de trabajo de video a mapa de pose con SDPose-OOD - - Abrir en Comfy Cloud + + Open in Comfy Cloud - - Descarga el JSON o busca "SDPose-OOD: Video to Pose Map" en la Biblioteca de plantillas + + Descarga el JSON o busca "SDPose-OOD: Video to Pose Map" en Template Library @@ -156,7 +158,7 @@ Sube este archivo al nodo `LoadVideo` correspondiente: - Nodo `LoadVideo` 679 · `man_in_the_rain.mp4` + nodo `LoadVideo` 679 · `man_in_the_rain.mp4` @@ -171,9 +173,9 @@ Sube este archivo al nodo `LoadVideo` correspondiente: -### 2. Descargar los modelos +### 2. Descargar modelos -Los checkpoints de los modelos SDPose y RT-DETRv4 están en el [repositorio del modelo SDPose de Comfy-Org](https://huggingface.co/Comfy-Org/SDPose). +Los checkpoints de los modelos SDPose y RT-DETRv4 están alojados en el [repositorio de modelos Comfy-Org SDPose](https://huggingface.co/Comfy-Org/SDPose). **checkpoints** (modelo SDPose): - [sdpose_wholebody_fp16.safetensors](https://huggingface.co/Comfy-Org/SDPose/blob/main/checkpoints/sdpose_wholebody_fp16.safetensors) @@ -182,7 +184,7 @@ Los checkpoints de los modelos SDPose y RT-DETRv4 están en el [repositorio del - [rt_detr_v4-x-hgnet_fp16.safetensors](https://huggingface.co/Comfy-Org/SDPose/blob/main/diffusion_models/rt_detr_v4-x-hgnet_fp16.safetensors) (recomendado) - [rt_detr_v4-x-hgnet_fp32.safetensors](https://huggingface.co/Comfy-Org/SDPose/blob/main/diffusion_models/rt_detr_v4-x-hgnet_fp32.safetensors) (precisión completa, más grande) -Colócalos con la siguiente estructura de directorios: +Colócalos en la siguiente estructura de directorios: ``` 📂 ComfyUI/ @@ -196,42 +198,41 @@ Colócalos con la siguiente estructura de directorios: ### 3. Usar los flujos de trabajo -#### Multi-Person (Image) - -- **Entrada**: carga una imagen con el nodo `Load Image`. Usa una imagen con una o varias personas (ejemplo: `group_photo.png`). -- **Detección**: el subgrafo `Image to Pose Map (SDPose Multi-Person)` procesa la imagen y genera: - - **IMAGE**: visualización del esqueleto de la pose superpuesto a la imagen - - **keypoints**: datos brutos de los keypoints de todo el cuerpo - - **bboxes**: coordenadas de las cajas delimitadoras -- **Opciones de dibujo**: configura qué partes del cuerpo se dibujan: - - `draw_body`, `draw_hands`, `draw_face`, `draw_feet`: activan o desactivan la visibilidad - - `stick_width`, `face_point_size`: ajustan el estilo visual - - `score_threshold`: confianza mínima para mostrar los keypoints +#### Multipersona (imagen) + +- **Entrada**: Carga una imagen mediante el nodo `Load Image`. Usa una imagen con una o más personas (ejemplo: `group_photo.png`). +- **Detección**: El subgrafo `Image to Pose Map (SDPose Multi-Person)` procesa la imagen y produce: + - **IMAGE**: visualización del esqueleto de la pose superpuesta a la imagen + - **keypoints**: datos de puntos clave del cuerpo completo sin procesar + - **bboxes**: coordenadas de la caja delimitadora +- **Opciones de dibujo**: Configura qué partes del cuerpo dibujar: + - `draw_body`, `draw_hands`, `draw_face`, `draw_feet`: alternar visibilidad + - `stick_width`, `face_point_size`: ajustar el estilo visual + - `score_threshold`: confianza mínima para mostrar los puntos clave - **Opciones de detección**: - - `resize_type.longer_size`: escala el lado más largo antes de la detección + - `resize_type.longer_size`: escalar la dimensión más larga antes de la detección - `max_detections`: número máximo de personas a detectar - - `detect_threshold`: umbral de confianza de la detección + - `detect_threshold`: umbral de confianza de detección - `detect_class`: clase de objeto a detectar (predeterminado: person) -#### Multi-Person (Video) +#### Multipersona (video) -Igual que el flujo de trabajo de imagen, pero procesa los fotogramas del video uno tras otro. Usa `Load Video` para introducir un archivo de video y `Save Video` para exportar el resultado. +Igual que el flujo de trabajo de imagen, pero procesa los fotogramas de video de forma secuencial. Usa `Load Video` para cargar un archivo de video y `Save Video` para exportar el resultado. -#### OOD Image to Pose +#### OOD de imagen a pose -Usa el modelo SDPose para generar un mapa de pose limpio a partir de una imagen, sin visualización de cajas delimitadoras. Resulta útil para la transferencia de estilo, cuando quieres extraer la pose del esqueleto de una imagen y aplicarla a otra. +Usa el modelo SDPose para generar un mapa de pose limpio a partir de una imagen, sin visualización de la caja delimitadora. Esto es útil para la transferencia de estilo, donde quieres extraer la pose del esqueleto de una imagen y aplicarla a otra. -#### OOD Video to Pose Map +#### OOD de video a mapa de pose -Genera mapas de pose por fotograma a partir de un video. La salida es un archivo de video en el que cada fotograma contiene el esqueleto de la pose extraído, apto para animación posterior o para flujos de trabajo de ControlNet. +Genera mapas de pose por fotograma a partir de un video. La salida es un archivo de video en el que cada fotograma contiene el esqueleto de la pose extraído, adecuado para animación o flujos de trabajo de ControlNet posteriores. - + Estos flujos de trabajo usan nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar los flujos de trabajo. - ## Notas adicionales - **Directorio de modelos**: el checkpoint de SDPose va en `models/checkpoints/`, y el detector RT-DETRv4 va en `models/diffusion_models/` - **Ejemplo de imagen de entrada**: el archivo `group_photo.png` está disponible en el directorio `input/` de la plantilla del flujo de trabajo para hacer pruebas -- **Salida de puntos clave**: el tipo POSE_KEYPOINT se puede conectar a nodos posteriores que aceptan datos de pose para la generación condicional -- **Actualización necesaria**: el soporte de SDPose + RT-DETRv4 está disponible en versiones recientes de ComfyUI. Asegúrate de que tu ComfyUI esté actualizado. +- **Salida de keypoints**: el tipo POSE_KEYPOINT se puede conectar a nodos posteriores que aceptan datos de pose para la generación condicional +- **Actualización requerida**: el soporte de SDPose + RT-DETRv4 está disponible en versiones recientes de ComfyUI. Asegúrate de que tu ComfyUI esté actualizado. diff --git a/es/tutorials/utility/sam3d-body.mdx b/es/tutorials/utility/sam3d-body.mdx index c7290e8e4a..0f42636b97 100644 --- a/es/tutorials/utility/sam3d-body.mdx +++ b/es/tutorials/utility/sam3d-body.mdx @@ -2,18 +2,20 @@ title: "SAM 3D Body: extraer una malla 3D humana desde un video en ComfyUI" description: "Extrae una malla 3D del cuerpo humano desde un video con SAM 3D Body: pose y forma, expresiones faciales y video con la malla superpuesta." sidebarTitle: "SAM 3D Body" -translationSourceHash: 1f177291 +translationSourceHash: ca0733f3 translationFrom: tutorials/utility/sam3d-body.mdx translationBlockHashes: "_intro": 892aa34b "How it works": f02ec8f2 "Steps to run": bd124afc + "Model downloads": 8931e430 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" **SAM 3D Body** es un modelo de código abierto que recupera una malla humana 3D de cuerpo completo a partir de un solo video. Combina seguimiento de video, detección de personas y predicción de malla para reconstruir el cuerpo humano con pose, forma y expresiones faciales, y luego renderiza el rig recuperado de vuelta sobre el video. -El flujo de trabajo es útil para prototipos de captura de movimiento, análisis biomecánico y previsualización de animación de personajes. +Este flujo de trabajo es útil para la creación de prototipos de captura de movimiento, el análisis biomecánico y la previsualización de animación de personajes. ### SAM 3D Body: extracción de malla humana 3D desde video {#utility_sam3d_body} @@ -44,12 +46,12 @@ Sube este archivo al nodo `LoadVideo`: ## Cómo funciona -1. **Seguimiento de video**: SAM3 rastrea a la persona a lo largo de los fotogramas del video. El seguimiento es prácticamente obligatorio cuando aparecen varias personas en el clip, y en general mejora la precisión de la detección +1. **Seguimiento en el video**: SAM3 rastrea a la persona a lo largo de los fotogramas del video. El seguimiento es prácticamente obligatorio cuando aparecen varias personas en el clip y, en general, mejora la precisión de la detección 2. **Detección de personas**: RT-DETR detecta las cajas delimitadoras de la persona, guiado por el prompt de texto (`person`) -3. **Predicción de la malla**: SAM 3D Body predice la malla 3D de cuerpo completo a partir de los fotogramas rastreados, con un FOV de cámara MoGe opcional para una alineación más precisa con el video fuente +3. **Predicción de la malla**: SAM 3D Body predice la malla 3D de cuerpo completo a partir de los fotogramas rastreados, con un campo de visión de cámara MoGe opcional para lograr una alineación más precisa con el video fuente 4. **Expresiones faciales**: un paso basado en MediaPipe añade las expresiones faciales, que el modelo base no detecta 5. **Suavizado**: la secuencia de mallas se suaviza a lo largo del tiempo -6. **Renderizado**: se construye un archivo de pose (GLB), la malla se renderiza de vuelta sobre el video y luego se guarda como video de salida +6. **Renderizado**: se construye un archivo de pose (GLB), la malla se renderiza de nuevo sobre el video y luego se guarda como video de salida ## Pasos para ejecutar @@ -60,16 +62,16 @@ Sube este archivo al nodo `LoadVideo`: ## Descargas de modelos -Descarga el modelo SAM 3D Body y los archivos necesarios. Colócalos en los subdirectorios correspondientes de `models/`. +Descarga el modelo SAM 3D Body y los archivos requeridos. Colócalos en las subcarpetas correspondientes de `models/`. - sam3.1_multiplex_fp16.safetensors: checkpoint multiplex de SAM3 para el seguimiento en video + sam3.1_multiplex_fp16.safetensors: checkpoint multiplex de SAM3 para seguimiento de video - sam_3d_body_dinov3_bf16.safetensors: modelo de detección de SAM 3D Body (con backbone DINOv3) + sam_3d_body_dinov3_bf16.safetensors: modelo de detección de SAM 3D Body (backbone DINOv3) - + moge_2_vitl_normal_fp16.safetensors: estimación opcional del campo de visión de la cámara para la alineación diff --git a/es/tutorials/utility/seedvr2.mdx b/es/tutorials/utility/seedvr2.mdx index 6b23dffce1..4e86fdc42a 100644 --- a/es/tutorials/utility/seedvr2.mdx +++ b/es/tutorials/utility/seedvr2.mdx @@ -2,15 +2,17 @@ title: "SeedVR2: ampliación de imágenes y video en ComfyUI" description: "Aprende a ampliar imágenes y videos con SeedVR2, un modelo de restauración de un solo paso basado en difusión de ByteDance Seed" sidebarTitle: "SeedVR2" -translationSourceHash: d883cbec +translationSourceHash: 3bfd881e translationFrom: tutorials/utility/seedvr2.mdx translationBlockHashes: "_intro": 3ae2f661 + "Model Installation": ed2b6d9b "Example Workflows": acb91939 "Troubleshooting": 2ec4258d "Community Resources": dc823da3 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' # Introducción a ComfyUI SeedVR2 @@ -29,16 +31,16 @@ SeedVR2 viene en dos tamaños. El [modelo 3B](https://huggingface.co/ByteDance-S ## Instalación del modelo -Descarga los checkpoints de SeedVR2 del [repositorio SeedVR2 de Comfy-Org](https://huggingface.co/Comfy-Org/SeedVR2) y guárdalos en la carpeta correspondiente de ComfyUI: +Descarga los checkpoint(s) de SeedVR2 desde el [repositorio SeedVR2 de Comfy-Org](https://huggingface.co/Comfy-Org/SeedVR2) y guárdalos en la carpeta correspondiente de ComfyUI: -- [seedvr2_3b_fp16.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_3b_fp16.safetensors): modelo base 3B FP16, requiere menos VRAM -- [seedvr2_3b_fp8_e4m3fn.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_3b_fp8_e4m3fn.safetensors): 3B FP8 cuantizado, reduce aún más la VRAM +- [seedvr2_3b_fp16.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_3b_fp16.safetensors): modelo base 3B FP16, menor requisito de VRAM +- [seedvr2_3b_fp8_e4m3fn.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_3b_fp8_e4m3fn.safetensors): 3B FP8 cuantizado, VRAM aún más reducida - [seedvr2_3b_int8_convrot.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_3b_int8_convrot.safetensors): 3B INT8 con convrot - [seedvr2_7b_fp16.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_7b_fp16.safetensors): modelo base 7B FP16, mayor calidad - [seedvr2_7b_fp8_e4m3fn.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_7b_fp8_e4m3fn.safetensors): 7B FP8 cuantizado, equilibrio entre calidad y VRAM - [seedvr2_7b_int8_convrot.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_7b_int8_convrot.safetensors): 7B INT8 con convrot -- [seedvr2_7b_sharp_fp16.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_7b_sharp_fp16.safetensors): variante 7B FP16 sharp para más detalle -- [seedvr2_ema_vae_fp16.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/vae/seedvr2_ema_vae_fp16.safetensors): checkpoint VAE (compartido por todas las variantes del modelo) +- [seedvr2_7b_sharp_fp16.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/diffusion_models/seedvr2_7b_sharp_fp16.safetensors): variante sharp 7B FP16 para un detalle mejorado +- [seedvr2_ema_vae_fp16.safetensors](https://huggingface.co/Comfy-Org/SeedVR2/blob/main/vae/seedvr2_ema_vae_fp16.safetensors): checkpoint VAE (compartido entre todas las variantes del modelo) Coloca los archivos en los siguientes directorios: @@ -56,21 +58,20 @@ ComfyUI/ │ └── vae/ │ └── seedvr2_ema_vae_fp16.safetensors ``` - -## Flujos de trabajo de ejemplo +## Ejemplos de flujos de trabajo ### SeedVR2 3B Int8: Ampliar imagen {#utility_seedvr2_3b_int8_upscale_image} -Amplía imágenes con SeedVR2 3B Int8, un modelo de restauración de video basado en difusión de un solo paso que produce resultados de alta calidad con una mejor consistencia temporal. +Amplía imágenes con SeedVR2 3B Int8, un modelo de restauración de video basado en diffusion de un solo paso que produce resultados de alta calidad con una mejor consistencia temporal. -Vista previa del flujo de trabajo para ampliar imágenes con SeedVR2 3B Int8 +Vista previa del flujo de trabajo de ampliación de imagen con SeedVR2 3B Int8 - + Abrir en Comfy Cloud - Descarga el JSON o busca "SeedVR2 3B Int8: Upscale Image" en la Biblioteca de plantillas + Descarga el JSON o busca "SeedVR2 3B Int8: Upscale Image" en la biblioteca de plantillas @@ -80,7 +81,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - nodo `LoadImage` 1 · `watch_macro_shot.png` + Nodo `LoadImage` 1 · `watch_macro_shot.png` @@ -95,13 +96,13 @@ Sube este archivo al nodo `LoadImage` correspondiente: 1. Coloca tu imagen en la carpeta `ComfyUI/input/` y selecciónala en el nodo `Load Image` 2. Selecciona el checkpoint `seedvr2_3b_int8_convrot.safetensors` en el cargador de modelos de SeedVR2 -3. Haz clic en `Queue` o usa `Ctrl(cmd) + Enter` para ejecutar +3. Haz clic en `Queue` o usa `Ctrl(cmd) + Enter` para ejecutarlo -### SeedVR2 7B Int8: Ampliar imagen {#utility_seedvr2_7b_int8_upscale_image} +### SeedVR2 7B Int8: ampliar imagen {#utility_seedvr2_7b_int8_upscale_image} -Amplía imágenes con SeedVR2 7B Int8, un modelo de difusión de un solo paso que mejora la resolución mediante entrenamiento adversarial y atención de ventana adaptativa. +Amplía imágenes con SeedVR2 7B Int8, un modelo de difusión de un solo paso que mejora la resolución mediante entrenamiento adversario y atención de ventana adaptativa. -Vista previa del flujo de trabajo para ampliar imagen con SeedVR2 7B Int8 +Vista previa del flujo de trabajo para ampliar imágenes con SeedVR2 7B Int8 @@ -126,20 +127,20 @@ Sube este archivo al nodo `LoadImage` correspondiente:
Imagen de entrada - Salida de ejemplo de la ampliación con SeedVR2 7B Int8 + Ejemplo de salida de ampliación con SeedVR2 7B Int8
### 2.1 Pasos para ejecutar 1. Coloca tu imagen en la carpeta `ComfyUI/input/` y selecciónala en el nodo `Load Image` -2. Selecciona el checkpoint `seedvr2_7b_int8_convrot.safetensors` en el cargador de modelos de SeedVR2 -3. Haz clic en `Queue` o usa `Ctrl(cmd) + Enter` para ejecutar +2. Selecciona el checkpoint `seedvr2_7b_int8_convrot.safetensors` en el cargador de modelos SeedVR2 +3. Haz clic en `Queue` o usa `Ctrl(cmd) + Enter` para ejecutarlo -### SeedVR2 3B Int8: Escalar video {#utility_seedvr2_3b_int8_upscale_video} +### SeedVR2 3B Int8: Aumentar la resolución de video {#utility_seedvr2_3b_int8_upscale_video} -Escala y restaura metraje de video con SeedVR2 3B Int8, un modelo de difusión de un solo paso que mejora la resolución y mantiene la consistencia temporal entre fotogramas. +Aumenta la resolución y restaura metraje de video con SeedVR2 3B Int8, un modelo de difusión de un solo paso que mejora la resolución manteniendo la consistencia temporal entre fotogramas. -Vista previa del flujo de trabajo para escalar video con SeedVR2 3B Int8 +Vista previa del flujo de trabajo para aumentar la resolución de video con SeedVR2 3B Int8 @@ -187,20 +188,20 @@ Las resoluciones objetivo más altas requieren más tiempo de procesamiento. La ### La imagen ampliada sale completamente negra -Los backends de atención pueden devolver de forma silenciosa resultados negros o corruptos con checkpoints cuantizados. Si los flujos de trabajo SeedVR2 INT8 producen una imagen totalmente negra, prueba lo siguiente en este orden: +Los backends de atención pueden devolver resultados negros o corruptos sin previo aviso con checkpoints cuantizados. Si los flujos de trabajo de SeedVR2 INT8 producen una imagen totalmente negra, prueba lo siguiente en orden: -1. **Ejecutar sin FlashAttention:** si la habilitaste con `--use-flash-attention` o con un paquete de nodos personalizado, inicia ComfyUI con el backend de atención predeterminado y vuelve a ejecutar. Desactivar FlashAttention ha resuelto la salida totalmente negra en los flujos de trabajo INT8 de 3B y 7B en una RTX 3090. -2. **Cambiar el checkpoint:** usa el archivo FP16 o FP8 del mismo tamaño. Si esos se generan correctamente, el punto donde falla es la ruta de cuantización INT8. -3. **Verificar los archivos:** tanto el modelo de difusión como `seedvr2_ema_vae_fp16.safetensors` deben estar descargados por completo y colocados como se indica en Instalación del modelo. Una descarga truncada falla del mismo modo. -4. **Desactivar la vista previa en vivo:** en algunos casos solo la vista previa aparece negra mientras que el archivo guardado es correcto, así que desactivar la vista previa en vivo elimina la ambigüedad. +1. **Ejecuta sin FlashAttention:** si la habilitaste mediante `--use-flash-attention` o un paquete de nodos personalizado, inicia ComfyUI con el backend de atención predeterminado y vuelve a ejecutar. Deshabilitar FlashAttention ha resuelto la salida totalmente negra en los flujos de trabajo INT8 de 3B y 7B en una RTX 3090. +2. **Cambia el checkpoint:** usa el archivo FP16 o FP8 del mismo tamaño. Si esos se renderizan correctamente, la ruta de cuantización INT8 es donde falla. +3. **Verifica los archivos:** tanto el modelo de difusión como `seedvr2_ema_vae_fp16.safetensors` deben estar completamente descargados y colocados como se muestra en Instalación de modelos. Una descarga truncada falla de la misma manera. +4. **Desactiva la vista previa en vivo:** en algunos casos solo la vista previa está negra mientras el archivo guardado es correcto, así que desactivar la vista previa en vivo elimina la ambigüedad. -Si el resultado sigue siendo negro, publica en la discusión del tutorial con tu GPU, la versión de ComfyUI, el método de instalación (Desktop, portable o manual) y la salida de la consola, además de indicar si los flujos de trabajo de 3B y 7B fallan de forma idéntica. +Si el resultado sigue siendo negro, publica en la discusión del tutorial con tu GPU, la versión de ComfyUI, el método de instalación (Desktop, portable o manual) y la salida de la consola, además de si los flujos de trabajo de 3B y 7B fallan de forma idéntica. ## Recursos de la comunidad - [Página del proyecto SeedVR2](https://iceclear.github.io/projects/seedvr2/): Sitio web oficial del proyecto -- [Código de ByteDance SeedVR (GitHub)](https://github.com/ByteDance-Seed/SeedVR): Código de investigación original y artículo -- [Comfy-Org/SeedVR2 (HuggingFace)](https://huggingface.co/Comfy-Org/SeedVR2): Pesos oficiales del modelo para ComfyUI +- [Código base de ByteDance SeedVR (GitHub)](https://github.com/ByteDance-Seed/SeedVR): Código de investigación original y artículo +- [Comfy-Org/SeedVR2 (HuggingFace)](https://huggingface.co/Comfy-Org/SeedVR2): Pesos oficiales del modelo de ComfyUI - [ByteDance-Seed/SeedVR2-3B (HuggingFace)](https://huggingface.co/ByteDance-Seed/SeedVR2-3B): Pesos originales del modelo 3B - [ByteDance-Seed/SeedVR2-7B (HuggingFace)](https://huggingface.co/ByteDance-Seed/SeedVR2-7B): Pesos originales del modelo 7B - [Artículo (arXiv)](https://arxiv.org/abs/2506.05301) diff --git a/es/tutorials/video/hunyuan/hunyuan-video.mdx b/es/tutorials/video/hunyuan/hunyuan-video.mdx index d905fdc10d..50d0b70321 100644 --- a/es/tutorials/video/hunyuan/hunyuan-video.mdx +++ b/es/tutorials/video/hunyuan/hunyuan-video.mdx @@ -2,13 +2,16 @@ title: "Ejemplos de Hunyuan Video en ComfyUI" description: "Guía para usar los flujos de trabajo texto a video e imagen a video de Hunyuan en ComfyUI" sidebarTitle: "Hunyuan Video" -translationSourceHash: b0191226 +translationSourceHash: aa9c03fe translationFrom: tutorials/video/hunyuan/hunyuan-video.mdx translationBlockHashes: "_intro": 1af8ce94 + "Common Models for All Workflows": dee5f872 "Hunyuan Text-to-Video Workflow": 8b79e012 "Hunyuan Image-to-Video Workflow": fe9a6b51 + "Try It Yourself": d46e8289 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; - Guárdalo en ComfyUI/models/vae + Guardar en ComfyUI/models/vae Ubicación de almacenamiento: @@ -65,10 +68,9 @@ ComfyUI/ │ └── vae/ │ └── hunyuan_video_vae_bf16.safetensors ``` +## Flujo de trabajo de Hunyuan texto a video -## Flujo de trabajo de texto a video con Hunyuan - -Hunyuan Text-to-Video se publicó como código abierto en diciembre de 2024 y permite generar videos cortos de 5 segundos mediante descripciones en lenguaje natural, tanto en chino como en inglés. +Hunyuan texto a video se publicó como código abierto en diciembre de 2024 y permite generar videos cortos de 5 segundos a partir de descripciones en lenguaje natural, tanto en chino como en inglés. ### 1. Flujo de trabajo @@ -85,10 +87,10 @@ Descarga la imagen del flujo de trabajo que aparece a continuación y arrástral
-### 2. Instalación manual de los modelos +### 2. Instalación manual de modelos - Guarda el archivo en ComfyUI/models/diffusion_models + Guarda en ComfyUI/models/diffusion_models Asegúrate de tener todos estos archivos de modelo en las ubicaciones correctas: @@ -108,11 +110,11 @@ ComfyUI/ ![ComfyUI Hunyuan Video T2V Workflow](/images/tutorial/advanced/hunyuanvideo/flow_diagram_t2v.jpg) -1. Comprueba que el nodo `DualCLIPLoader` tenga cargados estos modelos: +1. Verifica que el nodo `DualCLIPLoader` tenga cargados estos modelos: - clip_name1: clip_l.safetensors - clip_name2: llava_llama3_fp8_scaled.safetensors -2. Comprueba que el nodo `Load Diffusion Model` tenga cargado `hunyuan_video_t2v_720p_bf16.safetensors` -3. Comprueba que el nodo `Load VAE` tenga cargado `hunyuan_video_vae_bf16.safetensors` +2. Verifica que el nodo `Load Diffusion Model` tenga cargado `hunyuan_video_t2v_720p_bf16.safetensors` +3. Verifica que el nodo `Load VAE` tenga cargado `hunyuan_video_vae_bf16.safetensors` 4. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo @@ -121,11 +123,11 @@ Cuando el parámetro `length` del nodo `EmptyHunyuanLatentVideo` se establece en ## Flujo de trabajo de imagen a video de Hunyuan -El modelo Hunyuan Image-to-Video se publicó como código abierto el 6 de marzo de 2025, basado en el framework HunyuanVideo. Transforma imágenes estáticas en videos suaves y de alta calidad, y también ofrece código de entrenamiento de LoRA para personalizar efectos de video especiales como el crecimiento del cabello, la transformación de objetos y más. +El modelo Hunyuan Image-to-Video se publicó como código abierto el 6 de marzo de 2025, basado en el framework HunyuanVideo. Transforma imágenes estáticas en videos suaves y de alta calidad y también proporciona código de entrenamiento LoRA para personalizar efectos de video especiales como crecimiento de cabello, transformación de objetos y más. Actualmente, el modelo Hunyuan Image-to-Video tiene dos versiones: -- v1 "concat": mejor fluidez de movimiento, pero menor adherencia a la orientación de la imagen -- v2 "replace": actualizada al día siguiente de la v1, con mejor orientación de la imagen, pero al parecer menos dinámica en comparación con la v1 +- v1 "concat": mejor fluidez de movimiento pero menor adherencia a la orientación de la imagen +- v2 "replace": actualizado al día siguiente de v1, con mejor orientación de la imagen pero aparentemente menos dinámico en comparación con v1
@@ -141,10 +143,10 @@ Actualmente, el modelo Hunyuan Image-to-Video tiene dos versiones: ### Modelo compartido para las versiones v1 y v2 - Guardar en ComfyUI/models/clip_vision + Guarda en ComfyUI/models/clip_vision -### Flujo de trabajo imagen a video V1 "concat" +### Flujo de trabajo de imagen a video V1 "concat" #### 1. Flujo de trabajo y recursos @@ -161,9 +163,9 @@ Descarga la imagen del flujo de trabajo que aparece a continuación y arrástral Descarga la imagen a continuación y úsala como fotograma inicial para la generación de imagen a video: - Guárdala y úsala como imagen de entrada para la generación I2V + Guarda y usa como imagen de entrada para la generación I2V -#### 2. Instalación manual de los modelos relacionados +#### 2. Instalación manual de modelos relacionados Guarda en ComfyUI/models/diffusion_models @@ -181,12 +183,12 @@ ComfyUI/ │ ├── vae/ │ │ └── hunyuan_video_vae_bf16.safetensors // Modelo compartido │ └── diffusion_models/ -│ └── hunyuan_video_image_to_video_720p_bf16.safetensors // Modelo de la versión I2V v1 "concat" +│ └── hunyuan_video_image_to_video_720p_bf16.safetensors // Modelo de la versión "concat" de I2V v1 ``` #### 3. Pasos para ejecutar el flujo de trabajo -![Flujo de trabajo de ComfyUI Hunyuan Video I2V v1](/images/tutorial/advanced/hunyuanvideo/flow_diagram_i2v_v1.jpg) +![Flujo de trabajo de Hunyuan Video I2V v1 de ComfyUI](/images/tutorial/advanced/hunyuanvideo/flow_diagram_i2v_v1.jpg) 1. Asegúrate de que `DualCLIPLoader` haya cargado estos modelos: - clip_name1: clip_l.safetensors @@ -199,13 +201,13 @@ ComfyUI/ ### Flujo de trabajo de imagen a video v2 "replace" -El flujo de trabajo v2 es esencialmente el mismo que el del v1. Solo necesitas descargar el modelo **replace** y usarlo en el nodo `Load Diffusion Model`. +El flujo de trabajo v2 es esencialmente igual al flujo de trabajo v1. Solo necesitas descargar el modelo **replace** y usarlo en el nodo `Load Diffusion Model`. #### 1. Flujo de trabajo y recursos -Descarga la imagen del flujo de trabajo de abajo y arrástrala a ComfyUI para cargarlo: +Descarga la imagen del flujo de trabajo que aparece a continuación y arrástrala a ComfyUI para cargar el flujo de trabajo: -![Flujo de trabajo de ComfyUI - Hunyuan imagen a video v2](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hunyuan-video/i2v/v2_fennec_gril.webp) +![ComfyUI Workflow - Hunyuan Image-to-Video v2](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hunyuan-video/i2v/v2_fennec_gril.webp) @@ -213,12 +215,12 @@ Descarga la imagen del flujo de trabajo de abajo y arrástrala a ComfyUI para ca -Descarga la imagen de abajo y úsala como fotograma inicial para la generación de imagen a video: +Descarga la imagen que aparece a continuación y úsala como fotograma inicial para la generación de imagen a video: - Guarda y usa como imagen de entrada para la generación I2V + Guárdala y úsala como imagen de entrada para la generación de I2V -#### 2. Instalación manual de modelos relacionados +#### 2. Instalación manual de los modelos relacionados Guárdalo en ComfyUI/models/diffusion_models @@ -241,22 +243,22 @@ ComfyUI/ #### 3. Pasos para ejecutar el flujo de trabajo -![Flujo de trabajo de ComfyUI Hunyuan Video I2V v2](/images/tutorial/advanced/hunyuanvideo/flow_diagram_i2v_v2.jpg) +![ComfyUI Hunyuan Video I2V v2 Workflow](/images/tutorial/advanced/hunyuanvideo/flow_diagram_i2v_v2.jpg) -1. Asegúrate de que el nodo `DualCLIPLoader` haya cargado estos modelos: +1. Asegúrate de que el nodo `DualCLIPLoader` tenga cargados estos modelos: - clip_name1: clip_l.safetensors - clip_name2: llava_llama3_fp8_scaled.safetensors -2. Asegúrate de que el nodo `Load CLIP Vision` haya cargado `llava_llama3_vision.safetensors` -3. Asegúrate de que el nodo `Load Image Model` haya cargado `hunyuan_video_image_to_video_720p_bf16.safetensors` -4. Asegúrate de que el nodo `Load VAE` haya cargado `hunyuan_video_vae_bf16.safetensors` -5. Asegúrate de que el nodo `Load Diffusion Model` haya cargado `hunyuan_video_v2_replace_image_to_video_720p_bf16.safetensors` +2. Asegúrate de que el nodo `Load CLIP Vision` tenga cargado `llava_llama3_vision.safetensors` +3. Asegúrate de que el nodo `Load Image Model` tenga cargado `hunyuan_video_image_to_video_720p_bf16.safetensors` +4. Asegúrate de que el nodo `Load VAE` tenga cargado `hunyuan_video_vae_bf16.safetensors` +5. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `hunyuan_video_v2_replace_image_to_video_720p_bf16.safetensors` 6. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo ## Pruébalo tú mismo Aquí tienes algunas imágenes y prompts que proporcionamos. Úsalos tal cual o ajústalos para crear tu propio video. -![example](/images/tutorial/advanced/hunyuanvideo/humanoid_android_dressed_in_a_flowing.png) +![ejemplo](/images/tutorial/advanced/hunyuanvideo/humanoid_android_dressed_in_a_flowing.png) ``` Futuristic robot dancing ballet, dynamic motion, fast motion, fast shot, moving scene @@ -264,7 +266,7 @@ Futuristic robot dancing ballet, dynamic motion, fast motion, fast shot, moving --- -![example](/images/tutorial/advanced/hunyuanvideo/samurai.png) +![ejemplo](/images/tutorial/advanced/hunyuanvideo/samurai.png) ``` Samurai waving sword and hitting the camera. camera angle movement, zoom in, fast scene, super fast, dynamic @@ -272,7 +274,7 @@ Samurai waving sword and hitting the camera. camera angle movement, zoom in, fas --- -![example](/images/tutorial/advanced/hunyuanvideo/a_flying_car.png) +![ejemplo](/images/tutorial/advanced/hunyuanvideo/a_flying_car.png) ``` flying car fastly moving and flying through the city @@ -280,7 +282,7 @@ flying car fastly moving and flying through the city --- -![example](/images/tutorial/advanced/hunyuanvideo/cyber_car_race.png) +![ejemplo](/images/tutorial/advanced/hunyuanvideo/cyber_car_race.png) ``` cyberpunk car race in night city, dynamic, super fast, fast shot diff --git a/ja/development/comfy-router/api.mdx b/ja/development/comfy-router/api.mdx index c6f3fadec0..dd4fb7cbd6 100644 --- a/ja/development/comfy-router/api.mdx +++ b/ja/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API の概要" sidebarTitle: "概要" description: "Comfy Router API の仕組み: モデル ID ごとに 1 つのルート。検出、スキーマ、キュー中のリクエスト、エラー、課金に関するガイドを用意しています。" -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx - [クイックスタート](/ja/development/comfy-router/quickstart): インストール、呼び出し、画像の保存。 - [モデル](/ja/development/comfy-router/models): カタログをブラウズし、モデル固有のリクエスト例を確認します。 - [ヘッダー](/ja/development/comfy-router/headers): 認証、冪等性、リクエスト ID、リトライのペース配分。 -- [API リファレンス](/ja/development/comfy-router/reference): エンドポイントのパラメータ、スキーマ、レスポンスコード。 \ No newline at end of file +- [API リファレンス](/ja/development/comfy-router/reference): エンドポイントのパラメータ、スキーマ、レスポンスコード。 +- [リアルタイム音声](/ja/development/comfy-router/realtime): Grok Voice の WebSocket セッションを開き、秒単位で課金されます。 diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index e251530d59..96993f599f 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router の機能と制限" sidebarTitle: "機能と制限" description: "Comfy Router とパートナープロキシのどちらを選ぶか、長時間実行される呼び出しへの備え、リカバリ・レート制限・アセット保存について説明します。" -translationSourceHash: 235802c5 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": cf6e2050 - "Models without a pre-flight estimate": 495bdb2b + "Models without a pre-flight estimate": f6dfd921 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -116,21 +116,17 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} - **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **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` +- **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` -- **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` - **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` - **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/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 */} diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 3a23417044..db3d238d64 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "Dreamina Seedance 2.0 260128 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-260128 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 9604ca27 +translationSourceHash: 70ec471f translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 6c5da06a + "Schema": 8c0478c9 "Examples": 641c458b --- @@ -287,10 +287,10 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ 返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。ドラフトタスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 - 範囲: `2` から `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index b33007d441..660ce9f9ff 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Dreamina Seedance 2.0 Fast 260128 を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-fast-260128 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: b02c6ed1 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": e03c503a + "Schema": 90b60b2e "Examples": 7714eccd --- @@ -279,10 +279,10 @@ v1 /proxy を直接呼び出す場合は、代わりに BytePlus 自身のバリ 返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 - 範囲: `2` から `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 1fc770ca00..2f8f216ebd 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Dreamina Seedance 2.0 Mini を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-mini を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 28c5c053 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 3c26a330 + "Schema": ebf1fc3a "Examples": db01067e --- @@ -281,10 +281,10 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ 返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 プロ: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 - 範囲: `2` 〜 `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 32aea062d4..048ce0e7a1 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,13 +2,13 @@ title: "Dreamina Seedance 2.5 260628 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-5-260628 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンス。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 07fd9c64 +translationSourceHash: 3606fb83 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0a76af44 + "Schema": d2c28a84 "Examples": 5465695b --- @@ -292,10 +292,10 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ 返されたタスク ID を `draft_task` コンテンツ項目で渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動)。 - 範囲: `2` から `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 89d9be1b9f..a2c17b032b 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Seedance 1.0 Pro 250528 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-250528 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 450bbe6e +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": fc979e05 + "Schema": b57b84de "Examples": 815d621e --- @@ -279,10 +279,10 @@ Comfy側のガードレールであり、BytePlusの制約ではありません 返されたタスクIDを `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。ドラフトタスクIDは7日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 1.0 pro、1.0 pro fast: [2,12]。 - 範囲: `2` 〜 `30` + 指定可能な値: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 0d3cd6f3c6..ee5d48e414 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,12 +2,12 @@ title: "Seedance 1.0 Pro Fast 251015 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-fast-251015 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて解説します。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 43683424 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": a882b2d8 + "Schema": dd74b012 "Examples": 1469ab97 --- @@ -281,10 +281,10 @@ BytePlus 自身のバリデータが応答します。実際のトラフィッ 返されたタスク ID を `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 1.0 pro、1.0 pro fast: [2,12]。 - 範囲: `2` から `30` + 指定可能な値: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 7a54185e4e..6134345bb4 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Seedance 1.5 Pro 251215 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-5-pro-251215 を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 1d016721 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 35f3b5dc + "Schema": f4d67fb6 "Examples": 7e73ac5c --- @@ -279,10 +279,10 @@ v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが 返されたタスク ID を `draft_task` コンテンツ項目で指定して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 1.5 pro: [4,12] または -1(自動)。 - 範囲: `2` から `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index e387986e28..178e03001d 100644 --- a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で Kling 3.0 Turbo を使用する" description: "Comfy Router 経由で kling/kling-3.0-turbo を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling 3.0 Turbo" -translationSourceHash: 301a1ee1 +translationSourceHash: d03a4ba5 translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx translationBlockHashes: "_intro": 5a8c5f4b "Quick start": a2145573 "Serving providers": 7ec93d4f - "Schema": 1f5f61c1 + "Schema": 4ec53894 "Examples": 0a9a8bbe --- @@ -195,11 +195,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - タスク結果のコールバック通知 URL。タスクのステータスが変化したときにサーバーが通知します。 + タスク結果のコールバック通知 URL。タスクのステータスが変化したときにサーバーが通知します。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 - カスタムタスク ID。システムが生成したタスク ID を上書きすることはありませんが、クエリに使用できます。1 つのユーザーアカウント内で一意である必要があります。 + カスタムタスク ID。システムが生成したタスク ID を上書きすることはありませんが、クエリに使用できます。1 つのユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx index 1dfb6f8731..4795fab741 100644 --- a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Kling Image O1 を使用する" description: "Comfy Router を通じて kling/kling-image-o1 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling Image O1" -translationSourceHash: cf053382 +translationSourceHash: 0d76917c translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx translationBlockHashes: "_intro": 513c65df "Quick start": 6256a30d - "Schema": d18a5393 + "Schema": 61821697 "Examples": 826db173 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -182,7 +182,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 + カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index a69f9bf8a4..55044739be 100644 --- a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,12 +2,12 @@ title: "Kling V2.5 Turbo を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-v2-5-turbo を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1a5ec6e5 +translationSourceHash: 1671e7b6 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 2495a4d3 "Quick start": dc63b3ac - "Schema": 68d50e72 + "Schema": 3bcb036e "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - コールバック通知先アドレス + コールバック通知先アドレス 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - カスタムタスクID + カスタムタスクID 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx index 86f2e928dc..6594273577 100644 --- a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Kling V2.6 を使用する" description: "Comfy Router 経由で kling/kling-v2-6 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.6" -translationSourceHash: 1e64e957 +translationSourceHash: c445a7bd translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": 04868509 "Quick start": 48a3d970 - "Schema": 9d23ff94 + "Schema": a61a551f "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - コールバック通知先アドレス + コールバック通知先アドレス 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - カスタムタスク ID + カスタムタスク ID 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx index d6e09f2638..161299a1f8 100644 --- a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,12 +2,12 @@ title: "Kling V3 Omni を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-v3-omni を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V3 Omni" -translationSourceHash: 226ee8a6 +translationSourceHash: 29d1799c translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": f9b37353 + "Schema": 68bd0500 "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーが能動的に通知します。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーが能動的に通知します。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 フォーマット: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - カスタムタスクID。単一のユーザーアカウント内で一意である必要があります。 + カスタムタスクID。単一のユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-v3/code.mdx b/ja/development/comfy-router/models/kling/kling-v3/code.mdx index bd8c4f29cf..8e04045525 100644 --- a/ja/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で Kling V3 を使用する" description: "Comfy Router 経由で kling/kling-v3 を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V3" -translationSourceHash: ecfa3f9b +translationSourceHash: e07d4035 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 74a12e0f "Quick start": 09c0a41a "Serving providers": a8b20c72 - "Schema": 77550c0a + "Schema": 8e8b04e6 "Examples": 8623c725 --- @@ -177,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - コールバック通知先アドレス + コールバック通知先アドレス 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -247,7 +247,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - カスタムタスクID + カスタムタスクID 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx index 1bc4fa1c1c..dcd06095bb 100644 --- a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,12 +2,12 @@ title: "Kling Video O1 を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-video-o1 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling Video O1" -translationSourceHash: 3c228231 +translationSourceHash: 892ccf77 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": 6f4cf55b + "Schema": f693e2ef "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーから能動的に通知されます。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーから能動的に通知されます。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - カスタムタスクID。1 つのユーザーアカウント内で一意である必要があります。 + カスタムタスクID。1 つのユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index 46daa06fdf..a4db08bffc 100644 --- a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Videos Avatar Image 2video を使用する" description: "Comfy Router 経由で kling/videos-avatar-image2video を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Videos Avatar Image 2video" -translationSourceHash: 444b1395 +translationSourceHash: 5181e917 translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx translationBlockHashes: "_intro": baca1542 "Quick start": 5605d33f - "Schema": eeb06fe1 + "Schema": 073bf8b2 "Examples": ce6803dd --- @@ -164,13 +164,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - このタスクの結果を受け取るコールバック通知アドレス。 + このタスクの結果を受け取るコールバック通知アドレス。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` - カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 + カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx index 80a7965e28..5a948550b4 100644 --- a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Videos Lip Sync を使う" description: "Comfy Router 経由で kling/videos-lip-sync を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて。" sidebarTitle: "Videos Lip Sync" -translationSourceHash: ddd2a405 +translationSourceHash: 6103bea9 translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx translationBlockHashes: "_intro": 0477697a "Quick start": e13a4628 - "Schema": 90571e9f + "Schema": 4fb7c777 "Examples": d1dd6ed8 --- @@ -176,7 +176,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 入力 - コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。 + コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` diff --git a/ja/development/comfy-router/models/runway/gen4-image/code.mdx b/ja/development/comfy-router/models/runway/gen4-image/code.mdx index 02df1cab50..550a44df97 100644 --- a/ja/development/comfy-router/models/runway/gen4-image/code.mdx +++ b/ja/development/comfy-router/models/runway/gen4-image/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Gen 4 Image を使用する" description: "Comfy Router 経由で runway/gen4_image を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Gen 4 Image" -translationSourceHash: c5792f5c +translationSourceHash: 51dc9815 translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx translationBlockHashes: "_intro": f3b89ce9 "Quick start": 82a202eb - "Schema": d889abf3 + "Schema": 1160ec6d "Examples": 291dbf54 --- @@ -168,7 +168,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \ - エンコードされた画像を含む HTTPS URL またはデータ URI + エンコードされた画像を含む HTTPS URL、Runway アップロード URI(runway://)、または data URI Router が `GET /v2/models/runway/gen4_image/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index b0b1763d17..f2bbc30d2e 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Grok Imagine Image 2.0 を使用する" description: "Comfy Router 経由で xai/grok-imagine-image-2.0 を呼び出します: endpoint、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: 83fe91a1 +translationSourceHash: e062dc40 translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: "_intro": 614e2e15 "Quick start": ff9945c8 - "Schema": faf9e081 + "Schema": cb29dfae "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES - 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します(low/medium。デフォルトは medium)。その他のモデルは現在これを無視します。 + 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します(low、medium、または auto。省略時は xAI のデフォルトで、auto は生成時に low、編集時に medium を使用)。その他のモデルはこれを無視します。 - 指定可能な値: `low`, `medium`, `high` + 指定可能な値: `low`, `medium`, `high`, `auto` diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index ea409df086..db5f5ae708 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,12 +2,12 @@ title: "Grok Imagine Image Pro を Comfy Router で使用する" description: "Comfy Router 経由で xai/grok-imagine-image-pro を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: 7932bb72 +translationSourceHash: 773b1560 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: "_intro": 97d341e4 "Quick start": 3a4bd585 - "Schema": 5d56d158 + "Schema": 805c771c "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します(low/medium、デフォルトは medium)。その他のモデルでは現在無視されます。 + 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します(low、medium、または auto。省略時は xAI のデフォルトで、auto は生成時に low、編集時に medium を使用)。その他のモデルはこれを無視します。 - 指定可能な値: `low`, `medium`, `high` + 指定可能な値: `low`, `medium`, `high`, `auto` diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index 5f7d233efb..e8c6ea066a 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Grok Imagine Image Quality を使用する" description: "Comfy Router 経由で xai/grok-imagine-image-quality を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて。" sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 923968d2 +translationSourceHash: 9f6e16d5 translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: "_intro": 72081c22 "Quick start": 799275b8 - "Schema": e0fcef44 + "Schema": e2c96ff6 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 出力画像の品質。grok-imagine-image-2.0 では価格ティア(low/medium。デフォルトは medium)を選択します。その他のモデルは現在この項目を無視します。 + 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します(low、medium、または auto。省略時は xAI のデフォルトで、auto は生成時に low、編集時に medium を使用)。その他のモデルはこれを無視します。 - 指定可能な値: `low`、`medium`、`high` + 指定可能な値: `low`、`medium`、`high`、`auto` diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 92b8b1dfc1..9bb27cb588 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Grok Imagine Image を使う" description: "Comfy Router 経由で xai/grok-imagine-image を呼び出す: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Grok Imagine Image" -translationSourceHash: 9cfb938a +translationSourceHash: 2e5c55ad translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: "_intro": a2e97c88 "Quick start": a5495331 - "Schema": 1d17b83a + "Schema": 171da7d5 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します(low/medium。デフォルトは medium)。その他のモデルは現在のところこれを無視します。 + 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します(low、medium、または auto。省略時は xAI のデフォルトで、auto は生成時に low、編集時に medium を使用)。その他のモデルはこれを無視します。 - 取り得る値: `low`、`medium`、`high` + 指定可能な値: `low`、`medium`、`high`、`auto` diff --git a/ja/development/comfy-router/realtime.mdx b/ja/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..1cd640f8d5 --- /dev/null +++ b/ja/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Comfy Router リアルタイム音声セッション" +sidebarTitle: "リアルタイム音声" +description: "Comfy Router 経由で Grok Voice のリアルタイム WebSocket セッションを開く方法: エンドポイント、認証、秒単位の料金、セッションの制限、そして発生しうるエラーとクローズコードについて説明します。" +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 は、fal が提供する xAI の Grok Voice とのリアルタイム音声対音声セッションを中継します。Comfy APIキーを使って Router への WebSocket を1本開きます。Router はアカウントとクレジットを確認し、上流でセッションを開き、その後イベントを双方向に中継します。料金はセッションの秒単位で Comfy クレジットから支払われます。 + +## エンドポイント + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +リクエストは WebSocket アップグレード(`GET` と `Connection: Upgrade`、`Upgrade: websocket`)です。それ以外のリクエストは `426` で拒否されます。 + +## 認証 + +アップグレードリクエストのヘッダーで、`X-API-Key: comfyui-...` または `Authorization: Bearer comfyui-...` のいずれかとして Comfy APIキーを送信してください。Router はクエリ文字列や WebSocket サブプロトコルからキーを読み取りません。 + + +ブラウザは WebSocket にヘッダーを設定できません。また、Comfy APIキーがブラウザに渡ることは決してあってはなりません。お使いのサーバーからセッションを開き、オーディオをブラウザにご自身で中継してください。 + + +## 接続 + +アップグレードが成功したら、Grok Voice 向けに xAI がドキュメント化しているリアルタイムイベントを送受信します。この例では、セッションを設定し、1 回のテキストターンを送信して、受信した各イベントタイプを出力します。 + + + +```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 # fal 自身の x-fal-message フレーム + 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) => { + // アップグレードが拒否されました。理由は JSON ボディに示されています。 + 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; // fal 自身の x-fal-message フレーム + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +完了したらすぐにソケットを閉じてください。課金は最後の応答までではなく、セッションが閉じるまで続きます。 + +## イベント + +Router は独自のイベントプロトコルを定義していません。サーバーイベントは fal が送信するそのままの形で届き、Router が受け付けるクライアントイベントは変更されずに転送されます。イベント一覧、セッションフィールド、音声、オーディオ形式については、以下を参照してください: + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) と xAI の [realtime event schema](https://docs.x.ai/voice-realtime.ws.json) +- fal の [Grok Voice realtime model page](https://fal.ai/models/xai/grok-voice/realtime) とその [API ページ](https://fal.ai/models/xai/grok-voice/realtime/api) + +例のように、各クライアントイベントを 1 つの msgpack バイナリメッセージとして送信してください。これは fal の realtime クライアントが使用するフレーミングであり、モデルのイベントも同様に、`session.created` で始まる msgpack バイナリメッセージとして返されます。fal はさらに、タイプ `x-fal-message` の独自の JSON テキストメッセージ(タイミング情報)も送信しますが、これはスキップしてかまいません。Router のチェックではクライアントイベントを 1 つの JSON テキストメッセージとしても受け付けますが、クライアントで JSON をテスト済みでない限り msgpack を使用してください。 + +Router は転送前に各クライアントイベントをチェックします: + +- **イベントタイプ:** `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`、および fal の `x-fal-session.configure`。 +- **モデル:** `session.update` 内の `model` は `grok-voice-latest`、`grok-voice-3.0`、または `grok-voice-2.0` である必要があります。 +- **ツール:** クライアントが実行する関数ツールは許可されます。サーバー側ツール(ウェブ検索、X 検索、ファイル検索、MCP)は拒否されます。 +- **メディア:** 画像およびビデオ入力は拒否されます。セッションは音声とテキストのみです。 +- **サイズ:** クライアントメッセージ 1 つあたり最大 1 MiB です。 + +拒否されたイベントは転送されず、Router はクローズコード `1008` でセッションを閉じます。 + +## 料金 + +セッションの料金は **1 秒あたり $0.0011869** です(1 分あたり約 $0.0712、1 秒あたり 0.2504 クレジット、1 分あたり約 15.0 クレジット。211 クレジット = 1 USD)。セッションが開いている間は 15 秒単位で課金され、最後の端数の単位は秒単位で切り上げて課金されます。課金はアップグレードからソケットが閉じるまで、オーディオが流れているかどうかに関係なく続きます。 + +## 制限 + +| 制限 | 値 | +| --- | --- | +| アカウントあたりのセッション数 | 同時に開けるセッションは 1 つです。2 つ目を開くと `429` と `router.realtime.session_already_live` が返されます。 | +| セッション長 | 最大 30 分で、接続時点のあなたのクレジット残高で賄える時間を超えることはありません。 | +| セッション中のクレジット | Router は 15 秒ごとに残高を再確認し、次の 1 秒を賄えなくなった時点でセッションを終了します。 | +| 接続レート | 各アップグレード試行は、[呼び出し元ごとのリクエストレート](/ja/development/comfy-router/limitations#リクエストは呼び出し元ごとにレート制限される)にカウントされ、他の Router 呼び出しと共有されます。 | + +セッションが時間制限に達した場合、またはクレジットが不足した場合、接続はクローズフレームなしで閉じることがあります(多くの場合、クローズコード `1006` として現れます)。トップアップ後にのみ再接続するか、より長い時間が必要な場合は新しいセッションを開始してください。 + +## エラー + +### アップグレード前 + +Router が接続を拒否した場合、プロトコルを切り替える代わりに HTTP ステータスと JSON ボディで応答します。 + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +判定には `code` を使用してください。`detail` は人間向けの説明です。 + +| ステータス | `code` | 原因 | 対処 | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | リクエストが WebSocket アップグレードではありませんでした。 | WebSocket クライアントで接続してください。 | +| `401` | `router.realtime.unauthorized` | APIキーが不足しているか無効です。 | `X-API-Key` または `Authorization: Bearer` で有効なキーを送信してください。 | +| `402` | `router.realtime.insufficient_credits` | 残高がセッションの最低1秒分にも満たない状態です。 | クレジットを追加してから再接続してください。 | +| `402` | `router.realtime.spend_denied` | このセッションの課金対象となるウォレットに資金がありません。ボディ内の `denied_reason` と `billed_workspace` がどのウォレットかを示します。 | そのワークスペースにクレジットを追加してから再接続してください。 | +| `403` | `router.realtime.provider_disabled` | ワークスペースのパートナープロバイダーポリシーがこのプロバイダーを許可していません。 | ワークスペースの管理者に許可を依頼してください。 | +| `404` | `router.realtime.model_not_allowed` | URL 内のモデルはリアルタイムでは利用不可です。 | URL を確認してください。 | +| `429` | `router.realtime.rate_limited` | リクエストレートを超過しました。 | `Retry-After` の時間待ってから再試行してください。 | +| `429` | `router.realtime.session_already_live` | あなたのアカウントで既に別のセッションが開いています。 | 先にそれを閉じてください。 | +| `429` | `router.realtime.concurrency_limit` | パートナーモデルの同時呼び出しが多すぎます。 | 同時実行数を減らして再試行してください。 | +| `502` | `router.realtime.upstream_refused`、`router.realtime.token_mint_failed` | 上流プロバイダーがセッションを開きませんでした。 | バックオフを伴って再試行してください。 | +| `503` | その他の `router.realtime.*` コード | リアルタイムセッションが一時的に利用できません。 | バックオフを伴って再試行してください。 | + +### アップグレード後 + +| クローズコード | 意味 | 対処 | +| --- | --- | --- | +| `1008` | クライアントイベントが拒否されました([イベント](#イベント)を参照)。 | イベントを修正してください。セッションは終了します。 | +| `1012` | Router が再起動中です。 | 再接続してください。新しいセッションが開始され、新しいアップグレード時点から課金されます。 | +| `1006`(クローズフレームなし) | セッションが制限時間に達した、またはクレジットが不足した際にクライアントが報告する値としてよく見られます。ネットワーク切断も同じように見えます。 | クレジットを追加するか、新しいセッションを開始してください。 | + +その他のクローズコードは fal または xAI からのものです。[イベント](#イベント)にリンクされている各社のドキュメントを参照してください。 + +## 次のステップ + +- [課金](/ja/development/comfy-router/billing): Router の課金方法と利用量の照合方法。 +- [エラーとリトライ](/ja/development/comfy-router/errors): 他の Router 呼び出しが返すエラーの分類。 +- [制限事項](/ja/development/comfy-router/limitations): リクエストレートやその他の制限。 diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index fd47f1f242..afe1998237 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API リファレンス" description: "Comfy API 契約から生成済みの、Comfy Router のすべてのエンドポイント、パラメータ、レスポンスボディ、エラーバケット。" sidebarTitle: "API リファレンス" -translationSourceHash: a6f99965 +translationSourceHash: aee933a1 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": 222fd740 + "Endpoints": e0879d3c "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 5952af3f - "Result assets": 18fe6dad + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 - "Schemas": 984bd216 + "Schemas": c1245cc9 --- @@ -309,7 +309,7 @@ Comfy API キーは Bearer トークンとして送信することもできま **モデル呼び出しを実行する前に、実行せずに価格を見積もります。** -このボディをこのモデルで実行した場合のコストを米ドルで示す事前見積もりを返します。価格は、実行時の請求に使われるのと同じレートカードから算出されます(ベンダーが報告するコストで課金されるモデルの場合は、代わりにベンダーの公開価格表から見積もられます)。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの利用状況および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。デフォルトの実行(`strict_mode` なし、`reject_unknown_fields` なし)が検証するのと同じ方法です。そのため、モデルのスキーマに適合しないボディは、実行時と同じ `422` になります。プロバイダーには何もディスパッチされず、課金も発生しません。この応答は価格の固定ではありません。`pricing_as_of` の時点で有効な料率で価格が算出され、実行はレーティング時点で有効な料率で課金されます。この機能のロールアウト中は、このルートは `403` を返し、`error_type: not_enabled` となります。 +このボディをこのモデルで実行した場合のコストを米ドルで示す事前見積もりを返します。価格は、実行時の請求に使われるのと同じレートカードから算出されます(ベンダーが報告するコストで課金されるモデルの場合は、代わりにベンダーの公開価格表から見積もられます)。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの利用状況および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。デフォルトの実行(`strict_mode` なし、`reject_unknown_fields` なし)が検証するのと同じ方法です。そのため、モデルのスキーマに適合しないボディは、実行時と同じ `422` になります。プロバイダーには何もディスパッチされず、課金も発生しません。この応答は価格の固定ではありません。`pricing_as_of` の時点で有効な料率で価格が算出され、実行はレーティング時点で有効な料率で課金されます。この機能のロールアウト中は、このルートは `403` を返し、`error_type: not_enabled` となります。また、Router がまだ実行できないモデルは、実行ルート自身の `detail` を伴う同じ `403` を返すため、`detail` を読んで両者を区別してください。 **パラメータ** @@ -1000,7 +1000,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 見積もりの限界。`200` の数値は、実行が受け付けられること、または正確にその金額が請求されることを約束するものではありません: - `/estimate` は `strict_mode` や `reject_unknown_fields` を受け取らないため、モデルのネイティブな契約のみを検証します。`strict_mode=true` の実行が代替プロバイダー自身のスキーマで受け付けるボディが、ここでは `422` になることがあります。また、`reject_unknown_fields=true` の実行なら拒否する未宣言のトップレベルフィールドが、ここでは価格付けされます。Anthropic Messages モデルは例外です。そのスキーマは未宣言のフィールドを許容するため、`reject_unknown_fields=true` の実行でも何も拒否せず、見積もりは未宣言のトップレベルフィールド `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` および空の `mcp_servers` のみを価格付けします。その他の未宣言のトップレベルフィールドがあると、`reason: not_quotable` とともに `unknown` を返します。 -- `pricing_as_of` は料率表を取得した時刻、またはベンダーの公開価格表から取得した `estimated` の見積もりの場合はその価格表を読んだ日付です(どちらも読まれていない場合は、見積もりを返した時刻です)。これは価格の固定ではありません。実行は、レーティング時点で有効な料率で請求されます。 +- `pricing_as_of` は料率表を取得した時刻です。ベンダーの公開価格表から取得した `estimated` の見積もりは、その価格表を読んだ日付を持ちます。請求数量をベンダーの公開スケジュールから予測し、その後レートカードで価格設定する `exact` または `estimated` の見積もりは、そのスケジュールの読み取り日がカードより古い場合、スケジュールの読み取り日を持ちます。カードもスケジュールも読まれていない場合は、見積もりを返した時刻です。これは価格の固定ではありません。実行は、レーティング時点で有効な料率で請求されます。 - `/estimate` は `model_provider` が示すレグ、またはネイティブのプロバイダーを価格付けします。`fallback_provider` や `strict_mode` パラメータは受け取りません。フォールバックのリトライが別のプロバイダーで行われる同期実行は、そのプロバイダーの料率で請求され、見積もりはそのレグを価格付けしていません。実行のレスポンスの `X-Comfy-Router-Fallback-Provider` が、それが発生したことを示します。キュー中の送信にはフォールバックがないため、その `estimate` は実行されるレグを価格付けします。 - `/estimate` とキュー中の送信の `estimate` は、`model_provider` レグの同じボディ、または兄弟オペレーションで実行されるボディについて、わずかに異なるドキュメントを価格付けすることがあります。送信の `estimate` は、実行が送信するドキュメントに基づいて価格付けされます。 - `/estimate` は常にプラットフォームの請求額を算出します。自分のプロバイダーキーでの実行は Comfy から請求されませんが、`/estimate` はそれを検出せずに数値を返します。`reason: byok` を返すのはキュー中の送信だけです。- ドルは丸めていないセントから最大8桁の小数で表示され、課金対象の1セント未満の `amount` が `0` と表示されることはありません。`credits` は `round(amount × 211, 2)` であり、これは `X-Comfy-Credits-Used` が課金に適用するのと同じ変換です。そのため、ごく小さい非ゼロの価格では `credits` が `0` にラウンドされることがあります。これが重要となる場合は、`credits` ではなく `amount` または `amount_cents` で予算を立ててください。このヘッダーは引き続き、1回の実行に対する事後的な数値です。残高は Comfy プラットフォーム上にあります。 @@ -1016,7 +1016,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 | `minimax/*` | 完了したビデオ | 12 時間 | | `xai/*` | 生成されたすべての画像、および完了したビデオ | 24 時間 | -これらの有効期間は、URL を開いたときではなく、URL が署名されたときに開始されます。キャッシュされた URL や再利用された URL は残り時間が短い場合があります。再利用しても有効期間は更新されません。アセットは速やかにダウンロードしてください。コピーされるのは各行に記載されたアセットのみです。`byteplus/seedream-*` と `byteplus/seededit-*` の画像は BytePlus ビデオの行には含まれません。 +これらの有効期間は、URL を開いたときではなく、URL が署名されたときに開始されます。キャッシュされた URL や再利用された URL は残り時間が短い場合があります。再利用しても有効期間は更新されません。`Idempotency-Key` の記録は、保持する URL より長く残ることがあるため、そうした URL の有効期限が切れる 1 時間前から、同じキーでの再試行は記録済みのレスポンスではなく `409 invalid_input` で応答されます。応答が返された時点ですでにそれだけ期限に近かった場合は、5 分間は再再生できます。アセットは速やかにダウンロードしてください。コピーされるのは各行に記載されたアセットのみです。`byteplus/seedream-*` と `byteplus/seededit-*` の画像は BytePlus ビデオの行には含まれません。 コピーを実行するのは、モデルのネイティブプロバイダーのみです。代替プロバイダーによって処理された実行、つまり `model_provider` が代替プロバイダーを指定している場合、またはネイティブ実行のフォールバック再試行が代替プロバイダーに到達した場合(`X-Comfy-Router-Fallback-Provider` で開示されます)は、そのプロバイダー自身の URL を返します。これらの URL はプロバイダーの有効期限に従い、コピーされません。`model_provider` の値 `default`、`comfy`、`comfyui` は代替プロバイダーを指定しないため、それらの実行はネイティブであり、上記と同様にコピーされます。フォールバック再試行がネイティブプロバイダーに戻った `model_provider` の実行も同様です。 @@ -1123,7 +1123,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 - この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` 見積もり(ベンダーが報告するコストで請求されるモデル)では、代わりにその価格表を読み取った日付を持ちます。請求数量をその価格表から予測し、その後レートカードで価格設定するもの(ベンダーが報告するクレジットで請求されるモデル)では、2 つの日付のうち古い方を持ちます。レートカードを読み取らなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、これは見積もりに回答した時点です。 + この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` 見積もり(ベンダーが報告するコストで請求されるモデル)では、代わりにその価格表を読み取った日付を持ちます。請求数量をベンダーの公開スケジュールから予測し、その後レートカードで価格設定する見積もりは、`exact` の回答でも `estimated` の回答でも、そのスケジュールの読み取り日とカードの取得時刻のうち古い方を持ちます(ベンダーが報告するクレジットで請求されるモデルが `estimated` の場合です)。レートカードを読み取らなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、これは見積もりに回答した時点です。 date-time @@ -1334,7 +1334,7 @@ Router モデルカタログの 1 ページ分です。 このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求が見つけた内容を示します。どちらもHTTPステータスに反映されるため、クライアントはどちらを基準に分岐してもかまいません。 -型: `文字列` +型: `string` ### RouterQueuePosition diff --git a/ko/development/comfy-router/api.mdx b/ko/development/comfy-router/api.mdx index dfff2eac06..f205d1bf4d 100644 --- a/ko/development/comfy-router/api.mdx +++ b/ko/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 개요" sidebarTitle: "개요" description: "Comfy Router API의 작동 방식: 모델 ID당 하나의 라우트이며, 검색, 스키마, 대기 중인 요청, 오류, 결제에 대한 가이드를 제공합니다." -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx - [빠른 시작](/ko/development/comfy-router/quickstart): 설치, 호출, 이미지 저장. - [모델](/ko/development/comfy-router/models): 카탈로그를 찾아보고 모델별 요청 예시를 확인합니다. - [헤더](/ko/development/comfy-router/headers): 인증, 멱등성, 요청 ID, 재시도 간격 조정. -- [API 레퍼런스](/ko/development/comfy-router/reference): 엔드포인트 파라미터, 스키마, 응답 코드. \ No newline at end of file +- [API 레퍼런스](/ko/development/comfy-router/reference): 엔드포인트 파라미터, 스키마, 응답 코드. +- [실시간 음성](/ko/development/comfy-router/realtime): Grok Voice WebSocket 세션을 열고 초 단위로 과금됩니다. diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index 5fd22da5b6..2086187958 100644 --- a/ko/development/comfy-router/limitations.mdx +++ b/ko/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 기능과 한계" sidebarTitle: "기능과 한계" description: "Comfy Router 또는 파트너 프록시 선택, 장시간 실행되는 호출 대비, 복구, 속도 제한 및 자산 저장에 대해 설명합니다." -translationSourceHash: 235802c5 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": cf6e2050 - "Models without a pre-flight estimate": 495bdb2b + "Models without a pre-flight estimate": f6dfd921 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -116,21 +116,17 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} - **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **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` +- **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` -- **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` - **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` - **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/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 */} diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 1df7667f38..831b21f68c 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Dreamina Seedance 2.0 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-260128을 호출합니다. endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 9604ca27 +translationSourceHash: 70ec471f translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 6c5da06a + "Schema": 8c0478c9 "Examples": 641c458b --- @@ -294,10 +294,10 @@ Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index b552dadeb9..579142be5d 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Dreamina Seedance 2.0 Fast 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-fast-260128을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: b02c6ed1 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": e03c503a + "Schema": 90b60b2e "Examples": 7714eccd --- @@ -279,10 +279,10 @@ BytePlus의 제약이 아닌 Comfy 측 보호 장치입니다. BytePlus는 텍 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 6d55390eba..d48699d1df 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router와 함께 Dreamina Seedance 2.0 Mini 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-mini를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 28c5c053 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 3c26a330 + "Schema": ebf1fc3a "Examples": db01067e --- @@ -280,10 +280,10 @@ BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하면 최종 1080p 비디오가 렌더링됩니다. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index e57578b988..0d3147eea6 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router에서 Dreamina Seedance 2.5 260628 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-5-260628을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 07fd9c64 +translationSourceHash: 3606fb83 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0a76af44 + "Schema": d2c28a84 "Examples": 5465695b --- @@ -291,10 +291,10 @@ BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 6db703933c..f8ba4298d6 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Seedance 1.0 Pro 250528 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-250528을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 450bbe6e +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": fc979e05 + "Schema": b57b84de "Examples": 815d621e --- @@ -275,10 +275,10 @@ v1 /proxy를 직접 호출할 경우에는 대신 BytePlus 자체 검증기가 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하면 최종 1080p 비디오를 렌더링합니다. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 1.0 pro, 1.0 pro fast: [2,12]. - 범위: `2` ~ `30` + 가능한 값: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 4d7c40f493..80b0f0e982 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router에서 Seedance 1.0 Pro Fast 251015 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-fast-251015를 호출하는 방법: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 43683424 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": a882b2d8 + "Schema": dd74b012 "Examples": 1469ab97 --- @@ -279,10 +279,10 @@ v1 /proxy를 직접 호출할 경우에는 BytePlus 자체 검증기가 대신 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 1.0 pro, 1.0 pro fast: [2,12]. - 범위: `2` ~ `30` + 가능한 값: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 13800db3cd..92ed015aea 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Seedance 1.5 Pro 251215 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-5-pro-251215를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 1d016721 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 35f3b5dc + "Schema": f4d67fb6 "Examples": 7e73ac5c --- @@ -279,10 +279,10 @@ v1 /proxy를 직접 호출하면 대신 BytePlus 자체 검증기가 응답합 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 1.5 pro: [4,12] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index fb407ea5de..77809eb0d3 100644 --- a/ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Kling 3.0 Turbo 사용하기" description: "Comfy Router를 통해 kling/kling-3.0-turbo를 호출합니다. 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Kling 3.0 Turbo" -translationSourceHash: 301a1ee1 +translationSourceHash: d03a4ba5 translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx translationBlockHashes: "_intro": 5a8c5f4b "Quick start": a2145573 "Serving providers": 7ec93d4f - "Schema": 1f5f61c1 + "Schema": 4ec53894 "Examples": 0a9a8bbe --- @@ -195,11 +195,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 작업 결과에 대한 콜백 알림 URL입니다. 작업 상태가 변경되면 서버가 알림을 보냅니다. + 작업 결과에 대한 콜백 알림 URL입니다. 작업 상태가 변경되면 서버가 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. - 사용자 지정 작업 ID입니다. 시스템이 생성한 작업 ID를 덮어쓰지는 않지만 조회에 사용할 수 있습니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 지정 작업 ID입니다. 시스템이 생성한 작업 ID를 덮어쓰지는 않지만 조회에 사용할 수 있습니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-image-o1/code.mdx b/ko/development/comfy-router/models/kling/kling-image-o1/code.mdx index 85e9483b17..5e190c08f2 100644 --- a/ko/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router와 함께 Kling Image O1 사용하기" description: "Comfy Router를 통해 kling/kling-image-o1 호출하기: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling Image O1" -translationSourceHash: cf053382 +translationSourceHash: 0d76917c translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx translationBlockHashes: "_intro": 513c65df "Quick start": 6256a30d - "Schema": d18a5393 + "Schema": 61821697 "Examples": 826db173 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 이 작업 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. + 이 작업 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -182,7 +182,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 사용자 지정 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 지정 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index ac88236104..9a9579cf3c 100644 --- a/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Kling V2.5 Turbo 사용하기" description: "Comfy Router를 통해 kling/kling-v2-5-turbo를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1a5ec6e5 +translationSourceHash: 1671e7b6 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 2495a4d3 "Quick start": dc63b3ac - "Schema": 68d50e72 + "Schema": 3bcb036e "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 콜백 알림 주소 + 콜백 알림 주소 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 사용자 정의 Task ID + 사용자 정의 Task ID 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx index 893e68985e..59c19ce1d2 100644 --- a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Kling V2.6 사용하기" description: "Comfy Router를 통해 kling/kling-v2-6을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답." sidebarTitle: "Kling V2.6" -translationSourceHash: 1e64e957 +translationSourceHash: c445a7bd translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": 04868509 "Quick start": 48a3d970 - "Schema": 9d23ff94 + "Schema": a61a551f "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 콜백 알림 주소 + 콜백 알림 주소 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 사용자 정의 작업 ID + 사용자 정의 작업 ID 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx index deae7364d7..1a428adb70 100644 --- a/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Kling V3 Omni 사용하기" description: "Comfy Router를 통해 kling/kling-v3-omni를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "Kling V3 Omni" -translationSourceHash: 226ee8a6 +translationSourceHash: 29d1799c translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": f9b37353 + "Schema": 68bd0500 "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 이 작업의 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. + 이 작업의 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 사용자 정의 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 정의 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-v3/code.mdx b/ko/development/comfy-router/models/kling/kling-v3/code.mdx index 27d8caab71..30895188c2 100644 --- a/ko/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Kling V3 사용하기" description: "Comfy Router를 통해 kling/kling-v3 호출하기: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling V3" -translationSourceHash: ecfa3f9b +translationSourceHash: e07d4035 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 74a12e0f "Quick start": 09c0a41a "Serving providers": a8b20c72 - "Schema": 77550c0a + "Schema": 8e8b04e6 "Examples": 8623c725 --- @@ -177,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 콜백 알림 주소 + 콜백 알림 주소 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -247,7 +247,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 사용자 정의 작업 ID + 사용자 정의 작업 ID 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx b/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx index f80a82c880..5458761525 100644 --- a/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Kling Video O1 사용하기" description: "Comfy Router를 통해 kling/kling-video-o1 호출: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling Video O1" -translationSourceHash: 3c228231 +translationSourceHash: 892ccf77 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": 6f4cf55b + "Schema": f693e2ef "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 이 작업 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. + 이 작업 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 사용자 정의 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 정의 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/ko/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index 5e9cf499b4..911afcdc5b 100644 --- a/ko/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/ko/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Videos Avatar Image 2video 사용하기" description: "Comfy Router를 통해 kling/videos-avatar-image2video를 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답입니다." sidebarTitle: "Videos Avatar Image 2video" -translationSourceHash: 444b1395 +translationSourceHash: 5181e917 translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx translationBlockHashes: "_intro": baca1542 "Quick start": 5605d33f - "Schema": eeb06fe1 + "Schema": 073bf8b2 "Examples": ce6803dd --- @@ -164,13 +164,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - 이 작업의 결과에 대한 콜백 알림 주소입니다. + 이 작업의 결과에 대한 콜백 알림 주소입니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` - 사용자 지정 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 지정 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/ko/development/comfy-router/models/kling/videos-lip-sync/code.mdx index 8ea8d2d235..efc675217b 100644 --- a/ko/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/ko/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Videos Lip Sync 사용하기" description: "Comfy Router를 통해 kling/videos-lip-sync를 호출합니다. endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Videos Lip Sync" -translationSourceHash: ddd2a405 +translationSourceHash: 6103bea9 translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx translationBlockHashes: "_intro": 0477697a "Quick start": e13a4628 - "Schema": 90571e9f + "Schema": 4fb7c777 "Examples": d1dd6ed8 --- @@ -176,7 +176,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 입력 - 콜백 알림 주소입니다. 작업 상태가 변경되면 서버가 알림을 보냅니다. + 콜백 알림 주소입니다. 작업 상태가 변경되면 서버가 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` diff --git a/ko/development/comfy-router/models/runway/gen4-image/code.mdx b/ko/development/comfy-router/models/runway/gen4-image/code.mdx index 676ca6d9aa..6b5f0cd535 100644 --- a/ko/development/comfy-router/models/runway/gen4-image/code.mdx +++ b/ko/development/comfy-router/models/runway/gen4-image/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Gen 4 Image 사용하기" description: "Comfy Router를 통해 runway/gen4_image를 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Gen 4 Image" -translationSourceHash: c5792f5c +translationSourceHash: 51dc9815 translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx translationBlockHashes: "_intro": f3b89ce9 "Quick start": 82a202eb - "Schema": d889abf3 + "Schema": 1160ec6d "Examples": 291dbf54 --- @@ -168,7 +168,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \ - 인코딩된 이미지를 포함하는 HTTPS URL 또는 데이터 URI + 인코딩된 이미지를 포함하는 HTTPS URL, Runway 업로드 URI(runway://) 또는 data URI Router가 `GET /v2/models/runway/gen4_image/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index bb47c8467f..b54aa6f881 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router에서 Grok Imagine Image 2.0 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image-2.0을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: 83fe91a1 +translationSourceHash: e062dc40 translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: "_intro": 614e2e15 "Quick start": ff9945c8 - "Schema": faf9e081 + "Schema": cb29dfae "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES - 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급(low/medium, 기본값은 medium)을 선택합니다. 다른 모델은 현재 이 값을 무시합니다. + 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low, medium 또는 auto, 생략 시 xAI의 기본값이며 auto는 생성 시 low, 편집 시 medium 사용). 다른 모델은 이를 무시합니다. - 가능한 값: `low`, `medium`, `high` + 가능한 값: `low`, `medium`, `high`, `auto` diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index 441313b906..b67a36c6bf 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Grok Imagine Image Pro 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image-pro를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: 7932bb72 +translationSourceHash: 773b1560 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: "_intro": 97d341e4 "Quick start": 3a4bd585 - "Schema": 5d56d158 + "Schema": 805c771c "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급(low/medium, 기본값은 medium)을 선택합니다. 다른 모델은 현재 이를 무시합니다. + 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low, medium 또는 auto, 생략 시 xAI의 기본값이며 auto는 생성 시 low, 편집 시 medium 사용). 다른 모델은 이를 무시합니다. - 가능한 값: `low`, `medium`, `high` + 가능한 값: `low`, `medium`, `high`, `auto` diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index eb1ef0f56e..80b048b5ae 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Grok Imagine Image Quality 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image-quality를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 923968d2 +translationSourceHash: 9f6e16d5 translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: "_intro": 72081c22 "Quick start": 799275b8 - "Schema": e0fcef44 + "Schema": e2c96ff6 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low/medium, 기본값은 medium). 다른 모델은 현재 이 값을 무시합니다. + 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low, medium 또는 auto, 생략 시 xAI의 기본값이며 auto는 생성 시 low, 편집 시 medium 사용). 다른 모델은 이를 무시합니다. - 가능한 값: `low`, `medium`, `high` + 가능한 값: `low`, `medium`, `high`, `auto` diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 75afa4df95..387a7232ac 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Grok Imagine Image 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Grok Imagine Image" -translationSourceHash: 9cfb938a +translationSourceHash: 2e5c55ad translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: "_intro": a2e97c88 "Quick start": a5495331 - "Schema": 1d17b83a + "Schema": 171da7d5 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low/medium, 기본값은 medium). 다른 모델은 현재 이 값을 무시합니다. + 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low, medium 또는 auto, 생략 시 xAI의 기본값이며 auto는 생성 시 low, 편집 시 medium 사용). 다른 모델은 이를 무시합니다. - 가능한 값: `low`, `medium`, `high` + 가능한 값: `low`, `medium`, `high`, `auto` diff --git a/ko/development/comfy-router/realtime.mdx b/ko/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..3f7db7d40c --- /dev/null +++ b/ko/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Comfy Router 실시간 음성 세션" +sidebarTitle: "실시간 음성" +description: "Comfy Router를 통해 Grok Voice 실시간 WebSocket 세션을 여는 방법을 설명합니다. 엔드포인트, 인증, 초당 가격, 세션 제한, 그리고 발생할 수 있는 오류와 종료 코드를 다룹니다." +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는 fal이 제공하는 xAI의 Grok Voice와 실시간 음성 대 음성 세션을 중계합니다. 사용자는 Comfy API 키로 Router에 WebSocket 하나를 엽니다. Router는 계정과 크레딧을 확인하고, 업스트림에서 세션을 연 뒤, 양방향으로 이벤트를 중계합니다. 세션 시간(초)당 Comfy 크레딧으로 요금이 청구됩니다. + +## 엔드포인트 + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +요청은 WebSocket 업그레이드입니다 (`GET`에 `Connection: Upgrade` 및 `Upgrade: websocket` 사용). 그 외의 요청은 `426`으로 거부됩니다. + +## 인증 + +업그레이드 요청의 헤더에 Comfy API 키를 `X-API-Key: comfyui-...` 또는 `Authorization: Bearer comfyui-...` 형식으로 보내세요. Router는 쿼리 문자열이나 WebSocket 서브프로토콜에서 키를 읽지 않습니다. + + +브라우저는 WebSocket에 헤더를 설정할 수 없으며, Comfy API 키는 절대 브라우저에 도달해서는 안 됩니다. 서버에서 세션을 열고 오디오를 브라우저로 직접 중계하세요. + + +## 연결 + +업그레이드가 성공하면 xAI가 Grok Voice용으로 문서화한 실시간 이벤트를 보내고 받으세요. 이 예제는 세션을 구성하고, 텍스트 턴 하나를 보내며, 수신하는 각 이벤트 유형을 출력합니다. + + + +```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 # fal 자체의 x-fal-message 프레임 + 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) => { + // 업그레이드가 거부되었습니다. JSON 본문에 사유가 명시됩니다. + 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; // fal 자체의 x-fal-message 프레임 + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +작업을 마치면 즉시 소켓을 닫으세요. 마지막 응답 시점이 아니라 세션이 닫힐 때까지 과금됩니다. + +## 이벤트 + +Router는 자체 이벤트 프로토콜을 정의하지 않습니다. 서버 이벤트는 fal이 보내는 그대로 도달하며, Router가 허용하는 클라이언트 이벤트도 변경 없이 전달됩니다. 이벤트 목록, 세션 필드, 음성, 오디오 형식은 다음 문서를 참고하세요: + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) 및 xAI의 [realtime 이벤트 스키마](https://docs.x.ai/voice-realtime.ws.json) +- fal의 [Grok Voice realtime 모델 페이지](https://fal.ai/models/xai/grok-voice/realtime) 및 [API 페이지](https://fal.ai/models/xai/grok-voice/realtime/api) + +각 클라이언트 이벤트는 예제에서처럼 하나의 msgpack 바이너리 메시지로 보내세요. 이는 fal의 realtime 클라이언트가 사용하는 프레이밍이며, 모델의 이벤트도 `session.created`로 시작하는 msgpack 바이너리 메시지로 같은 방식으로 돌아옵니다. fal은 또한 자체 JSON 텍스트 메시지인 `x-fal-message`(타이밍 정보)를 보내는데, 이는 건너뛰어도 됩니다. Router의 검사는 클라이언트 이벤트를 하나의 JSON 텍스트 메시지로도 허용하지만, 클라이언트에서 JSON을 테스트해 보지 않았다면 msgpack을 사용하세요. + +Router는 전달하기 전에 각 클라이언트 이벤트를 검사합니다: + +- **이벤트 유형:** `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`, 그리고 fal의 `x-fal-session.configure`. +- **모델:** `session.update`의 `model`은 `grok-voice-latest`, `grok-voice-3.0`, `grok-voice-2.0` 중 하나여야 합니다. +- **도구:** 클라이언트가 실행하는 함수 도구는 허용됩니다. 서버 측 도구(웹 검색, X 검색, 파일 검색, MCP)는 거부됩니다. +- **미디어:** 이미지 및 비디오 입력은 거부됩니다. 세션은 음성과 텍스트 전용입니다. +- **크기:** 클라이언트 메시지 하나는 최대 1 MiB입니다. + +거부된 이벤트는 전달되지 않으며, Router는 종료 코드 `1008`로 세션을 닫습니다. + +## 가격 + +세션 비용은 **초당 $0.0011869**입니다(분당 약 $0.0712, 초당 0.2504 크레딧, 분당 약 15.0 크레딧이며, 211 크레딧 = $1 USD 기준). 세션이 열려 있는 동안 15초 단위로 청구되며, 마지막 부분 증가분은 초 단위로 올림하여 청구됩니다. 청구는 업그레이드 시점부터 소켓이 닫힐 때까지 진행되며, 오디오가 흐르고 있는지 여부와 관계없이 적용됩니다. + +## 제한 사항 + +| 제한 | 값 | +| --- | --- | +| 계정당 세션 수 | 한 번에 하나의 세션만 열 수 있습니다. 두 번째 세션을 열면 `router.realtime.session_already_live`와 함께 `429`가 반환됩니다. | +| 세션 시간 | 최대 30분이며, 연결 시점의 보유 크레딧 잔액으로 감당할 수 있는 시간을 초과할 수 없습니다. | +| 세션 중 크레딧 | Router는 15초마다 잔액을 다시 확인하며, 잔액이 다음 1초를 더 감당할 수 없게 되면 세션을 종료합니다. | +| 연결 요청 속도 | 각 업그레이드 시도는 [호출자별 요청 속도](/ko/development/comfy-router/limitations#요청은-호출자별로-속도-제한됩니다)에 포함되며, 이 속도는 다른 Router 호출과 공유됩니다. | + +세션이 시간 제한에 도달하거나 크레딧이 소진되면, close 프레임 없이 연결이 닫힐 수 있습니다(흔히 close 코드 `1006`으로 표시됨). 크레딧을 충전한 이후에만 다시 연결하거나, 더 많은 시간이 필요하면 새 세션을 시작하세요. + +## 오류 + +### 업그레이드 이전 + +Router가 연결을 거부하면 프로토콜을 전환하지 않고 HTTP 상태와 JSON 본문으로 응답합니다. + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +`code`를 기준으로 분기하세요. `detail`은 사람이 읽기 위한 것입니다. + +| 상태 | `code` | 원인 | 해결 방법 | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | 요청이 WebSocket 업그레이드가 아니었습니다. | WebSocket 클라이언트로 연결하세요. | +| `401` | `router.realtime.unauthorized` | API 키가 누락되었거나 유효하지 않습니다. | `X-API-Key` 또는 `Authorization: Bearer`에 유효한 키를 보내세요. | +| `402` | `router.realtime.insufficient_credits` | 잔액으로 최소 1초의 세션도 감당할 수 없습니다. | 크레딧을 추가한 뒤 다시 연결하세요. | +| `402` | `router.realtime.spend_denied` | 세션이 청구될 지갑에 자금이 없습니다. 본문의 `denied_reason`과 `billed_workspace`가 어느 지갑인지 알려줍니다. | 해당 워크스페이스에 크레딧을 추가한 뒤 다시 연결하세요. | +| `403` | `router.realtime.provider_disabled` | 워크스페이스의 파트너 공급자 정책이 이 공급자를 허용하지 않습니다. | 워크스페이스 관리자에게 허용을 요청하세요. | +| `404` | `router.realtime.model_not_allowed` | URL에 있는 모델은 realtime에 사용할 수 없습니다. | URL을 확인하세요. | +| `429` | `router.realtime.rate_limited` | 요청 속도 제한을 초과했습니다. | `Retry-After`만큼 기다린 뒤 재시도하세요. | +| `429` | `router.realtime.session_already_live` | 계정에 이미 다른 세션이 열려 있습니다. | 먼저 해당 세션을 닫으세요. | +| `429` | `router.realtime.concurrency_limit` | 동시 파트너 모델 호출이 너무 많습니다. | 동시 작업을 줄이고 재시도하세요. | +| `502` | `router.realtime.upstream_refused`, `router.realtime.token_mint_failed` | 업스트림 공급자가 세션을 열지 않았습니다. | 백오프를 두고 재시도하세요. | +| `503` | 그 밖의 다른 `router.realtime.*` 코드 | realtime 세션을 일시적으로 사용할 수 없습니다. | 백오프를 두고 재시도하세요. | + +### 업그레이드 이후 + +| 종료 코드 | 의미 | 해결 방법 | +| --- | --- | --- | +| `1008` | 클라이언트 이벤트가 거부되었습니다([이벤트](#이벤트) 참고). | 이벤트를 수정하세요. 세션은 종료되었습니다. | +| `1012` | Router가 재시작 중입니다. | 다시 연결하세요. 새 세션이 시작되며 새 업그레이드 시점부터 과금됩니다. | +| `1006` (종료 프레임 없음) | 세션이 시간 제한에 도달했거나 크레딧이 소진되었을 때 클라이언트가 흔히 보고하는 값입니다. 네트워크 끊김도 동일하게 보입니다. | 크레딧을 추가하거나 새 세션을 시작하세요. | + +그 밖의 종료 코드는 fal 또는 xAI에서 발생합니다. [이벤트](#이벤트)에 링크된 해당 문서를 참고하세요. + +## 다음 + +- [청구](/ko/development/comfy-router/billing): Router가 과금하는 방식과 사용량을 확인하는 방법입니다. +- [오류 및 재시도](/ko/development/comfy-router/errors): 다른 Router 호출이 반환하는 오류 유형입니다. +- [제한 사항](/ko/development/comfy-router/limitations): 요청 비율 및 기타 제한 사항입니다. diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index 6547d5ccc3..c645afb46c 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API 레퍼런스" description: "Comfy API 계약에서 생성된 모든 Comfy Router 엔드포인트, 매개변수, 응답 본문 및 오류 버킷." sidebarTitle: "API 레퍼런스" -translationSourceHash: a6f99965 +translationSourceHash: aee933a1 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": 222fd740 + "Endpoints": e0879d3c "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 5952af3f - "Result assets": 18fe6dad + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 - "Schemas": 984bd216 + "Schemas": c1245cc9 --- @@ -53,7 +53,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 **Comfy Router가 실행할 수 있는 모델을 나열합니다.** -사용 가능한 모델 ID와 청구 정보를 나열합니다. `has_more`가 `true`인 동안 `next_cursor`를 사용하세요. +사용 가능한 모델 ID와 청구 정보를 나열합니다. `has_more`가 true인 동안 `next_cursor`를 사용하세요. **파라미터** @@ -309,7 +309,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 **모델 호출을 실행하기 전에, 실행하지 않고 가격을 산정합니다.** -이 모델에서 이 본문을 실행하면 얼마가 들지 미국 달러로 사전 견적하여 반환합니다. 가격은 실행 시 청구에 사용되는 것과 동일한 요율표를 기준으로 산정됩니다(공급업체가 보고한 비용으로 청구되는 모델은 대신 공급업체가 공개한 가격표를 기준으로 견적됩니다). 이는 견적일 뿐 최종 청구가 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 결제 기록에 정산된 청구액입니다. 본문은 먼저 모델의 입력 스키마에 대해 검증되며, 이는 기본 실행(`strict_mode` 없음, `reject_unknown_fields` 없음)이 검증하는 방식과 같습니다. 따라서 모델 스키마를 통과하지 못하는 본문은 실행 시와 동일하게 여기서도 `422`입니다. 공급자로 아무것도 전달되지 않으며 비용도 청구되지 않습니다. 이 응답은 가격을 고정하는 것이 아닙니다. `pricing_as_of` 시점에 유효한 요율로 산정되며, 실행은 요율 산정 시점에 유효한 요율로 청구됩니다. 이 기능이 순차 배포되는 동안 이 라우트는 `error_type: not_enabled`와 함께 `403`을 응답합니다. +이 모델에서 이 본문을 실행하면 얼마가 들지 미국 달러로 사전 견적하여 반환합니다. 가격은 실행 시 청구에 사용되는 것과 동일한 요율표를 기준으로 산정됩니다(공급업체가 보고한 비용으로 청구되는 모델은 대신 공급업체가 공개한 가격표를 기준으로 견적됩니다). 이는 견적일 뿐 최종 청구가 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 결제 기록에 정산된 청구액입니다. 본문은 먼저 모델의 입력 스키마에 대해 검증되며, 이는 기본 실행(`strict_mode` 없음, `reject_unknown_fields` 없음)이 검증하는 방식과 같습니다. 따라서 모델 스키마를 통과하지 못하는 본문은 실행 시와 동일하게 여기서도 `422`입니다. 공급자로 아무것도 전달되지 않으며 비용도 청구되지 않습니다. 이 응답은 가격을 고정하는 것이 아닙니다. `pricing_as_of` 시점에 유효한 요율로 산정되며, 실행은 요율 산정 시점에 유효한 요율로 청구됩니다. 이 기능이 순차 배포되는 동안 이 라우트는 `error_type: not_enabled`와 함께 `403`을 응답합니다. 또한 Router가 아직 실행할 수 없는 모델은 실행 라우트 자체의 `detail`과 함께 동일한 `403`을 응답하므로, `detail`을 읽어 두 경우를 구분하세요. **파라미터** @@ -1000,7 +1000,7 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 예상치의 한계. `200` 응답의 금액은 실행이 수락된다거나 정확히 그 금액이 청구된다는 약속이 아닙니다: - `/estimate`는 `strict_mode`나 `reject_unknown_fields`를 받지 않으므로 모델의 기본 계약만 검사합니다. `strict_mode=true` 실행이 대체 공급자 자체 스키마에서 수락하는 본문이 여기서는 `422`를 받을 수 있고, `reject_unknown_fields=true` 실행이 거부할 선언되지 않은 최상위 필드도 여기서는 가격이 산정됩니다. Anthropic Messages 모델은 예외입니다. 해당 스키마는 선언되지 않은 필드를 허용하므로 `reject_unknown_fields=true` 실행도 아무것도 거부하지 않으며, 예상치는 선언되지 않은 최상위 필드 `tools`, `tool_choice`, `temperature`, `top_p`, `top_k`, `stop_sequences`, `metadata`, `thinking` 및 빈 `mcp_servers`에 대해서만 가격을 산정합니다. 그 밖의 선언되지 않은 최상위 필드가 있으면 `reason: not_quotable`과 함께 `unknown`을 응답합니다. -- `pricing_as_of`는 요율표를 가져온 시점이며, 공급자의 공개 가격표에서 가져온 `estimated` 견적의 경우에는 그 가격표를 읽은 날짜입니다(둘 다 읽지 않은 경우에는 예상치를 응답한 시점입니다). 이는 가격 고정이 아닙니다. 실행은 요율이 적용되는 시점에 유효한 요율로 청구됩니다. +- `pricing_as_of`는 요율표를 가져온 시점입니다. 공급자의 공개 가격표에서 가져온 `estimated` 견적은 그 가격표를 읽은 날짜를 담습니다. 청구 수량을 공급자의 공개 일정표에서 예측한 뒤 요율표로 가격을 매기는 `exact` 또는 `estimated` 견적은, 해당 일정표를 읽은 날짜가 요율표보다 이르면 그 날짜를 담습니다. 요율표와 일정표 모두 읽지 않은 경우에는 예상치를 응답한 시점입니다. 이는 가격 고정이 아닙니다. 실행은 요율이 적용되는 시점에 유효한 요율로 청구됩니다. - `/estimate`는 `model_provider`가 지정한 레그 또는 기본 공급자의 견적을 제시합니다. `fallback_provider`나 `strict_mode` 매개변수는 받지 않습니다. 폴백 재시도가 다른 공급자에 도달한 동기 실행은 예상치가 제시하지 않았던 그 공급자의 요율로 청구되며, 실행 응답의 `X-Comfy-Router-Fallback-Provider`가 그런 일이 있었음을 알려줍니다. 대기 중 제출에는 폴백이 없으므로 그 `estimate`는 실제 실행되는 레그의 견적을 제시합니다. - `/estimate`와 대기 중 제출의 `estimate`는 `model_provider` 레그에서 또는 형제 작업에서 실행되는 본문의 경우 동일한 본문에 대해 약간 다른 문서를 가격 산정할 수 있습니다. 제출의 `estimate`는 실행이 전송하는 문서를 기준으로 산정됩니다. - `/estimate`는 항상 플랫폼 청구액의 견적을 제시합니다. 자체 공급자 키로 실행하면 Comfy는 청구하지 않지만, `/estimate`는 이를 감지하지 못하고 여전히 금액을 반환합니다. `reason: byok`를 응답하는 것은 대기 중 제출뿐입니다.- 달러는 반올림되지 않은 센트 값을 기준으로 소수점 이하 최대 8자리까지 표시되며, 청구 가능한 1센트 미만의 `amount`는 절대 `0`으로 표시되지 않습니다. `credits`는 `round(amount × 211, 2)`이며, 이는 `X-Comfy-Credits-Used`가 청구 금액에 적용하는 것과 동일한 변환입니다. 따라서 매우 작은 0이 아닌 가격에서는 `credits`가 `0`으로 반올림될 수 있습니다. 이 점이 중요할 때는 `credits`가 아니라 `amount` 또는 `amount_cents`를 기준으로 예산을 책정하세요. 해당 헤더는 한 번의 실행에 대한 사후 수치로 남습니다. 잔액은 Comfy 플랫폼에 있습니다. @@ -1016,7 +1016,7 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 | `minimax/*` | 완료된 비디오 | 12시간 | | `xai/*` | 생성된 모든 이미지, 그리고 완료된 비디오 | 24시간 | -이 수명은 URL에 서명될 때 시작되며, URL을 열 때 시작되는 것이 아닙니다. 캐시되었거나 재생된 URL은 남은 시간이 더 적을 수 있으며, 재생해도 수명이 갱신되지 않습니다. 에셋을 즉시 다운로드하세요. 각 행에 명시된 에셋만 복사됩니다. `byteplus/seedream-*` 및 `byteplus/seededit-*` 이미지는 BytePlus 비디오 행에 포함되지 않습니다. +이 수명은 URL에 서명될 때 시작되며, URL을 열 때 시작되는 것이 아닙니다. 캐시되었거나 재생된 URL은 남은 시간이 더 적을 수 있으며, 재생해도 수명이 갱신되지 않습니다. `Idempotency-Key` 기록은 보유한 URL보다 오래 유지될 수 있으므로, 해당 URL이 만료되기 1시간 전부터 같은 키로 재시도하면 기록된 응답 대신 `409 invalid_input`이 응답됩니다. 응답이 반환될 때 이미 그만큼 만료에 가까웠던 경우에는 5분 동안 재생할 수 있습니다. 에셋을 즉시 다운로드하세요. 각 행에 명시된 에셋만 복사됩니다. `byteplus/seedream-*` 및 `byteplus/seededit-*` 이미지는 BytePlus 비디오 행에 포함되지 않습니다. 복사는 해당 모델의 네이티브 공급자만 수행합니다. 대체 공급자가 처리한 실행, 즉 `model_provider`가 대체 공급자를 지정한 경우나 폴백 재시도가 대체 공급자에 도달한 네이티브 실행(`X-Comfy-Router-Fallback-Provider`로 공개됨)은 해당 공급자 자체의 URL을 반환하며, 이 URL은 공급자의 만료 정책을 따르고 복사되지 않습니다. `model_provider` 값 `default`, `comfy`, `comfyui`는 대체 공급자를 지정하지 않으므로 해당 실행은 네이티브이며 위와 같이 복사됩니다. 폴백 재시도가 다시 네이티브 공급자에 도달한 `model_provider` 실행도 마찬가지입니다. @@ -1123,7 +1123,7 @@ Type: `string` - 이 견적을 산정한 요율표를 가져온 시점입니다. 이 추정치는 가격 고정이 아닙니다. 실행은 이 시점이 아니라 실행이 요율 산정되는 시점에 유효한 요율로 청구됩니다. 공급자의 공개 가격표에서 가져온 `estimated` 견적(공급자가 보고하는 비용으로 청구되는 모델)의 경우에는 대신 해당 가격표를 읽은 날짜가 담깁니다. 청구 수량을 그 가격표에서 예측한 뒤 요율표로 가격을 매기는 견적(공급자가 보고하는 크레딧으로 청구되는 모델)의 경우에는 두 날짜 중 이른 날짜가 담깁니다. 어떤 요율표도 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 가격을 매길 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시점입니다. + 이 견적을 산정한 요율표를 가져온 시점입니다. 이 추정치는 가격 고정이 아닙니다. 실행은 이 시점이 아니라 실행이 요율 산정되는 시점에 유효한 요율로 청구됩니다. 공급자의 공개 가격표에서 가져온 `estimated` 견적(공급자가 보고하는 비용으로 청구되는 모델)의 경우에는 대신 해당 가격표를 읽은 날짜가 담깁니다. 청구 수량을 공급자의 공개 일정표에서 예측한 뒤 요율표로 가격을 매기는 견적은 `exact` 답변이든 `estimated` 답변이든 해당 일정표를 읽은 날짜와 요율표를 가져온 시점 중 이른 날짜를 담습니다(공급자가 보고하는 크레딧으로 청구되는 모델이 `estimated`인 경우입니다). 어떤 요율표도 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 가격을 매길 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시점입니다. date-time 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 diff --git a/zh/development/comfy-router/api.mdx b/zh/development/comfy-router/api.mdx index 63a66aff1a..b8db6daf9f 100644 --- a/zh/development/comfy-router/api.mdx +++ b/zh/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 概览" sidebarTitle: "概览" description: "Comfy Router API 的工作方式:每个模型 ID 对应一个路由,并提供关于发现模型、schema、排队请求、错误和计费的指南。" -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx - [快速开始](/zh/development/comfy-router/quickstart):安装、调用以及保存图像。 - [模型](/zh/development/comfy-router/models):浏览目录并查看各模型专属的请求示例。 - [请求头](/zh/development/comfy-router/headers):身份验证、幂等性、请求 ID 以及重试节奏。 -- [API 参考](/zh/development/comfy-router/reference):端点参数、schema 以及响应码。 \ No newline at end of file +- [API 参考](/zh/development/comfy-router/reference):端点参数、schema 以及响应码。 +- [实时语音](/zh/development/comfy-router/realtime):打开 Grok Voice 的 WebSocket 会话,按秒计费。 diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index f580a19c68..c445523018 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 的能力与限制" sidebarTitle: "能力与限制" description: "选择 Comfy Router 还是合作伙伴代理,为长时间运行的调用做好规划,并了解恢复、速率限制与资产存储。" -translationSourceHash: 235802c5 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": cf6e2050 - "Models without a pre-flight estimate": 495bdb2b + "Models without a pre-flight estimate": f6dfd921 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -116,21 +116,17 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价, {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} - **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **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` +- **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` -- **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` - **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` - **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/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 */} diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 4ddd53b499..763dfe84b5 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "使用 Dreamina Seedance 2.0 260128 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-260128:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 9604ca27 +translationSourceHash: 70ec471f translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 6c5da06a + "Schema": 8c0478c9 "Examples": 641c458b --- @@ -287,10 +287,10 @@ Comfy 侧的保护措施,并非 BytePlus 的限制。BytePlus 未公布文本 将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 范围:`2` 到 `30` + 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index e3b70a93fc..5ab516fef8 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,12 @@ title: "使用 Comfy Router 调用 Dreamina Seedance 2.0 Fast 260128" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-fast-260128:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: b02c6ed1 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": e03c503a + "Schema": 90b60b2e "Examples": 7714eccd --- @@ -271,10 +271,10 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 范围:`2` 到 `30` + 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 6995497779..d1474a43f1 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Dreamina Seedance 2.0 Mini" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-mini:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 28c5c053 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 3c26a330 + "Schema": ebf1fc3a "Examples": db01067e --- @@ -278,10 +278,10 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; 将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 范围:`2` 到 `30` + 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 6b83dea46c..1aacbc9334 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,13 +2,13 @@ title: "使用 Dreamina Seedance 2.5 260628 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-5-260628:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 07fd9c64 +translationSourceHash: 3606fb83 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0a76af44 + "Schema": d2c28a84 "Examples": 5465695b --- @@ -291,10 +291,10 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 在 `draft_task` 内容项中传入返回的任务 ID,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 与 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动)。 - 范围:`2` 到 `30` + 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 13ad884815..abebaade7b 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,12 +2,12 @@ title: "将 Seedance 1.0 Pro 250528 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-250528:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 450bbe6e +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": fc979e05 + "Schema": b57b84de "Examples": 815d621e --- @@ -279,10 +279,10 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; 将返回的任务 ID 传入 `draft_task` 内容项以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 1.0 pro 和 1.0 pro fast:[2,12]。 - 范围:`2` 至 `30` + 可能的值:`2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 573d9a16e9..e2daccec1b 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,12 +2,12 @@ title: "使用 Comfy Router 调用 Seedance 1.0 Pro Fast 251015" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-fast-251015:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 43683424 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": a882b2d8 + "Schema": dd74b012 "Examples": 1469ab97 --- @@ -271,10 +271,10 @@ Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本 将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 1.0 pro 和 1.0 pro fast:[2,12]。 - 范围:`2` 到 `30` + 可能的值:`2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 42cabe70ab..c1747d7edb 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Seedance 1.5 Pro 251215" description: "通过 Comfy Router 调用 byteplus/seedance-1-5-pro-251215:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 1d016721 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 35f3b5dc + "Schema": f4d67fb6 "Examples": 7e73ac5c --- @@ -274,10 +274,10 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。草稿任务 ID 的有效期为 7 天。 - - 视频时长,以秒为单位。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 1.5 pro:[4,12] 或 -1(自动)。 - 范围:`2` 至 `30` + 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index 05ce84cd96..8c3d2f1438 100644 --- a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -2,13 +2,13 @@ title: "通过 Comfy Router 使用 Kling 3.0 Turbo" description: "通过 Comfy Router 调用 kling/kling-3.0-turbo:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling 3.0 Turbo" -translationSourceHash: 301a1ee1 +translationSourceHash: d03a4ba5 translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx translationBlockHashes: "_intro": 5a8c5f4b "Quick start": a2145573 "Serving providers": 7ec93d4f - "Schema": 1f5f61c1 + "Schema": 4ec53894 "Examples": 0a9a8bbe --- @@ -195,11 +195,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 任务结果回调通知 URL。当任务状态发生变化时,服务器会发送通知。 + 任务结果回调通知 URL。当任务状态发生变化时,服务器会发送通知。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 - 自定义任务 ID。不会覆盖系统生成的任务 ID,但可用于查询。在单个用户账号内必须唯一。 + 自定义任务 ID。不会覆盖系统生成的任务 ID,但可用于查询。在单个用户账号内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx index e3731aac5b..ab61565876 100644 --- a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -2,12 +2,12 @@ title: "使用 Comfy Router 调用 Kling Image O1" description: "通过 Comfy Router 调用 kling/kling-image-o1:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling Image O1" -translationSourceHash: cf053382 +translationSourceHash: 0d76917c translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx translationBlockHashes: "_intro": 513c65df "Quick start": 6256a30d - "Schema": d18a5393 + "Schema": 61821697 "Examples": 826db173 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 此任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。 + 此任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 格式:`uri` @@ -182,7 +182,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账户内必须唯一。 + 自定义任务 ID。在单个用户账户内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index 711df496fd..d2bbe9ca65 100644 --- a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,12 +2,12 @@ title: "将 Kling V2.5 Turbo 与 Comfy Router 搭配使用" description: "通过 Comfy Router 调用 kling/kling-v2-5-turbo:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1a5ec6e5 +translationSourceHash: 1671e7b6 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 2495a4d3 "Quick start": dc63b3ac - "Schema": 68d50e72 + "Schema": 3bcb036e "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 回调通知地址 + 回调通知地址 已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 格式:`uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 自定义任务 ID + 自定义任务 ID 已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx index ccfd89e64f..ede7b09dd0 100644 --- a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Kling V2.6" description: "通过 Comfy Router 调用 kling/kling-v2-6:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V2.6" -translationSourceHash: 1e64e957 +translationSourceHash: c445a7bd translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": 04868509 "Quick start": 48a3d970 - "Schema": 9d23ff94 + "Schema": a61a551f "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 回调通知地址 + 回调通知地址 已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 格式:`uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 自定义任务 ID + 自定义任务 ID 已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx index 9bbff5063b..3e932df4e1 100644 --- a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Kling V3 Omni" description: "通过 Comfy Router 调用 kling/kling-v3-omni:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling V3 Omni" -translationSourceHash: 226ee8a6 +translationSourceHash: 29d1799c translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": f9b37353 + "Schema": 68bd0500 "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 本任务结果的回调通知地址。若配置此项,任务状态发生变化时服务器将主动通知。 + 本任务结果的回调通知地址。若配置此项,任务状态发生变化时服务器将主动通知。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 格式:`uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。 + 自定义任务 ID。在单个用户账号内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-v3/code.mdx b/zh/development/comfy-router/models/kling/kling-v3/code.mdx index 614cc72b20..c88f42fa94 100644 --- a/zh/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,13 +2,13 @@ title: "通过 Comfy Router 使用 Kling V3" description: "通过 Comfy Router 调用 kling/kling-v3:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V3" -translationSourceHash: ecfa3f9b +translationSourceHash: e07d4035 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 74a12e0f "Quick start": 09c0a41a "Serving providers": a8b20c72 - "Schema": 77550c0a + "Schema": 8e8b04e6 "Examples": 8623c725 --- @@ -177,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 回调通知地址 + 回调通知地址 已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 格式:`uri` @@ -247,7 +247,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 自定义任务 ID + 自定义任务 ID 已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx index 1fd6d2c0a4..550f454ff5 100644 --- a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,12 +2,12 @@ title: "将 Kling Video O1 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 kling/kling-video-o1:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling Video O1" -translationSourceHash: 3c228231 +translationSourceHash: 892ccf77 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": 6f4cf55b + "Schema": f693e2ef "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 本任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。 + 本任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 格式:`uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。 + 自定义任务 ID。在单个用户账号内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index f59763d31c..1c74914be3 100644 --- a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -2,12 +2,12 @@ title: "配合 Comfy Router 使用 Videos Avatar Image 2video" description: "通过 Comfy Router 调用 kling/videos-avatar-image2video:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Videos Avatar Image 2video" -translationSourceHash: 444b1395 +translationSourceHash: 5181e917 translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx translationBlockHashes: "_intro": baca1542 "Quick start": 5605d33f - "Schema": eeb06fe1 + "Schema": 073bf8b2 "Examples": ce6803dd --- @@ -164,13 +164,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - 本任务结果的回调通知地址。 + 本任务结果的回调通知地址。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 格式:`uri` - 自定义任务 ID。在单个用户账户内必须唯一。 + 自定义任务 ID。在单个用户账户内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx index de571505d6..ae5c95a754 100644 --- a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用视频唇形同步" description: "通过 Comfy Router 调用 kling/videos-lip-sync:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "视频唇形同步" -translationSourceHash: ddd2a405 +translationSourceHash: 6103bea9 translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx translationBlockHashes: "_intro": 0477697a "Quick start": e13a4628 - "Schema": 90571e9f + "Schema": 4fb7c777 "Examples": d1dd6ed8 --- @@ -176,7 +176,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 输入 - 回调通知地址。任务状态发生变化时,服务器会发出通知。 + 回调通知地址。任务状态发生变化时,服务器会发出通知。已忽略。comfy-api 会在转发前丢弃该字段,由 Comfy Router 代你轮询。 格式:`uri` diff --git a/zh/development/comfy-router/models/runway/gen4-image/code.mdx b/zh/development/comfy-router/models/runway/gen4-image/code.mdx index 4c11d24ba8..5eedc8a457 100644 --- a/zh/development/comfy-router/models/runway/gen4-image/code.mdx +++ b/zh/development/comfy-router/models/runway/gen4-image/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Gen 4 Image" description: "通过 Comfy Router 调用 runway/gen4_image:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Gen 4 Image" -translationSourceHash: c5792f5c +translationSourceHash: 51dc9815 translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx translationBlockHashes: "_intro": f3b89ce9 "Quick start": 82a202eb - "Schema": d889abf3 + "Schema": 1160ec6d "Examples": 291dbf54 --- @@ -168,7 +168,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \ - 包含编码图像的 HTTPS URL 或 data URI + 包含编码图像的 HTTPS URL、Runway 上传 URI(runway://)或 data URI 由 Router 在 `GET /v2/models/runway/gen4_image/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前它用于校验调用的同一份文档。 diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index e5f33d3207..309178558b 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,12 +2,12 @@ title: "将 Grok Imagine Image 2.0 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 xai/grok-imagine-image-2.0:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: 83fe91a1 +translationSourceHash: e062dc40 translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: "_intro": 614e2e15 "Quick start": ff9945c8 - "Schema": faf9e081 + "Schema": cb29dfae "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES - 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位(low/medium;medium 为默认值);其他模型目前会忽略此项。 + 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,编辑时使用 medium)。其他模型会忽略此项。 - 可选值:`low`、`medium`、`high` + 可能的值:`low`、`medium`、`high`、`auto` diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index f2ce00dd3e..57bfe834b7 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,12 +2,12 @@ title: "配合 Comfy Router 使用 Grok Imagine Image Pro" description: "通过 Comfy Router 调用 xai/grok-imagine-image-pro:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: 7932bb72 +translationSourceHash: 773b1560 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: "_intro": 97d341e4 "Quick start": 3a4bd585 - "Schema": 5d56d158 + "Schema": 805c771c "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位(low/medium;默认为 medium);其他模型目前会忽略该项。 + 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,编辑时使用 medium)。其他模型会忽略此项。 - 可选值:`low`、`medium`、`high` + 可能的值:`low`、`medium`、`high`、`auto` diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index 11a69c5911..67e5aebd4e 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,12 +2,12 @@ title: "配合 Comfy Router 使用 Grok Imagine Image Quality" description: "通过 Comfy Router 调用 xai/grok-imagine-image-quality:端点、请求结构与 Router 返回的响应。" sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 923968d2 +translationSourceHash: 9f6e16d5 translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: "_intro": 72081c22 "Quick start": 799275b8 - "Schema": e0fcef44 + "Schema": e2c96ff6 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位(low/medium;默认 medium);其他模型目前会忽略该项。 + 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,编辑时使用 medium)。其他模型会忽略此项。 - 可选值:`low`、`medium`、`high` + 可能的值:`low`、`medium`、`high`、`auto` diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 50889fad9d..70f243a657 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,12 +2,12 @@ title: "使用 Grok Imagine Image 与 Comfy Router" description: "通过 Comfy Router 调用 xai/grok-imagine-image:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image" -translationSourceHash: 9cfb938a +translationSourceHash: 2e5c55ad translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: "_intro": a2e97c88 "Quick start": a5495331 - "Schema": 1d17b83a + "Schema": 171da7d5 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位(low/medium;默认为 medium);其他模型目前会忽略该参数。 + 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,编辑时使用 medium)。其他模型会忽略此项。 - 可能的值:`low`, `medium`, `high` + 可能的值:`low`, `medium`, `high`, `auto` diff --git a/zh/development/comfy-router/realtime.mdx b/zh/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..dae580edb5 --- /dev/null +++ b/zh/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Comfy Router 实时语音会话" +sidebarTitle: "实时语音" +description: "通过 Comfy Router 开启 Grok Voice 实时 WebSocket 会话:端点、身份验证、按秒计费、会话限制,以及可能遇到的错误和关闭代码。" +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 会中继一段由 fal 提供的、与 xAI Grok Voice 之间的实时语音到语音会话。你只需使用自己的 Comfy API 密钥,向 Router 建立一个 WebSocket 连接。Router 会校验你的账户与积分,在上游开启会话,随后双向中继事件。会话按秒计费,费用从你的 Comfy 积分中扣除。 + +## 端点 + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +该请求是一个 WebSocket 升级(`GET` 请求,带有 `Connection: Upgrade` 和 `Upgrade: websocket`)。其他请求一律以 `426` 拒绝。 + +## 身份验证 + +在升级请求的头部中携带你的 Comfy API 密钥,可以是 `X-API-Key: comfyui-...`,也可以是 `Authorization: Bearer comfyui-...`。Router 不会从查询字符串或 WebSocket 子协议中读取密钥。 + + +浏览器无法为 WebSocket 设置头部,而且 Comfy API 密钥绝不能出现在浏览器中。请从你的服务器打开会话,并自行将音频转发到浏览器。 + + +## 连接 + +升级成功后,发送并接收 xAI 在 Grok Voice 文档中说明的实时事件。此示例配置会话、发送一轮文本,并打印它收到的每个事件类型。 + + + +```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 # fal 自己的 x-fal-message 帧 + 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) => { + // 升级被拒绝。JSON 正文说明了原因。 + 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; // fal 自己的 x-fal-message 帧 + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +完成后立即关闭套接字。计费会持续到会话关闭,而不是到最后一次响应。 + +## 事件 + +Router 不定义自己的事件协议。服务器事件会完全按照 fal 发送的原样到达你这里,Router 接受的客户端事件也会被原样转发。关于事件列表、会话字段、语音和音频格式,请参阅: + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) 以及 xAI 的 [realtime 事件 schema](https://docs.x.ai/voice-realtime.ws.json) +- fal 的 [Grok Voice realtime 模型页面](https://fal.ai/models/xai/grok-voice/realtime) 及其 [API 页面](https://fal.ai/models/xai/grok-voice/realtime/api) + +请像示例中那样,把每个客户端事件作为一条 msgpack 二进制消息发送。这是 fal 的 realtime 客户端所使用的帧格式,模型的事件也会以相同方式返回,即同样是以 `session.created` 开头的 msgpack 二进制消息。fal 还会发送自己的 JSON 文本消息,类型为 `x-fal-message`(计时信息),你可以跳过它们。Router 的检查也接受以单条 JSON 文本消息形式发送的客户端事件,但除非你已经用你的客户端测试过 JSON,否则请使用 msgpack。 + +Router 会在转发每个客户端事件之前先对其进行检查: + +- **事件类型:** `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`,以及 fal 的 `x-fal-session.configure`。 +- **模型:** `session.update` 中的 `model` 必须是 `grok-voice-latest`、`grok-voice-3.0` 或 `grok-voice-2.0`。 +- **工具:** 允许使用由你的客户端执行的函数工具。服务器端工具(Web 搜索、X 搜索、文件搜索和 MCP)会被拒绝。 +- **媒体:** 图像和视频输入会被拒绝。会话仅支持语音和文本。 +- **大小:** 单条客户端消息最大为 1 MiB。 + +被拒绝的事件不会被转发,Router 会以关闭码 `1008` 关闭会话。 + +## 定价 + +一次会话的费用为**每秒 $0.0011869**(约每分钟 $0.0712,或每秒 0.2504 积分,约每分钟 15.0 积分,按 211 积分 = 1 美元计算)。会话开启期间按 15 秒的增量计费,最后一个不足 15 秒的增量按秒计费并向上取整。计费从升级时开始,直到 socket 关闭为止,无论期间是否有音频传输。 + +## 限制 + +| 限制项 | 值 | +| --- | --- | +| 每账户会话数 | 同一时间只能有一个打开的会话。打开第二个会话会返回 `429`,错误码为 `router.realtime.session_already_live`。 | +| 会话时长 | 最长 30 分钟,且绝不会超过连接时你的积分余额所能覆盖的时长。 | +| 会话期间的积分 | Router 每 15 秒重新检查一次你的余额,当余额不足以覆盖下一秒时便会结束会话。 | +| 连接速率 | 每次升级尝试都计入你的[按调用方请求速率](/zh/development/comfy-router/limitations#请求按调用方进行速率限制),并与其他 Router 调用共享该额度。 | + +当会话达到时间上限或积分已用完时,连接可能会在没有关闭帧的情况下关闭(通常表现为关闭码 `1006`)。请在充值之后再重新连接,或者如果需要更多时间,请启动一个新会话。 + +## 错误 + +### 升级之前 + +如果 Router 拒绝连接,它会返回 HTTP 状态码和 JSON 响应体,而不是切换协议: + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +请根据 `code` 进行判断;`detail` 是供人阅读的。 + +| 状态码 | `code` | 原因 | 处理方式 | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | 该请求不是 WebSocket 升级请求。 | 使用 WebSocket 客户端连接。 | +| `401` | `router.realtime.unauthorized` | API 密钥缺失或无效。 | 在 `X-API-Key` 或 `Authorization: Bearer` 中发送有效密钥。 | +| `402` | `router.realtime.insufficient_credits` | 你的余额不足以支付至少一秒的会话费用。 | 添加积分,然后重新连接。 | +| `402` | `router.realtime.spend_denied` | 本次会话将扣费的钱包没有足够资金。响应体中的 `denied_reason` 和 `billed_workspace` 会说明是哪个钱包。 | 向该工作区添加积分,然后重新连接。 | +| `403` | `router.realtime.provider_disabled` | 你的工作区的合作伙伴提供商策略不允许使用此提供商。 | 请工作区管理员允许使用该提供商。 | +| `404` | `router.realtime.model_not_allowed` | URL 中的模型不可用于实时会话。 | 检查 URL。 | +| `429` | `router.realtime.rate_limited` | 你超过了请求速率限制。 | 等待 `Retry-After`,然后重试。 | +| `429` | `router.realtime.session_already_live` | 你的账户已打开另一个会话。 | 请先关闭该会话。 | +| `429` | `router.realtime.concurrency_limit` | 并发合作伙伴模型调用过多。 | 减少并发任务并重试。 | +| `502` | `router.realtime.upstream_refused`、`router.realtime.token_mint_failed` | 上游提供商未能打开会话。 | 使用退避策略重试。 | +| `503` | 任何其他 `router.realtime.*` 代码 | 实时会话暂时不可用。 | 使用退避策略重试。 | + +### 升级之后 + +| 关闭码 | 含义 | 处理方式 | +| --- | --- | --- | +| `1008` | 客户端事件被拒绝(见[事件](#事件))。 | 修正该事件。会话已结束。 | +| `1012` | Router 正在重启。 | 重新连接。新会话会启动,并从新的升级开始计费。 | +| `1006`(无关闭帧) | 通常是在会话达到时间限制或积分用完时客户端报告的结果。网络中断看起来也是如此。 | 添加积分或启动新会话。 | + +任何其他关闭码都来自 fal 或 xAI。请参阅[事件](#事件)下链接的文档。 + +## 下一步 + +- [计费](/zh/development/comfy-router/billing):Router 如何收费以及如何核对用量。 +- [错误与重试](/zh/development/comfy-router/errors):其他 Router 调用返回的错误分类。 +- [限制](/zh/development/comfy-router/limitations):请求速率及其他限制。 diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 51f1a1ee9a..b560e1fca8 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API 参考" description: "每个 Comfy Router 端点、参数、响应体和错误分类,均由 Comfy API 契约生成。" sidebarTitle: "API 参考" -translationSourceHash: a6f99965 +translationSourceHash: aee933a1 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": 222fd740 + "Endpoints": e0879d3c "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 5952af3f - "Result assets": 18fe6dad + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 - "Schemas": 984bd216 + "Schemas": c1245cc9 --- @@ -51,7 +51,7 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 **列出 Comfy Router 可以运行的模型。** -列出可用的模型 ID 和计费信息。当 `has_more` 为 `true` 时,使用 `next_cursor`。 +列出可用的模型 ID 和计费信息。当 `has_more` 为 true 时,使用 `next_cursor`。 **参数** @@ -307,7 +307,7 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 **在运行模型调用之前先为它定价,而无需实际运行。** -返回一个以美元计的预检估算,表示用此模型运行该请求体将产生的费用,其定价依据与实际运行计费所依据的同一份费率卡(若某模型按其供应商上报的成本计费,则改为依据供应商公布的价格表来估算)。这是估算值,而非最终费用:你实际支付的是工作区用量与账单记录中结算后的费用。请求体会先按模型的输入 schema 进行校验,校验方式与默认运行(未设置 `strict_mode`,也未设置 `reject_unknown_fields`)相同,因此未通过模型 schema 的请求体在此处和在运行时都会得到相同的 `422`;不会向任何提供商派发请求,也不会产生任何扣费。该结果并非价格锁定:它按 `pricing_as_of` 时点生效的费率计价,而一次运行则按计费时生效的费率收费。在该功能逐步推出的期间,此路由会返回 `403`,并带有 `error_type: not_enabled`。 +返回一个以美元计的预检估算,表示用此模型运行该请求体将产生的费用,其定价依据与实际运行计费所依据的同一份费率卡(若某模型按其供应商上报的成本计费,则改为依据供应商公布的价格表来估算)。这是估算值,而非最终费用:你实际支付的是工作区用量与账单记录中结算后的费用。请求体会先按模型的输入 schema 进行校验,校验方式与默认运行(未设置 `strict_mode`,也未设置 `reject_unknown_fields`)相同,因此未通过模型 schema 的请求体在此处和在运行时都会得到相同的 `422`;不会向任何提供商派发请求,也不会产生任何扣费。该结果并非价格锁定:它按 `pricing_as_of` 时点生效的费率计价,而一次运行则按计费时生效的费率收费。在该功能逐步推出的期间,此路由会返回 `403`,并带有 `error_type: not_enabled`;Router 尚无法运行的模型会返回同样的 `403`,但带有运行路由自身的 `detail`,因此请读取 `detail` 以区分两者。 **参数** @@ -998,7 +998,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ 估算的局限。一个 `200` 的数字并不代表该次运行一定会被接受,也不代表一定按该金额收费: - `/estimate` 不接受 `strict_mode` 或 `reject_unknown_fields`,因此只校验模型的原生约定:一个在 `strict_mode=true` 运行中按备用提供商自身 schema 可以接受的请求体,在这里可能得到 `422`;而某个未声明的顶层字段,在 `reject_unknown_fields=true` 的运行中会被拒绝,在这里却会被定价。Anthropic Messages 模型是例外:其 schema 允许未声明字段,因此 `reject_unknown_fields=true` 的运行不会拒绝任何字段,而估算只会为未声明的顶层字段 `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` 以及空的 `mcp_servers` 定价。任何其他未声明的顶层字段都会使其返回 `unknown`,并带有 `reason: not_quotable`。 -- `pricing_as_of` 是费率卡的获取时间;对于取自供应商公布价格表的 `estimated` 报价,它是读取该价格表的日期(两者都未读取时,则为估算作答的时间)。它不是价格锁定:运行按其被计费评级时生效的费率收费。 +- `pricing_as_of` 是费率卡的获取时间。取自供应商公布价格表的 `estimated` 报价携带的是读取该价格表的日期。计费数量由供应商公布的调度表预测、再按费率卡定价的 `exact` 或 `estimated` 报价,在该调度表的读取日期早于费率卡时携带该调度表的读取日期。费率卡与调度表都未读取时,它则是估算作答的时间。它不是价格锁定:运行按其被计费评级时生效的费率收费。 - `/estimate` 为 `model_provider` 指定的分支报价,或为原生提供商报价。它不接受 `fallback_provider` 或 `strict_mode` 参数。同步运行的回退重试落到另一个提供商时,按该提供商的费率计费,而该费率并非估算所报的费率;运行响应上的 `X-Comfy-Router-Fallback-Provider` 表明发生了这种情况。排队提交没有回退,因此其 `estimate` 报的就是实际运行的分支。 - 对于 `model_provider` 分支上的同一请求体,或对于在同级操作(sibling operation)上运行的请求体,`/estimate` 与排队提交的 `estimate` 可能为略有差异的文档定价。提交的 `estimate` 是按运行实际发送的文档定价的。 - `/estimate` 始终报出平台费用。使用自有提供商密钥的运行不由 Comfy 计费,但 `/estimate` 不会检测这一点,仍会返回一个数值;只有排队提交才会返回 `reason: byok`。- 美元金额由未舍入的美分渲染,最多保留 8 位小数,可计费的不足 1 美分的 `amount` 绝不会显示为 `0`。`credits` 为 `round(amount × 211, 2)`,这与 `X-Comfy-Credits-Used` 对一次收费所采用的换算相同,因此对于极小的非零价格,`credits` 可能舍入为 `0`;在这一点很重要时,请按 `amount` 或 `amount_cents` 编制预算,而不是按 `credits`。该响应头仍是某次运行结束后的事后数值;余额保存在 Comfy 平台上。 @@ -1014,7 +1014,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ | `minimax/*` | 已完成视频 | 12 小时 | | `xai/*` | 每一张已生成的图像,以及已完成视频 | 24 小时 | -这些有效期从 URL 签名时开始计算,而不是从你打开它时开始。缓存或重放的 URL 可能剩余时间更少;重放不会为其续期。请及时下载资产。只有每一行中列出的资产会被复制:`byteplus/seedream-*` 和 `byteplus/seededit-*` 图像不在 BytePlus 视频行的覆盖范围内。 +这些有效期从 URL 签名时开始计算,而不是从你打开它时开始。缓存或重放的 URL 可能剩余时间更少;重放不会为其续期。一条 `Idempotency-Key` 记录的有效期可能长于它所保存的 URL,因此在这样的 URL 到期前一小时起,使用同一键重试会得到 `409 invalid_input`,而不是记录中的响应;若某条响应在送达时就已如此接近到期,则它在 5 分钟内仍可重放。请及时下载资产。只有每一行中列出的资产会被复制:`byteplus/seedream-*` 和 `byteplus/seededit-*` 图像不在 BytePlus 视频行的覆盖范围内。 复制只由模型的原生提供商执行。由替代提供商提供服务的运行(`model_provider` 指定了某个替代提供商,或原生运行的回退重试落到了替代提供商上,并通过 `X-Comfy-Router-Fallback-Provider` 披露)会返回该提供商自己的 URL,这些 URL 遵循提供商的过期时间,不会被复制。`model_provider` 取值 `default`、`comfy` 和 `comfyui` 时不指定替代提供商,因此这些运行属于原生运行并按上述方式复制;`model_provider` 运行的回退重试落回原生提供商时也同样如此。 @@ -1121,7 +1121,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ - 本报价所依据的费率卡的获取时间。估算值不是价格锁定:运行按计费时生效的费率收费,而不是按这一时刻的费率。从供应商公布的价格表取得的 `estimated` 报价(按供应商报告的费用计费的模型)改为携带读取该价格表的日期;而计费数量由该价格表预测、再按费率卡定价的报价(按供应商报告的积分计费的模型)携带两者中较早的日期。只要没有读取任何费率卡(`reason: pricing_unavailable`、`byok`,或无法从任何卡定价的 `not_quotable` 调用),它就是回答该报价的时间。 + 本报价所依据的费率卡的获取时间。估算值不是价格锁定:运行按计费时生效的费率收费,而不是按这一时刻的费率。从供应商公布的价格表取得的 `estimated` 报价(按供应商报告的费用计费的模型)改为携带读取该价格表的日期;而计费数量由供应商公布的调度表预测、再按费率卡定价的报价,无论给出的是 `exact` 还是 `estimated` 答案,都携带该调度表的读取日期与费率卡获取时间中较早的一个(按供应商报告的积分计费的模型属于 `estimated` 情形)。只要没有读取任何费率卡(`reason: pricing_unavailable`、`byok`,或无法从任何卡定价的 `not_quotable` 调用),它就是回答该报价的时间。 date-time From afa946af03acac9b7a81a93a3123a4b3a04e6977 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 21:03:51 +0800 Subject: [PATCH 2/5] i18n: include the 10-31 batches (#2193, #2195) in the consolidated sync Their files are disjoint from the ones already here (35 es + 35 zh/ja/ko); the three overlapping pages keep the newer 11-01/11-02 translation. --- es/tutorials/3d/pixal3d.mdx | 51 +++--- es/tutorials/3d/trellis2.mdx | 35 ++-- es/tutorials/3d/triposplat.mdx | 41 ++--- .../controlnet/pose-controlnet-2-pass.mdx | 52 +++--- es/tutorials/flux/flux-1-fill-dev.mdx | 58 +++---- es/tutorials/flux/flux-1-kontext-dev.mdx | 46 ++--- es/tutorials/flux/flux-2-dev.mdx | 15 +- es/tutorials/flux/flux-2-klein.mdx | 50 +++--- es/tutorials/llm/gemma4/gemma4.mdx | 31 ++-- es/tutorials/llm/qwen/qwen3.mdx | 27 +-- es/tutorials/llm/qwen/qwen3_5.mdx | 39 +++-- .../partner-nodes/fishaudio/drama-3.mdx | 2 +- .../partner-nodes/fishaudio/fish-audio.mdx | 2 +- .../partner-nodes/fishaudio/prompt-guide.mdx | 108 ++++++------ .../topaz/image-enhance-bloom-2.mdx | 26 +-- es/tutorials/video/bytedance/bernini-r.mdx | 50 +++--- .../video/hunyuan/hunyuan-video-1-5.mdx | 44 ++--- es/tutorials/video/kandinsky/kandinsky-5.mdx | 33 ++-- es/tutorials/video/ltx/ltx-2-3.mdx | 158 +++++++++--------- es/tutorials/video/ltx/ltx-2-5-dfr.mdx | 30 ++-- es/tutorials/video/ltxv.mdx | 10 +- .../video/minimax/minimax-h3-fastvideo.mdx | 46 ++--- .../minimax/minimax-h3-fun-controlnet.mdx | 20 ++- .../video/minimax/minimax-h3-multiframe.mdx | 18 +- .../video/minimax/minimax-h3-prompt-guide.mdx | 9 +- es/tutorials/video/wan/fun-camera.mdx | 46 ++--- es/tutorials/video/wan/fun-control.mdx | 110 ++++++------ es/tutorials/video/wan/wan-animate-2.mdx | 53 +++--- es/tutorials/video/wan/wan-causal-forcing.mdx | 29 ++-- es/tutorials/video/wan/wan-move.mdx | 31 ++-- es/tutorials/video/wan/wan2-2-animate.mdx | 79 ++++----- es/tutorials/video/wan/wan2-2-fun-control.mdx | 75 +++++---- es/tutorials/video/wan/wan2-2-fun-inp.mdx | 87 +++++----- es/tutorials/video/wan/wan2_2.mdx | 72 ++++---- es/tutorials/video/zai/scail2.mdx | 40 +++-- .../models/kling/kling-3-0-turbo/code.mdx | 4 +- .../models/kling/kling-image-o1/code.mdx | 4 +- .../models/kling/kling-v2-5-turbo/code.mdx | 4 +- .../models/kling/kling-v2-6/code.mdx | 4 +- .../models/kling/kling-v3-omni/code.mdx | 4 +- .../models/kling/kling-v3/code.mdx | 4 +- .../models/kling/kling-video-o1/code.mdx | 4 +- .../kling/videos-avatar-image2video/code.mdx | 4 +- .../models/kling/videos-lip-sync/code.mdx | 2 +- ja/development/comfy-router/realtime.mdx | 75 +++++---- ko/development/comfy-router/limitations.mdx | 13 +- .../models/kling/kling-3-0-turbo/code.mdx | 4 +- .../models/kling/kling-image-o1/code.mdx | 4 +- .../models/kling/kling-v2-5-turbo/code.mdx | 4 +- .../models/kling/kling-v2-6/code.mdx | 4 +- .../models/kling/kling-v3-omni/code.mdx | 4 +- .../models/kling/kling-v3/code.mdx | 4 +- .../models/kling/kling-video-o1/code.mdx | 4 +- .../kling/videos-avatar-image2video/code.mdx | 4 +- .../models/kling/videos-lip-sync/code.mdx | 2 +- ko/development/comfy-router/queue.mdx | 2 +- ko/development/comfy-router/realtime.mdx | 61 +++---- zh/development/comfy-router/api.mdx | 2 +- zh/development/comfy-router/limitations.mdx | 13 +- .../models/kling/kling-3-0-turbo/code.mdx | 4 +- .../models/kling/kling-image-o1/code.mdx | 4 +- .../models/kling/kling-v2-5-turbo/code.mdx | 4 +- .../models/kling/kling-v2-6/code.mdx | 4 +- .../models/kling/kling-v3-omni/code.mdx | 4 +- .../models/kling/kling-v3/code.mdx | 4 +- .../models/kling/kling-video-o1/code.mdx | 4 +- .../kling/videos-avatar-image2video/code.mdx | 4 +- .../models/kling/videos-lip-sync/code.mdx | 2 +- zh/development/comfy-router/realtime.mdx | 73 ++++---- 69 files changed, 1029 insertions(+), 935 deletions(-) diff --git a/es/tutorials/3d/pixal3d.mdx b/es/tutorials/3d/pixal3d.mdx index 9a2aa2df41..d13f40b643 100644 --- a/es/tutorials/3d/pixal3d.mdx +++ b/es/tutorials/3d/pixal3d.mdx @@ -2,16 +2,18 @@ title: "Pixal3D en ComfyUI: modelos 3D PBR desde una sola imagen" description: "Convierte una imagen en un modelo 3D con textura en ComfyUI con Pixal3D, el modelo de imagen a 3D de Tencent ARC con materiales PBR completos." sidebarTitle: "Pixal3D" -translationSourceHash: 489b52d9 +translationSourceHash: 6524a7b2 translationFrom: tutorials/3d/pixal3d.mdx translationBlockHashes: "_intro": c3d2e1ee "How it works": 30b7a245 "Steps to run": 1a7d044c + "Model downloads": 890d9666 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Pixal3D** es un modelo abierto de imagen a 3D de Tencent ARC, presentado en SIGGRAPH 2026. Convierte una sola imagen en un recurso 3D de alta fidelidad con materiales PBR completos. +**Pixal3D** es un modelo de imagen a 3D de código abierto de Tencent ARC, presentado en SIGGRAPH 2026. Convierte una sola imagen en un recurso 3D de alta fidelidad con materiales PBR completos. La mayoría de los generadores nativos 3D sintetizan formas en un espacio canónico e inyectan señales de la imagen mediante atención, lo que deja ambiguas las asociaciones entre píxeles y 3D. Pixal3D, en cambio, usa generación alineada a píxeles: establece una correspondencia directa entre píxeles y 3D mediante retroproyección, de modo que el frente del modelo generado coincide 1:1 con tu imagen de entrada, sin texturas deformadas ni desalineadas. @@ -99,44 +101,44 @@ Este flujo de trabajo usa los modelos que se indican a continuación. Descárgal Pixal3D combina una generación consciente de la cámara y alineada por píxeles con un pipeline completo de posprocesamiento de malla: -1. **Eliminación de fondo**: BiRefNet elimina el fondo de la imagen de entrada y el flujo de trabajo recorta el sujeto a un lienzo centrado. Un interruptor te permite saltar la eliminación de fondo -2. **Estimación de cámara**: MoGe estima la geometría y el campo de visión de la cámara a partir de la imagen. El campo de visión impulsa el acondicionamiento alineado por píxeles -3. **Generación de estructura**: se muestrea un latente de estructura dispersa y se decodifica en vóxeles, que luego se convierten en una malla aproximada -4. **Refinamiento de forma**: la etapa de forma y la etapa de upsampling refinan la malla hasta la resolución objetivo (1536) -5. **Generación de texturas**: una etapa de difusión de texturas produce vóxeles de material PBR (color base, metalicidad, rugosidad) -6. **Posprocesamiento**: remesh DC, decimación QEM, desplegado UV y horneado de mapas de color base, normales y oclusión ambiental en la malla texturizada final +1. **Eliminación de fondo**: BiRefNet elimina el fondo de la imagen de entrada y el flujo de trabajo recorta el sujeto a un lienzo centrado. Un interruptor te permite saltar la eliminación de fondo. +2. **Estimación de la cámara**: MoGe estima la geometría y el campo de visión de la cámara a partir de la imagen. El campo de visión determina el acondicionamiento alineado por píxeles. +3. **Generación de la estructura**: se muestrea un latente de estructura dispersa y se decodifica en vóxeles, que luego se convierten en una malla aproximada. +4. **Refinamiento de la forma**: la etapa de forma y la etapa de upsampling refinan la malla hasta la resolución objetivo (1536). +5. **Generación de texturas**: una etapa de difusión de texturas produce vóxeles de material PBR (color base, metalicidad, rugosidad). +6. **Posprocesamiento**: remesh DC, decimación QEM, desplegado UV y horneado de mapas de color base, normales y oclusión ambiental en la malla texturizada final. -## Pasos para ejecutar +## Pasos para ejecutar {#steps-to-run} -1. **Carga una imagen**: usa el nodo `LoadImage` para cargar una sola imagen del objeto. -2. **Pon el flujo de trabajo en cola**: presiona Ctrl (Cmd en macOS) + Enter. -3. **Espera a que se complete el pipeline**: las etapas de estructura, forma y textura se ejecutan en secuencia, seguidas del posprocesamiento. -4. **Consulta el resultado**: revisa la malla en el nodo `Preview3DAdvanced`. El modelo 3D se guarda en `ComfyUI/output/3d/ComfyUI/`. +1. **Carga una imagen**: usa el nodo `LoadImage` para cargar una sola imagen del objeto +2. **Pon el flujo de trabajo en cola**: presiona Ctrl (Cmd en macOS) + Enter +3. **Espera a que se ejecute el pipeline**: las etapas de estructura, forma y textura se ejecutan en secuencia, seguidas del posprocesamiento +4. **Consulta el resultado**: revisa la malla en el nodo `Preview3DAdvanced`. El modelo 3D se guarda en `ComfyUI/output/3d/ComfyUI/` ## Descargas de modelos -Descarga los modelos que usa este flujo de trabajo. Los dos checkpoints de difusión son obligatorios: el interruptor elige cuál se ejecuta. Colócalos en los subdirectorios correspondientes de `models/`. +Descarga los modelos que usa este flujo de trabajo. Ambos checkpoints de difusión son requeridos: el selector determina cuál se ejecuta. Colócalos en los subdirectorios correspondientes de `models/`. - pixal3d_int8_convrot.safetensors: modelo de difusión de Pixal3D, cargado de forma predeterminada + pixal3d_int8_convrot.safetensors: modelo de difusión Pixal3D, que se carga de forma predeterminada - trellis_2_int8_convrot.safetensors: modelo de difusión de TRELLIS.2, cargado cuando el interruptor está en `true` + trellis_2_int8_convrot.safetensors: modelo de difusión TRELLIS.2, que se carga cuando el selector está en `true` - - trellis_2_shape_vae_bf16.safetensors: VAE para la decodificación de estructura y forma + + trellis_2_shape_vae_bf16.safetensors: VAE para decodificar estructura y forma - - trellis_2_texture_vae_bf16.safetensors: VAE para la decodificación de texturas + + trellis_2_texture_vae_bf16.safetensors: VAE para decodificar texturas - dino_v3_L_naf_fp32.safetensors: codificador de visión CLIP para el acondicionamiento de imágenes + dino_v3_L_naf_fp32.safetensors: codificador de visión CLIP para el acondicionamiento de imagen - - moge_2_vitl_normal_fp16.safetensors: estimación de profundidad y de cámara para el acondicionamiento alineado por píxeles + + moge_2_vitl_normal_fp16.safetensors: estimación de profundidad y cámara para el acondicionamiento alineado a píxeles - + birefnet.safetensors: modelo de eliminación de fondo para el preprocesamiento @@ -159,3 +161,4 @@ Descarga los modelos que usa este flujo de trabajo. Los dos checkpoints de difus │ └── 📂 background_removal/ │ └── birefnet.safetensors ``` + diff --git a/es/tutorials/3d/trellis2.mdx b/es/tutorials/3d/trellis2.mdx index 4c1c2c761c..326da728f4 100644 --- a/es/tutorials/3d/trellis2.mdx +++ b/es/tutorials/3d/trellis2.mdx @@ -2,18 +2,20 @@ title: "TRELLIS.2 en ComfyUI: imagen a modelos 3D con texturas PBR" description: "Convierte una sola imagen en un modelo 3D con textura en ComfyUI con TRELLIS.2, el modelo open source de 4B de Microsoft, junto a Pixal3D en un mismo flujo." sidebarTitle: "TRELLIS.2" -translationSourceHash: 3e73a8a0 +translationSourceHash: ec22c0fe translationFrom: tutorials/3d/trellis2.mdx translationBlockHashes: "_intro": 5168e8d6 "How it works": e79c0e78 "Steps to run": f899f7e5 + "Model downloads": 125142da --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**TRELLIS.2** es un modelo de imagen a 3D de código abierto de Microsoft Research y el sucesor de TRELLIS. Es un modelo de 4B parámetros construido sobre VAE 3D nativos con compresión espacial de 16× y una representación de vóxeles dispersos llamada O-Voxel, que produce recursos 3D detallados con materiales PBR completos a partir de una sola imagen. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' -TRELLIS.2 comparte su arquitectura base con Pixal3D: ambos usan el mismo codificador de imágenes DINOv3, los mismos VAE de forma y textura, y las mismas etapas de generación de estructura, forma y textura. Solo cambian el modelo de difusión principal y el formato de acondicionamiento. Si ya has ejecutado el [flujo de trabajo de Pixal3D](/es/tutorials/3d/pixal3d), la configuración del modelo es casi idéntica. +**TRELLIS.2** es un modelo de código abierto de imagen a 3D de Microsoft Research y el sucesor de TRELLIS. Es un modelo de 4B parámetros construido sobre VAE 3D nativos con compresión espacial de 16× y una representación de vóxeles dispersos llamada O-Voxel, que produce recursos 3D detallados con materiales PBR completos a partir de una sola imagen. + +TRELLIS.2 comparte su arquitectura base con Pixal3D: ambos usan el mismo codificador de imágenes DINOv3, los mismos VAE de forma y textura, y las mismas etapas de generación de estructura, forma y textura. Solo difieren el modelo de difusión principal y el formato de acondicionamiento. Si ya has ejecutado el [flujo de trabajo de Pixal3D](/es/tutorials/3d/pixal3d), la configuración del modelo es casi idéntica. ### TRELLIS.2: modelo 3D a partir de una imagen {#trellis2} @@ -50,11 +52,11 @@ Sube este archivo al nodo `LoadImage`: ## Cómo funciona -TRELLIS.2 genera un recurso 3D en tres etapas de difusión y luego ejecuta un pipeline completo de posprocesamiento de la malla: +TRELLIS.2 genera un recurso 3D en tres etapas de difusión y después ejecuta un pipeline completo de posprocesamiento de la malla: 1. **Eliminación de fondo**: BiRefNet elimina el fondo de la imagen de entrada y el flujo de trabajo recorta el sujeto a un lienzo centrado. Un interruptor te permite saltar la eliminación de fondo 2. **Generación de estructura**: se muestrea un latente de estructura dispersa y se decodifica en vóxeles, que luego se convierten en una malla aproximada -3. **Refinamiento de forma**: la etapa de forma y la etapa de sobremuestreo refinan la malla hasta la resolución objetivo (1536) +3. **Refinamiento de forma**: la etapa de forma y la etapa de upsampling refinan la malla hasta la resolución objetivo (1536) 4. **Generación de textura**: una etapa de difusión de textura produce vóxeles de material PBR (color base, metalicidad, rugosidad) 5. **Posprocesamiento**: DC remesh, QEM decimation, UV unwrapping y baking de mapas de color base, normal y oclusión ambiental en la malla texturizada final @@ -63,30 +65,30 @@ TRELLIS.2 genera un recurso 3D en tres etapas de difusión y luego ejecuta un pi 1. **Carga una imagen**: usa el nodo `LoadImage` para cargar una sola imagen del objeto 2. **Cambia al pipeline de TRELLIS.2**: establece `Boolean (Switch to Trellis2)` en `true`. El flujo de trabajo carga el checkpoint de TRELLIS.2 automáticamente 3. **Envía el flujo de trabajo a la cola**: presiona Ctrl (Cmd en macOS) + Enter -4. **Espera al pipeline**: las etapas de estructura, forma y textura se ejecutan en secuencia, seguidas del posprocesamiento -5. **Visualiza el resultado**: revisa la malla en el nodo `Preview3DAdvanced`. El modelo 3D se guarda en `ComfyUI/output/3d/ComfyUI/` +4. **Espera a que termine el pipeline**: las etapas de estructura, forma y textura se ejecutan en secuencia, seguidas del posprocesamiento +5. **Revisa el resultado**: inspecciona la malla en el nodo `Preview3DAdvanced`. El modelo 3D se guarda en `ComfyUI/output/3d/ComfyUI/` -## Descarga de modelos +## Descargas de modelos -Descarga los modelos que usa este flujo de trabajo. Los dos checkpoints de difusión son obligatorios: el interruptor elige cuál se ejecuta. Colócalos en los subdirectorios correspondientes de `models/`. +Descarga los modelos que usa este flujo de trabajo. Los dos checkpoints de diffusion son requeridos: el interruptor selecciona cuál se ejecuta. Colócalos en los subdirectorios correspondientes de `models/`. - trellis_2_int8_convrot.safetensors: modelo de difusión de TRELLIS.2, cargado cuando el interruptor está en `true` + trellis_2_int8_convrot.safetensors: modelo de diffusion de TRELLIS.2, se carga cuando el interruptor está en `true` - pixal3d_int8_convrot.safetensors: modelo de difusión de Pixal3D, cargado de forma predeterminada + pixal3d_int8_convrot.safetensors: modelo de diffusion de Pixal3D, se carga por defecto - + trellis_2_shape_vae_bf16.safetensors: VAE para la decodificación de estructura y forma - + trellis_2_texture_vae_bf16.safetensors: VAE para la decodificación de texturas - dino_v3_L_naf_fp32.safetensors: codificador de visión CLIP para el conditioning de imágenes. El dino_v3_vit_l.safetensors equivalente del repositorio TRELLIS.2 también funciona + dino_v3_L_naf_fp32.safetensors: codificador de visión CLIP para el acondicionamiento de imagen. El archivo equivalente dino_v3_vit_l.safetensors del repositorio de TRELLIS.2 también funciona - + birefnet.safetensors: modelo de eliminación de fondo para el preprocesamiento @@ -107,3 +109,4 @@ Descarga los modelos que usa este flujo de trabajo. Los dos checkpoints de difus │ └── 📂 background_removal/ │ └── birefnet.safetensors ``` + diff --git a/es/tutorials/3d/triposplat.mdx b/es/tutorials/3d/triposplat.mdx index f8f3124ab0..b133ff3c77 100644 --- a/es/tutorials/3d/triposplat.mdx +++ b/es/tutorials/3d/triposplat.mdx @@ -2,7 +2,7 @@ title: "TripoSplat en ComfyUI: imagen a Gaussian splat 3D" description: "Genera representaciones 3D Gaussian splat de alta calidad desde una sola imagen 2D con TripoSplat, con densidad y presupuesto controlables para el renderizado." sidebarTitle: "TripoSplat" -translationSourceHash: 453c982d +translationSourceHash: 12824fc1 translationFrom: tutorials/3d/triposplat.mdx translationBlockHashes: "_intro": 09a020f2 @@ -10,8 +10,10 @@ translationBlockHashes: "Workflow node guide": 83cd15a0 "Steps to run": 3bf53f69 "Output options": 9a1cc408 + "Model downloads": 33be821b --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' **TripoSplat** es un modelo de código abierto que genera representaciones de **Gaussian splat 3D** directamente a partir de una sola imagen 2D. Fue desarrollado por VAST-AI y publicado bajo una licencia de código abierto. @@ -50,12 +52,12 @@ Sube este archivo al nodo `LoadImage` correspondiente: ## Cómo funciona -TripoSplat usa una **arquitectura feed-forward** que toma una sola imagen RGB y predice directamente un conjunto de primitivas Gaussianas 3D. El pipeline implica: +TripoSplat usa una **arquitectura feed-forward** que toma una única imagen RGB y predice directamente un conjunto de primitivas gaussianas 3D. El pipeline incluye: 1. **Codificación de imagen**: la imagen de entrada se procesa con un codificador visual (DINOv2). 2. **Generación de triplanos**: las características se decodifican en una representación de triplanos. -3. **Predicción de Gaussianas**: se muestrea el triplano para producir los parámetros de las Gaussianas (posición, escala, rotación, opacidad, color). -4. **Renderizado**: las Gaussianas se renderizan desde puntos de vista arbitrarios mediante splatting diferenciable. +3. **Predicción de gaussianas**: se muestrea el triplano para producir los parámetros de las gaussianas (posición, escala, rotación, opacidad, color). +4. **Renderizado**: las gaussianas se renderizan desde puntos de vista arbitrarios mediante splatting diferenciable. Este flujo de trabajo usa un nodo Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y extender el flujo de trabajo. @@ -69,16 +71,16 @@ TripoSplat usa una **arquitectura feed-forward** que toma una sola imagen RGB y ### TripoSplat (subgrafo) -El nodo de subgrafo principal procesa la imagen y genera el splat gaussiano 3D. Parámetros expuestos: +El nodo principal del subgrafo procesa la imagen y genera el splat gaussiano 3D. Parámetros expuestos: | Parámetro | Predeterminado | Descripción | |---|---|---| | `switch` | N/D | Habilita o deshabilita el subgrafo | -| `num_gaussians` | N/D | Número de primitivas gaussianas a generar (controla calidad/rendimiento) | -| `seed` | N/D | Semilla aleatoria para reproducibilidad | +| `num_gaussians` | N/D | Número de primitivas gaussianas a generar (controla la calidad y el rendimiento) | +| `seed` | N/D | Semilla aleatoria para la reproducibilidad | | `unet_name` | N/D | Checkpoint del modelo diffusion TripoSplat | | `clip_name` | N/D | Modelo codificador de visión CLIP | -| `vae_name` | N/D | VAE para codificar/decodificar (2 entradas: una para el VAE principal y otra para el codificador) | +| `vae_name` | N/D | VAE para codificar y decodificar (2 entradas: una para el VAE principal y otra para el codificador) | | `bg_removal_name` | N/D | Modelo de eliminación de fondo | ### CreateCameraInfo @@ -88,7 +90,7 @@ El nodo de subgrafo principal procesa la imagen y genera el splat gaussiano 3D. ### RenderSplat - Renderiza el splat gaussiano en una imagen 2D desde el ángulo de cámara definido -- Parámetros: resolución de salida (predeterminado 1024×1024), configuraciones de calidad de imagen +- Parámetros: resolución de salida (predeterminada: 1024×1024), configuraciones de calidad de imagen ### SplatToMesh - Convierte el splat gaussiano en una malla (opcional) @@ -110,7 +112,7 @@ El nodo de subgrafo principal procesa la imagen y genera el splat gaussiano 3D. 1. **Carga una imagen**: usa el nodo **LoadImage** para cargar una sola imagen 2D 2. **Ejecuta el subgrafo TripoSplat**: el modelo generará una representación Gaussian splat -3. **Elige el formato de salida**: exporta como GLB, SPZ, video o renderiza a malla +3. **Elige el formato de salida**: exporta como GLB, SPZ, video o renderiza a una malla 4. **Consulta los resultados**: usa el archivo 3D creado o la vista previa renderizada ## Opciones de salida @@ -118,28 +120,28 @@ El nodo de subgrafo principal procesa la imagen y genera el splat gaussiano 3D. | Nodo | Formato | Caso de uso | |---|---|---| | **SaveGLB** | `.glb` | Formato de archivo 3D estándar, importable en software 3D | -| **SplatToFile3D** | `.spz` | Formato comprimido de Gaussian splat para un almacenamiento eficiente | +| **SplatToFile3D** | `.spz` | Formato comprimido de Gaussian splat para almacenamiento eficiente | | **RenderSplat** | Imagen 2D | Vista previa rápida del resultado desde cualquier ángulo | | **SplatToMesh** | Malla | Convierte a una malla tradicional para seguir editando | -## Descarga de modelos +## Descargas de modelos -Descarga el modelo de TripoSplat y los archivos necesarios. Colócalos en los subdirectorios correspondientes de `models/`. +Descarga el modelo TripoSplat y los archivos requeridos. Colócalos en las subcarpetas correspondientes de `models/`. - triposplat_fp16.safetensors: checkpoint del modelo de difusión de TripoSplat + triposplat_fp16.safetensors: checkpoint del modelo diffusion TripoSplat - + triposplat_vae_decoder_fp16.safetensors: decodificador VAE - + flux2-vae.safetensors: VAE de FLUX.2 para la codificación latente - + dino_v3_vit_h.safetensors: codificador de visión CLIP (DINOv2) - + birefnet.safetensors: modelo de eliminación de fondo para el preprocesamiento @@ -158,3 +160,4 @@ Descarga el modelo de TripoSplat y los archivos necesarios. Colócalos en los su │ └── 📂 background_removal/ │ └── birefnet.safetensors ``` + diff --git a/es/tutorials/controlnet/pose-controlnet-2-pass.mdx b/es/tutorials/controlnet/pose-controlnet-2-pass.mdx index bec3d42158..a3729380ad 100644 --- a/es/tutorials/controlnet/pose-controlnet-2-pass.mdx +++ b/es/tutorials/controlnet/pose-controlnet-2-pass.mdx @@ -2,16 +2,18 @@ title: "Pose ControlNet en ComfyUI: OpenPose y flujos de trabajo de dos pasadas" description: "Usa esqueletos de OpenPose para controlar la postura del personaje y afina el detalle con un flujo de trabajo de dos pasadas para imágenes grandes." sidebarTitle: "Pose ControlNet" -translationSourceHash: 88d83e4a +translationSourceHash: b939c04c translationFrom: tutorials/controlnet/pose-controlnet-2-pass.mdx translationBlockHashes: "Introduction to OpenPose": 3dd3b023 "ComfyUI 2-Pass Pose ControlNet Usage Example": 89bf8647 + "Explanation of the Pose ControlNet 2-Pass Workflow": 8396d044 "Advantages of 2-Pass Image Generation": fba5db79 --- + ## Introducción a OpenPose -[OpenPose](https://github.com/CMU-Perceptual-Computing-Lab/openpose) es un sistema de código abierto para la estimación de pose de varias personas en tiempo real, desarrollado por la Universidad Carnegie Mellon (CMU), que supone un avance significativo en el campo de la visión por computador. El sistema puede detectar simultáneamente a varias personas en una imagen y captura: +[OpenPose](https://github.com/CMU-Perceptual-Computing-Lab/openpose) es un sistema de código abierto para la estimación de pose de varias personas en tiempo real, desarrollado por la Universidad Carnegie Mellon (CMU), que supone un avance significativo en el campo de la visión por computadora. El sistema puede detectar simultáneamente a varias personas en una imagen y captura: - **Esqueleto corporal**: 18 puntos clave, incluidos cabeza, hombros, codos, muñecas, caderas, rodillas y tobillos - **Expresiones faciales**: 70 puntos clave faciales para capturar microexpresiones y contornos faciales @@ -29,21 +31,21 @@ En particular, con los modelos más antiguos de la serie Stable Diffusion 1.5, l Descarga la imagen del flujo de trabajo que aparece a continuación y arrástrala a ComfyUI para cargar el flujo de trabajo: -![Flujo de trabajo de ComfyUI - Pose ControlNet](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/controlnet/pose_controlnet_2_pass.png) +![Flujo de trabajo de ComfyUI: Pose ControlNet](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/controlnet/pose_controlnet_2_pass.png) -Las imágenes que contienen el JSON del flujo de trabajo en sus metadatos se pueden arrastrar directamente a ComfyUI o cargar con el menú `Workflows` -> `Open (ctrl+o)`. -Esta imagen ya incluye los enlaces de descarga de los modelos correspondientes, y al arrastrarla a ComfyUI se te pedirá automáticamente que descargues los modelos. +Las imágenes que contienen el JSON del flujo de trabajo en sus metadatos puedes arrastrarlas directamente a ComfyUI o cargarlas con el menú `Workflows` -> `Open (ctrl+o)`. +Esta imagen ya incluye los enlaces de descarga de los modelos correspondientes; al arrastrarla a ComfyUI, se te pedirá automáticamente que descargues los modelos. -Descarga la imagen que aparece a continuación, la cual usaremos como entrada: +Descarga la imagen que aparece a continuación, que usaremos como entrada: ![Imagen de entrada de pose de ComfyUI](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/controlnet/pose_controlnet_2_pass_input.png) ### 2. Instalación manual de los modelos -Si tu red no puede completar correctamente la descarga automática de los modelos correspondientes, intenta descargar manualmente los modelos que aparecen a continuación y colócalos en los directorios indicados: +Si tu red no puede completar correctamente la descarga automática de los modelos correspondientes, intenta descargar manualmente los modelos que aparecen a continuación y colócalos en los directorios especificados: - [control_v11p_sd15_openpose_fp16.safetensors](https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/blob/main/control_v11p_sd15_openpose_fp16.safetensors?download=true) @@ -65,22 +67,22 @@ ComfyUI/ ### 3. Ejecución del flujo de trabajo paso a paso -![Diagrama del flujo de trabajo Pose ControlNet de ComfyUI](/images/tutorial/controlnet/flow_diagram_pose_controlnet_2_pass.jpg) +![Diagrama del flujo de trabajo de Pose ControlNet en ComfyUI](/images/tutorial/controlnet/flow_diagram_pose_controlnet_2_pass.jpg) Sigue estos pasos según los marcadores numerados de la imagen: 1. Asegúrate de que `Load Checkpoint` pueda cargar **majicmixRealistic_v7.safetensors** 2. Asegúrate de que `Load VAE` pueda cargar **vae-ft-mse-840000-ema-pruned.safetensors** 3. Asegúrate de que `Load ControlNet Model` pueda cargar **control_v11p_sd15_openpose_fp16.safetensors** -4. Haz clic en el botón de selección del nodo `Load Image` para subir la imagen de entrada de pose proporcionada anteriormente, o usa tu propio mapa de esqueleto OpenPose +4. Haz clic en el botón de selección del nodo `Load Image` para subir la imagen de pose de entrada proporcionada anteriormente, o usa tu propio mapa de esqueleto OpenPose 5. Asegúrate de que `Load Checkpoint` pueda cargar **japaneseStyleRealistic_v20.safetensors** 6. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de la imagen -## Explicación del flujo de trabajo Pose ControlNet en dos pasadas +## Explicación del flujo de trabajo Pose ControlNet de dos pasadas -Este flujo de trabajo usa un enfoque de generación de imágenes en dos pasadas, que divide el proceso de creación de la imagen en dos fases: +Este flujo de trabajo utiliza un enfoque de generación de imágenes en dos pasadas, que divide el proceso de creación de la imagen en dos fases: -### Primera fase: generación de la imagen básica de la pose +### Primera fase: generación de la imagen de pose básica En la primera fase, el modelo **majicmixRealistic_v7** se combina con Pose ControlNet para generar una imagen inicial de la pose del personaje: @@ -90,29 +92,29 @@ En la primera fase, el modelo **majicmixRealistic_v7** se combina con Pose Contr 4. El primer nodo `KSampler` (normalmente con 20-30 pasos) genera una imagen básica de la pose del personaje 5. La imagen en espacio de píxeles de la primera fase se obtiene mediante `VAE Decode` -Esta fase se centra principalmente en la postura correcta del personaje, la pose y la estructura básica, asegurando que el personaje generado se ajuste a la pose del esqueleto de entrada. +Esta fase se centra principalmente en la postura, la pose y la estructura básica correctas del personaje, y asegura que el personaje generado se ajuste a la pose del esqueleto de entrada. -### Segunda fase: optimización del estilo y mejora de detalles +### Segunda fase: optimización de estilo y mejora de detalles -En la segunda fase, la imagen de salida de la primera fase se usa como referencia, y el modelo **japaneseStyleRealistic_v20** realiza la estilización y la mejora de detalles: +En la segunda fase, la imagen de salida de la primera fase sirve como referencia, y el modelo **japaneseStyleRealistic_v20** realiza la estilización y la mejora de detalles: -1. La imagen generada en la primera fase crea un espacio latent de mayor resolución mediante el nodo `Upscale latent` +1. La imagen generada en la primera fase crea un espacio latente de mayor resolución mediante el nodo `Upscale latent` 2. El segundo `Load Checkpoint` carga el modelo japaneseStyleRealistic_v20, que se centra en los detalles y el estilo -3. El segundo nodo `KSampler` usa una fuerza de `denoise` más baja (normalmente 0.4-0.6) para el refinado, conservando la estructura básica de la primera fase -4. Por último, se obtiene una imagen de mayor calidad y resolución mediante los segundos nodos `VAE Decode` y `Save Image` +3. El segundo nodo `KSampler` utiliza una intensidad de `denoise` más baja (normalmente 0.4-0.6) para el refinamiento, y conserva la estructura básica de la primera fase +4. Por último, el segundo `VAE Decode` y los nodos `Save Image` producen una imagen de mayor calidad y resolución -Esta fase se centra principalmente en la coherencia del estilo, la riqueza de detalles y la mejora de la calidad general de la imagen. +Esta fase se centra principalmente en la consistencia del estilo, la riqueza de detalles y la mejora de la calidad general de la imagen. ## Ventajas de la generación de imágenes en dos pasadas En comparación con la generación en una sola pasada, el método de generación de imágenes en dos pasadas ofrece las siguientes ventajas: -1. **Mayor resolución**: El procesamiento en dos pasadas puede generar imágenes de alta resolución que superan las capacidades de la generación en una sola pasada. -2. **Mezcla de estilos**: Puede combinar las ventajas de diferentes modelos, como usar un modelo realista en la primera fase y un modelo estilizado en la segunda fase. -3. **Mejores detalles**: La segunda fase puede centrarse en optimizar los detalles sin tener que preocuparse por la estructura general. -4. **Control preciso**: Una vez completado el control de pose en la primera fase, la segunda fase puede centrarse en refinar el estilo y los detalles. -5. **Menor carga de la GPU**: Generar en dos pasadas permite obtener imágenes grandes de alta calidad con recursos limitados de GPU. +1. **Mayor resolución**: el procesamiento en dos pasadas puede generar imágenes de alta resolución que superan las capacidades de la generación en una sola pasada +2. **Mezcla de estilos**: puede combinar las ventajas de distintos modelos, por ejemplo, usar un modelo realista en la primera fase y un modelo estilizado en la segunda fase +3. **Mejores detalles**: la segunda fase puede centrarse en optimizar los detalles sin tener que preocuparse por la estructura general +4. **Control preciso**: una vez completado el control de pose en la primera fase, la segunda fase puede centrarse en refinar el estilo y los detalles +5. **Menor carga de GPU**: generar en dos pasadas permite obtener imágenes grandes de alta calidad con recursos de GPU limitados -Para aprender más sobre las técnicas para mezclar varios ControlNet, consulta el tutorial [Mezclar modelos ControlNet](/es/tutorials/controlnet/mixing-controlnets). +Aprende más sobre las técnicas para mezclar varios ControlNets en el tutorial [Mezcla de modelos ControlNet](/es/tutorials/controlnet/mixing-controlnets). diff --git a/es/tutorials/flux/flux-1-fill-dev.mdx b/es/tutorials/flux/flux-1-fill-dev.mdx index 5a3759d37e..2ff2cbbe24 100644 --- a/es/tutorials/flux/flux-1-fill-dev.mdx +++ b/es/tutorials/flux/flux-1-fill-dev.mdx @@ -2,38 +2,40 @@ title: "Ejemplo de ComfyUI Flux.1 fill dev" description: "Aprende a usar Flux.1 fill dev para crear flujos de trabajo de relleno inteligente y extensión de imagen." sidebarTitle: "Flux.1 fill dev" -translationSourceHash: d44cacbe +translationSourceHash: d4b82038 translationFrom: tutorials/flux/flux-1-fill-dev.mdx translationBlockHashes: "_intro": 73fb6ba4 "Introduction to Flux.1 fill dev Model": 6dfbcfd4 + "Flux.1 Fill dev and related models installation": cf7747cd "Flux.1 Fill dev inpainting workflow": 016cb519 "Flux.1 Fill dev Outpainting Workflow": b0f0715d --- + ![Flux.1 fill dev](/images/tutorial/flux/flux-fill-dev-demo.jpeg) ## Introducción al modelo Flux.1 fill dev -Flux.1 fill dev es una de las herramientas principales de la [suite FLUX.1 Tools](https://blackforestlabs.ai/flux-1-tools/) lanzada por [Black Forest Labs](https://blackforestlabs.ai/), diseñada específicamente para inpainting y outpainting de imágenes. +Flux.1 fill dev es una de las herramientas principales de la [suite FLUX.1 Tools](https://blackforestlabs.ai/flux-1-tools/) lanzada por [Black Forest Labs](https://blackforestlabs.ai/), diseñada específicamente para el relleno inteligente y la extensión de imágenes. Características principales de Flux.1 fill dev: -- Potentes capacidades de inpainting y outpainting de imágenes, con resultados solo superados por la versión comercial FLUX.1 Fill [pro]. +- Potentes capacidades de relleno inteligente y extensión de imágenes, con resultados solo superados por la versión comercial FLUX.1 Fill [pro]. - Excelente capacidad para comprender y seguir el prompt, capturando con precisión la intención del usuario y manteniendo una alta consistencia con la imagen original. -- Tecnología avanzada de entrenamiento con destilación guiada, que hace el modelo más eficiente sin dejar de producir salidas de alta calidad. -- Términos de licencia flexibles: las salidas generadas se pueden usar para uso personal, científico y comercial. Consulta la [licencia no comercial de FLUX.1 [dev]](https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md) para más detalles. +- Tecnología avanzada de entrenamiento con destilación guiada, que hace que el modelo sea más eficiente sin dejar de producir salidas de alta calidad. +- Términos de licencia flexibles: las salidas generadas pueden usarse para fines personales, científicos y comerciales. Consulta la [licencia no comercial de FLUX.1 [dev]](https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md) para más detalles. Repositorio de código abierto: [FLUX.1 [dev]](https://huggingface.co/black-forest-labs/FLUX.1-dev) -Esta guía mostrará flujos de trabajo de inpainting y outpainting basados en el modelo Flux.1 fill dev. -Si no estás familiarizado con los flujos de trabajo de inpainting y outpainting, puedes consultar el [ejemplo de inpainting de ComfyUI Layout](/es/tutorials/basic/inpaint) y el [ejemplo de extensión de imagen de ComfyUI](/es/tutorials/basic/outpaint) para ver explicaciones relacionadas. +Esta guía mostrará flujos de trabajo de relleno inteligente y extensión de imágenes basados en el modelo Flux.1 fill dev. +Si no estás familiarizado con los flujos de trabajo de relleno inteligente y extensión de imágenes, puedes consultar el [ejemplo de relleno inteligente de ComfyUI Layout](/es/tutorials/basic/inpaint) y el [ejemplo de extensión de imagen de ComfyUI](/es/tutorials/basic/outpaint) para ver explicaciones relacionadas. -## Instalación de Flux.1 Fill dev y de los modelos relacionados +## Instalación de Flux.1 Fill dev y modelos relacionados -Antes de empezar, completemos la instalación de los archivos del modelo Flux.1 Fill dev. Los flujos de trabajo de inpainting y outpainting que vienen a continuación usan exactamente los mismos archivos de modelo. -Si ya has usado antes la versión completa del [flujo de trabajo de texto a imagen de Flux.1](/es/tutorials/flux/flux-1-text-to-image), -en esta sección solo necesitas descargar el archivo de modelo **flux1-fill-dev.safetensors**. +Antes de empezar, completemos la instalación de los archivos del modelo Flux.1 Fill dev. Los flujos de trabajo de Relleno inteligente y extensión de imagen usarán exactamente los mismos archivos de modelo. +Si ya has usado antes la versión completa del [flujo de trabajo Flux.1 de texto a imagen](/es/tutorials/flux/flux-1-text-to-image), +solo necesitas descargar el archivo de modelo **flux1-fill-dev.safetensors** en esta sección. -Sin embargo, como la descarga del modelo correspondiente exige aceptar antes el acuerdo de uso, visita la página [black-forest-labs/FLUX.1-Fill-dev](https://huggingface.co/black-forest-labs/FLUX.1-Fill-dev) y asegúrate de haber aceptado el acuerdo correspondiente, como se muestra en la imagen de abajo. +Sin embargo, como la descarga del modelo correspondiente requiere aceptar el acuerdo de uso correspondiente, visita la página [black-forest-labs/FLUX.1-Fill-dev](https://huggingface.co/black-forest-labs/FLUX.1-Fill-dev) y asegúrate de haber aceptado el acuerdo correspondiente, como se muestra en la imagen siguiente. ![Acuerdo de Flux](/images/tutorial/flux/flux1_fill_dev_agreement.jpg) Lista completa de modelos: @@ -57,18 +59,18 @@ ComfyUI/ ## Flujo de trabajo de relleno inteligente con Flux.1 Fill dev -### Flux.1 Inpaint {#flux_fill_inpaint_example} +### Relleno inteligente con Flux.1 {#flux_fill_inpaint_example} -Rellena las partes faltantes de las imágenes con Flux.1 Fill Inpainting. +Rellena las partes faltantes de las imágenes con el relleno inteligente de Flux.1 Fill. -Vista previa del flujo de trabajo Flux.1 Inpaint +Vista previa del flujo de trabajo de relleno inteligente con Flux.1 Abrir en Comfy Cloud - Descarga el JSON o busca "Flux.1 Inpaint" en la biblioteca de plantillas + Descarga el JSON o busca "Flux.1 Inpaint" en la Biblioteca de plantillas @@ -78,7 +80,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - `LoadImage`, nodo 17 · `flux_fill_inpaint_example_input_image.png` + Nodo `LoadImage` 17 · `flux_fill_inpaint_example_input_image.png` @@ -90,14 +92,14 @@ Sube este archivo al nodo `LoadImage` correspondiente:
Imagen de entrada - Salida de ejemplo de Flux.1 Inpaint + Salida de ejemplo de relleno inteligente con Flux.1
### 1. Flujo de trabajo de relleno inteligente y recursos -La imagen correspondiente ya contiene un canal alpha, así que no necesitas dibujar una máscara por separado. -Si quieres dibujar tu propia máscara, [haz clic aquí](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/flux/inpaint/flux_fill_inpaint_input_original.png) para obtener la imagen sin máscara y consulta la sección de uso de MaskEditor en el [Ejemplo de relleno inteligente de diseño de ComfyUI](/es/tutorials/basic/inpaint#usar-el-editor-de-máscara) para aprender a dibujar una máscara en el nodo `Load Image`. +La imagen correspondiente ya incluye un canal alfa, así que no necesitas dibujar una máscara por separado. +Si quieres dibujar tu propia máscara, [haz clic aquí](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/flux/inpaint/flux_fill_inpaint_input_original.png) para obtener la imagen sin máscara, y consulta la sección de uso del Editor de máscara en el [ejemplo de relleno inteligente de diseño de ComfyUI](/es/tutorials/basic/inpaint#usar-el-editor-de-máscara) para aprender a dibujar una máscara en el nodo `Load Image`. ### 2. Pasos para ejecutar el flujo de trabajo @@ -109,16 +111,16 @@ Si quieres dibujar tu propia máscara, [haz clic aquí](https://raw.githubuserco - clip_name1: `t5xxl_fp16.safetensors` - clip_name2: `clip_l.safetensors` 3. Asegúrate de que el nodo `Load VAE` tenga cargado `ae.safetensors`. -4. Sube la imagen de entrada proporcionada en el documento al nodo `Load Image`; si usas la versión sin máscara, recuerda completar el dibujo de la máscara con el editor de máscara -5. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo +4. Sube la imagen de entrada que se proporciona en el documento al nodo `Load Image`; si usas la versión sin máscara, recuerda completar el dibujo de la máscara con el Editor de máscara. +5. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo. ## Flujo de trabajo de outpainting con Flux.1 Fill dev -### Flux.1 Outpaint {#flux_fill_outpaint_example} +### Outpaint de Flux.1 {#flux_fill_outpaint_example} -Amplía las imágenes más allá de sus límites con outpainting de Flux.1. +Extiende las imágenes más allá de sus límites con el outpainting de Flux.1. -Vista previa del flujo de trabajo de outpainting de Flux.1 +Vista previa del flujo de trabajo de outpainting con Flux.1 @@ -135,7 +137,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - Nodo `LoadImage` 17 · `flux_fill_outpaint_example_input_image.png` + nodo `LoadImage` 17 · `flux_fill_outpaint_example_input_image.png` @@ -143,11 +145,11 @@ Sube este archivo al nodo `LoadImage` correspondiente: flux_fill_outpaint_example_input_image.png
-### 1. Flujo de trabajo y recurso de outpainting +### 1. Flujo de trabajo de outpainting y recursos ### 2. Pasos para ejecutar el flujo de trabajo -![Flujo de trabajo de outpainting con Flux.1 Fill dev de ComfyUI](/images/tutorial/flux/flow_diagram_outpaint.jpg) +![Flujo de trabajo de outpainting con ComfyUI Flux.1 Fill dev](/images/tutorial/flux/flow_diagram_outpaint.jpg) 1. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `flux1-fill-dev.safetensors`. 2. Asegúrate de que el nodo `DualCLIPLoader` tenga cargados los siguientes modelos: diff --git a/es/tutorials/flux/flux-1-kontext-dev.mdx b/es/tutorials/flux/flux-1-kontext-dev.mdx index c196d2edc8..d9952f2eaf 100644 --- a/es/tutorials/flux/flux-1-kontext-dev.mdx +++ b/es/tutorials/flux/flux-1-kontext-dev.mdx @@ -2,15 +2,17 @@ title: "FLUX.1 Kontext Dev en ComfyUI: edición de imágenes en local" description: "Edita imágenes en local en ComfyUI con FLUX.1 Kontext Dev, el modelo de 12B de Black Forest Labs para ediciones consistentes, estilo y refinado iterativo." sidebarTitle: "FLUX.1 Kontext Dev" -translationSourceHash: 391031ed +translationSourceHash: 6b87ee9a translationFrom: tutorials/flux/flux-1-kontext-dev.mdx translationBlockHashes: "_intro": 51c48128 "About FLUX.1 Kontext Dev": bb2f00f7 + "Model Download": e6b40970 "FLUX.1 Kontext Dev Workflow": 8408eb0d --- + import PromptTechniques from "/snippets/es/tutorials/flux/prompt-techniques.mdx"; -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' ## Acerca de FLUX.2 -[FLUX.2](https://bfl.ai/blog/flux-2) es un modelo de imágenes de nueva generación de [Black Forest Labs](https://blackforestlabs.ai/), que ofrece resultados fotorrealistas de hasta 4MP con una mejora considerable en iluminación, piel, telas y detalle de las manos. Añade una consistencia fiable con múltiples referencias (hasta 10 imágenes), una precisión de edición mejorada, una mejor comprensión visual y un renderizado de texto de nivel profesional. +[FLUX.2](https://bfl.ai/blog/flux-2) es un modelo de imágenes de nueva generación de [Black Forest Labs](https://blackforestlabs.ai/) que ofrece resultados fotorrealistas de hasta 4MP con una mejora considerable en iluminación, piel, telas y detalle de las manos. Añade una consistencia fiable con múltiples referencias (hasta 10 imágenes), mayor precisión de edición, una mejor comprensión visual y un renderizado de texto de nivel profesional. **Características principales:** - **Consistencia con múltiples referencias:** Mantiene de forma fiable la identidad, la geometría del producto, las texturas, los materiales, el vestuario y la intención de composición en múltiples salidas -- **Fotorrealismo de alta resolución:** Genera imágenes de hasta 4MP con un comportamiento realista de la iluminación, razonamiento espacial y detalles que tienen en cuenta la física +- **Fotorrealismo de alta resolución:** Genera imágenes de hasta 4MP con un comportamiento de iluminación realista, razonamiento espacial y detalles que tienen en cuenta la física - **Control de nivel profesional:** Control exacto de la pose, colores de marca precisos según el código hex, cualquier relación de aspecto y prompts estructurados para flujos de trabajo programáticos - **Renderizado de texto utilizable:** Produce texto limpio y legible en pantallas de interfaz, infografías y contenido en varios idiomas **Modelos disponibles:** -- **FLUX.2 Dev:** Modelo de código abierto (utilizado en este tutorial) -- **FLUX.2 Pro:** Versión API de Black Forest Labs +- **FLUX.2 Dev:** Modelo de código abierto (el que se usa en este tutorial) +- **FLUX.2 Pro:** Versión de API de Black Forest Labs En este flujo de trabajo usamos pesos cuantizados. El repositorio original de FLUX.2 está disponible [aquí](https://huggingface.co/black-forest-labs/FLUX.2-dev/). @@ -147,3 +149,4 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` + diff --git a/es/tutorials/flux/flux-2-klein.mdx b/es/tutorials/flux/flux-2-klein.mdx index 09c3acb227..ab6efae55e 100644 --- a/es/tutorials/flux/flux-2-klein.mdx +++ b/es/tutorials/flux/flux-2-klein.mdx @@ -2,26 +2,29 @@ title: "Guía de ComfyUI FLUX.2 Klein 4B" description: "Introducción rápida a FLUX.2 [klein] 4B y cómo ejecutar flujos de trabajo de texto a imagen y edición de imágenes en ComfyUI." sidebarTitle: "FLUX.2 Klein" -translationSourceHash: c108dbe5 +translationSourceHash: 98542515 translationFrom: tutorials/flux/flux-2-klein.mdx translationBlockHashes: "_intro": 980a68e5 "About FLUX.2 [klein]": 556eac08 "FLUX.2 Klein 4B Workflows": 8095f2bc + "FLUX.2 Klein 4B Model Downloads": f8158c6b "FLUX.2 Klein 9B Workflows": 99d18075 + "FLUX.2 Klein 9B Model Downloads": 0407c874 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' ## Acerca de FLUX.2 [klein] -FLUX.2 [Klein] es el modelo más rápido de la familia FLUX: unifica texto a imagen y edición de imágenes en una sola arquitectura compacta. Está diseñado para flujos de trabajo interactivos, vistas previas inmediatas y aplicaciones donde la latencia es crítica, con variantes destiladas que ofrecen una inferencia de extremo a extremo en torno a un segundo y mantienen una gran calidad en la edición con una o varias referencias. +FLUX.2 [Klein] es el modelo más rápido de la familia FLUX y unifica texto a imagen y edición de imágenes en una sola arquitectura compacta. Está pensado para flujos de trabajo interactivos, vistas previas inmediatas y aplicaciones donde la latencia es crítica, con variantes destiladas que ofrecen una inferencia de extremo a extremo en torno a un segundo y mantienen una gran calidad en la edición con una o varias referencias. **Aspectos destacados del modelo:** - Dos tipos de 4B: Base (sin destilar) para máxima flexibilidad y ajuste fino; Distilled (4 pasos) para despliegues que priorizan la velocidad - Rendimiento: destilado ~1.2s (5090) · 8.4GB VRAM; base ~17s (5090) · 9.2GB VRAM -- Soporte de edición: transformaciones de estilo, ediciones semánticas, reemplazo y eliminación de objetos, composición con varias referencias, ediciones iterativas +- Soporte de edición: transformaciones de estilo, ediciones semánticas, reemplazo y eliminación de objetos, composición con varias referencias y ediciones iterativas @@ -35,7 +38,7 @@ FLUX.2 [Klein] es el modelo más rápido de la familia FLUX: unifica texto a ima Ejecuta este flujo de trabajo en Comfy Cloud - + Descarga el flujo de trabajo de texto a imagen para FLUX.2 Klein 4B. @@ -79,16 +82,16 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: ![Ejemplo de edición de imagen base de FLUX.2 Klein 4B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/thumbnail/image_flux2_klein_image_edit_4b_base.png) -### FLUX.2 [Klein] 4B destilado: Edición de imagen {#image_flux2_klein_image_edit_4b_distilled} +### FLUX.2 [Klein] 4B Distilled: Edición de imagen {#image_flux2_klein_image_edit_4b_distilled} -Vista previa del flujo de trabajo de edición de imagen destilado de FLUX.2 Klein 4B +Vista previa del flujo de trabajo de edición de imagen Distilled de FLUX.2 Klein 4B Ejecuta este flujo de trabajo en Comfy Cloud - - Descarga el flujo de trabajo rápido de edición de imagen 4B destilado. + + Descarga el flujo de trabajo rápido y destilado de edición de imagen 4B. @@ -112,9 +115,9 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: **Salida de ejemplo** -![Ejemplo de edición de imagen destilado de FLUX.2 Klein 4B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux2_klein_image_edit_4b_distilled.png) +![Ejemplo de edición de imagen Distilled de FLUX.2 Klein 4B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux2_klein_image_edit_4b_distilled.png) -## Descargas de modelos de FLUX.2 Klein 4B +## Descargas del modelo FLUX.2 Klein 4B @@ -131,7 +134,7 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: -**Ubicación de almacenamiento de los modelos 4B** +**Ubicación de almacenamiento del modelo 4B** ``` 📂 ComfyUI/ @@ -149,14 +152,14 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: ### FLUX.2 [Klein] 9B: Texto a imagen {#image_flux2_text_to_image_9b} -Vista previa del flujo de trabajo texto a imagen de FLUX.2 Klein 9B +Vista previa del flujo de trabajo de texto a imagen de FLUX.2 Klein 9B Ejecuta este flujo de trabajo en Comfy Cloud - - Descarga el flujo de trabajo texto a imagen de FLUX.2 Klein 9B. + + Descarga el flujo de trabajo de texto a imagen para FLUX.2 Klein 9B. @@ -172,7 +175,7 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: Ejecuta este flujo de trabajo en Comfy Cloud - + Descarga el flujo de trabajo de edición de imagen con el modelo base 9B. @@ -197,7 +200,7 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: **Salida de ejemplo** -![Ejemplo base de edición de imagen de FLUX.2 Klein 9B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/thumbnail/image_flux2_klein_image_edit_9b_base.png) +![Ejemplo de edición de imagen base de FLUX.2 Klein 9B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/thumbnail/image_flux2_klein_image_edit_9b_base.png) ### FLUX.2 [Klein] 9B destilado: Edición de imagen {#image_flux2_klein_image_edit_9b_distilled} @@ -207,8 +210,8 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: Ejecuta este flujo de trabajo en Comfy Cloud - - Descarga el flujo de trabajo rápido destilado de edición de imagen 9B. + + Descarga el flujo de trabajo rápido y destilado de edición de imagen 9B. @@ -232,9 +235,9 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: **Salida de ejemplo** -![Ejemplo destilado de edición de imagen de FLUX.2 Klein 9B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux2_klein_image_edit_9b_distilled.png) +![Ejemplo de edición de imagen destilada de FLUX.2 Klein 9B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux2_klein_image_edit_9b_distilled.png) -## Descargas de modelos de FLUX.2 Klein 9B +## Descargas del modelo FLUX.2 Klein 9B Para los modelos de difusión, visita el repositorio de BFL, acepta el acuerdo y luego descarga los modelos. @@ -248,10 +251,10 @@ Para los modelos de difusión, visita el repositorio de BFL, acepta el acuerdo y Modelo de difusión (9B destilado). - Codificador de texto para modelos 9B. + Codificador de texto para los modelos 9B. - VAE para modelos 9B. + VAE para los modelos 9B. @@ -268,3 +271,4 @@ Para los modelos de difusión, visita el repositorio de BFL, acepta el acuerdo y │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` + diff --git a/es/tutorials/llm/gemma4/gemma4.mdx b/es/tutorials/llm/gemma4/gemma4.mdx index 5ad1c758e2..94f2d62fd1 100644 --- a/es/tutorials/llm/gemma4/gemma4.mdx +++ b/es/tutorials/llm/gemma4/gemma4.mdx @@ -2,17 +2,19 @@ title: "Gemma 4 en ComfyUI: LLM multimodal con TextGenerate" description: "Ejecuta Gemma 4 de Google en ComfyUI a través del nodo TextGenerate para generación de texto, comprensión de imágenes y transcripción de audio." sidebarTitle: "Gemma 4" -translationSourceHash: e876070d +translationSourceHash: e17f6d7d translationFrom: tutorials/llm/gemma4/gemma4.mdx translationBlockHashes: "_intro": e283d42e "Available workflow": a5a260f2 + "Model Download": 8eb8dbb8 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' -**Gemma 4** es la última generación de LLM abiertos y ligeros de Google DeepMind, diseñada para la generación de texto, la comprensión de imágenes, el análisis de video, la transcripción de audio y el uso estructurado de herramientas. Es compatible de forma nativa con ComfyUI como el modelo **Text Generation** predeterminado. +**Gemma 4** es la última generación de LLM abiertos y ligeros de Google DeepMind, creada para la generación de texto, la comprensión de imágenes, el análisis de video, la transcripción de audio y el uso estructurado de herramientas. ComfyUI lo admite de forma nativa como modelo **Text Generation** predeterminado. **Aspectos destacados del modelo**: @@ -21,11 +23,11 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" - **E2B (2B)**: rápido y ligero, ideal para GPU de consumo - **E4B (4B)**: rendimiento equilibrado, opción predeterminada recomendada - **12B**: mejor calidad, requiere más VRAM -- **Modo de razonamiento**: razonamiento paso a paso integrado antes de generar respuestas +- **Modo de pensamiento**: razonamiento paso a paso integrado antes de generar las respuestas - **Contexto largo**: hasta 128K tokens (E2B/E4B) y 256K tokens (12B) -- **Multilingüe**: más de 35 idiomas listos para usar, preentrenado con más de 140 +- **Multilingüe**: más de 35 idiomas listos para usar, con preentrenamiento en más de 140 idiomas - **Llamada a funciones**: soporte nativo para el uso estructurado de herramientas y flujos de trabajo agénticos -- **Nativo en ComfyUI**: se carga y ejecuta mediante los nodos integrados `TextGenerate` y `CLIPLoader` +- **Nativo en ComfyUI**: ComfyUI lo carga y lo ejecuta a través de los nodos integrados `TextGenerate` y `CLIPLoader` **Enlaces relacionados**: - [Hugging Face (Comfy-Org/gemma-4)](https://huggingface.co/Comfy-Org/gemma-4) @@ -36,7 +38,7 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" ### Gemma4: Text Generation {#llm_gemma4_text_gen} -Introduce tu prompt de texto y, de forma opcional, una imagen, audio o video. Genera una salida de texto con razonamiento, programación y soporte multilingüe configurables. +Ingresa tu prompt de texto y, de forma opcional, una imagen, audio o video. Genera una salida de texto con soporte configurable para razonamiento, programación y varios idiomas. Vista previa del flujo de trabajo de generación de texto de Gemma 4 @@ -71,36 +73,36 @@ Este flujo de trabajo demuestra las capacidades principales de **generación de - **Prompt de texto**: tu pregunta o instrucción - **Imagen** (opcional): para tareas de comprensión visual (OCR, detección de objetos, lectura de gráficos, etc.) - **Audio** (opcional): para reconocimiento de voz o transcripción -- **Video** (opcional): la plantilla carga el video y lo divide con **Get Video Components**, pero esos fotogramas no están conectados al generador de texto, así que el video no afecta a la salida +- **Video** (opcional): la plantilla carga el video y lo divide con **Obtener componentes de video**, pero esos fotogramas no están conectados al generador de texto, así que el video no afecta la salida **Controles principales**: - **Longitud máxima**: número máximo de tokens a generar (256 por defecto) - **Modo de muestreo**: activa o desactiva el muestreo y ajusta temperatura, top-k, top-p, penalización por repetición y semilla -- **Modo de razonamiento**: activa el razonamiento paso a paso antes de la respuesta final +- **Modo de pensamiento**: activa el razonamiento paso a paso antes de la respuesta final - **Usar plantilla predeterminada**: aplica el prompt de sistema integrado del modelo **Salida**: - **Texto generado**: la respuesta del modelo como una cadena de texto sin formato - Este flujo de trabajo usa nodos Subgraph para un procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. + Este flujo de trabajo usa nodos Subgraph para un procesamiento modular. Consulta la documentación de Subgraph para saber cómo personalizar y ampliar el flujo de trabajo. ## Descarga del modelo -Los modelos Gemma 4 se cargan como codificadores de texto en ComfyUI. Descarga el archivo de modelo correspondiente y colócalo en el directorio correcto: +Los modelos Gemma 4 se cargan como codificadores de texto en ComfyUI. Descarga el archivo del modelo correspondiente y colócalo en el directorio correcto: - Rápido y ligero. Recomendado para GPU de consumo. + Rápido y ligero. Recomendado para GPUs de consumo. - Rendimiento equilibrado. El modelo predeterminado del flujo de trabajo. + Rendimiento equilibrado. El modelo predeterminado en el flujo de trabajo. - Explora todos los pesos de los modelos Gemma 4. + Explora todos los pesos del modelo Gemma 4. @@ -112,3 +114,4 @@ Coloca el archivo `.safetensors` descargado en: │ └── 📂 text_encoders/ │ └── gemma4_e4b_it_fp8_scaled.safetensors ``` + diff --git a/es/tutorials/llm/qwen/qwen3.mdx b/es/tutorials/llm/qwen/qwen3.mdx index b4073fd05c..48e39bf8a9 100644 --- a/es/tutorials/llm/qwen/qwen3.mdx +++ b/es/tutorials/llm/qwen/qwen3.mdx @@ -2,34 +2,36 @@ title: "Qwen 3.0 en ComfyUI: generación de texto LLM con TextGenerate" description: "Ejecuta Qwen3 4B Thinking en ComfyUI con TextGenerate para reescritura de prompts, razonamiento con cadena de pensamiento y análisis de texto estructurado." sidebarTitle: "Qwen 3.0" -translationSourceHash: c9e91599 +translationSourceHash: 062180fe translationFrom: tutorials/llm/qwen/qwen3.mdx translationBlockHashes: "_intro": 75e813fe "Use Cases": 72228b63 "Available workflow": 93a0c3e5 + "Model Download": 6a95f95c --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' -**Qwen 3.0** (también conocido como Qwen3) es un potente LLM de código abierto de Alibaba Cloud diseñado para la generación de texto, el razonamiento y el análisis estructurado. Es compatible de forma nativa con ComfyUI mediante el nodo integrado `TextGenerate`. +**Qwen 3.0** (también conocido como Qwen3) es un potente LLM de código abierto de Alibaba Cloud creado para la generación de texto, el razonamiento y el análisis estructurado. ComfyUI lo admite de forma nativa mediante el nodo integrado `TextGenerate`. **Aspectos destacados del modelo**: - **Razonamiento sólido**: Qwen3-4B-Thinking admite razonamiento paso a paso con cadena de pensamiento - **Enfocado en la generación de texto**: optimizado para la salida de texto estructurado, el análisis y las tareas de programación -- **Nativo en ComfyUI**: funciona con el nodo integrado `TextGenerate`, sin necesidad de Nodos personalizados -- **Ligero**: comparte el mismo formato de codificador de texto que Qwen3.5, disponible en variantes de 2B, 4B y 9B para ajustarse a diferentes configuraciones de hardware +- **Nativo en ComfyUI**: funciona con el nodo integrado `TextGenerate`, sin necesidad de nodos personalizados +- **Ligero**: comparte el mismo formato de codificador de texto que Qwen3.5 y está disponible en variantes de 2B, 4B y 9B para ajustarse a distintas configuraciones de hardware ## Casos de uso -Qwen 3.0 es adecuado para tareas que requieren generación de texto estructurado y razonamiento inteligente dentro de un flujo de trabajo de ComfyUI: +Qwen 3.0 es ideal para tareas que requieren generación de texto estructurado y razonamiento inteligente dentro de un flujo de trabajo de ComfyUI: - **Optimización de prompts**: pasa prompts existentes a Qwen 3.0 y pídele que los reescriba, los expanda o los refine para obtener mejores resultados de generación de imágenes. Por ejemplo, convierte un prompt corto de palabras clave en descripciones detalladas y estructuradas con detalles de estilo, iluminación y composición. - **Razonamiento sobre la lógica del flujo de trabajo**: usa el modelo para analizar los parámetros del flujo de trabajo, sugerir pasos de procesamiento o generar instrucciones estructuradas que alimenten otros nodos. - **Análisis basado en texto**: extrae información, clasifica contenido o genera informes estructurados a partir de entradas de texto. -- **Razonamiento de cadena de pensamiento**: activa el modo de pensamiento para tareas complejas de varios pasos que se benefician de un razonamiento intermedio antes de producir la salida final. +- **Razonamiento en cadena de pensamiento**: activa el modo de pensamiento para tareas complejas de varios pasos que se benefician de un razonamiento intermedio antes de producir la salida final. ## Flujo de trabajo disponible @@ -56,19 +58,19 @@ Este flujo de trabajo demuestra las capacidades fundamentales de **generación d **Controles principales**: - **Longitud máxima**: número máximo de tokens a generar (predeterminado 256) - **Modo de muestreo**: activa o desactiva el muestreo y ajusta la temperatura, top-k, top-p, la penalización por repetición y la semilla -- **Modo de razonamiento**: habilita el razonamiento paso a paso antes de la respuesta final +- **Modo de pensamiento**: habilita el razonamiento paso a paso antes de la respuesta final - **Usar plantilla predeterminada**: aplica el prompt de sistema integrado del modelo **Salida**: - **Texto generado**: la respuesta del modelo como una cadena de texto simple - + Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y extender el flujo de trabajo. ## Descarga del modelo -Los modelos Qwen 3.0 se cargan como codificadores de texto en ComfyUI. Los archivos de modelo se comparten con Qwen3.5. Descarga la variante que mejor se adapte a tu hardware: +Los modelos Qwen 3.0 se cargan como text encoders en ComfyUI. Los archivos del modelo son compartidos con Qwen3.5. Descarga la variante que mejor se adapte a tu hardware: @@ -76,11 +78,11 @@ Los modelos Qwen 3.0 se cargan como codificadores de texto en ComfyUI. Los archi - Equilibrio entre tamaño y calidad. Recomendado para la mayoría de GPU de consumo. + Tamaño y calidad equilibrados. RECOMENDADO para la mayoría de las GPU de consumo. - La variante más grande, ~19 GB. Salida de mayor calidad, requiere más VRAM. + La variante más grande, ~19 GB. Mayor calidad de salida, requiere más VRAM. @@ -92,3 +94,4 @@ Coloca el archivo `.safetensors` descargado en: │ └── 📂 text_encoders/ │ └── qwen3.5_4b_bf16.safetensors # or 2b / 9b variant ``` + diff --git a/es/tutorials/llm/qwen/qwen3_5.mdx b/es/tutorials/llm/qwen/qwen3_5.mdx index 4818144e0a..2800da3920 100644 --- a/es/tutorials/llm/qwen/qwen3_5.mdx +++ b/es/tutorials/llm/qwen/qwen3_5.mdx @@ -2,44 +2,46 @@ title: "Qwen3.5 en ComfyUI: LLM multimodal para descripción de imágenes" description: "Ejecuta Qwen3.5, el LLM multimodal de Alibaba Cloud, en ComfyUI con el nodo TextGenerate para descripción de imágenes, prompts inversos y preguntas visuales." sidebarTitle: "Qwen3.5" -translationSourceHash: f25a584f +translationSourceHash: 37805a0b translationFrom: tutorials/llm/qwen/qwen3_5.mdx translationBlockHashes: "_intro": cc4cef60 "Use Cases": 01910a1e "Available workflow": 767cf795 + "Model Download": 835bbbd0 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Qwen3.5** es un LLM multimodal de código abierto de Alibaba Cloud, que se basa en la serie Qwen 3.0 y añade capacidades de comprensión de imágenes. Admite tanto la generación de texto como tareas basadas en imágenes, como el etiquetado de imágenes y la ingeniería inversa de prompts. +**Qwen3.5** es un LLM multimodal de código abierto de Alibaba Cloud, que se basa en la serie Qwen 3.0 y añade capacidades de comprensión de imágenes. Admite tanto la generación de texto como tareas basadas en imágenes, como la descripción de imágenes y la ingeniería inversa de prompts. **Aspectos destacados del modelo**: - **Multimodal**: acepta entradas de texto e imagen para tareas de comprensión visual -- **Etiquetado de imágenes**: puede describir imágenes y generar leyendas detalladas +- **Descripción de imágenes**: puede describir imágenes y generar descripciones detalladas - **Ingeniería inversa de prompts**: extrae prompts y parámetros de generación a partir de imágenes de referencia -- **Nativo en ComfyUI**: funciona con el nodo integrado `TextGenerate`, sin necesidad de Nodos personalizados -- **Ligero**: modelo de 4B parámetros, apto para GPUs de consumo +- **Nativo en ComfyUI**: funciona con el nodo integrado `TextGenerate`, sin necesidad de nodos personalizados +- **Ligero**: modelo de 4B de parámetros, adecuado para GPUs de consumo ## Casos de uso Qwen3.5 destaca en escenarios donde combinar la comprensión visual con la generación de texto aporta valor a un flujo de trabajo de ComfyUI: - **Ingeniería inversa de prompts a partir de una imagen**: dale una imagen de referencia a Qwen3.5 y pídele que genere un prompt de texto detallado que pueda reproducir esa imagen. Resulta especialmente útil cuando encuentras una gran imagen pero no sabes con qué prompt se generó. -- **Optimización de prompts**: carga un prompt existente y un concepto de imagen, y luego pide a Qwen3.5 que genere, refine o expanda prompts con más detalle para obtener mejores resultados de generación. +- **Optimización de prompts**: carga un prompt existente y un concepto de imagen, y luego pide a Qwen3.5 que genere, refine o expanda prompts con mayor detalle para obtener mejores resultados de generación. - **Generación de descripciones de imágenes**: genera automáticamente leyendas, descripciones o etiquetas de metadatos para las imágenes generadas, lo que resulta útil para catalogar o preparar datos de entrenamiento. - **Respuesta a preguntas sobre imágenes**: haz preguntas acerca del contenido de la imagen ("¿Qué objetos hay en esta escena?", "¿De qué color es el fondo?") y obtén respuestas de texto estructuradas. -- **Lectura de texto**: con un prompt adecuado, el modelo puede intentar leer el texto visible o las etiquetas de las imágenes, aunque la fiabilidad depende de la calidad y la claridad del texto representado. +- **Lectura de texto**: con un prompt adecuado, el modelo puede intentar leer el texto visible o las etiquetas de las imágenes, aunque la fiabilidad depende de la calidad y la claridad del texto renderizado. ## Flujo de trabajo disponible ### Qwen3.5: Text Generation {#llm_qwen3_5_text_gen} -Usa el modelo Qwen3.5 para analizar una imagen de entrada y generar prompts descriptivos de texto. Este flujo de trabajo realiza captioning de imágenes e ingeniería inversa de prompts. +Usa el modelo Qwen3.5 para analizar una imagen de entrada y generar prompts descriptivos de texto. Este flujo de trabajo realiza descripción de imágenes e ingeniería inversa de prompts. -Qwen3.5 text generation workflow preview +Vista previa del flujo de trabajo de generación de texto con Qwen3.5 @@ -61,30 +63,30 @@ Sube este archivo al nodo `LoadImage` correspondiente:
- Input image + Imagen de entrada
Este flujo de trabajo demuestra las capacidades de **generación de texto y comprensión de imágenes** de Qwen3.5. Acepta un prompt de texto y una imagen opcional, y genera texto descriptivo o análisis estructurado a partir de la entrada. **Entradas**: - **Prompt de texto**: tu pregunta, instrucción o descripción de la tarea -- **Imagen** (opcional): para tareas de comprensión visual (captioning de imágenes, ingeniería inversa de prompts, optimización de prompts, etc.) +- **Imagen** (opcional): para tareas de comprensión visual (descripción de imágenes, ingeniería inversa de prompts, optimización de prompts, etc.) **Controles clave**: - **Max length**: número máximo de tokens a generar (256 por defecto) -- **Sampling mode**: activa o desactiva el muestreo y ajusta temperature, top-k, top-p, repetition penalty y seed -- **Use default template**: aplica el system prompt integrado del modelo +- **Sampling mode**: activa o desactiva el muestreo y ajusta temperature, top-k, top-p, repetition penalty y semilla +- **Use default template**: aplica el prompt de sistema integrado del modelo **Salida**: - **Texto generado**: la respuesta del modelo como una cadena de texto plano - - Este flujo de trabajo usa nodos Subgraph para un procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. + + Este flujo de trabajo usa nodos Subgraph para un procesamiento modular. Consulta la documentación de Subgraph para saber cómo personalizar y ampliar el flujo de trabajo. ## Descarga del modelo -Los modelos Qwen3.5 se cargan como codificadores de texto en ComfyUI. Elige la variante que mejor se adapte a tu hardware: +Los modelos Qwen3.5 se cargan como text encoders en ComfyUI. Elige la variante que mejor se adapte a tu hardware: @@ -92,11 +94,11 @@ Los modelos Qwen3.5 se cargan como codificadores de texto en ComfyUI. Elige la v - Equilibrio entre tamaño y calidad. Recomendado para la mayoría de GPU de consumo. + Tamaño y calidad equilibrados. RECOMENDADO para la mayoría de las GPU de consumo. - La variante más grande, ~19 GB. Salida de mayor calidad, requiere más VRAM. + La variante más grande, ~19 GB. Mayor calidad de salida, requiere más VRAM. @@ -108,3 +110,4 @@ Coloca el archivo `.safetensors` descargado en: │ └── 📂 text_encoders/ │ └── qwen3.5_4b_bf16.safetensors # or 2b / 9b variant ``` + diff --git a/es/tutorials/partner-nodes/fishaudio/drama-3.mdx b/es/tutorials/partner-nodes/fishaudio/drama-3.mdx index 2ba7ea514b..dd560fdbfd 100644 --- a/es/tutorials/partner-nodes/fishaudio/drama-3.mdx +++ b/es/tutorials/partner-nodes/fishaudio/drama-3.mdx @@ -90,7 +90,7 @@ She looked at the menu and said Je voudrais une table pour deux, s'il vo ### Combinarlas -Las indicaciones, las etiquetas de palabra y las [etiquetas de fonemas](/es/tutorials/partner-nodes/fishaudio/prompt-guide#phoneme-control) funcionan en el mismo guion, incluso dentro de un turno con varios hablantes: +Las indicaciones, las etiquetas de palabra y las [etiquetas de fonemas](/es/tutorials/partner-nodes/fishaudio/prompt-guide#control-de-fonemas) funcionan en el mismo guion, incluso dentro de un turno con varios hablantes: ```text @Voice1 [calm and inviting] Welcome back to the studio. diff --git a/es/tutorials/partner-nodes/fishaudio/fish-audio.mdx b/es/tutorials/partner-nodes/fishaudio/fish-audio.mdx index 7572d8a262..032a93e55f 100644 --- a/es/tutorials/partner-nodes/fishaudio/fish-audio.mdx +++ b/es/tutorials/partner-nodes/fishaudio/fish-audio.mdx @@ -38,7 +38,7 @@ La documentación del modelo más reciente, `drama-3`, está en su propia págin ### Conectar voces -La salida `voice` del Voice Selector o del Instant Voice Clone se conecta al nodo Text to Speech. El nombre de la entrada depende del modelo: `s2.1-pro` (recomendado) expone la entrada `voices`, que puede crecer (hasta 5 espacios de voz), mientras que `s1` tiene una única entrada `voice` opcional. Con una voz conectada, el nodo la pasa internamente como `reference_id`. Con dos o más, el texto debe marcar a los hablantes con `@Voice1`, `@Voice2`, etc., y cada voz conectada debe aparecer al menos una vez en el texto; de lo contrario, el nodo genera un error. Consulta [Diálogo con varios hablantes](/es/tutorials/partner-nodes/fishaudio/prompt-guide#multi-speaker-dialogue) en la guía de prompts. +La salida `voice` del Voice Selector o del Instant Voice Clone se conecta al nodo Text to Speech. El nombre de la entrada depende del modelo: `s2.1-pro` (recomendado) expone la entrada `voices`, que puede crecer (hasta 5 espacios de voz), mientras que `s1` tiene una única entrada `voice` opcional. Con una voz conectada, el nodo la pasa internamente como `reference_id`. Con dos o más, el texto debe marcar a los hablantes con `@Voice1`, `@Voice2`, etc., y cada voz conectada debe aparecer al menos una vez en el texto; de lo contrario, el nodo genera un error. Consulta [Diálogo con varios hablantes](/es/tutorials/partner-nodes/fishaudio/prompt-guide#diálogo-con-varios-hablantes) en la guía de prompts. ### Límites de la clonación de voz diff --git a/es/tutorials/partner-nodes/fishaudio/prompt-guide.mdx b/es/tutorials/partner-nodes/fishaudio/prompt-guide.mdx index 5941d78bc3..1997ea5cab 100644 --- a/es/tutorials/partner-nodes/fishaudio/prompt-guide.mdx +++ b/es/tutorials/partner-nodes/fishaudio/prompt-guide.mdx @@ -2,7 +2,7 @@ title: "Guía de prompts de Fish Audio: cómo escribir prompts para Fish Audio TTS en ComfyUI" description: "Escribe prompts para los Nodos asociados de Fish Audio en ComfyUI: etiquetas de emoción, tono, efectos de audio, pausas y diálogos." sidebarTitle: "Guía de prompts" -translationSourceHash: 15c1b378 +translationSourceHash: f37ebbfa translationFrom: tutorials/partner-nodes/fishaudio/prompt-guide.mdx translationBlockHashes: "_intro": 92787dbd @@ -11,12 +11,16 @@ translationBlockHashes: "Tone markers": aca7ba72 "Audio effects": aadc74bb "Pauses and special effects": 7d87b14e + "Combining tags": 0c4cf8d1 "Best practices": f4c22fed + "Multi-speaker dialogue": a86dc954 + "Phoneme control": 72653bf7 "Parameter tuning": c53e91bf "Voice cloning quality": 7e721eb5 "References": c8122f0c --- -Fish Audio TTS te da control directo sobre cómo suena el habla mediante etiquetas en línea escritas en el propio texto. Esta guía cubre todas las categorías de etiquetas que entiende el modelo, dónde colocarlas y cómo combinarlas. Las etiquetas siguientes se aplican a `s2.1-pro` y `s1`. Drama 3 usa instrucciones en lenguaje natural y etiquetas de palabras emparejadas en su lugar, descritas en la página [Fish Audio Drama 3](/es/tutorials/partner-nodes/fishaudio/drama-3). + +Fish Audio TTS te da control directo sobre cómo suena el habla mediante etiquetas en línea escritas en el propio texto. Esta guía cubre todas las categorías de etiquetas que entiende el modelo, dónde colocarlas y cómo combinarlas. Las etiquetas siguientes se aplican a `s2.1-pro` y `s1`. En cambio, Drama 3 usa instrucciones en lenguaje natural y etiquetas de palabras emparejadas, descritas en la página [Fish Audio Drama 3](/es/tutorials/partner-nodes/fishaudio/drama-3). Los ejemplos siguientes funcionan en el nodo Fish Audio Text to Speech. Escríbelos directamente en el campo `text`, reemplazando el guion de ejemplo por el tuyo. Para configurar el nodo, las plantillas de flujo de trabajo y los precios, consulta [Fish Audio: Texto a voz, clonación de voz y voz a texto](/es/tutorials/partner-nodes/fishaudio/fish-audio). @@ -32,11 +36,11 @@ Los modelos Fish Audio S2 interpretan indicaciones en lenguaje natural escritas Tres propiedades hacen que este sistema sea flexible: -- **La posición determina el significado.** Una etiqueta actúa desde donde aparece hasta la siguiente etiqueta o el final de la oración. `[whispering] I didn't want to go inside` susurra toda la línea. `I didn't want to go [whispering] inside` empieza a susurrar en «inside». -- **Las descripciones de forma libre funcionan.** No estás limitado a un conjunto fijo de etiquetas. Si puedes describírselo a un actor de voz, escríbelo entre corchetes: `[tired, end of a long shift]`, `[voice rough from crying, trying to sound normal]`, `[professional broadcast tone]`. +- **La posición determina el significado.** Una etiqueta se aplica desde donde aparece hasta la siguiente etiqueta o el final de la oración. `[whispering] I didn't want to go inside` susurra toda la línea. `I didn't want to go [whispering] inside` empieza a susurrar en «inside». +- **Las descripciones libres funcionan.** No estás limitado a un conjunto fijo de etiquetas. Si puedes describírselo a un actor de voz, escríbelo entre corchetes: `[tired, end of a long shift]`, `[voice rough from crying, trying to sound normal]`, `[professional broadcast tone]`. - **Las etiquetas funcionan en tu idioma.** Escribe las indicaciones en el mismo idioma que tu guion: `[低声说] 不要让他们听见`, `[ため息をついて] もう一度やり直そう`. -El modelo clásico `s1` usa los mismos nombres de emociones, pero los encierra entre paréntesis con un conjunto fijo de etiquetas: `(happy) What a beautiful day!` El modelo actual `s2.1-pro` acepta indicaciones entre corchetes y descripciones de forma libre. +El modelo clásico `s1` usa los mismos nombres de emociones, pero los encierra entre paréntesis con un conjunto fijo de etiquetas: `(happy) What a beautiful day!` El modelo actual `s2.1-pro` acepta indicaciones entre corchetes y descripciones libres. ## Etiquetas de emoción @@ -49,7 +53,7 @@ El modelo clásico `s1` usa los mismos nombres de emociones, pero los encierra e | `[angry]` | Frustrado, agresivo | Quejas, advertencias | | `[excited]` | Energético, entusiasta | Anuncios, celebraciones | | `[calm]` | Tranquilo, relajado | Instrucciones, meditación | -| `[nervous]` | Ansioso, inseguro | Aclaraciones, disculpas | +| `[nervous]` | Ansioso, inseguro | Descargos de responsabilidad, disculpas | | `[confident]` | Firme, seguro de sí mismo | Presentaciones, ventas | | `[surprised]` | Sorprendido, asombrado | Reacciones, descubrimientos | | `[satisfied]` | Satisfecho, contento | Confirmaciones, reseñas | @@ -63,7 +67,7 @@ El modelo clásico `s1` usa los mismos nombres de emociones, pero los encierra e | `[embarrassed]` | Avergonzado, incómodo | Disculpas, errores | | `[disgusted]` | Repugnado, asqueado | Reseñas negativas | | `[moved]` | Conmovido emocionalmente | Momentos emotivos | -| `[proud]` | Realizado, satisfecho | Logros, elogios | +| `[proud]` | Con sentido de logro, satisfecho | Logros, elogios | | `[relaxed]` | Relajado, informal | Conversación informal | | `[grateful]` | Agradecido, reconocido | Agradecimientos, aprecio | | `[curious]` | Inquisitivo, interesado | Preguntas, exploración | @@ -94,14 +98,14 @@ El modelo clásico `s1` usa los mismos nombres de emociones, pero los encierra e | `[lonely]` | Aislado, solo | Contenido emocional | | `[bored]` | Desinteresado, cansado | Desinterés | | `[contemptuous]` | Muestra desprecio | Crítica fuerte | -| `[sympathetic]` | Muestra compasión | Condolencias | -| `[compassionate]` | Muestra cariño profundo | Soporte, ayuda | +| `[sympathetic]` | Muestra simpatía | Condolencias | +| `[compassionate]` | Muestra compasión profunda | Soporte, ayuda | | `[determined]` | Resuelto, decidido | Objetivos, compromisos | | `[resigned]` | Acepta la derrota | Rendición, aceptación | ## Marcadores de tono -Los marcadores de tono controlan el volumen, la intensidad y el énfasis. Coloca `[emphasis]` justo antes de la palabra o frase que quieras enfatizar: +Los marcadores de tono controlan el volumen, la intensidad y el énfasis. Coloca `[emphasis]` justo antes de la palabra o frase que quieras destacar: ```text This is [emphasis] really important. @@ -109,29 +113,29 @@ This is [emphasis] really important. | Etiqueta | Interpretación | Cuándo usarla | |-----|----------|-------------| -| `[in a hurry tone]` | Apresurado, urgente | Información urgente | -| `[shouting]` | Fuerte, para llamar la atención | Captar la atención | +| `[in a hurry tone]` | Apresurado, urgente | Información con límite de tiempo | +| `[shouting]` | Fuerte, alzando la voz | Captar la atención | | `[screaming]` | Muy fuerte, con pánico | Emergencias, miedo | -| `[whispering]` | Muy suave, sigiloso | Secretos, escenas tranquilas | +| `[whispering]` | Muy suave, sigiloso | Secretos, escenas silenciosas | | `[soft tone]` | Suave, tranquilo | Consuelo, canciones de cuna | | `[emphasis]` | Enfatizar una palabra o frase | Resaltar palabras clave | ## Efectos de audio -Las etiquetas de efectos de audio añaden sonidos humanos naturales. A continuación de la etiqueta, incluye el texto correspondiente cuando se sugiera: +Las etiquetas de efectos de audio agregan sonidos humanos naturales. Después de la etiqueta, incluye el texto correspondiente cuando se sugiera: | Etiqueta | Descripción | Texto sugerido después de la etiqueta | |-----|-------------|------------------------------| -| `[laughing]` | Carcajada | Ha, ha, ha | -| `[chuckling]` | Risa leve | Heh, heh | -| `[sobbing]` | Sollozos | Texto opcional | +| `[laughing]` | Risa a carcajadas | Ha, ha, ha | +| `[chuckling]` | Risa suave | Heh, heh | +| `[sobbing]` | Llanto intenso | Texto opcional | | `[crying loudly]` | Llanto en voz alta | Texto opcional | | `[sighing]` | Exhalación de alivio o frustración | sigh | | `[groaning]` | Sonido de frustración | ugh | | `[panting]` | Sin aliento | huff, puff | | `[gasping]` | Inhalación brusca | gasp | | `[yawning]` | Sonido de cansancio | yawn | -| `[snoring]` | Sonido de sueño | zzz | +| `[snoring]` | Sonido al dormir | zzz | | `[clear throat]` | Sonido de carraspeo | ahem | ## Pausas y efectos especiales @@ -140,7 +144,7 @@ Las etiquetas de efectos de audio añaden sonidos humanos naturales. A continuac |-----|-------------| | `[break]` | Pausa breve en el habla | | `[long-break]` | Pausa prolongada en el habla | -| `[short pause]` | Breve pausa entre líneas | +| `[short pause]` | Pausa breve entre líneas | | `[long pause]` | Silencio prolongado | | `[audience laughing]` | Sonido de público riendo | | `[background laughter]` | Risa de fondo | @@ -158,7 +162,7 @@ Las palabras de pausa normales también marcan el ritmo sin necesidad de etiquet [shouting] [angry] I told you this would happen! ``` -**Combina emociones en capas para expresiones complejas.** Limita las combinaciones a tres etiquetas o menos por oración: +**Combina varias emociones para expresiones complejas.** Limita las combinaciones a tres etiquetas o menos por oración: ```text [sad][whispering] I miss you so much. @@ -166,7 +170,7 @@ Las palabras de pausa normales también marcan el ritmo sin necesidad de etiquet [excited][laughing] We won! Ha ha! ``` -**Escribe transiciones de emoción** como una progresión natural entre oraciones: +**Escribe las transiciones de emoción** como una progresión natural entre oraciones: ```text [happy] I got the promotion! @@ -176,7 +180,7 @@ Las palabras de pausa normales también marcan el ritmo sin necesidad de etiquet [determined] I'm going to make it work! ``` -**Añade efectos de fondo** para dar atmósfera: +**Agrega efectos de fondo** para crear ambiente: ```text The comedy show was amazing [audience laughing] @@ -190,29 +194,29 @@ The comedy show was amazing [audience laughing] [extremely angry] This is unacceptable! ``` -## Mejores prácticas +## Buenas prácticas -**Qué hacer:** +**Sí:** - Usa una emoción principal por oración - Ajusta las emociones al contexto de forma lógica -- Agrega texto después de los efectos de sonido, por ejemplo "Ha ha" después de `[laughing]` -- Espacia los cambios emocionales para que suenen realistas +- Añade texto después de los efectos de sonido, por ejemplo "Ha ha" después de `[laughing]` +- Espacia los cambios emocionales para lograr realismo - Prueba distintas combinaciones con la misma voz -**Qué evitar:** +**No:** -- No abuses de las etiquetas en textos cortos -- No mezcles emociones en conflicto en una misma oración -- No escribas descripciones entre corchetes tan largas que interrumpan el flujo -- No dejes una etiqueta descriptiva sin texto después de ella -- No coloques las indicaciones de emoción de una oración lejos de la oración que controlan +- Abuses de las etiquetas en textos cortos +- Mezcles emociones en conflicto dentro de una misma oración +- Escribas descripciones entre corchetes tan largas que interrumpan el flujo +- Dejes una etiqueta descriptiva sin texto después de ella +- Alejes de la oración que controlan las indicaciones de emoción de nivel de oración -Si el resultado suena poco natural, espacia los cambios emocionales, baja la intensidad o prueba con otra voz: la misma etiqueta funciona distinto en cada voz. +Si la salida suena poco natural, espacia los cambios emocionales, baja la intensidad o prueba con otra voz: la misma etiqueta suena distinto en voces diferentes. -## Diálogo con varios hablantes {#multi-speaker-dialogue} +## Diálogo con varios hablantes -Conecta dos o más voces al nodo Fish Audio Text to Speech y luego marca los cambios de hablante en el texto con `@Voice1`, `@Voice2` y así sucesivamente. Cada voz conectada debe aparecer al menos una vez en el texto, o el nodo genera un error. Las conexiones de voz se explican en [Fish Audio: texto a voz, clonación de voz y voz a texto](/es/tutorials/partner-nodes/fishaudio/fish-audio#conectar-voces). +Conecta dos o más voces al nodo Fish Audio Texto a voz, luego marca los cambios de hablante en el texto con `@Voice1`, `@Voice2`, etc. Cada voz conectada debe aparecer en el texto al menos una vez; de lo contrario, el nodo genera un error. Las conexiones de voz se explican en [Fish Audio: Texto a voz, clonación de voz y voz a texto](/es/tutorials/partner-nodes/fishaudio/fish-audio#conectar-voces). ```text @Voice1 [nervous] You're sure no one followed you? @@ -221,9 +225,9 @@ Conecta dos o más voces al nodo Fish Audio Text to Speech y luego marca los cam @Voice2 [curious] You don't even know what it is? ``` -## Control de fonemas {#phoneme-control} +## Control de fonemas -Las etiquetas de fonemas especifican pronunciaciones exactas para nombres, homógrafos, siglas y términos técnicos. Envuelve la pronunciación de reemplazo entre las etiquetas `<|phoneme_start|>` y `<|phoneme_end|>`. Las etiquetas de fonemas se conservan durante la normalización del texto, así que mantén `normalize` activado. +Las etiquetas de fonemas especifican pronunciaciones exactas para nombres, homógrafos, siglas y términos técnicos. Encierra la pronunciación de reemplazo entre las etiquetas `<|phoneme_start|>` y `<|phoneme_end|>`. La normalización de texto conserva las etiquetas de fonemas, así que mantén `normalize` activado. **Inglés** (CMU Arpabet, reemplaza una palabra): @@ -231,13 +235,13 @@ Las etiquetas de fonemas especifican pronunciaciones exactas para nombres, homó I am an <|phoneme_start|>EH1 N JH AH0 N IH1 R<|phoneme_end|>. ``` -**Chino** (pinyin con número de tono, reemplaza un carácter o una sílaba; útil para caracteres polifónicos y nombres): +**Chino** (pinyin con número de tono, reemplaza un carácter o una sílaba, útil para caracteres polifónicos y nombres): ```text 我是一个<|phoneme_start|>gong1<|phoneme_end|><|phoneme_start|>cheng2<|phoneme_end|><|phoneme_start|>shi1<|phoneme_end|>。 ``` -**Japonés** (romaji estilo OpenJTalk con dígitos de acento tonal): +**Japonés** (romaji al estilo OpenJTalk con dígitos de acento tonal): ```text <|phoneme_start|>ha0shi1ga0<|phoneme_end|>見えます。 @@ -251,34 +255,34 @@ I am, um, an [break] <|phoneme_start|>EH1 N JH AH0 N IH1 R<|phoneme_end|>. ## Ajuste de parámetros -Los valores predeterminados están bien calibrados. Ajusta solo cuando lo necesites: +Los valores predeterminados están bien ajustados. Ajusta solo cuando lo necesites: | Parámetro | Valor predeterminado | Efecto | |-----------|---------|--------| | `temperature` | 0.7 | Expresividad. Un valor más alto es más variado, uno más bajo es más consistente | -| `top_p` | 0.7 | Diversidad mediante muestreo de núcleo | +| `top_p` | 0.7 | Diversidad mediante muestreo de núcleo (nucleus sampling) | | `speed` | 1.0 | Velocidad del habla, de 0.5 a 2.0 | | `volume` | 0.0 | Ajuste de volumen en decibelios, de -10 a 10 | -| `normalize` | true | Expande números y fechas para una lectura natural. Mantenlo activado a menos que la normalización reescriba texto que quieres leer literalmente | +| `normalize` | true | Expande números y fechas para una lectura natural. Mantenlo activado a menos que la normalización reescriba texto que quieres leer de forma literal | -La `seed` controla si el nodo se vuelve a ejecutar; los resultados no son deterministas independientemente del valor de la semilla. +El parámetro `seed` controla si el nodo se vuelve a ejecutar; los resultados no son deterministas, independientemente del valor de la semilla. ## Calidad de la clonación de voz -Para el nodo Fish Audio Instant Voice Clone, la calidad de la grabación de referencia determina el resultado. Consulta los límites de grabación en [Fish Audio: texto a voz, clonación de voz y voz a texto](/es/tutorials/partner-nodes/fishaudio/fish-audio#límites-de-la-clonación-de-voz): +Para el nodo Clonación instantánea de voz de Fish Audio, la calidad de la grabación de referencia decide el resultado. Los límites de grabación se explican en [Fish Audio: Text to Speech, clonación de voz y Speech to Text](/es/tutorials/partner-nodes/fishaudio/fish-audio#límites-de-la-clonación-de-voz): - Graba de 2 a 3 clips de 15 a 20 segundos cada uno, con menos de 270 segundos en total -- Un solo hablante, volumen constante, tono y emoción consistentes -- Pausas pequeñas entre frases, de aproximadamente medio segundo -- Habitación silenciosa, micrófono a una mano de distancia de la boca -- Una grabadora de teléfono o un micrófono de auriculares son suficientes; evita la música de fondo, la televisión y el eco +- Un solo hablante, volumen estable, tono y emoción uniformes +- Pausas breves entre frases, de aproximadamente medio segundo +- Una habitación silenciosa, con el micrófono a una mano de distancia de la boca +- Sirve una grabadora de teléfono o el micrófono de unos auriculares; evita la música de fondo, la TV y el eco -Si la voz clonada suena robótica, graba más material, de 30 a 60 segundos en total, y habla con naturalidad, con pausas. +Si la voz clonada suena robótica, graba más material, de 30 a 60 segundos en total, y habla con naturalidad, haciendo pausas. -Clona solo las voces que tengas permiso de usar: tu propia voz o la de alguien que te haya dado permiso explícito. +Clona solo voces que tengas permiso de usar: la tuya propia, o la de alguien que te haya dado permiso explícito. ## Referencias -- [Documentación sobre el control de emociones de Fish Audio](https://docs.fish.audio/developer-guide/core-features/emotions) -- [Documentación sobre el control detallado de Fish Audio](https://docs.fish.audio/developer-guide/core-features/fine-grained-control) +- [Documentación de control de emociones de Fish Audio](https://docs.fish.audio/developer-guide/core-features/emotions) +- [Documentación de control detallado de Fish Audio](https://docs.fish.audio/developer-guide/core-features/fine-grained-control) - [Prácticas recomendadas para la clonación de voces de Fish Audio](https://docs.fish.audio/developer-guide/best-practices/voice-cloning) diff --git a/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx b/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx index 9b022ecdfc..64adc9b912 100644 --- a/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx +++ b/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx @@ -2,48 +2,50 @@ title: "Topaz Image Enhance Bloom 2: ampliación creativa de imágenes con IA" description: "Amplía y mejora imágenes con Topaz Image Enhance Bloom 2 en ComfyUI: ampliación creativa que añade detalle, textura y elementos visuales" sidebarTitle: "Image Enhance Bloom 2" -translationSourceHash: ea0e893b +translationSourceHash: 243c9f97 translationFrom: tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx translationBlockHashes: "_intro": 1b619937 "What Topaz Image Enhance Bloom 2 is good at": bc0b5457 "Example outputs": 4eb243ba + "Topaz Image Enhance Bloom 2": 8e33b921 "Get started": 9c5c9043 --- + import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; Topaz Image Enhance Bloom 2 es un modelo de ampliación creativa disponible en ComfyUI a través de los nodos asociados de Topaz. Añade nuevo detalle, textura y elementos visuales a tus imágenes, con un control de creatividad de 1 a 9 para un refinamiento sutil o una reinterpretación audaz. Conserva la relación de aspecto de la entrada y admite factores de ampliación de 1x a 6x. -## Para qué es bueno Topaz Image Enhance Bloom 2 +## Para qué sirve Topaz Image Enhance Bloom 2 - **Ampliación creativa**: Agrega nuevos detalles, texturas y elementos visuales a tus imágenes -- **Creatividad ajustable**: Un control de 1 para una mejora contenida hasta 9 para una reinterpretación pronunciada +- **Creatividad ajustable**: Un control que va de 1 para una mejora contenida a 9 para una reinterpretación pronunciada - **Prompt automático**: Si el prompt está vacío, el modelo crea uno automáticamente - **Salida flexible**: Conserva la relación de aspecto de la entrada y admite factores de ampliación de 1x a 6x ## Salidas de ejemplo -Ampliación creativa de una imagen generada por IA, con nuevos detalles y texturas añadidos: +Ampliación creativa de una imagen generada por IA, con nuevo detalle y textura añadidos: ![Salida de Topaz Image Enhance Bloom 2](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/Upscaled_topaz_bloom2.png) -## Topaz Image Enhance Bloom 2 +## Mejorar imagen con Topaz Bloom 2 -Mejora imágenes generadas por IA con el modelo de ampliación creativa de Bloom 2, que añade nuevo detalle, textura y elementos visuales. El control de Creatividad va de 1, para una mejora contenida, a 9, para una reinterpretación marcada. Si el prompt está vacío, el modelo crea uno automáticamente. +Mejora las imágenes generadas por IA con el modelo de ampliación creativa de Bloom 2, que añade nuevo detalle, textura y elementos visuales. El control Creatividad va de 1, para una mejora contenida, a 9, para una reinterpretación marcada. Si el prompt está vacío, el modelo crea uno automáticamente. -Vista previa del flujo de trabajo Topaz Image Enhance Bloom 2 +Vista previa del flujo de trabajo Mejorar imagen con Topaz Bloom 2 Abrir en Comfy Cloud - Descarga el JSON o busca "Topaz Image Enhance Bloom 2" en la Biblioteca de plantillas + Descarga el JSON o busca "Topaz Image Enhance Bloom 2" en la Biblioteca de plantillas @@ -59,14 +61,14 @@ Descarga esta imagen de entrada de ejemplo para probar el flujo de trabajo: -![Salida de Topaz Image Enhance Bloom 2](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/Upscaled_topaz_bloom2.png) +![Salida de Mejorar imagen con Topaz Bloom 2](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/Upscaled_topaz_bloom2.png) ### Resumen del flujo de trabajo Este flujo de trabajo usa cuatro nodos: - **LoadImage**: proporciona la imagen de origen -- **TopazImageEnhanceV2**: el nodo principal, configurado con el modelo de ampliación `Bloom 2` +- **TopazImageEnhanceV2**: el nodo principal, configurado con el modelo de mejora `Bloom 2` - **SaveImageAdvanced**: guarda la salida mejorada como PNG - **ImageCompare**: muestra el resultado mejorado junto al original para compararlos @@ -74,11 +76,11 @@ Este flujo de trabajo usa cuatro nodos: 1. **Carga una imagen**: sube o selecciona tu imagen de entrada en el nodo **LoadImage** 2. **Selecciona el modelo**: mantén `Bloom 2` en el nodo **TopazImageEnhanceV2** -3. **Establece la creatividad**: de 1 para una mejora contenida a 9 para una reinterpretación marcada +3. **Ajusta la creatividad**: de 1 para una mejora contenida a 9 para una reinterpretación marcada 4. **Prompt opcional**: déjalo vacío para que el modelo cree uno automáticamente 5. **Haz clic en Queue**: pulsa `Ctrl+Enter` para generar ## Empezar 1. Actualiza ComfyUI a la última versión -2. Ve a la Biblioteca de plantillas y busca `Topaz Image Enhance Bloom 2` \ No newline at end of file +2. Ve a la Biblioteca de plantillas y busca `Topaz Image Enhance Bloom 2` diff --git a/es/tutorials/video/bytedance/bernini-r.mdx b/es/tutorials/video/bytedance/bernini-r.mdx index 6a796a6bce..10d3f7b823 100644 --- a/es/tutorials/video/bytedance/bernini-r.mdx +++ b/es/tutorials/video/bytedance/bernini-r.mdx @@ -2,26 +2,28 @@ title: "Bernini-R en ComfyUI: edición de imágenes y video en contexto" description: "Edita imágenes y video en ComfyUI con ByteDance Bernini-R, un modelo Wan 2.2 solo de renderizado que usa imágenes o video de referencia sin entrenamiento LoRA." sidebarTitle: "Bernini-R" -translationSourceHash: 28ac25ab +translationSourceHash: d89830ba translationFrom: tutorials/video/bytedance/bernini-r.mdx translationBlockHashes: "_intro": b791048b + "Model Installation": 286fbd69 "Example Workflows": cf2f84c1 "1. Image Editing": a9437ae9 "2. Video Editing": d17ea37c "Community Resources": 9b4a0aaf --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' # Introducción a ComfyUI Bernini-R -[Bernini-R](https://github.com/bytedance/Bernini) es el modelo Wan 2.2 **solo de renderizado** de ByteDance para el conditioning de imágenes y video en contexto. Utiliza un conjunto de flujos de conditioning (video fuente, imágenes de referencia, video de referencia) para guiar la generación. No requiere entrenamiento de LoRA ni ajuste fino. +[Bernini-R](https://github.com/bytedance/Bernini) es el modelo Wan 2.2 de ByteDance **solo para renderizado**, pensado para el acondicionamiento de imágenes y video en contexto. Usa un conjunto de flujos de acondicionamiento (video fuente, imágenes de referencia, video de referencia) para guiar la generación. No requiere entrenamiento de LoRA ni ajuste fino. Capacidades principales: - **Varios tipos de tarea en un solo modelo**: generación de imagen y video, edición, cambio de iluminación, cambio de estilo, inserción de sujetos -- **Acondicionamiento en contexto**: las imágenes y videos de referencia actúan como prompts visuales, inyectados como tokens -- **Ligero**: modelo solo de renderizado. Sin backbone de difusión de texto a video. +- **Acondicionamiento en contexto**: las imágenes y los videos de referencia actúan como prompts visuales y se inyectan como tokens +- **Ligero**: modelo solo para renderizado. No usa un backbone de difusión de texto a video. - **Soporte flexible de entradas**: referencias de una o varias imágenes, video a video, edición guiada por referencia Bernini-R admite estos tipos de tarea: @@ -31,7 +33,7 @@ Bernini-R admite estos tipos de tarea: | **t2v** | Prompt de texto | Generación de texto a video | | **v2v** | Video fuente | Cambio de estilo de video a video | | **rv2v** | Video fuente + imagen(es) de referencia | Edición de video guiada por referencia (cambio de iluminación, inserción de sujetos) | -| **r2v** | Solo imagen(es) de referencia | Generación de referencia a video | +| **r2v** | Solo imagen(es) de referencia | Generación de video a partir de referencias | | **img** | Imagen fuente + prompt de texto | Edición de imagen (cambio de iluminación, cambio de estilo, inserción de sujetos) | | **ads2v** | Video fuente + video de referencia | Insertar contenido de imagen o video en el video fuente | @@ -43,7 +45,7 @@ ComfyUI ahora admite de forma nativa los nodos de Bernini-R. Asegúrate de haber ## Instalación de modelos -Descarga los pesos de modelo necesarios y guárdalos en las carpetas correspondientes de ComfyUI: +Descarga los pesos de modelo requeridos y guárdalos en las carpetas correspondientes de ComfyUI: **text_encoders:** - [umt5_xxl_fp8_e4m3fn_scaled.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensors?download=true) @@ -76,16 +78,16 @@ ComfyUI/ ## 1. Edición de imagen -**Qué hace:** genera una imagen editada con iluminación coincidente y consulta una comparación en paralelo de antes y después. Es ideal para cambiar la iluminación de retratos y productos, mantener una iluminación coherente en conjuntos de fotos y para fotografía de catálogo de comercio electrónico. +**Qué hace:** Genera una imagen editada con iluminación coincidente y consulta una comparación en paralelo de antes y después. Ideal para volver a iluminar retratos y productos, mantener una iluminación coherente en series de fotos y fotografía de catálogo para comercio electrónico. -Vista previa del flujo de trabajo de edición de imagen con Bernini-R +Vista previa del flujo de trabajo de edición de imágenes de Bernini-R Abrir en Comfy Cloud - Descarga el JSON o busca "Bernini-R" en la biblioteca de plantillas + Descarga el JSON o busca "Bernini-R" en la Biblioteca de plantillas @@ -104,14 +106,14 @@ ComfyUI/ 1. **Selecciona el tipo de tarea**: elige tu tarea (Image Editing, Subject to Image, etc.) 2. **Conecta las entradas**: carga la imagen de origen y las imágenes de referencia opcionales -3. **Escribe el prompt**: describe la edición que deseas -4. **Ejecuta**: haz clic en Queue o usa `Cmd+Enter` +3. **Escribe el prompt**: describe la edición deseada +4. **Run**: haz clic en Queue o usa `Cmd+Enter` -**Entrada de imagen de referencia:** úsala para **Subject to Image** cuando necesites una o más imágenes de referencia (sujeto, vestuario, escena, accesorios). En el prompt, usa `image0`, `image1`, … para hacer referencia a cada imagen. No es necesaria para **Image Editing**: esa tarea usa `source_image` en su lugar. +**Entrada de imagen de referencia:** Úsala para **Subject to Image** cuando necesites una o más imágenes de referencia (sujeto, vestuario, escena, accesorios). En el prompt, usa `image0`, `image1`, … para hacer referencia a cada imagen. No es necesaria para **Image Editing**: esa tarea usa `source_image` en su lugar. - Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y extender el flujo de trabajo. + Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. @@ -119,16 +121,16 @@ ComfyUI/ ## 2. Edición de video -**Qué hace:** Genera un video editado con una nueva iluminación consistente usando Bernini-R. Conecta un video de origen, una o varias imágenes de referencia opcionales o un video de referencia, elige el tipo de tarea, escribe un prompt y ejecuta. +**Qué hace:** Genera un video editado con una iluminación coherente usando Bernini-R. Conecta un video de origen, imágenes de referencia o un video de referencia opcionales, elige el tipo de tarea, escribe un prompt y ejecuta. -Vista previa del flujo de trabajo de edición de video con Bernini-R +Vista previa del flujo de trabajo de edición de video de Bernini-R Abrir en Comfy Cloud - Descarga el JSON o busca "Bernini-R" en Biblioteca de plantillas + Descarga el JSON o busca "Bernini-R" en la Biblioteca de plantillas @@ -146,16 +148,16 @@ ComfyUI/ ### Pasos para ejecutar 1. **Carga el video de origen**: conecta tu video de entrada -2. **(Opcional) Carga las referencias**: una o varias imágenes de referencia o un video de referencia +2. **(Opcional) Carga las referencias**: imágenes de referencia o video de referencia 3. **Selecciona el tipo de tarea**: v2v, rv2v, r2v o ads2v -4. **Escribe el prompt**: describe la edición que quieres -5. **Ejecuta**: haz clic en Queue o usa `Cmd+Enter` +4. **Escribe el prompt**: describe la edición deseada +5. **Run**: haz clic en Queue o usa `Cmd+Enter` -**Entrada de imagen de referencia:** úsala cuando una tarea necesite una o más imágenes de referencia (rv2v, r2v, conjuntos de varias prendas). Cada imagen del lote se convierte en su propio token en contexto. Menciona `image0`, `image1`, … en el prompt si las referencias cumplen funciones distintas. +**Entrada de imagen de referencia:** Úsala cuando una tarea necesite una o más imágenes de referencia (rv2v, r2v, atuendos con varias piezas). Cada imagen del lote se convierte en su propio token en contexto. Menciona `image0`, `image1`, … en el prompt si las referencias cumplen funciones distintas. - Este flujo de trabajo usa nodos Subgraph para un procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. + Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. @@ -163,6 +165,6 @@ ComfyUI/ ## Recursos de la comunidad -- [Bernini GitHub (bytedance/Bernini)](https://github.com/bytedance/Bernini): Documentación del artículo de investigación y de las tareas -- [Comfy-Org/Bernini-R](https://huggingface.co/Comfy-Org/Bernini-R): Pesos oficiales del modelo para ComfyUI +- [Bernini GitHub (bytedance/Bernini)](https://github.com/bytedance/Bernini): Artículo de investigación y documentación de tareas +- [Comfy-Org/Bernini-R](https://huggingface.co/Comfy-Org/Bernini-R): Pesos oficiales del modelo de ComfyUI - [Bernini: Latent Semantic Planning for Video Diffusion](https://arxiv.org/abs/2605.22344): Artículo de investigación diff --git a/es/tutorials/video/hunyuan/hunyuan-video-1-5.mdx b/es/tutorials/video/hunyuan/hunyuan-video-1-5.mdx index d536767e6e..9258b9026c 100644 --- a/es/tutorials/video/hunyuan/hunyuan-video-1-5.mdx +++ b/es/tutorials/video/hunyuan/hunyuan-video-1-5.mdx @@ -2,14 +2,17 @@ title: "HunyuanVideo 1.5 en ComfyUI: T2V e I2V en GPUs de consumo" description: "Ejecuta HunyuanVideo 1.5 en ComfyUI con una GPU de 24 GB: texto a video e imagen a video de 8.3B en 720p, más un upscaler de superresolución para 1080p." sidebarTitle: "HunyuanVideo 1.5" -translationSourceHash: 3d889bf3 +translationSourceHash: 0c287152 translationFrom: tutorials/video/hunyuan/hunyuan-video-1-5.mdx translationBlockHashes: "_intro": 74d9d0ad "Model highlights": a18b0a64 + "Common models for all workflows": eb36d964 "Hunyuan Video 1.5 Text-to-Video Workflow": a6511c93 "Hunyuan Video 1.5 Image-to-Video Workflow": 9e20cd3b + "Super-resolution upscaler": 59623be1 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; [HunyuanVideo 1.5](https://github.com/Tencent/HunyuanVideo) es un modelo ligero de 8.3B parámetros desarrollado por el equipo Hunyuan de Tencent. Ofrece generación de video con calidad de primer nivel en GPUs de consumo (24 GB de VRAM), lo que reduce enormemente la barrera de entrada sin sacrificar la calidad. @@ -20,7 +23,7 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; - **Potencia compacta**: Ofrece un rendimiento SOTA comparable al de modelos más grandes mientras se ejecuta en hardware de consumo. - **Generación versátil**: Admite generación de texto a video e imagen a video (5-10s) de alta calidad con una consistencia excepcional. -- **Control preciso**: Sigue instrucciones con solidez para movimientos de cámara, física y expresiones emocionales. +- **Control preciso**: Sólido seguimiento de instrucciones para movimientos de cámara, física y expresiones emocionales. - **Calidad cinematográfica**: Salida nativa en 720p (ampliable a 1080p) con una estética profesional. - **Funciones completas**: Admite diversos estilos (realista, anime, 3D) y renderizado de texto en el video (chino/inglés). @@ -30,13 +33,13 @@ Los siguientes modelos se usan tanto en los flujos de trabajo de texto a video c - qwen_2.5_vl_7b_fp8_scaled.safetensors — guárdalo en ComfyUI/models/text_encoders/ + qwen_2.5_vl_7b_fp8_scaled.safetensors: guárdalo en ComfyUI/models/text_encoders/ - byt5_small_glyphxl_fp16.safetensors — guárdalo en ComfyUI/models/text_encoders/ + byt5_small_glyphxl_fp16.safetensors: guárdalo en ComfyUI/models/text_encoders/ - - hunyuanvideo15_vae_fp16.safetensors — guárdalo en ComfyUI/models/vae/ + + hunyuanvideo15_vae_fp16.safetensors: guárdalo en ComfyUI/models/vae/ @@ -52,9 +55,9 @@ ComfyUI/ │ └── hunyuanvideo15_vae_fp16.safetensors ``` -## Flujo de trabajo de texto a video de Hunyuan Video 1.5 +## Flujo de trabajo de texto a video con Hunyuan Video 1.5 -HunyuanVideo 1.5 Text-to-Video genera videos de 5 a 10 segundos a partir de descripciones en lenguaje natural, con mejor calidad y menores requisitos de VRAM. +HunyuanVideo 1.5 Text-to-Video genera videos de 5 a 10 segundos a partir de descripciones en lenguaje natural, con mayor calidad y menores requisitos de VRAM. ![Flujo de trabajo de ComfyUI - Hunyuan Video 1.5 T2V](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_hunyuan_video_1.5_720p_t2v-1.webp) @@ -71,11 +74,11 @@ HunyuanVideo 1.5 Text-to-Video genera videos de 5 a 10 segundos a partir de desc - hunyuanvideo1.5_720p_t2v_fp16.safetensors: guárdalo en ComfyUI/models/diffusion_models/ + hunyuanvideo1.5_720p_t2v_fp16.safetensors — guarda el archivo en ComfyUI/models/diffusion_models/ -#### Almacenamiento de modelos +#### Almacenamiento de los modelos ``` ComfyUI/ @@ -99,12 +102,12 @@ ComfyUI/ 4. Haz clic en el botón `Queue` o usa el atajo `Ctrl(Cmd) + Enter` para ejecutar el flujo de trabajo -El flujo de trabajo incluye un nodo de superresolución. Cuando está habilitado, usa `hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors` para aumentar la resolución de la salida a 1080p. +El flujo de trabajo incluye un nodo de upscale con superresolución. Cuando está habilitado, usa `hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors` para escalar la salida a 1080p. -## Flujo de trabajo de imagen a video con Hunyuan Video 1.5 +## Flujo de trabajo de imagen a video de Hunyuan Video 1.5 -HunyuanVideo 1.5 imagen a video transforma imágenes estáticas en videos suaves y de alta calidad, con mejor consistencia y dinámica de movimiento. +HunyuanVideo 1.5 Imagen a video transforma imágenes estáticas en videos suaves y de alta calidad, con mejor consistencia y dinámica de movimiento. ![Flujo de trabajo de ComfyUI - Hunyuan Video 1.5 I2V](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_hunyuan_video_1.5_720p_i2v-1.webp) @@ -129,10 +132,10 @@ HunyuanVideo 1.5 imagen a video transforma imágenes estáticas en videos suaves - sigclip_vision_patch14_384.safetensors: guardar en ComfyUI/models/clip_vision/ + sigclip_vision_patch14_384.safetensors: guárdalo en ComfyUI/models/clip_vision/ - hunyuanvideo1.5_720p_i2v_fp16.safetensors: guardar en ComfyUI/models/diffusion_models/ + hunyuanvideo1.5_720p_i2v_fp16.safetensors: guárdalo en ComfyUI/models/diffusion_models/ @@ -162,14 +165,14 @@ ComfyUI/ 4. Asegúrate de que el nodo `Load VAE` haya cargado `hunyuanvideo15_vae_fp16.safetensors` 5. Haz clic en el botón `Queue` o usa el atajo `Ctrl(Cmd) + Enter` para ejecutar el flujo de trabajo -## Ampliador de superresolución +## Upscaler de superresolución -Ambos flujos de trabajo incluyen un nodo de superresolución que puede hacer upscale del video de salida de 720p a 1080p. Este ampliador opcional usa un modelo destilado para obtener una salida de alta resolución de forma eficiente. +Ambos flujos de trabajo incluyen un nodo de superresolución que puede hacer upscale del video de salida de 720p a 1080p. Este upscaler opcional usa un modelo destilado para una salida de alta resolución eficiente. - - hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors — guárdalo en ComfyUI/models/diffusion_models/ + + hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors: guárdalo en ComfyUI/models/diffusion_models/ -Todos los modelos compartidos y específicos de cada flujo de trabajo, en conjunto: +Todos los modelos compartidos y específicos del flujo de trabajo combinados: ``` ComfyUI/ @@ -186,3 +189,4 @@ ComfyUI/ │ ├── hunyuanvideo1.5_720p_i2v_fp16.safetensors // I2V model │ └── hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors // Upscaler ``` + diff --git a/es/tutorials/video/kandinsky/kandinsky-5.mdx b/es/tutorials/video/kandinsky/kandinsky-5.mdx index 0c36c06627..ebadca8656 100644 --- a/es/tutorials/video/kandinsky/kandinsky-5.mdx +++ b/es/tutorials/video/kandinsky/kandinsky-5.mdx @@ -2,33 +2,36 @@ title: "Kandinsky 5.0 en ComfyUI: texto a video e imagen a video" description: "Usa Kandinsky 5.0 Video Lite en ComfyUI: texto a video de hasta 10 segundos e imagen a video de 5 segundos, con variantes SFT de 2B, no-CFG y destilada." sidebarTitle: "Kandinsky 5.0" -translationSourceHash: 0766e01c +translationSourceHash: e0a46d75 translationFrom: tutorials/video/kandinsky/kandinsky-5.mdx translationBlockHashes: "_intro": cd71d0f9 "Overview": dead89b1 "Model variants": 3bdbc0cb + "Text-to-Video workflow": 8641d2fb + "Image-to-Video workflow": b945bc9a "Resources": fa8f3352 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -[Kandinsky 5.0](https://huggingface.co/kandinskylab/Kandinsky-5.0-I2V-Lite-5s) es una familia de modelos de difusión para la generación de video e imágenes desarrollada por [Kandinsky Lab](https://huggingface.co/kandinskylab). Kandinsky 5.0 T2V Lite es un modelo ligero de 2B parámetros que se ubica entre los mejores modelos de generación de video de código abierto, capaz de generar videos de hasta 10 segundos de duración. +[Kandinsky 5.0](https://huggingface.co/kandinskylab/Kandinsky-5.0-I2V-Lite-5s) es una familia de modelos de difusión para la generación de video e imágenes, desarrollada por [Kandinsky Lab](https://huggingface.co/kandinskylab). Kandinsky 5.0 T2V Lite es un modelo ligero de 2B de parámetros que figura entre los mejores modelos de generación de video de código abierto y es capaz de generar videos de hasta 10 segundos de duración. ## Descripción general -Kandinsky 5.0 usa un pipeline de difusión latent con Flow Matching e incluye: +Kandinsky 5.0 usa un pipeline de difusión latente con Flow Matching e incluye: - **Diffusion Transformer (DiT):** Arquitectura generativa principal con atención cruzada a los embeddings de texto -- **Qwen2.5-VL y CLIP:** Proporciona embeddings de texto de alta calidad -- **HunyuanVideo 3D VAE:** Codifica y decodifica el video en un espacio latent +- **Qwen2.5-VL y CLIP:** Proporcionan embeddings de texto de alta calidad +- **HunyuanVideo 3D VAE:** Codifica y decodifica el video en un espacio latente -La familia de modelos incluye varias variantes optimizadas para diferentes casos de uso: +La familia de modelos incluye varias variantes optimizadas para distintos casos de uso: - **Modelo SFT:** Máxima calidad de generación - **CFG-distilled:** Inferencia 2× más rápida - **Diffusion-distilled:** 6× más rápida con una pérdida mínima de calidad (16 pasos) -- **Modelo preentrenado:** Diseñado para fine-tuning +- **Modelo preentrenado:** Diseñado para ajuste fino Todos los modelos están disponibles en versiones de generación de video de 5 y 10 segundos. @@ -47,7 +50,7 @@ Todos los modelos están disponibles en versiones de generación de video de 5 y Un modelo ligero de 2B que genera videos a partir de prompts en inglés y ruso con alta calidad visual. -Vista previa del flujo de trabajo Kandinsky 5.0 Video Lite de texto a video +Vista previa del flujo de trabajo Kandinsky 5.0 Video Lite Text to Video @@ -63,18 +66,18 @@ Un modelo ligero de 2B que genera videos a partir de prompts en inglés y ruso c **Codificadores de texto** - + Codificador de texto Qwen2.5-VL 7B (FP8). Colócalo en ComfyUI/models/text_encoders/ - + Codificador de texto CLIP-L. Colócalo en ComfyUI/models/text_encoders/ **Modelo de difusión** - - Modelo de difusión Kandinsky 5.0 T2V Lite SFT (5 s). Colócalo en ComfyUI/models/diffusion_models/ + + Modelo de difusión Kandinsky 5.0 T2V Lite SFT (5s). Colócalo en ComfyUI/models/diffusion_models/ **VAE** @@ -99,7 +102,7 @@ ComfyUI/ Un modelo ligero de 2B que genera videos a partir de prompts en inglés y ruso con alta calidad visual. -Vista previa del flujo de trabajo Kandinsky 5.0 Video Lite de imagen a video +Vista previa del flujo de trabajo Kandinsky 5.0 Video Lite Image to Video @@ -140,7 +143,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: **Modelo de difusión** - Modelo de difusión Kandinsky 5.0 I2V Lite (5 s). Colócalo en ComfyUI/models/diffusion_models/ + Modelo de difusión Kandinsky 5.0 I2V Lite (5s). Colócalo en ComfyUI/models/diffusion_models/ **VAE** @@ -161,7 +164,7 @@ ComfyUI/ ## Recursos -- [Colección de modelos de Hugging Face](https://huggingface.co/collections/kandinskylab/kandinsky-50-video-lite) +- [Colección de modelos de HuggingFace](https://huggingface.co/collections/kandinskylab/kandinsky-50-video-lite) - [Repositorio de GitHub](https://github.com/ai-forever/Kandinsky-5) - [Integración con ComfyUI](https://github.com/ai-forever/Kandinsky-5/blob/main/comfyui/README.md) - [Página del proyecto](https://kandinskylab.github.io/kandinsky-5/) diff --git a/es/tutorials/video/ltx/ltx-2-3.mdx b/es/tutorials/video/ltx/ltx-2-3.mdx index 4d7e6dcbea..5a3974488c 100644 --- a/es/tutorials/video/ltx/ltx-2-3.mdx +++ b/es/tutorials/video/ltx/ltx-2-3.mdx @@ -2,18 +2,20 @@ title: "LTX-2.3 en ComfyUI: flujos de video y audio" description: "Usa LTX-2.3 en ComfyUI con flujos nativos para texto a video, imagen a video, FLF2V, video controlado por audio, control IC-LoRA y personalización ID-LoRA." sidebarTitle: "LTX-2.3" -translationSourceHash: 0519dac5 +translationSourceHash: 2e21405a translationFrom: tutorials/video/ltx/ltx-2-3.mdx translationBlockHashes: "_intro": 2afce33d "Key features": 3ddea9bd "Getting started": 8bd36b77 + "ComfyUI Native Workflows": fb09a224 "Prompting tips": f92227b7 "Resources": 3f045765 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -[LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3) es la última evolución del modelo de generación de audio y video de código abierto de Lightricks, ahora compatible de forma nativa con ComfyUI. Sobre la base de LTX-2, esta versión ofrece mejoras importantes de calidad en detalles finos, video de retratos, calidad de audio, consistencia de imagen a video, comprensión de prompts y renderizado de texto. +[LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3) es la última evolución del modelo de generación de audio y video de código abierto de Lightricks, ahora compatible de forma nativa con ComfyUI. Tomando como base LTX-2, esta versión ofrece mejoras importantes de calidad en los detalles finos, el video de retrato, la calidad de audio, la consistencia de imagen a video, la comprensión de prompts y el renderizado de texto. ComfyUI incluye seis flujos de trabajo nativos para LTX-2.3, cada uno diseñado para un modo de generación específico: @@ -29,11 +31,11 @@ ComfyUI incluye seis flujos de trabajo nativos para LTX-2.3, cada uno diseñado ## Características clave - **Detalles más finos**: nuevo espacio latente y VAE actualizado para texturas más nítidas, bordes más limpios y visuales más precisos -- **Soporte para formato vertical 9:16**: calidad muy mejorada en videos verticales -- **Mejor audio**: sonido más limpio con menos ruido y diálogos mejorados +- **Soporte para 9:16 vertical**: calidad muy mejorada en videos en formato retrato +- **Mejor audio**: sonido más limpio, con menos ruido y diálogos mejorados - **Imagen a video mejorado**: movimiento más consistente y menos fallos - **Comprensión de prompts más inteligente**: codificador de texto mejorado para una interpretación más precisa -- **Soporte nativo en ComfyUI**: todos los flujos de trabajo son integrados, no se requieren Nodos personalizados +- **Soporte nativo en ComfyUI**: todos los flujos de trabajo están integrados y no necesitas nodos personalizados ## Primeros pasos @@ -41,21 +43,21 @@ LTX-2.3 es compatible de forma nativa con ComfyUI. Para empezar: 1. Actualiza ComfyUI a la última versión 2. Ve a **Biblioteca de plantillas** > **Video** > elige cualquier flujo de trabajo de LTX-2.3 -3. Sigue la ventana emergente para descargar los modelos y ejecutar el flujo de trabajo +3. Sigue las indicaciones de la ventana emergente para descargar los modelos y ejecutar el flujo de trabajo ## Flujos de trabajo nativos de ComfyUI -### LTX-2.3 Texto a video (T2V) +### LTX-2.3 Text to Video (T2V) -Genera videos a partir de prompts de texto con mejor comprensión de prompts y mejor renderizado de texto. +Genera videos a partir de prompts de texto con una mejor comprensión de los prompts y renderizado de texto. ### LTX-2.3 Texto a video {#video_ltx2_3_t2v} -Genera videos a partir de prompts de texto con mejor comprensión de prompts y mejor renderizado de texto. +Genera videos a partir de prompts de texto con mejor comprensión de prompts y renderizado de texto. -Vista previa del flujo de trabajo LTX-2.3 Text to Video +LTX-2.3 Texto a video ( vista previa del flujo de trabajo @@ -66,7 +68,7 @@ Genera videos a partir de prompts de texto con mejor comprensión de prompts y m -#### Descarga de modelos +#### Descargas de modelos @@ -78,7 +80,7 @@ Genera videos a partir de prompts de texto con mejor comprensión de prompts y m Colócalo en ComfyUI/models/loras/ - + Colócalo en ComfyUI/models/text_encoders/ @@ -106,7 +108,7 @@ ComfyUI/ 1. **Acciones principales**: Describe los eventos y las acciones tal como ocurren a lo largo del tiempo 2. **Detalles visuales**: Describe todos los detalles visuales que quieres que aparezcan en el video -3. **Audio**: Describe los sonidos y el diálogo que necesita la escena +3. **Audio**: Describe los sonidos y el diálogo necesarios para la escena --- @@ -120,7 +122,7 @@ Genera videos a partir de una imagen de entrada con un movimiento más consisten Genera videos a partir de una imagen de entrada con una consistencia de movimiento mejorada. -Vista previa del flujo de trabajo LTX-2.3 Image to Video +LTX-2.3 Imagen a video ( vista previa del flujo de trabajo @@ -137,9 +139,9 @@ Genera videos a partir de una imagen de entrada con una consistencia de movimien -#### Descarga de modelos +#### Descargas de modelos -El flujo de trabajo I2V usa el mismo conjunto de modelos que el de texto a video. +El flujo de trabajo I2V usa el mismo conjunto de modelos que texto a video. @@ -151,7 +153,7 @@ El flujo de trabajo I2V usa el mismo conjunto de modelos que el de texto a video Colócalo en ComfyUI/models/loras/ - + Colócalo en ComfyUI/models/text_encoders/ @@ -179,22 +181,22 @@ ComfyUI/ ### LTX-2.3 FLF2V -Interpola entre una imagen inicial y una imagen final para generar una transición de video fluida. +Interpola entre una imagen inicial y una imagen final para generar una transición de video suave. -### LTX-2.3 Primer y último fotograma a video {#video_ltx2_3_flf2v} +### LTX-2.3: convertir de primer y último fotograma a video {#video_ltx2_3_flf2v} Interpola entre una imagen inicial y una final. -Vista previa del flujo de trabajo LTX-2.3 First-Last Frame to Video +LTX-2.3: primer y último fotograma a video (vista previa del flujo de trabajo) Abrir en Comfy Cloud - Descarga el JSON o busca "LTX-2.3 FLF2V" en la Biblioteca de plantillas + Descarga el JSON o busca "LTX-2.3 FLF2V" en la biblioteca de plantillas @@ -207,15 +209,15 @@ Interpola entre una imagen inicial y una final. -#### Descarga de modelos +#### Descargas de modelos -El flujo de trabajo FLF2V usa el checkpoint distilled en lugar del checkpoint dev. +El flujo de trabajo FLF2V usa el checkpoint destilado en lugar del checkpoint dev. Colócalo en ComfyUI/models/checkpoints/ - + Colócalo en ComfyUI/models/text_encoders/ @@ -231,26 +233,24 @@ ComfyUI/ │ └── gemma_3_12B_it_fp4_mixed.safetensors ``` ---- - -### LTX-2.3 Imagen y audio a video (IA2V) +### LTX-2.3 Image Audio to Video (IA2V) -Sube una imagen y un archivo de audio para generar un video de alta calidad con movimientos labiales sincronizados. +Sube una imagen y un archivo de audio para generar un video de alta calidad con movimientos de labios sincronizados. ### LTX-2.3 Imagen y audio a video {#video_ltx2_3_ia2v} -Genera videos con sincronización labial a partir de una imagen y audio. +Genera videos con sincronización de labios a partir de una imagen y un audio. -Vista previa del flujo de trabajo LTX-2.3 Image and Audio to Video +LTX-2.3 Imagen y audio a video ( vista previa del flujo de trabajo - Abrir en Comfy Cloud + Abre en Comfy Cloud - Descarga el JSON o busca "LTX-2.3 IA2V" en la Biblioteca de plantillas + Descarga el JSON o busca "LTX-2.3 IA2V" en Template Library @@ -259,29 +259,29 @@ Genera videos con sincronización labial a partir de una imagen y audio. Imagen de referencia para el personaje que habla. - Pista de audio para la sincronización labial. + Pista de audio para la sincronización de labios. -#### Descarga de modelos +#### Descargas de modelos El flujo de trabajo IA2V usa el mismo conjunto de modelos que el de texto a video. - Colócalo en ComfyUI/models/checkpoints/ + Coloca en ComfyUI/models/checkpoints/ - - Colócalo en ComfyUI/models/loras/ + + Coloca en ComfyUI/models/loras/ - Colócalo en ComfyUI/models/loras/ + Coloca en ComfyUI/models/loras/ - - Colócalo en ComfyUI/models/text_encoders/ + + Coloca en ComfyUI/models/text_encoders/ - Colócalo en ComfyUI/models/latent_upscale_models/ + Coloca en ComfyUI/models/latent_upscale_models/ @@ -303,9 +303,9 @@ ComfyUI/ --- -### LTX-2.3 IC-LoRA Union Control +### Control Union con IC-LoRA de LTX-2.3 -Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como profundidad, pose o bordes. IC-LoRA es un LoRA in-context entrenado sobre LTX-2.3 que aplica la guía estructural de un video de referencia. Acepta señales de control de varios preprocesadores, incluidos mapas de profundidad, bordes de Canny y esqueletos de pose. Este flujo de trabajo usa un Subgraph para el procesamiento modular. +Genera videos de LTX-2.3 con IC-LoRA usando entradas de control alineadas como profundidad, pose o bordes. IC-LoRA es un LoRA en contexto entrenado sobre LTX-2.3 que aplica orientación estructural a partir de un video de referencia. Acepta señales de control de varios preprocesadores, incluidos mapas de profundidad, bordes Canny y esqueletos de pose. Este flujo de trabajo usa un subgrafo para el procesamiento modular. ![Vista previa de LTX-2.3 IC-LoRA](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_ltx2_3_ic_lora-1.webp) @@ -318,7 +318,7 @@ Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como pr - + Este flujo de trabajo usa un nodo Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. @@ -326,14 +326,14 @@ Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como pr - Video guía del que se extrae la señal de control. + Video guía para extraer la señal de control. Imagen de referencia para el estilo y el contenido. -#### Descarga de modelos +#### Descargas de modelos @@ -345,10 +345,10 @@ Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como pr Colócalo en ComfyUI/models/loras/ - + Colócalo en ComfyUI/models/text_encoders/ - + Colócalo en ComfyUI/models/geometry_estimation/ @@ -373,13 +373,13 @@ ComfyUI/ ### Edición de video con IC-LoRA -Los pesos IC-LoRA no se limitan al control de la generación. La Biblioteca de plantillas incluye flujos de trabajo IC-LoRA de LTX-2.3 ya preparados para editar material existente, y cada uno se ejecuta en Comfy Cloud o de forma local en ComfyUI. Los checkpoints IC-LoRA de la comunidad entrenados sobre LTX-2.3 (por ejemplo, la familia [LTX2.3-ICEdit-Insight](https://huggingface.co/joyfox/LTX2.3-ICEdit-Insight)) también son compatibles con el modelo nativo LTX-2.3. +Los pesos IC-LoRA no se limitan al control de la generación. La Biblioteca de plantillas incluye flujos de trabajo LTX-2.3 IC-LoRA listos para editar material existente, y cada uno se ejecuta en Comfy Cloud o de forma local en ComfyUI. Los checkpoints IC-LoRA de la comunidad entrenados sobre LTX-2.3 (por ejemplo, la familia [LTX2.3-ICEdit-Insight](https://huggingface.co/joyfox/LTX2.3-ICEdit-Insight)) también son compatibles con el modelo nativo LTX-2.3. #### Eliminar subtítulos de un video Elimina subtítulos, rótulos, marcas de agua u otras superposiciones de texto de un video: -Vista previa del flujo de trabajo de eliminación de subtítulos de LTX-2.3 +LTX-2.3 Remove Subtitles workflow preview @@ -393,20 +393,20 @@ Elimina subtítulos, rótulos, marcas de agua u otras superposiciones de texto d
Materiales de entrada -Descarga este video de entrada de ejemplo para probar el flujo de trabajo: +Descarga este video de entrada de muestra para probar el flujo de trabajo: - - Descarga el video de entrada de ejemplo + + Descargar video de entrada de muestra
#### Eliminar un objeto de un video -Elimina un objeto concreto del primer plano de un video describiéndolo en el prompt: +Elimina un objeto específico del primer plano de un video describiéndolo en el prompt: -Vista previa del flujo de trabajo de eliminación de objetos de LTX-2.3 +LTX-2.3 Remove Object workflow preview @@ -420,11 +420,11 @@ Elimina un objeto concreto del primer plano de un video describiéndolo en el pr
Materiales de entrada -Descarga este video de entrada de ejemplo para probar el flujo de trabajo: +Descarga este video de entrada de muestra para probar el flujo de trabajo: - - Descarga el video de entrada de ejemplo + + Descargar video de entrada de muestra
@@ -433,7 +433,7 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo: Restaura material de archivo antiguo o degradado: -Vista previa del flujo de trabajo de restauración de material de archivo de LTX-2.3 +LTX-2.3 Restore Archival Footage workflow preview @@ -447,20 +447,20 @@ Restaura material de archivo antiguo o degradado:
Materiales de entrada -Descarga este video de entrada de ejemplo para probar el flujo de trabajo: +Descarga este video de entrada de muestra para probar el flujo de trabajo: - - Descarga el video de entrada de ejemplo + + Descargar video de entrada de muestra
#### Outpainting de video -Amplía un video en cualquier dirección con el IC-LoRA Video Outpainting de LTX-2.3: +Expande un video en cualquier dirección con el IC-LoRA Video Outpainting de LTX-2.3: -Vista previa del flujo de trabajo de outpainting de video de LTX-2.3 +LTX-2.3 Video Outpainting workflow preview @@ -474,27 +474,27 @@ Amplía un video en cualquier dirección con el IC-LoRA Video Outpainting de LTX
Materiales de entrada -Descarga este video de entrada de ejemplo para probar el flujo de trabajo: +Descarga este video de entrada de muestra para probar el flujo de trabajo: - - Descarga el video de entrada de ejemplo + + Descargar video de entrada de muestra
-#### Googly Eyes +#### Ojos saltones -Aplica el LoRA Googlyeyes de LTX-2.3 a un video de entrada para poner ojos saltones a todas las personas del fotograma: +Aplica el LoRA Googlyeyes de LTX-2.3 a un video de entrada para darle ojos saltones a todos los que aparecen en el encuadre: -Vista previa del flujo de trabajo Googly Eyes de LTX-2.3 +LTX-2.3 Googly Eyes workflow preview Abrir en Comfy Cloud - Descarga el JSON o busca "Googly Eyes" en la Biblioteca de plantillas + Descargar JSON o buscar "Googly Eyes" en la biblioteca de plantillas @@ -505,12 +505,12 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo: - Descarga el video de entrada de ejemplo + Descargar video de entrada de ejemplo -Para los IC-LoRA de la comunidad, coloca el LoRA de edición en `ComfyUI/models/loras/` y cárgalo con un cargador de LoRA junto al checkpoint de LTX-2.3; después ejecuta el flujo de trabajo con tu video como entrada y un prompt como: +Para los IC-LoRA de la comunidad, coloca el LoRA de edición en `ComfyUI/models/loras/` y cárgalo con un LoRA loader junto al checkpoint LTX-2.3; luego ejecuta el flujo de trabajo con tu video como entrada y un prompt como este: ```text Remove subtitles, captions, and related text occlusions from the video, restoring a clean and natural underlying image. @@ -528,7 +528,7 @@ Genera videos personalizados con audio sincronizado a partir de un prompt de tex Genera videos personalizados con audio sincronizado a partir de una imagen de referencia y un clip de audio. -Vista previa del flujo de trabajo LTX-2.3 ID LoRA +LTX-2.3 ID LoRA (vista previa del flujo de trabajo @@ -548,7 +548,7 @@ Genera videos personalizados con audio sincronizado a partir de una imagen de re -#### Descarga de modelos +#### Descargas de modelos @@ -560,7 +560,7 @@ Genera videos personalizados con audio sincronizado a partir de una imagen de re Colócalo en ComfyUI/models/loras/ - + Colócalo en ComfyUI/models/text_encoders/ @@ -584,12 +584,12 @@ ComfyUI/ │ └── ltx-2.3-spatial-upscaler-x2-1.1.safetensors ``` -## Consejos para escribir prompts +## Consejos para los prompts -Cuando escribas prompts para LTX-2.3, céntrate en descripciones detalladas y cronológicas de acciones y escenas: +Cuando escribas prompts para LTX-2.3, enfócate en descripciones detalladas y cronológicas de las acciones y las escenas: 1. **Acciones principales**: Describe los eventos y las acciones tal como ocurren a lo largo del tiempo -2. **Detalles visuales**: Describe todos los detalles visuales que quieres que aparezcan en el video +2. **Detalles visuales**: Describe todos los detalles visuales que quieras que aparezcan en el video 3. **Audio**: Describe los sonidos y el diálogo que necesita la escena ## Recursos diff --git a/es/tutorials/video/ltx/ltx-2-5-dfr.mdx b/es/tutorials/video/ltx/ltx-2-5-dfr.mdx index 14cd89b24d..58c8025ffd 100644 --- a/es/tutorials/video/ltx/ltx-2-5-dfr.mdx +++ b/es/tutorials/video/ltx/ltx-2-5-dfr.mdx @@ -2,15 +2,17 @@ title: "LTX-2.5 DFR en ComfyUI: imagen a video con audio" description: "Ejecuta el flujo de trabajo LTX-2.5 DFR en ComfyUI: tres etapas Diffusion Fidelity Rendering que generan video con audio sincronizado desde una imagen." sidebarTitle: "LTX-2.5 DFR" -translationSourceHash: 525f6be2 +translationSourceHash: 6958a6c7 translationFrom: tutorials/video/ltx/ltx-2-5-dfr.mdx translationBlockHashes: "_intro": 950d68f0 "The three stages": 1ccaf9c8 "Model downloads": c2c37fb4 + "Model storage": d7c0900c "Workflow controls": 2cf64b86 "Prompting tips": c40b888a --- + Genera un video con audio sincronizado a partir de una sola imagen mediante la ruta Diffusion Fidelity Rendering de LTX-2.5. DFR es la receta con calidad de producción: un transformer destilado combinado con un IC-LoRA de detallado, con keyframes generados dentro del clip y reutilizados como guías por las pasadas posteriores. Activa `Switch to T2V` para ejecutar el mismo pipeline solo desde texto. Para los demás flujos de trabajo de LTX-2.5, consulta la [descripción general de LTX-2.5](/es/tutorials/video/ltx/ltx-2-5). @@ -36,17 +38,17 @@ Para los demás flujos de trabajo de LTX-2.5, consulta la [descripción general | Etapa | Se ejecuta a | Pasos | Qué hace | | :---- | :------ | :---- | :----------- | -| 1. Generar | La mitad del tamaño de salida | 8 | Aplica denoising al video, con un fotograma clave de detalle por segundo, y al audio juntos en una sola pasada | -| 2. Espacial x2 | El tamaño de salida | 3 | Aplica upscale al latent de la etapa 1 y lo vuelve a muestrear con el IC-LoRA de detalle espacial de píxeles, usando el latent de media resolución como referencia | -| 3. Temporal x2 | 241 fotogramas a 48 fps | 4 | Duplica la frecuencia de fotogramas en la misma duración, con los fotogramas clave de la etapa 2 fijados como guías | +| 1. Generar | La mitad del tamaño de salida | 8 | Aplica denoise al video, con un fotograma clave de detalle por segundo, y al audio juntos en una sola pasada | +| 2. Espacial x2 | El tamaño de salida | 3 | Hace upscale del latente de la etapa 1 y lo vuelve a muestrear con el IC-LoRA de detalle espacial de píxeles, usando el latente de media resolución como referencia | +| 3. Temporal x2 | 241 fotogramas a 48 fps | 4 | Duplica la frecuencia de cuadros durante la misma duración, con los fotogramas clave de la etapa 2 fijados como guías | Todas las etapas muestrean con el sampler `euler`, `cfg` 1.0 y una programación fija de `ManualSigmas`. El checkpoint está destilado, así que el número de pasos y las programaciones son parte de la receta: cambiarlos cambia el aspecto del resultado. -La tercera etapa es opcional. Desactiva `Run 3rd stage - Temporal Upscale` para saltarla y obtener en su lugar un clip con la frecuencia de fotogramas de la etapa 2. El audio se arrastra desde la etapa 1 por todo el pipeline, así que el sonido no cambia cuando se ejecuta la pasada temporal. +La tercera etapa es opcional. Desactiva `Run 3rd stage - Temporal Upscale` para saltarla y obtener en su lugar un clip con la frecuencia de cuadros de la etapa 2. El audio se conserva desde la etapa 1 en todo el pipeline, así que el sonido no cambia cuando se ejecuta la pasada temporal. ## Descargas de modelos -El flujo de trabajo DFR carga el codificador de texto de precisión completa y añade el IC-LoRA de detallado más el escalador temporal, por lo que su conjunto de modelos difiere del de los demás flujos de trabajo de LTX-2.5. +El flujo de trabajo DFR carga el codificador de texto de precisión completa y añade el IC-LoRA de detallado más el upscaler temporal, por lo que su conjunto de modelos difiere del de los demás flujos de trabajo de LTX-2.5. @@ -97,15 +99,15 @@ ComfyUI/ ## Controles del flujo de trabajo -- `Start image (I2V)`: el primer fotograma. Se ignora mientras `Switch to T2V` esté activado -- `Output size (aspect / megapixels)`: la relación de aspecto y el presupuesto de píxeles objetivo, redondeados a múltiplos de 32. La etapa 1 se ejecuta a la mitad de este tamaño -- `Switch to T2V`: ejecuta el pipeline solo a partir de texto, sin una imagen inicial -- `Float (fps)` y `Float (Duration)`: 24 fps durante 5 segundos por defecto, lo que da 121 fotogramas -- `Enable Prompt Enhancer`: reescribe y amplía el prompt con el pequeño codificador Gemma 4 antes del muestreo -- `Enable Tiled Decode`: decodifica el VAE en mosaicos para reducir el uso de VRAM, con un pequeño costo en el detalle fino +- `Start image (I2V)`: el primer fotograma. Se ignora mientras `Switch to T2V` está activado. +- `Output size (aspect / megapixels)`: la relación de aspecto y el presupuesto de píxeles objetivo, redondeados a múltiplos de 32. La etapa 1 se ejecuta a la mitad de este tamaño. +- `Switch to T2V`: ejecuta el pipeline solo a partir de texto, sin una imagen inicial. +- `Float (fps)` y `Float (Duration)`: 24 fps durante 5 segundos de forma predeterminada, lo que equivale a 121 fotogramas. +- `Enable Prompt Enhancer`: reescribe y amplía el prompt con el pequeño codificador Gemma 4 antes del muestreo. +- `Enable Tiled Decode`: decodifica el VAE por mosaicos para reducir el uso de VRAM, a costa de un pequeño sacrificio en el detalle fino. ## Consejos para escribir prompts -1. **Escribe para un solo plano continuo**: DFR construye el clip a partir de fotogramas clave generados, así que describe una escena que se desarrolla en una sola toma en lugar de una secuencia de cortes +1. **Escribe para una sola toma continua**: DFR construye el clip a partir de keyframes generados, así que describe una escena que se desarrolla en una sola toma en lugar de una secuencia de cortes 2. **Audio en la misma pasada**: pon las líneas habladas entre comillas y describe el ambiente y los efectos; el modelo genera el audio junto con el video -3. **Mantén los movimientos de cámara suaves**: los movimientos rápidos sobre texturas con ruido y degradados suaves son donde el pipeline tiene más probabilidades de mostrar ebullición o banding +3. **Mantén los movimientos de cámara suaves**: los movimientos rápidos sobre texturas con ruido y degradados suaves son donde el pipeline es más propenso a mostrar ebullición o banding diff --git a/es/tutorials/video/ltxv.mdx b/es/tutorials/video/ltxv.mdx index 21999ebd3e..79d540fb4f 100644 --- a/es/tutorials/video/ltxv.mdx +++ b/es/tutorials/video/ltxv.mdx @@ -2,13 +2,14 @@ title: "LTX-Video 0.9.5 en ComfyUI: T2V, I2V, control de múltiples fotogramas" sidebarTitle: "LTX-0.9.5" description: "Ejecuta LTX-Video 0.9.5 en ComfyUI para texto a video, imagen a video y control multifotograma desde imágenes inicial y final, con descarga y configuración." -translationSourceHash: b2aad3a7 +translationSourceHash: b4e3cee7 translationFrom: tutorials/video/ltxv.mdx translationBlockHashes: "_intro": 354083fd "Multi Frame Control": 0fe2f937 "Image to Video": 1072ef32 "Text to Video": 664fc166 + "Requirements": 4d0884e2 --- import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; @@ -85,14 +86,14 @@ Arrastra el video directamente a ComfyUI para ejecutar el flujo de trabajo. ## Requisitos -Descarga los siguientes modelos y colócalos en las ubicaciones que se indican a continuación: +Descarga los siguientes modelos y colócalos en las ubicaciones indicadas a continuación: - Descarga y guárdalo en ComfyUI/models/checkpoints/ + Descarga y coloca en ComfyUI/models/checkpoints/ - Descarga y guárdalo en ComfyUI/models/text_encoders/ + Descarga y coloca en ComfyUI/models/text_encoders/ ``` @@ -101,3 +102,4 @@ Descarga los siguientes modelos y colócalos en las ubicaciones que se indican a └── text_encoders/ └── t5xxl_fp16.safetensors ``` + diff --git a/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx b/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx index 0dadd530c0..99eb4726c1 100644 --- a/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx +++ b/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx @@ -2,25 +2,27 @@ title: "FastVideo FastH3: ejemplos de flujos de trabajo de ComfyUI" description: "FastVideo FastH3 genera video MiniMax H3 con audio sincronizado en 8 pasos de muestreo en ComfyUI, para flujos de texto a video y de primer/último fotograma." sidebarTitle: "FastVideo FastH3" -translationSourceHash: c9534724 +translationSourceHash: cb542dfa translationFrom: tutorials/video/minimax/minimax-h3-fastvideo.mdx translationBlockHashes: "_intro": 096c332e "Requirements": bcdeb37e - "FastH3 Text to Video": e9a7420a + "FastH3 Text to Video": 1c4cb909 "FastH3 Image to Video": ec7d82bf - "Workflow structure notes": 77b7c476 + "Model downloads": b88037db + "Workflow structure notes": 8f5d2153 --- -[FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) es un checkpoint de MiniMax H3 destilado con DMD2 por el equipo de FastVideo que genera video con audio nativo sincronizado en **8 pasos de muestreo** en lugar de la programación completa del modelo base. Reutiliza el codificador de texto de H3, el VAE de video y el VAE de audio, así que el resultado coincide con la configuración del modelo base mientras el muestreo termina en una fracción de los pasos. -El trabajo de la versión de vista previa de FastH3 se desarrolló en colaboración con Nuva Lab y el equipo de NVIDIA FastGen; consulta el [anuncio de FastH3](https://haoailab.com/blogs/fasth3-preview/) para conocer los detalles de la destilación. ComfyUI incluye el checkpoint V2 de 8 pasos, reempaquetado por Comfy-Org en el [repositorio FastVideo-FastH3-Comfy](https://huggingface.co/FastVideo/FastVideo-FastH3-Comfy). +[FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) es un checkpoint de MiniMax H3 destilado con DMD2 por el equipo de FastVideo que genera video con audio nativo sincronizado en **8 pasos de muestreo** en lugar del programa de muestreo completo del modelo base. Reutiliza el codificador de texto de H3, el VAE de video y el VAE de audio, así que el resultado coincide con la configuración del modelo base mientras el muestreo termina en una fracción de los pasos. + +El trabajo de vista previa de FastH3 se desarrolló en colaboración con Nuva Lab y el equipo de NVIDIA FastGen; consulta el [anuncio de FastH3](https://haoailab.com/blogs/fasth3-preview/) para conocer los detalles de la destilación. ComfyUI incluye el checkpoint V2 de 8 pasos, reempaquetado por Comfy-Org en el [repositorio FastVideo-FastH3-Comfy](https://huggingface.co/FastVideo/FastVideo-FastH3-Comfy). FastH3 sacrifica algo de fidelidad de movimiento y audio a cambio de velocidad. Úsalo para borradores, iteración y entregas rápidas; usa los flujos de trabajo base de MiniMax H3 cuando la máxima calidad sea lo importante. -El checkpoint destilado solo admite texto a video e imagen a video con primer y último fotograma. Ref2VA (conditioning con múltiples referencias) no se destiló; usa los [flujos de trabajo base de MiniMax H3](/es/tutorials/video/minimax/minimax-h3-native) para la generación basada en referencias. +El checkpoint destilado solo admite texto a video e imagen a video con primer y último fotograma. Ref2VA (acondicionamiento con múltiples referencias) no se destiló; usa los [flujos de trabajo base de MiniMax H3](/es/tutorials/video/minimax/minimax-h3-native) para la generación basada en referencias. ## Requisitos @@ -49,17 +51,17 @@ Genera video y audio sincronizados a partir de un prompt de texto en 8 pasos. ### Consejos para escribir prompts -1. **Describe toda la escena**: Indica primero la escena general (lugar, personaje, qué ocurre) y luego divídela en tomas con duración +1. **Describe toda la escena**: Indica primero la escena general (lugar, personaje, qué ocurre) y luego divídela en tomas con tiempos definidos 2. **Tomas, cámara y audio**: Describe las tomas, los movimientos de cámara y el audio que las acompaña (diálogo, SFX, música) en un solo bloque de prompt -3. **Resolución**: El lienzo nativo de H3 tiene un borde corto de 768px y un área de 768×1344, y las resoluciones se redondean a un múltiplo de 32. El nodo acepta tamaños mayores, pero se renderizan más lento sin añadir detalle +3. **Resolución**: El lienzo nativo de H3 tiene un borde corto de 768px y un área de 768×1344, y las resoluciones se redondean a un múltiplo de 32. El nodo acepta tamaños mayores, pero tardan más en renderizarse sin añadir detalle 4. **Duración**: La entrada de duración se ajusta a la cuadrícula del modelo de 17 fotogramas por bloque (17k+5) a 24fps -5. **Los pasos son fijos en 8**: El checkpoint destilado está entrenado para exactamente 8 pasos; cambiar la cantidad de pasos en el scheduler degrada la calidad +5. **Los pasos son fijos en 8**: El checkpoint destilado está entrenado para exactamente 8 pasos; cambiar el número de pasos en el scheduler degrada la calidad -Para obtener recursos sobre cómo escribir prompts, consulta la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide). +Para ver recursos sobre cómo escribir prompts, consulta la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide). ## FastH3: imagen a video -Anima una imagen fija con audio sincronizado y con control opcional de primer y último fotograma. +Anima una imagen fija con audio sincronizado y con control opcional del primer y último fotograma. @@ -88,7 +90,7 @@ Sube este archivo al nodo `LoadImage` correspondiente, o usa tu propia imagen: ### Modo de primer y último fotograma -Conecta imágenes a `first_frame` y/o `last_frame` en el nodo `MiniMaxH3ImageToVideo` para generar el movimiento entre dos fotogramas clave. Deja ambos desconectados para texto a video. +Conecta imágenes a `first_frame` y/o `last_frame` en el nodo `MiniMaxH3ImageToVideo` para generar el movimiento entre dos fotogramas clave. Deja ambos desconectados para el modo texto a video. ### Consejos para el prompt @@ -96,15 +98,15 @@ Conecta imágenes a `first_frame` y/o `last_frame` en el nodo `MiniMaxH3ImageToV 2. **Duración**: La entrada de duración se ajusta a la cuadrícula del modelo de 17 fotogramas por bloque (17k+5) a 24fps 3. **Los pasos están fijos en 8**: Mantén el scheduler en 8 pasos; el checkpoint está destilado para esa programación -## Descarga de modelos +## Descargas de modelos -El modelo de difusión viene del repositorio de FastVideo; el codificador de texto y los VAE se comparten con el modelo base MiniMax H3. +El modelo de diffusion proviene del repositorio FastVideo; el text encoder y los VAE se comparten con el modelo base MiniMax H3. - + Colócalo en ComfyUI/models/diffusion_models/ - + Colócalo en ComfyUI/models/text_encoders/ @@ -131,11 +133,11 @@ ComfyUI/ ## Notas sobre la estructura del flujo de trabajo -Ambos flujos de trabajo FastH3 comparten estos nodos con la configuración base de H3, con configuraciones específicas de destilación: +Ambos flujos de trabajo de FastH3 comparten estos nodos con la configuración base de H3, con configuraciones específicas de destilación: -- **BlockSparseAttention**: ejecuta Video Sparse Attention (VSA) con `keep_percent` 10, iniciando al 20% de la programación, lo que reduce el costo de atención mientras preserva la calidad -- **MiniMaxH3SigmaShift**: aplica el desplazamiento sigma de H3 (10 para video, 3 para audio) que coincide con la programación destilada -- **ComfyMathExpression**: convierte la entrada de duración en una `length` de fotogramas válida en la cuadrícula de 17k+5 a 24fps -- **Sampler**: sampler `res_multistep` con el scheduler `simple` a 8 pasos +- **BlockSparseAttention**: Ejecuta Video Sparse Attention (VSA) con `keep_percent` 10, a partir del 20% del programa, lo que reduce el costo de atención mientras preserva la calidad +- **MiniMaxH3SigmaShift**: Aplica el desplazamiento sigma de H3 (10 para video, 3 para audio) que coincide con el programa destilado +- **ComfyMathExpression**: Convierte la entrada de duración en una `length` de fotogramas válida en la cuadrícula 17k+5 a 24fps +- **Sampler**: sampler `res_multistep` con el scheduler `simple` en 8 pasos -Los pesos de FastH3 incluyen capas de compuerta `to_gate_compress`, que VSA lee para su rama gruesa. Los checkpoints base de H3 no las tienen. Para comparar métodos, establece `method` en `sol-attn` en el nodo **Model Sparse Attention** y mantén la misma seed. `sol-attn` no necesita pesos coincidentes y se ejecuta en cualquier checkpoint H3 con el `tau` que establezcas. +Los pesos de FastH3 incluyen capas de compuerta `to_gate_compress`, que VSA lee para su rama gruesa. Los checkpoints base de H3 no las tienen. Para comparar métodos, establece `method` en `sol-attn` en el nodo **Model Sparse Attention** y mantén la misma semilla. `sol-attn` no necesita pesos coincidentes y funciona con cualquier checkpoint de H3 con el `tau` que establezcas. diff --git a/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx b/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx index 273cef655d..918bc97d5e 100644 --- a/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx +++ b/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx @@ -2,14 +2,16 @@ title: "ComfyUI MiniMax H3 Fun ControlNet Union: video con control de pose, profundidad y Canny" description: "Guía el movimiento de video de MiniMax H3 en ComfyUI con videos de control Canny, Depth, HED, MLSD o Pose, además de relleno inteligente con máscaras usando el parche Fun ControlNet Union." sidebarTitle: "Fun ControlNet Union" -translationSourceHash: d4c42cef +translationSourceHash: e9538916 translationFrom: tutorials/video/minimax/minimax-h3-fun-controlnet.mdx translationBlockHashes: "_intro": a84faa25 "Model downloads": 5310815d + "Model storage": b507229f "Prompting tips": 39f67d41 --- -Controla el movimiento de un video de MiniMax H3 con un video de control en lugar de solo texto. El parche Fun ControlNet Union ([alibaba-pai/MiniMax-H3-Fun-Controlnet-Union](https://huggingface.co/alibaba-pai/MiniMax-H3-Fun-Controlnet-Union), empaquetado en [Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3)) es un único checkpoint que condiciona H3 con videos de control Canny, Profundidad, HED, MLSD o Pose, y también ejecuta relleno inteligente de video con una máscara. Funciona con ambos archivos transformer `fl2va` y `ref2va`. + +Controla el movimiento de un video de MiniMax H3 con un video de control en lugar de usar solo texto. El parche Fun ControlNet Union ([alibaba-pai/MiniMax-H3-Fun-Controlnet-Union](https://huggingface.co/alibaba-pai/MiniMax-H3-Fun-Controlnet-Union), empaquetado en [Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3)) es un único checkpoint que condiciona H3 con videos de control Canny, Profundidad, HED, MLSD o Pose, y también ejecuta relleno inteligente de video con una máscara. Funciona con los archivos transformer `fl2va` y `ref2va`. ![Vista previa del flujo de trabajo MiniMax H3 Fun ControlNet Union](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_minimax_h3_fun_controlnet_union-1.webp) @@ -32,7 +34,7 @@ Sube este archivo al nodo `Load Video` correspondiente: -Esta plantilla requiere ComfyUI 0.35.0 o una versión posterior. El ejemplo usa un video de control de pose: un subgrafo SDPose integrado extrae el esqueleto de la pose del video de entrada, por lo que la salida reproduce el movimiento del bailarín. También puedes conectar cualquier video de control preprocesado directamente a la entrada `control_video` del nodo `Apply MiniMax H3 Fun ControlNet`. +Esta plantilla requiere ComfyUI 0.35.0 o una versión posterior. El ejemplo usa un video de control de pose: un subgrafo SDPose integrado extrae el esqueleto de la pose del video de entrada, así que la salida reproduce el movimiento del bailarín. También puedes conectar cualquier video de control preprocesado directamente a la entrada `control_video` del nodo `Apply MiniMax H3 Fun ControlNet`. ## Descargas de modelos @@ -53,7 +55,7 @@ Esta plantilla requiere ComfyUI 0.35.0 o una versión posterior. El ejemplo usa Coloca en ComfyUI/models/vae/ - Habilita el modo turbo opcional con el Lightning LoRA. Coloca en ComfyUI/models/loras/ + Habilita el modo turbo opcional del Lightning LoRA. Coloca en ComfyUI/models/loras/ Extractor de pose que usa el subgrafo SDPose integrado. Coloca en ComfyUI/models/checkpoints/ @@ -84,10 +86,10 @@ ComfyUI/ │ └── sdpose_wholebody_fp16.safetensors ``` -## Consejos para los prompts +## Consejos para escribir prompts -1. **Duración del video**: El video objetivo dura de 5 a 15 segundos en la cuadrícula de fotogramas 17n+5 a 24fps (124 fotogramas = 5 segundos). Un video de control más largo que el objetivo se recorta a sus primeros fotogramas; uno más corto mantiene su último fotograma. Para igualar exactamente la duración del video de control, conecta la salida `batch_size` calculada del ejemplo con la entrada de longitud del nodo `MiniMax H3 Reference to Video` -2. **Orientación y strength**: Mantén `guidance_scale` en 1.0. Aumenta el `strength` del patch por encima de 1 solo si el resultado se aleja del control -3. **Relleno inteligente de video**: Conecta una máscara a la entrada `mask`: las regiones marcadas con `1` se regeneran bajo el control de la entrada opcional `source_video`, mientras el resto del fotograma permanece fijo +1. **Duración del video**: El video objetivo dura entre 5 y 15 segundos en la cuadrícula de fotogramas 17n+5 a 24fps (124 fotogramas = 5 segundos). Si el video de control es más largo que el objetivo, se recorta a sus primeros fotogramas; si es más corto, mantiene su último fotograma. Para igualar exactamente la duración del video de control, conecta la salida `batch_size` calculada del ejemplo a la entrada de duración del nodo `MiniMax H3 Referencia a Video` +2. **Orientación y fuerza**: Mantén `guidance_scale` en 1.0. Aumenta la `strength` del patch por encima de 1 solo si la salida se aleja del control +3. **Relleno inteligente de video**: Conecta una máscara a la entrada `mask`: las regiones marcadas con `1` se regeneran bajo el control de la entrada opcional `source_video`, mientras que el resto del fotograma permanece fijo 4. **Modo turbo (opcional)**: Activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos y generar mucho más rápido, con una calidad de audio y movimiento ligeramente inferior -5. **Preparar los videos de control**: ComfyUI incluye nodos de preprocesamiento integrados para cada tipo de control. Consulta el [nodo Detect Edges (Canny)](https://docs.comfy.org/built-in-nodes/Canny) para bordes y el [tutorial Depth Anything 3](https://docs.comfy.org/tutorials/utility/depth-anything-3) para mapas de profundidad +5. **Preparar videos de control**: ComfyUI incluye nodos de preprocesamiento integrados para cada tipo de control. Consulta el [nodo Detect Edges (Canny)](https://docs.comfy.org/built-in-nodes/Canny) para bordes y el [tutorial de Depth Anything 3](https://docs.comfy.org/tutorials/utility/depth-anything-3) para mapas de profundidad diff --git a/es/tutorials/video/minimax/minimax-h3-multiframe.mdx b/es/tutorials/video/minimax/minimax-h3-multiframe.mdx index 79e7241a9d..d9b87a3444 100644 --- a/es/tutorials/video/minimax/minimax-h3-multiframe.mdx +++ b/es/tutorials/video/minimax/minimax-h3-multiframe.mdx @@ -2,14 +2,16 @@ title: "Flujo de trabajo de referencia multifotograma de MiniMax H3 en ComfyUI" description: "Crea continuaciones de video y escenas de varias tomas con MiniMax H3 en ComfyUI fijando fotogramas de referencia en la línea de tiempo con nodos Add Guide." sidebarTitle: "Referencia multifotograma" -translationSourceHash: 456918f4 +translationSourceHash: 92c8dde7 translationFrom: tutorials/video/minimax/minimax-h3-multiframe.mdx translationBlockHashes: "_intro": 3a03ecf1 "Model downloads": 263666fa + "Model storage": 17ed75e6 "Prompting tips": 12a34e31 "Prompt writing guide": 4f808c3a --- + Genera continuaciones de video y escenas de varios planos anclando fotogramas de referencia en puntos específicos a lo largo de la línea de tiempo de salida. El flujo de trabajo combina el nodo Reference to Video con nodos Add Guide encadenados: cada Add Guide fija una imagen estática (más audio opcional) a un índice de fotograma, de modo que el video pasa por esa composición exacta en ese momento. ![Vista previa del flujo de trabajo MiniMax H3 Multiframe Reference](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_minimax_h3_multiframe_reference-1.webp) @@ -54,7 +56,7 @@ Genera continuaciones de video y escenas de varios planos anclando fotogramas de Colócalo en ComfyUI/models/vae/ - Habilita el modo turbo opcional con el Lightning LoRA. Colócalo en ComfyUI/models/loras/ + Habilita el modo turbo opcional del Lightning LoRA. Colócalo en ComfyUI/models/loras/ @@ -76,12 +78,12 @@ ComfyUI/ ## Consejos para el prompt -1. **Haz referencia por etiqueta**: `` es la imagen conectada a la primera ranura de `ref_images`, `` a la segunda, y así sucesivamente. En este flujo de trabajo, `` es tanto el bloqueo de identidad como el primer fotograma del video -2. **Anclajes de la línea de tiempo frente a referencias**: las imágenes conectadas solo a nodos Add Guide anclan composiciones en fotogramas específicos, pero no son visibles para el codificador de texto. Conéctalas también a ranuras `ref_images` adicionales si quieres que el prompt las vea como `` -3. **Índice de fotograma**: cada Add Guide toma `frame_idx` en fotogramas a 24 fps; la plantilla lo calcula a partir de segundos con `round(seconds * 24)`. Los valores negativos cuentan desde el final del video. El índice más la longitud de la guía deben quedar dentro de la duración generada -4. **Añade más fotogramas clave**: copia un bloque de guía (Load Image + Frame Index + Math Expression + Add Guide for MiniMax H3) y mantén las salidas `positive` encadenadas en serie hacia el Basic Guider -5. **Modo turbo (opcional)**: activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos y lograr una generación mucho más rápida, con una calidad de audio y movimiento ligeramente inferior +1. **Referencia por etiqueta**: `` es la imagen conectada a la primera ranura `ref_images`, `` la segunda, y así sucesivamente. En este flujo de trabajo, `` es a la vez el bloqueo de identidad y el primer fotograma del video +2. **Anclajes de línea de tiempo vs referencias**: Las imágenes conectadas solo a nodos Añadir guía para MiniMax H3 anclan composiciones en fotogramas específicos, pero no son visibles para el codificador de texto. Conéctalas también a ranuras `ref_images` adicionales si el prompt debe verlas como `` +3. **Índice de fotogramas**: Cada Añadir guía para MiniMax H3 toma `frame_idx` en fotogramas a 24fps; la plantilla lo calcula a partir de segundos con `round(seconds * 24)`. Los valores negativos cuentan desde el final del video. El índice más la longitud de la guía deben mantenerse dentro de la duración generada +4. **Añadir más fotogramas clave**: Copia un bloque de guía (Cargar imagen + Índice de fotogramas + Expresión matemática + Añadir guía para MiniMax H3) y mantén las salidas `positive` encadenadas en serie hasta la Guía básica +5. **Modo turbo (opcional)**: Activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos y obtener una generación mucho más rápida, con una calidad de audio y movimiento ligeramente inferior ## Guía para escribir prompts -El prompt de la plantilla sigue la [guía de prompts del modo de referencia completa](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md): define cada sujeto, asigna cada `` al primer fotograma o fotograma clave de un plano y corta entre planos en marcas de tiempo explícitas. Usa la misma estructura cuando escribas tus propios prompts de varios planos. La guía está resumida en la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide). +El prompt de la plantilla sigue la [guía de prompts del modo de referencia completa](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md): define cada sujeto, asigna cada `` al primer fotograma o al fotograma clave de un plano, y corta entre planos en marcas de tiempo explícitas. Usa la misma estructura cuando escribas tus propios prompts de varios planos. La guía está resumida en la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide). diff --git a/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx index 2a9accf37c..7d48c43bc4 100644 --- a/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx +++ b/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx @@ -2,16 +2,17 @@ title: "Guía de prompts de ComfyUI MiniMax H3: guías oficiales, consejos y embeddings de prompt" description: "Escribe mejores prompts de MiniMax H3 en ComfyUI: guías oficiales, consejos generales, reglas de diálogo y hablantes, y embeddings de estilo." sidebarTitle: "Guía de prompts" -translationSourceHash: 0d858ae8 +translationSourceHash: 0f1ded35 translationFrom: tutorials/video/minimax/minimax-h3-prompt-guide.mdx translationBlockHashes: "_intro": da22cc9d "Official guides": 3d762c67 - "General tips": 91822299 + "General tips": fab4ad35 "Shots and cuts": 8184dae6 "Dialogue and speakers": 4985438e "Prompt embeddings": 9c899169 --- + H3 espera planos, cámara, diálogo y SFX en un solo prompt multimodal. Esta página reúne guías oficiales, consejos entre flujos de trabajo, reglas de planos y diálogo, y embeddings de estilo. ## Guías oficiales @@ -21,7 +22,7 @@ H3 espera planos, cámara, diálogo y SFX en un solo prompt multimodal. Esta pá El paquete instalable de [habilidades H3](https://github.com/MiniMax-AI/MiniMax-H3/tree/main/skills) reúne estos contenidos para los agentes. -Aplicado por plantilla: [T2V/I2V](/es/tutorials/video/minimax/minimax-h3-native), [R2V](/es/tutorials/video/minimax/minimax-h3-native#minimax-h3-referencia-a-video-r2v), [Multiframe](/es/tutorials/video/minimax/minimax-h3-multiframe#guía-para-escribir-prompts), [Fun ControlNet](/es/tutorials/video/minimax/minimax-h3-fun-controlnet#consejos-para-los-prompts). +Aplicado por plantilla: [T2V/I2V](/es/tutorials/video/minimax/minimax-h3-native), [R2V](/es/tutorials/video/minimax/minimax-h3-native#minimax-h3-referencia-a-video-r2v), [Multiframe](/es/tutorials/video/minimax/minimax-h3-multiframe#guía-para-escribir-prompts), [Fun ControlNet](/es/tutorials/video/minimax/minimax-h3-fun-controlnet#consejos-para-escribir-prompts). ## Consejos generales @@ -41,7 +42,7 @@ Escribe los prompts en **inglés**. Los diálogos y las letras de canciones van 4. **Longitud**: `length` son fotogramas a 24fps (predeterminado **124** ≈ 5s), ajustado a **17k+5** 5. **Texto en pantalla**: comillas dobles en inglés para cada cadena, literal (p. ej., `A red neon sign reading "营业中"`). Las líneas habladas usan ``, no comillas 6. **Marcadores de audio de R2V**: en el análisis de retención, marca cada referencia de audio como `fully_copy`, `partially_copy`, `reference` o `weak_reference` según cómo se use el clip (consulta la tabla de la guía oficial de referencias) -7. **Campos de audio**: `overall_soundscape` = sonido ambiente/SFX/no verbal (1–4 frases; `N/A` solo si hay silencio real). Los diálogos y la música diegética se mantienen en los planos. `non_diegetic_music` = solo banda sonora (1–3 frases; `N/A` si no hay). Si aparece habla no deseada, rellena ambos campos de forma explícita +7. **Campos de audio**: `overall_soundscape` = sonido ambiente/SFX/no verbal (1–4 frases; `N/A` solo si hay silencio real). Los diálogos y la música diegética se mantienen en los planos. `non_diegetic_music` = solo banda sonora musical (1–3 frases; `N/A` si no hay). Si aparece habla no deseada, rellena ambos campos de forma explícita 8. **Sin negativos**: `BasicGuider` funciona con `cfg` 1 y sin rama negativa. Las listas de prohibiciones añaden conceptos no deseados. Indica lo que debería aparecer (o usa los campos de retención de R2V: `fully_preserved`, `partially_preserved`, etc.) 9. **Hojas de referencia (R2V)**: una imagen puede contener varios paneles. Asigna a la hoja su propio `` (no solo dentro de ``), describe los paneles y dirige los planos a un panel (p. ej., vista frontal completa de ``). Etiqueta los paneles con claridad diff --git a/es/tutorials/video/wan/fun-camera.mdx b/es/tutorials/video/wan/fun-camera.mdx index 44669c4aad..45a71045d2 100644 --- a/es/tutorials/video/wan/fun-camera.mdx +++ b/es/tutorials/video/wan/fun-camera.mdx @@ -2,16 +2,18 @@ title: "Ejemplos oficiales de ComfyUI Wan2.1 Fun Camera" description: "Esta guía muestra cómo usar Wan2.1 Fun Camera en ComfyUI para generar video" sidebarTitle: "Wan2.1 Fun Camera" -translationSourceHash: 6173f2a1 +translationSourceHash: f2b906a8 translationFrom: tutorials/video/wan/fun-camera.mdx translationBlockHashes: "_intro": 59d5e57d "About Wan2.1 Fun Camera": 98c0ae00 + "Model Installation": 65ab0da5 "ComfyUI Wan2.1 Fun Camera 1.3B Workflow": 4ddf8882 "ComfyUI Wan2.1 Fun Camera 14B Workflow": ea99a5f1 "Performance Reference": 2dc2f8f0 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' Wan2.1 Fun Camera es un modelo de generación de video con movimiento de cámara del proyecto VideoX-Fun de Alibaba, con soporte nativo en ComfyUI. Genera videos cuyo movimiento de cámara sigue tus condiciones de control, así puedes dirigir cómo se mueve la cámara en el resultado en lugar de describir cada plano en el prompt. @@ -19,27 +21,27 @@ El modelo forma parte de la familia Wan2.1-Fun y se distribuye en dos tamaños: ## Acerca de Wan2.1 Fun Camera -**Wan2.1 Fun Camera** es un proyecto de generación de video lanzado por el equipo de Alibaba, centrado en controlar los efectos de generación de video mediante el movimiento de cámara. +**Wan2.1 Fun Camera** es un proyecto de generación de video lanzado por el equipo de Alibaba, centrado en controlar los efectos de la generación de video mediante el movimiento de cámara. -**Descargar los pesos del modelo**: +**Descarga de los pesos del modelo**: - [Versión 14B](https://huggingface.co/alibaba-pai/Wan2.1-Fun-V1.1-14B-Control-Camera) - [Versión 1.3B](https://huggingface.co/alibaba-pai/Wan2.1-Fun-V1.1-1.3B-Control-Camera) **Repositorio de código**: [VideoX-Fun](https://github.com/aigc-apps/VideoX-Fun) -**ComfyUI ahora es compatible de forma nativa con el modelo Wan2.1 Fun Camera**. +**ComfyUI ya es compatible de forma nativa con el modelo Wan2.1 Fun Camera**. -## Instalación de modelos +## Instalación del modelo -Estos modelos solo hay que instalarlos una vez. Además, la información de descarga de los modelos está incluida en las imágenes de los flujos de trabajo correspondientes, así que puedes elegir la forma de descarga que prefieras. +Estos modelos solo necesitan instalarse una vez. Además, la información de descarga de los modelos está incluida en las imágenes del flujo de trabajo correspondiente, así que puedes elegir la forma de descarga que prefieras. -Todos los modelos siguientes están disponibles en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) +Puedes encontrar todos los siguientes modelos en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) ### Modelos de difusión -Elige entre 1.3B o 14B: +Elige 1.3B o 14B: @@ -50,7 +52,7 @@ Elige entre 1.3B o 14B: -Si ya has usado modelos de Wan2.1, deberías tener ya los siguientes modelos. Si no es así, descárgalos: +Si ya has usado modelos relacionados con Wan2.1 antes, ya deberías tener los siguientes modelos. Si no es así, descárgalos: ### Codificadores de texto @@ -61,7 +63,7 @@ Elige uno de los siguientes: Codificador de texto de precisión completa - Codificador de texto cuantizado FP8 (recomendado para menos VRAM) + Codificador de texto cuantizado FP8 (RECOMENDADO para menos VRAM) @@ -69,7 +71,7 @@ Elige uno de los siguientes: - Modelo VAE de Wan2.1 + Modelo VAE Wan2.1 @@ -77,7 +79,7 @@ Elige uno de los siguientes: - Codificador CLIP Vision + Codificador de visión CLIP @@ -110,7 +112,7 @@ Genera videos dinámicos con movimientos de cámara cinematográficos usando el Abrir en Comfy Cloud
- Descarga el JSON o busca "Wan 2.1 Fun Camera 1.3B" en la biblioteca de plantillas + Descarga el JSON o busca "Wan 2.1 Fun Camera 1.3B" en la Biblioteca de plantillas
@@ -144,12 +146,12 @@ Sube este archivo al nodo `LoadImage` correspondiente: ![Pasos del flujo de trabajo Wan2.1 Fun Camera](/images/tutorial/video/wan/wan2-1-fun-camera-1-3b-step-guide.jpg) -1. Verifica que se haya cargado la versión correcta del archivo del modelo: +1. Asegúrate de que esté cargada la versión correcta del archivo del modelo: - Versión 1.3B: `wan2.1_fun_camera_v1.1_1.3B_bf16.safetensors` - Versión 14B: `wan2.1_fun_camera_v1.1_14B_bf16.safetensors` -2. Verifica que el nodo `Load CLIP` tenga cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors` -3. Verifica que el nodo `Load VAE` tenga cargado `wan_2.1_vae.safetensors` -4. Verifica que el nodo `Load CLIP Vision` tenga cargado `clip_vision_h.safetensors` +2. Asegúrate de que el nodo `Load CLIP` tenga cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors` +3. Asegúrate de que el nodo `Load VAE` tenga cargado `wan_2.1_vae.safetensors` +4. Asegúrate de que el nodo `Load CLIP Vision` tenga cargado `clip_vision_h.safetensors` 5. Sube el fotograma inicial al nodo `Load Image` 6. Modifica el prompt si vas a usar tu propia imagen de entrada 7. Configura el movimiento de cámara en el nodo `WanCameraEmbedding` @@ -159,7 +161,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: ### Wan 2.1 Fun Camera 14B {#video_wan2.1_fun_camera_v1.1_14B} -Genera videos de alta calidad con control de cámara avanzado usando el modelo completo de 14B. +Genera videos de alta calidad con control de cámara avanzado usando el modelo completo 14B. Vista previa del flujo de trabajo Wan 2.1 Fun Camera 14B @@ -184,7 +186,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - nodo `LoadImage` 52 · `video_wan2.1_fun_camera_v1.1_14B_start_image.jpg` + Nodo `LoadImage` 52 · `video_wan2.1_fun_camera_v1.1_14B_start_image.jpg` @@ -195,7 +197,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: ## Referencia de rendimiento **Versión 1.3B**: -- A 512x512 de resolución, una RTX 4090 tarda unos 72 segundos en generar 81 frames +- Con una resolución de 512x512 en una RTX 4090, generar 81 fotogramas tarda unos 72 segundos **Versión 14B**: -- Una RTX 4090 de 24 GB de VRAM puede quedarse sin memoria al generar a 512x512 de resolución, y también han aparecido problemas de memoria en una A100 al usar tamaños mayores +- La RTX 4090 de 24 GB de VRAM puede quedarse sin memoria al generar a una resolución de 512x512, y también se han producido problemas de memoria en la A100 al usar tamaños mayores diff --git a/es/tutorials/video/wan/fun-control.mdx b/es/tutorials/video/wan/fun-control.mdx index fc40179236..199cf3a256 100644 --- a/es/tutorials/video/wan/fun-control.mdx +++ b/es/tutorials/video/wan/fun-control.mdx @@ -2,32 +2,34 @@ title: "Ejemplos de video con Wan2.1 Fun Control en ComfyUI" description: "Esta guía muestra cómo usar Wan2.1 Fun Control en ComfyUI para generar videos con videos de control" sidebarTitle: "Wan2.1 Fun Control" -translationSourceHash: 2ce972d6 +translationSourceHash: 8b293934 translationFrom: tutorials/video/wan/fun-control.mdx translationBlockHashes: "_intro": b7cb8b6d "About Wan2.1-Fun-Control": 2e562079 + "Model Installation": 6ee9c5c6 "ComfyUI Native Workflow": 01fc65b5 "Workflow Using Custom Nodes": 8f081a21 "Usage Tips": 9e74c201 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; Wan2.1-Fun-Control es un modelo de generación de video de código abierto del proyecto VideoX-Fun de Alibaba que sigue condiciones de control predefinidas en lugar de depender únicamente del texto del prompt. Puedes guiar la salida con mapas de bordes Canny, mapas de profundidad, esqueletos OpenPose, bordes geométricos MLSD o trayectorias de puntos. -El modelo está disponible en dos tamaños: la versión de 1.3B (unos 19 GB) para un despliegue local ligero con menores requisitos de VRAM, y la versión de 14B (unos 47 GB de almacenamiento total del modelo, con los pesos de difusión en unos 32.8 GB) para resultados de mayor calidad. Ambas admiten predicción de video multirresolución a 512, 768 y 1024 píxeles, generan hasta 81 fotogramas (unos 5 segundos) a 16 fotogramas por segundo y aceptan prompts multilingües. ComfyUI ofrece soporte nativo para Wan2.1-Fun-Control. +El modelo se ofrece en dos tamaños: la versión de 1.3B (unos 19 GB) para un despliegue local ligero con menores requisitos de VRAM, y la versión de 14B (unos 47 GB de almacenamiento total del modelo, con los pesos de diffusion en unos 32.8 GB) para obtener resultados de mayor calidad. Ambas admiten predicción de video multirresolución a 512, 768 y 1024 píxeles, generan hasta 81 fotogramas (unos 5 segundos) a 16 fotogramas por segundo y aceptan prompts multilingües. ComfyUI ofrece soporte nativo para Wan2.1-Fun-Control. ## Acerca de Wan2.1-Fun-Control **Wan2.1-Fun-Control** es un proyecto de generación y control de video de código abierto desarrollado por el equipo de Alibaba. -Introduce mecanismos innovadores de códigos de control (Control Codes) combinados con aprendizaje profundo y entradas condicionales multimodales para generar videos de alta calidad que cumplen con condiciones de control predefinidas. El proyecto se centra en guiar con precisión el contenido del video generado mediante condiciones de control multimodales. +Introduce mecanismos innovadores de Control Codes combinados con aprendizaje profundo y entradas condicionales multimodales para generar videos de alta calidad que se ajustan a condiciones de control predefinidas. El proyecto se centra en guiar con precisión el contenido del video generado mediante condiciones de control multimodales. -Actualmente, el modelo Fun Control admite diversas condiciones de control, como **Canny (arte lineal), Depth, OpenPose (postura humana), MLSD (bordes geométricos) y control de trayectoria.** -El modelo también admite predicción de video multirresolución con opciones de 512, 768 y 1024 de resolución a 16 fotogramas por segundo, generando videos de hasta 81 fotogramas (aproximadamente 5 segundos) de duración. +Actualmente, el modelo Fun Control admite diversas condiciones de control, entre ellas **Canny (arte lineal), Profundidad, OpenPose (postura humana), MLSD (bordes geométricos) y control de trayectoria.** +El modelo también admite predicción de video multirresolución con opciones de resolución de 512, 768 y 1024 a 16 fotogramas por segundo, generando videos de hasta 81 fotogramas (aproximadamente 5 segundos) de duración. Versiones del modelo: -- **1.3B** Ligero: ideal para el despliegue local y la inferencia rápida con **requisitos de VRAM más bajos** -- **14B** Alto rendimiento: el tamaño del modelo alcanza los 32 GB o más, ofrece mejores resultados pero **requiere más VRAM** +- **1.3B** Ligera: adecuada para el despliegue local y la inferencia rápida con **requisitos de VRAM más bajos** +- **14B** De alto rendimiento: el tamaño del modelo alcanza 32GB+, ofrece mejores resultados pero **requiere más VRAM** **Descarga de los pesos del modelo**: @@ -36,52 +38,52 @@ Versiones del modelo: Versión ligera, requisitos de VRAM más bajos
- Versión de alto rendimiento, tamaño del archivo de 32 GB o más, requisitos de VRAM más altos + Versión de alto rendimiento, tamaño del archivo de 32GB+, requisitos de VRAM más altos
**Repositorio de código**: [VideoX-Fun](https://github.com/aigc-apps/VideoX-Fun) -ComfyUI ahora **es compatible de forma nativa** con el modelo Wan2.1 Fun Control. Antes de comenzar este tutorial, actualiza tu ComfyUI para asegurarte de usar una versión posterior a [este commit](https://github.com/Comfy-Org/ComfyUI/commit/3661c833bcc41b788a7c9f0e7bc48524f8ee5f82). +ComfyUI ahora **es compatible de forma nativa** con el modelo Wan2.1 Fun Control. Antes de comenzar este tutorial, actualiza tu ComfyUI para asegurarte de que usas una versión posterior a [este commit](https://github.com/Comfy-Org/ComfyUI/commit/3661c833bcc41b788a7c9f0e7bc48524f8ee5f82). En esta guía proporcionamos dos flujos de trabajo: 1. Un flujo de trabajo que usa solo nodos nativos de Comfy Core -2. Un flujo de trabajo que usa nodos personalizados +2. Un flujo de trabajo que usa Nodos Personalizados -Debido a las limitaciones actuales de los nodos nativos para el soporte de video, el flujo de trabajo solo con nodos nativos permite completar el proceso sin instalar nodos personalizados. +Debido a las limitaciones actuales de los nodos nativos para el soporte de video, el flujo de trabajo solo con nodos nativos garantiza que los usuarios puedan completar el proceso sin instalar nodos personalizados. Sin embargo, hemos comprobado que ofrecer una buena experiencia de usuario para la generación de video es complicado sin nodos personalizados, así que en esta guía incluimos ambas versiones del flujo de trabajo. -## Instalación de modelos +## Instalar los modelos -Solo tienes que instalar estos modelos una vez. Las imágenes de los flujos de trabajo también contienen la información de descarga de los modelos, así que puedes elegir el método de descarga que prefieras. +Solo necesitas instalar estos modelos una vez. Las imágenes de los flujos de trabajo también contienen la información de descarga de los modelos, así que puedes elegir el método de descarga que prefieras. -Los siguientes modelos están disponibles en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) y [Wan2.1-Fun](https://huggingface.co/collections/alibaba-pai/wan21-fun-67e4fb3b76ca01241eb7e334) +Puedes encontrar los siguientes modelos en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) y [Wan2.1-Fun](https://huggingface.co/collections/alibaba-pai/wan21-fun-67e4fb3b76ca01241eb7e334) -Haz clic en los enlaces correspondientes para descargar. Si ya has usado flujos de trabajo de Wan, solo necesitas descargar los **modelos de difusión**. +Haz clic en los enlaces correspondientes para descargarlos. Si ya has usado flujos de trabajo relacionados con Wan, solo necesitas descargar los **modelos de difusión**. -**Modelos de difusión** -- elige 1.3B o 14B. La versión 14B tiene un tamaño de archivo mayor (32 GB) y requiere más VRAM: +**Modelos de difusión**: elige 1.3B o 14B. La versión 14B tiene un tamaño de archivo mayor (32GB) y requiere más VRAM: - Modelo de difusión Wan2.1 Fun Control 1.3B -- ligero, requiere menos VRAM + Modelo de difusión Wan2.1 Fun Control 1.3B: ligero, con menores requisitos de VRAM - Modelo de difusión Wan2.1 Fun Control 14B. Cámbiale el nombre a Wan2.1-Fun-14B-Control.safetensors después de descargarlo. Archivo de 32 GB o más, requiere más VRAM + Modelo de difusión Wan2.1 Fun Control 14B. Renómbralo a Wan2.1-Fun-14B-Control.safetensors después de descargarlo. Tamaño de archivo de 32GB o más, mayores requisitos de VRAM -**Codificadores de texto** -- elige uno de los siguientes modelos (la precisión fp16 tiene un tamaño mayor y requiere más rendimiento): +**Codificadores de texto**: elige uno de los siguientes modelos (la precisión fp16 tiene un tamaño mayor y mayores requisitos de rendimiento): - Codificador de texto UMT5 XXL -- precisión fp16, tamaño mayor, mayor rendimiento + Codificador de texto UMT5 XXL: precisión fp16, mayor tamaño, mayor rendimiento - Codificador de texto UMT5 XXL -- precisión fp8, tamaño menor, requiere menos rendimiento + Codificador de texto UMT5 XXL: precisión fp8, menor tamaño, menores requisitos de rendimiento @@ -95,7 +97,7 @@ Haz clic en los enlaces correspondientes para descargar. Si ya has usado flujos Modelo CLIP Vision para procesar imágenes de referencia -Ubicación de almacenamiento de archivos: +Ubicación de almacenamiento de los archivos: ``` 📂 ComfyUI/ ├── 📂 models/ @@ -112,12 +114,12 @@ Ubicación de almacenamiento de archivos: ## Flujo de trabajo nativo de ComfyUI -En este flujo de trabajo usamos videos convertidos a **formato WebP**, ya que el nodo `Load Image` no admite actualmente el formato mp4. También usamos **Canny Edge** para preprocesar el video original. -Como muchos usuarios se topan con fallos de instalación y problemas de entorno al instalar nodos personalizados, esta versión del flujo de trabajo usa solo nodos nativos para garantizar una experiencia más fluida. +En este flujo de trabajo usamos videos convertidos a **formato WebP**, ya que el nodo `Load Image` todavía no admite el formato mp4. También usamos **Canny Edge** para preprocesar el video original. +Como muchos usuarios se encuentran con fallos de instalación y problemas de entorno al instalar nodos personalizados, esta versión del flujo de trabajo usa solo nodos nativos para garantizar una experiencia más fluida. -Gracias a nuestros potentes autores de ComfyUI, que ofrecen nodos con muchas funciones. Si quieres consultar directamente la versión relacionada, mira [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados). +Gracias a nuestros grandes autores de ComfyUI, que ofrecen nodos con muchas funciones. Si quieres consultar directamente la versión relacionada, ve a [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados). -### 1. Descarga del archivo del flujo de trabajo +### 1. Descargar el archivo del flujo de trabajo ![Flujo de trabajo nativo de Wan2.1 Fun Control](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/wan2.1_fun_control/wan2.1_fun_control_native.webp) @@ -141,7 +143,7 @@ Gracias a nuestros potentes autores de ComfyUI, que ofrecen nodos con muchas fun
-### 2. Completa el flujo de trabajo paso a paso +### 2. Completar el flujo de trabajo paso a paso ![Pasos del flujo de trabajo de Wan2.1 Fun Control](/images/tutorial/video/wan/fun_control_native_flow_diagram.png) @@ -150,37 +152,37 @@ Gracias a nuestros potentes autores de ComfyUI, que ofrecen nodos con muchas fun 3. Asegúrate de que el nodo `Load VAE` haya cargado `wan_2.1_vae.safetensors` 4. Asegúrate de que el nodo `Load CLIP Vision` haya cargado `clip_vision_h.safetensors` 5. Sube el fotograma inicial al nodo `Load Image` (renombrado como `Start_image`) -6. Sube el video de control al segundo nodo `Load Image`. Nota: este nodo actualmente no admite mp4, solo videos WebP -7. (Opcional) Modifica el prompt (se admite inglés y chino) +6. Sube el video de control al segundo nodo `Load Image`. Nota: este nodo no admite mp4 por ahora, solo videos WebP +7. (Opcional) Modifica el prompt (se admiten inglés y chino) 8. (Opcional) Ajusta el tamaño del video en `WanFunControlToVideo`, evitando dimensiones demasiado grandes -9. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video +9. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación del video ### 3. Notas de uso -- Como debemos introducir en el nodo `WanFunControlToVideo` el mismo número de fotogramas que tiene el video de control, si el número de fotogramas especificado supera los fotogramas reales del video de control, los fotogramas sobrantes pueden mostrar escenas que no se ajustan a las condiciones de control. Abordaremos este problema en [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados) -- Evita establecer dimensiones demasiado grandes, ya que esto puede hacer que el muestreo sea muy lento. Prueba primero con imágenes más pequeñas y luego haz upscale +- Como debemos introducir en el nodo `WanFunControlToVideo` el mismo número de fotogramas que tiene el video de control, si la cantidad de fotogramas especificada supera la del video de control real, los fotogramas sobrantes pueden mostrar escenas que no se ajustan a las condiciones de control. Abordaremos este problema en [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados) +- Evita establecer dimensiones demasiado grandes, ya que esto puede hacer que el muestreo lleve mucho tiempo. Prueba a generar primero imágenes más pequeñas y luego escálalas - Usa tu imaginación para ampliar este flujo de trabajo añadiendo flujos de texto a imagen u otros tipos, y lograr así generación directa de texto a video o transferencia de estilo -- Usa herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para obtener opciones de control más ricas +- Usa herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para tener opciones de control más variadas -## Flujo de trabajo con nodos personalizados +## Flujo de trabajo con Nodos Personalizados -Necesitaremos instalar los siguientes dos nodos personalizados: +Necesitas instalar los siguientes dos nodos personalizados: -- [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) +- [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) - [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) -Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para instalar los nodos faltantes o seguir las instrucciones de instalación de cada paquete de nodos personalizados. +Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para instalar nodos faltantes o seguir las instrucciones de instalación de cada paquete de nodos personalizados. ### 1. Descargar el archivo del flujo de trabajo -![Flujo de trabajo Wan2.1 Fun Control](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/wan2.1_fun_control-1.webp) +![Flujo de trabajo de Wan2.1 Fun Control](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/wan2.1_fun_control-1.webp) - Abrir en Comfy Cloud + Open in Comfy Cloud - Descarga el JSON o busca "Wan 2.1 ControlNet" en la biblioteca de plantillas + Descarga el JSON o busca “Wan 2.1 ControlNet” en la Biblioteca de plantillas @@ -188,7 +190,7 @@ Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para - Fotograma inicial de entrada para el flujo de trabajo con nodos personalizados. Descarga y usa esta imagen, o reemplázala por una propia. + Fotograma inicial de entrada para el flujo de trabajo con nodos personalizados. Descarga y usa esta imagen, o reemplázala por la tuya. Video de control de entrada en formato MP4 para el flujo de trabajo con nodos personalizados. El nodo personalizado Load Video admite el formato mp4. @@ -197,18 +199,18 @@ Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para ### 2. Completar el flujo de trabajo paso a paso -![Pasos del flujo de trabajo Wan2.1 Fun Control con nodos personalizados](/images/tutorial/video/wan/fun_control_using_custom_nodes_flow_diagram.png) +![Pasos del flujo de trabajo de Wan2.1 Fun Control con Nodos Personalizados](/images/tutorial/video/wan/fun_control_using_custom_nodes_flow_diagram.png) -> La parte del modelo es esencialmente la misma. Si ya probaste el flujo de trabajo solo con nodos nativos, puedes subir directamente las imágenes correspondientes y ejecutarlo. +> La parte de los modelos es prácticamente la misma. Si ya probaste el flujo de trabajo con nodos nativos, puedes subir directamente las imágenes correspondientes y ejecutarlo. -1. Asegúrate de que el nodo `Load Diffusion Model` haya cargado `wan2.1_fun_control_1.3B_bf16.safetensors` -2. Asegúrate de que el nodo `Load CLIP` haya cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors` -3. Asegúrate de que el nodo `Load VAE` haya cargado `wan_2.1_vae.safetensors` -4. Asegúrate de que el nodo `Load CLIP Vision` haya cargado `clip_vision_h.safetensors` +1. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `wan2.1_fun_control_1.3B_bf16.safetensors` +2. Asegúrate de que el nodo `Load CLIP` tenga cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors` +3. Asegúrate de que el nodo `Load VAE` tenga cargado `wan_2.1_vae.safetensors` +4. Asegúrate de que el nodo `Load CLIP Vision` tenga cargado `clip_vision_h.safetensors` 5. Sube el fotograma inicial al nodo `Load Image` 6. Sube un video en formato mp4 al nodo personalizado `Load Video(Upload)`. Ten en cuenta que el flujo de trabajo ha ajustado el `frame_load_cap` predeterminado -7. Para la imagen actual, el `DWPose Estimator` solo usa la opción `detect_face` -8. (Opcional) Modifica el prompt (se admiten tanto inglés como chino) +7. Para la imagen actual, `DWPose Estimator` solo usa la opción `detect_face` +8. (Opcional) Modifica el prompt (se admiten inglés y chino) 9. (Opcional) Ajusta el tamaño del video en `WanFunControlToVideo`, evitando dimensiones demasiado grandes 10. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video @@ -216,7 +218,7 @@ Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para Gracias a los autores de la comunidad de ComfyUI por sus paquetes de nodos personalizados: - Este ejemplo usa `Load Video(Upload)` para admitir videos mp4 -- El `video_info` que se obtiene de `Load Video(Upload)` nos permite mantener los mismos `fps` en el video de salida +- El `video_info` que se obtiene de `Load Video(Upload)` permite mantener el mismo `fps` en el video de salida - Puedes reemplazar `DWPose Estimator` por otros preprocesadores del paquete de nodos `ComfyUI-comfyui_controlnet_aux` - Los prompts admiten varios idiomas @@ -224,10 +226,10 @@ Gracias a los autores de la comunidad de ComfyUI por sus paquetes de nodos perso ![Aplicar varios videos de control](/images/tutorial/video/wan/apply_multi_control_videos.jpg) -- Un consejo útil es que puedes combinar varias técnicas de preprocesamiento de imágenes y luego usar el nodo `Image Blend` para lograr el objetivo de aplicar varios métodos de control al mismo tiempo. -- Puedes usar el nodo `Video Combine` de `ComfyUI-VideoHelperSuite` para guardar videos en formato mp4 -- Usamos `SaveAnimatedWEBP` porque actualmente no admitimos incrustar el flujo de trabajo en **mp4** y algunos Nodos personalizados también pueden no admitir la incrustación del flujo de trabajo. Para conservar el flujo de trabajo en el video, elegimos el nodo `SaveAnimatedWEBP`. -- En el nodo `WanFunControlToVideo`, `control_video` no es obligatorio, así que a veces puedes Saltar el uso de un video de control, primero Generar un video de tamaño muy pequeño como 320x320 y luego usarlo como Entrada de video de control para lograr resultados consistentes. +- Un consejo útil: puedes combinar varias técnicas de preprocesamiento de imágenes y luego usar el nodo `Image Blend` para aplicar varios métodos de control al mismo tiempo. +- Puedes usar el nodo `Video Combine` de `ComfyUI-VideoHelperSuite` para guardar videos en formato mp4. +- Usamos `SaveAnimatedWEBP` porque actualmente no admitimos incrustar el flujo de trabajo en **mp4** y es posible que algunos nodos personalizados tampoco lo admitan. Para conservar el flujo de trabajo en el video, elegimos el nodo `SaveAnimatedWEBP`. +- En el nodo `WanFunControlToVideo`, `control_video` no es obligatorio, así que a veces puedes omitir el video de control: primero genera un video de tamaño muy pequeño, como 320x320, y luego úsalo como entrada de video de control para obtener resultados consistentes. - [ComfyUI-WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper) - [ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes) diff --git a/es/tutorials/video/wan/wan-animate-2.mdx b/es/tutorials/video/wan/wan-animate-2.mdx index 07a6b5786a..b8136aa32c 100644 --- a/es/tutorials/video/wan/wan-animate-2.mdx +++ b/es/tutorials/video/wan/wan-animate-2.mdx @@ -2,17 +2,19 @@ title: "Wan Animate 2: transferencia de movimiento" description: "Anima un personaje estático con Wan Animate 2 en ComfyUI: transfiere el movimiento desde un video guía directamente, sin extracción de poses ni preprocesamiento de esqueleto." sidebarTitle: "Wan Animate 2" -translationSourceHash: ae4a191b +translationSourceHash: 3eded645 translationFrom: tutorials/video/wan/wan-animate-2.mdx translationBlockHashes: "_intro": 358b6914 "Model Highlights": ab20a214 + "Wan Animate 2 workflow": c684e48e --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -Wan Animate 2 es un framework de animación de personajes de extremo a extremo del equipo de Wan que consume directamente videos guía en un Diffusion Transformer rediseñado. Logra una generación de movimiento de alta fidelidad y una fuerte preservación de la identidad al eliminar los extractores de movimiento intermedios: no se necesita extracción de pose ni preprocesamiento de esqueletos. +Wan Animate 2 es un framework de animación de personajes de extremo a extremo del equipo de Wan que consume directamente videos de referencia en un Diffusion Transformer rediseñado. Logra una generación de movimiento de alta fidelidad y una fuerte preservación de la identidad al eliminar los extractores de movimiento intermedios: no se necesita extracción de pose ni preprocesamiento de esqueletos. -El modelo también añade control de perspectiva impulsado por texto, lo que desacopla la perspectiva de la cámara de salida del video de conducción. Esto te permite animar a un personaje estático usando un video de conducción mientras controlas la cámara de forma independiente, e incluso generar un fondo nuevo a partir de tu prompt de texto. +El modelo también añade control de punto de vista impulsado por texto, lo que desacopla la perspectiva de la cámara de salida del video de referencia. Esto te permite animar un personaje estático usando un video de referencia mientras controlas la cámara de forma independiente, e incluso generar un fondo nuevo a partir de tu prompt de texto. @@ -20,13 +22,13 @@ El modelo también añade control de perspectiva impulsado por texto, lo que des - **Transferencia directa de movimiento**: Anima a un personaje estático a partir de un video guía sin extracción de pose ni preprocesamiento de esqueleto - **Preservación de la identidad**: Mantiene intactas la identidad, la apariencia y los detalles del personaje de referencia -- **Control de cámara por texto**: Desacopla la perspectiva de la cámara de salida respecto del video guía +- **Control de cámara mediante texto**: Desacopla la perspectiva de la cámara de salida del video guía - **Fondos nuevos**: Genera un fondo nuevo a partir de tu prompt de texto en lugar de copiar el fondo del video guía - **Movimiento de alta fidelidad**: Replica movimientos y expresiones complejas del video guía ## Flujo de trabajo de Wan Animate 2 -Anima un personaje estático con un video guía, transfiriendo el movimiento directamente desde los fotogramas del video. La salida conserva la identidad del personaje de referencia y, al mismo tiempo, genera un fondo nuevo y un movimiento de cámara a partir de tu prompt de texto. +Anima un personaje estático usando un video guía, transfiriendo el movimiento directamente desde los fotogramas del video. El resultado conserva la identidad del personaje de referencia mientras genera un fondo y un movimiento de cámara nuevos a partir de tu prompt de texto. @@ -35,7 +37,7 @@ Anima un personaje estático con un video guía, transfiriendo el movimiento dir Abrir en Comfy Cloud - Descarga el JSON o busca "Wan Animate 2" en la Biblioteca de plantillas + Descarga el JSON o busca "Wan Animate 2" en la biblioteca de plantillas @@ -45,38 +47,38 @@ Sube estos archivos a los nodos correspondientes: - Nodo `LoadImage`: pink_hair_mech_arms_ref.png (el personaje que se va a animar) + Nodo `LoadImage`: pink_hair_mech_arms_ref.png (el personaje a animar) Nodo `LoadVideo`: street_dance_drive.mp4 (la fuente del movimiento) -### Descarga de modelos +### Descargas de modelos -Este flujo de trabajo usa el modelo de difusión `wan_animate_2_int8_convrot.safetensors`. El repositorio también incluye variantes BF16 y destiladas; si prefieres usarlas, cambia la selección de modelo en el nodo `UNETLoader`. Todos los archivos están disponibles en el repositorio [Comfy-Org/Wan-Animate-2](https://huggingface.co/Comfy-Org/Wan-Animate-2): +Este flujo de trabajo usa el modelo de difusión `wan_animate_2_int8_convrot.safetensors`. El repositorio también incluye variantes BF16 y destiladas; si quieres usar esas en su lugar, cambia la selección de modelo en el nodo `UNETLoader`. Todos los archivos están disponibles en el repositorio [Comfy-Org/Wan-Animate-2](https://huggingface.co/Comfy-Org/Wan-Animate-2): - - wan_animate_2_int8_convrot.safetensors: Modelo de difusión cuantizado INT8 convrot que usa este flujo de trabajo + + wan_animate_2_int8_convrot.safetensors: modelo de difusión cuantizado INT8 convrot que usa este flujo de trabajo - wan_animate_2_bf16.safetensors: Modelo base de precisión completa. Requiere cambiar la selección de modelo en UNETLoader. + wan_animate_2_bf16.safetensors: modelo base de precisión completa. Requiere cambiar la selección de modelo en UNETLoader. - - wan_animate_2_distill_int8_convrot.safetensors: Variante INT8 destilada. Requiere cambiar la selección de modelo en UNETLoader. + + wan_animate_2_distill_int8_convrot.safetensors: variante INT8 destilada. Requiere cambiar la selección de modelo en UNETLoader. - - wan_animate_2_distill_bf16.safetensors: Variante BF16 destilada. Requiere cambiar la selección de modelo en UNETLoader. + + wan_animate_2_distill_bf16.safetensors: variante BF16 destilada. Requiere cambiar la selección de modelo en UNETLoader. lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors: LoRA de aceleración LightX2V - umt5_xxl_fp8_e4m3fn_scaled.safetensors: Codificador de texto UMT5-XXL FP8 + umt5_xxl_fp8_e4m3fn_scaled.safetensors: codificador de texto UMT5-XXL FP8 - clip_vision_h.safetensors: Codificador CLIP Vision + clip_vision_h.safetensors: codificador CLIP Vision Wan2_1_VAE_bf16.safetensors: VAE de Wan2.1 para codificar y decodificar @@ -105,20 +107,21 @@ Coloca los archivos en los siguientes directorios: ### Instrucciones del flujo de trabajo -1. Asegúrate de que todos los modelos se cargan correctamente +1. Asegúrate de que todos los modelos se carguen correctamente 2. Sube la imagen de referencia: el personaje de esta imagen es el personaje objetivo que se va a animar -3. Sube el video guía: su movimiento se transfiere al personaje de referencia +3. Sube el video de conducción: su movimiento se transfiere al personaje de referencia 4. Actualiza el prompt para describir la escena, el fondo y el movimiento de cámara que quieres 5. Haz clic en `Run` o usa el atajo `Ctrl(cmd) + Enter` para generar el video ### Extender a videos más largos -Los videos más largos se gestionan dentro del flujo de trabajo: el Subgraph `Motion Transfer (Wan Animate 2)` itera (`StartLoop` / `EndLoop`) y sigue generando hasta cubrir todo el video guía, así que con un solo Subgraph es suficiente. No hay que duplicar ni recablear nada. +Los videos más largos se manejan dentro del flujo de trabajo: el subgrafo `Motion Transfer (Wan Animate 2)` hace un bucle (`StartLoop` / `EndLoop`) y sigue generando hasta cubrir todo el video de origen, así que con un solo subgrafo basta. No hay que duplicar ni recablear nada. + +Cada iteración del bucle genera 81 fotogramas, unos 3.4 segundos a 24 fps. Ese es el valor de `Int (fragment_length)` dentro del subgrafo. Puedes aumentarlo, pero debe seguir siendo una longitud válida de Wan: 81, 85, 89, etcétera, es decir, `4n + 1`. -Cada iteración del bucle genera 81 fotogramas, unos 3.4 segundos a 24 fps. Ese es el valor `Int (fragment_length)` dentro del Subgraph. Puedes aumentarlo, pero debe mantenerse en una longitud válida de Wan: 81, 85, 89, etcétera, es decir, `4n + 1`. +El cálculo del bucle lee la cantidad de fotogramas del video de origen, determina cuántas continuaciones hacen falta y recorta el final para que la salida tenga exactamente la misma cantidad de fotogramas que el video de origen. Cada continuación repite el último fotograma del segmento anterior y ese duplicado se elimina, así que cada segmento adicional añade `fragment_length - 1` fotogramas nuevos. -El cálculo del bucle lee el número de fotogramas del video guía, determina cuántas continuaciones hacen falta y recorta el final para que la salida tenga exactamente los mismos fotogramas que el video guía. Cada continuación repite el último fotograma del segmento anterior y ese duplicado se elimina, así que cada segmento adicional añade `fragment_length - 1` fotogramas nuevos. +El bucle usa los nodos de bucle del núcleo, así que el flujo de trabajo necesita ComfyUI 0.36.0 o posterior. -El bucle usa los nodos de bucle del núcleo, así que el flujo de trabajo necesita ComfyUI 0.36.0 o superior. +El subgrafo `Video Stitch` es la vista previa comparativa: coloca el video generado junto al video de origen. No forma parte del proceso de extensión. -El Subgraph `Video Stitch` es la vista previa comparativa: coloca el video generado junto al video guía. No forma parte de la ruta de extensión. diff --git a/es/tutorials/video/wan/wan-causal-forcing.mdx b/es/tutorials/video/wan/wan-causal-forcing.mdx index 342ce69dae..271280192a 100644 --- a/es/tutorials/video/wan/wan-causal-forcing.mdx +++ b/es/tutorials/video/wan/wan-causal-forcing.mdx @@ -2,17 +2,19 @@ title: "Causal Forcing en ComfyUI: imagen a video con Wan2.1 en 1 a 4 pasos" description: "Genera video temporalmente consistente desde una sola imagen en ComfyUI con Causal Forcing o Causal Forcing++ sobre Wan2.1, usando tan solo 1 a 4 pasos." sidebarTitle: "Causal Forcing I2V" -translationSourceHash: 4cd31faf +translationSourceHash: e94bf5dc translationFrom: tutorials/video/wan/wan-causal-forcing.mdx translationBlockHashes: "_intro": 3da76367 "How it works": a3348b35 "Using the workflow": 5e6245a2 "Steps to run": 3202924b + "Model downloads": c6ce079e --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Causal Forcing** es una técnica de generación de video que aplica **conditioning recurrente** durante la inferencia, en la que cada fotograma generado se devuelve al modelo para predecir el siguiente fotograma. Así se obtienen videos suaves y coherentes en el tiempo a partir de una sola imagen inicial en tan solo **1 a 4 pasos de inferencia**. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Causal Forcing** es una técnica de generación de video que aplica **acondicionamiento recurrente** durante la inferencia, donde cada fotograma generado se devuelve al modelo para predecir el siguiente fotograma. Esto produce videos suaves y coherentes en el tiempo a partir de una sola imagen inicial en tan solo **1 a 4 pasos de inferencia**. Este flujo de trabajo usa **Wan2.1** y admite tanto el modo **Causal Forcing** (estándar) como **Causal Forcing++** (mejorado). @@ -33,7 +35,7 @@ Este flujo de trabajo usa **Wan2.1** y admite tanto el modo **Causal Forcing** ( - Imagen de entrada para el primer fotograma. Descárgala y úsala, o reemplázala por una tuya. + Imagen de entrada para el primer fotograma. Descarga y usa esta imagen, o reemplázala con una tuya. @@ -48,15 +50,15 @@ A diferencia de la generación de video estándar, que procesa todos los fotogra Este enfoque recurrente crea una **fuerte consistencia temporal**: cada fotograma surge de forma natural del anterior. Esto puede producir resultados de alta calidad con muy pocos pasos de inferencia (de 1 a 4). - + Este flujo de trabajo usa un nodo Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y extender el flujo de trabajo. ### Causal Forcing vs Causal Forcing++ | Modo | Descripción | |---|---| -| **Causal Forcing** | conditioning recurrente estándar. Buena calidad con 2–4 pasos. | -| **Causal Forcing++** | Modo mejorado que aplica conditioning adicional para una mejor coherencia temporal. Funciona bien con solo 1–2 pasos. | +| **Causal Forcing** | Acondicionamiento recurrente estándar. Buena calidad con 2–4 pasos. | +| **Causal Forcing++** | Modo mejorado que aplica acondicionamiento adicional para una mejor coherencia temporal. Funciona bien con solo 1–2 pasos. | ## Usar el flujo de trabajo @@ -67,12 +69,12 @@ El flujo de trabajo acepta una sola imagen de entrada (el primer fotograma) y un | Ajuste | Descripción | |---|---| | **first_frame** (requerido) | La imagen inicial del video. Carga un PNG/JPG con el nodo **LoadImage**. | -| **positive_prompt** (opcional) | Una descripción de texto del contenido de video deseado. Déjalo vacío para no aplicar conditioning. | +| **positive_prompt** (opcional) | Una descripción de texto del contenido de video deseado. Déjalo vacío para no aplicar acondicionamiento. | | **duration** (opcional) | El número de fotogramas a generar. Predeterminado: el número de fotogramas de la salida esperada del modelo. | ### Parámetros del subgrafo WAN I2V -Se exponen como controles en el nodo del subgrafo del plano: +El nodo del subgrafo del plano los expone como controles: | Parámetro | Predeterminado | Descripción | |---|---|---| @@ -86,15 +88,15 @@ Se exponen como controles en el nodo del subgrafo del plano: ## Pasos para ejecutar 1. **Carga una imagen**: usa el nodo **LoadImage** para cargar tu fotograma inicial -2. **Escribe un prompt** (opcional): describe el contenido de video que deseas +2. **Escribe un prompt** (opcional): describe el contenido del video que deseas 3. **Establece la duración**: cuántos fotogramas generar 4. **Selecciona los modelos**: elige el checkpoint, CLIP y VAE de Wan2.1 I2V 5. **Elige el modo**: Causal Forcing o Causal Forcing++ (configúralo mediante la configuración interna del subgrafo o una entrada específica de Causal Forcing si está disponible) 6. **Ejecuta**: los fotogramas se generarán de forma secuencial y se guardarán en `ComfyUI/output/` -## Descarga de modelos +## Descargas de modelos -Descarga el modelo Wan2.1 I2V y los archivos necesarios. Colócalos en los subdirectorios correspondientes de `models/`. +Descarga el modelo Wan2.1 I2V y los archivos requeridos. Colócalos en las subcarpetas correspondientes de `models/`. ### Wan2.1 I2V @@ -118,7 +120,7 @@ Descarga el modelo Wan2.1 I2V y los archivos necesarios. Colócalos en los subdi -### Ubicación de almacenamiento de modelos +### Ubicación de almacenamiento de los modelos ``` 📂 ComfyUI/ @@ -130,3 +132,4 @@ Descarga el modelo Wan2.1 I2V y los archivos necesarios. Colócalos en los subdi │ └── 📂 vae/ │ └── Wan2.1_VAE_bf16.safetensors ``` + diff --git a/es/tutorials/video/wan/wan-move.mdx b/es/tutorials/video/wan/wan-move.mdx index 205659fc86..9f5a576d9a 100644 --- a/es/tutorials/video/wan/wan-move.mdx +++ b/es/tutorials/video/wan/wan-move.mdx @@ -2,26 +2,28 @@ title: "Ejemplo de flujo de trabajo Wan-Move en ComfyUI" description: "Genera video con movimiento controlable usando Wan-Move en ComfyUI: guía el movimiento de objetos con trayectorias de puntos para imagen a video." sidebarTitle: "Wan-Move" -translationSourceHash: 78cfc130 +translationSourceHash: 6e632abd translationFrom: tutorials/video/wan/wan-move.mdx translationBlockHashes: "_intro": 67a26359 "Wan-Move image-to-video workflow": 78aef00b + "Model links": 8e0ef166 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Wan-Move** es un framework de generación de video con control de movimiento desarrollado por Tongyi Lab de Alibaba. Permite controlar el movimiento de los objetos en los videos generados especificando trayectorias de puntos sobre la imagen de entrada, lo que hace que la generación de imagen a video sea más precisa y controlable. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Wan-Move** es un framework de generación de video con control de movimiento desarrollado por Tongyi Lab de Alibaba. Te permite controlar el movimiento de los objetos en los videos generados especificando trayectorias de puntos sobre la imagen de entrada, lo que hace que la generación de imagen a video sea más precisa y controlable. **Características principales**: -- **Control de movimiento en 480p y 5 s de alta calidad**: genera videos de 5 segundos en 480p con una controlabilidad de movimiento de grano fino -- **Orientación por trayectorias latent**: representa las condiciones de movimiento propagando las características del primer fotograma a lo largo de las trayectorias -- **Control de grano fino a nivel puntual**: los movimientos de los objetos se representan con trayectorias de puntos densas, lo que permite un control preciso a nivel de región +- **Control de movimiento de alta calidad en 5 s y 480p**: genera videos de 5 segundos en 480p con una controlabilidad de movimiento de grano fino +- **Orientación por trayectorias latentes**: representa las condiciones de movimiento propagando las características del primer fotograma a lo largo de las trayectorias +- **Control de grano fino a nivel puntual**: el movimiento de los objetos se representa con trayectorias de puntos densas, lo que permite un control preciso a nivel de región - **Sin cambios en la arquitectura**: se integra sin problemas en Wan-I2V-14B sin módulos de movimiento adicionales **Enlaces relacionados**: - [GitHub](https://github.com/ali-vilab/Wan-Move) - [Hugging Face](https://huggingface.co/Ruihang/Wan-Move-14B-480P) -- [Paper](https://arxiv.org/abs/2512.08765) +- [Artículo](https://arxiv.org/abs/2512.08765) ## Flujo de trabajo de imagen a video Wan-Move @@ -58,23 +60,23 @@ Sube este archivo al nodo `LoadImage` correspondiente: - Colócalo en ComfyUI/models/diffusion_models/ + Coloca el archivo en ComfyUI/models/diffusion_models/ - Colócalo en ComfyUI/models/loras/ + Coloca el archivo en ComfyUI/models/loras/ - - Colócalo en ComfyUI/models/text_encoders/ + + Coloca el archivo en ComfyUI/models/text_encoders/ - Colócalo en ComfyUI/models/clip_vision/ + Coloca el archivo en ComfyUI/models/clip_vision/ - Colócalo en ComfyUI/models/vae/ + Coloca el archivo en ComfyUI/models/vae/ -**Ubicación de almacenamiento de modelos** +**Ubicación de almacenamiento de los modelos** ``` 📂 ComfyUI/ @@ -90,3 +92,4 @@ Sube este archivo al nodo `LoadImage` correspondiente: │ └── 📂 vae/ │ └── wan_2.1_vae.safetensors ``` + diff --git a/es/tutorials/video/wan/wan2-2-animate.mdx b/es/tutorials/video/wan/wan2-2-animate.mdx index 655eded00d..874b81e393 100644 --- a/es/tutorials/video/wan/wan2-2-animate.mdx +++ b/es/tutorials/video/wan/wan2-2-animate.mdx @@ -2,20 +2,22 @@ title: "Flujo de trabajo nativo de ComfyUI para Wan2.2 Animate" description: "Marco unificado de animación y reemplazo de personajes con replicación precisa de movimiento y expresión." sidebarTitle: "Wan2.2 Animate" -translationSourceHash: f66a9a5c +translationSourceHash: 081a4697 translationFrom: tutorials/video/wan/wan2-2-animate.mdx translationBlockHashes: "_intro": 96eb0424 "Model Highlights": fc4e7349 "ComfyOrg Wan2.2 Animate stream replay": a43ba31b + "About Wan2.2 Animate workflow": 71233e1e --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -Wan-Animate es un marco unificado para animar y reemplazar personajes, desarrollado por el equipo de WAN. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +Wan-Animate es un marco unificado para la animación y el reemplazo de personajes, desarrollado por el equipo de WAN. El modelo puede animar cualquier personaje a partir del video de un intérprete, replicando con precisión sus expresiones faciales y sus movimientos para generar videos de personajes muy realistas. -También puede reemplazar los personajes de un video por personajes animados, conservando sus expresiones y movimientos y replicando la iluminación y el tono de color originales para lograr una integración perfecta con el entorno. +También puede reemplazar los personajes de un video por personajes animados, conservando sus expresiones y movimientos y replicando la iluminación y el tono de color originales para una integración fluida con el entorno. ## Aspectos destacados del modelo @@ -23,7 +25,7 @@ También puede reemplazar los personajes de un video por personajes animados, co - Control avanzado del movimiento corporal: utiliza señales de esqueleto alineadas espacialmente para replicar con precisión el movimiento del cuerpo. - Movimiento y expresión precisos: reproduce con exactitud los movimientos y las expresiones faciales del video de referencia. - Integración natural con el entorno: combina a la perfección el personaje reemplazado con el entorno del video original. -- Generación fluida de videos largos: la generación iterativa garantiza un movimiento y un flujo visual consistentes en videos extensos. +- Generación fluida de videos largos: la generación iterativa garantiza un movimiento y un flujo visual constantes en videos extensos. ## Repetición del stream de ComfyOrg Wan2.2 Animate @@ -38,15 +40,15 @@ También puede reemplazar los personajes de un video por personajes animados, co -## Acerca del flujo de trabajo de Wan2.2 Animate +## Acerca del flujo de trabajo Wan2.2 Animate -Este flujo de trabajo admite dos modos: Mix (reemplaza un personaje de un video por el personaje de una imagen de referencia) y Move (anima un personaje usando el movimiento de un video de entrada). +Este flujo de trabajo admite dos modos: Mix (reemplaza a un personaje de un video con un personaje de una imagen de referencia) y Move (anima a un personaje usando el movimiento de un video de entrada). -### Wan2.2 Animate, Character Animation and Replacement {#video_wan2_2_14B_animate} +### Wan2.2 Animate, animación y reemplazo de personajes {#video_wan2_2_14B_animate} -Marco unificado de animación y reemplazo de personajes, con replicación precisa del movimiento y de las expresiones. +Framework unificado de animación y reemplazo de personajes con replicación precisa de movimiento y expresiones. -Wan2.2 Animate, Character Animation and Replacement workflow preview +Vista previa del flujo de trabajo Wan2.2 Animate, Character Animation and Replacement @@ -63,10 +65,10 @@ Sube estos archivos a los nodos correspondientes: - `LoadImage` nodo 10 · `video_wan2_2_14B_animate_reference_image.png` + Nodo `LoadImage` 10 · `video_wan2_2_14B_animate_reference_image.png` - `LoadVideo` nodo 145 · `video_wan2_2_14B_animate_original_video.mp4` + Nodo `LoadVideo` 145 · `video_wan2_2_14B_animate_original_video.mp4` @@ -76,23 +78,23 @@ Sube estos archivos a los nodos correspondientes: ### 2. Enlaces de modelos -Todos los modelos que se usan en esta guía están [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files). +Todos los modelos que se usan en esta guía están disponibles [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files). **Modelos de difusión** - Wan2_2-Animate-14B_fp8_e4m3fn_scaled_KJ.safetensors: Versión FP8 escalada del repositorio de Kijai + Wan2_2-Animate-14B_fp8_e4m3fn_scaled_KJ.safetensors: versión FP8 escalada del repositorio de Kijai - wan2.2_animate_14B_bf16.safetensors: Pesos originales del modelo en bf16 + wan2.2_animate_14B_bf16.safetensors: pesos originales del modelo en bf16 **CLIP Vision** - clip_vision_h.safetensors: Codificador CLIP Vision + clip_vision_h.safetensors: codificador CLIP Vision **LoRAs** @@ -107,7 +109,7 @@ Todos los modelos que se usan en esta guía están [aquí](https://huggingface.c **Codificadores de texto** - umt5_xxl_fp8_e4m3fn_scaled.safetensors: Codificador de texto FP8 escalado + umt5_xxl_fp8_e4m3fn_scaled.safetensors: codificador de texto FP8 escalado ``` ComfyUI/ @@ -125,11 +127,11 @@ ComfyUI/ │ └── wan_2.1_vae.safetensors ``` -### 3. Instala los nodos personalizados +### 3. Instalar nodos personalizados -Descarga el siguiente archivo de flujo de trabajo y arrástralo a ComfyUI para cargarlo; si tienes instalado [ComfyUI-Manager](https://github.com/Comfy-Org/ComfyUI-Manager), basta con hacer clic en el botón `Install missing nodes` para instalar los nodos que falten. +Descarga el siguiente archivo de flujo de trabajo y arrástralo a ComfyUI para cargar el flujo de trabajo. Si tienes [ComfyUI-Manager](https://github.com/Comfy-Org/ComfyUI-Manager) instalado, puedes hacer clic en el botón `Install missing nodes` para instalar los nodos faltantes. -Necesitamos instalar los siguientes nodos personalizados: +Necesitas instalar los siguientes nodos personalizados: - [ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes) - [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) @@ -138,30 +140,31 @@ Si no sabes cómo instalar nodos personalizados, consulta [Cómo instalar nodos ### 4. Instrucciones del flujo de trabajo -Wan2.2 Animate tiene dos modos: Mix y Move -- Mix: usa la imagen de referencia para reemplazar el personaje del video -- Move: usa el movimiento del personaje del video de entrada para animar el personaje de la imagen de referencia (como en Wan2.2 Fun Control) +Wan2.2 Animate tiene dos modos: Mix y Move. +- Mix: usa la imagen de referencia para reemplazar al personaje en el video. +- Move: usa el movimiento del personaje del video de entrada para animar al personaje de la imagen de referencia (como en Wan2.2 Fun Control). #### 4.1 Modo Mix -![Workflow Instructions](/images/tutorial/video/wan/wan2_2/wan_2.2_14b_animate.jpg) - -0. Si es la primera vez que ejecutas este flujo de trabajo, usa un tamaño pequeño para la generación de video, por si no tienes suficiente VRAM para ejecutarlo; además, por la limitación de `WanAnimateToVideo`, el ancho y el alto del video deben ser múltiplos de 16. -1. Asegúrate de que todos los modelos se cargan correctamente -2. Actualiza el prompt si quieres -3. Sube la imagen de referencia: el personaje de esta imagen será el personaje objetivo -4. La primera vez puedes usar los videos que proporcionamos como videos de entrada; el nodo **DWPose Estimator** de [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) preprocesará el video de entrada para obtener videos de control de pose y de rostro -5. El nodo `Points Editor` viene de [KJNodes](https://github.com/kijai/ComfyUI-KJNodes/); por defecto no carga el primer fotograma del video de entrada, así que debes ejecutar el flujo de trabajo una vez o subir el primer fotograma manualmente - - Debajo del nodo `Points Editor` hemos añadido una nota sobre cómo funciona este nodo y cómo editarlo. Consúltala -6. El grupo "Video Extend" sirve para ampliar la duración del video de salida - - Cada `Video Extend` amplía otros 77 fotogramas (alrededor de 4.8125 segundos) - - Si tu video de entrada dura menos de 5 s, puede que no lo necesites - - Si quieres ampliar más, tienes que copiar y pegar varias veces y enlazar el `batch_images` del último Video Extend con el siguiente, y también el `video_frame_offset` del último Video Extend con el siguiente -7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación del video +![Instrucciones del flujo de trabajo](/images/tutorial/video/wan/wan2_2/wan_2.2_14b_animate.jpg) + +0. Si ejecutas este flujo de trabajo por primera vez, usa un tamaño pequeño para la generación de video, en caso de que no tengas suficiente VRAM para ejecutarlo y, debido a la limitación de `WanAnimateToVideo`, el ancho o el alto del video deben ser múltiplos de 16. +1. Asegúrate de que todos los modelos estén cargados correctamente. +2. Actualiza el prompt si quieres. +3. Sube la imagen de referencia; el personaje de esta imagen será el personaje objetivo. +4. Puedes usar los videos que proporcionamos como videos de entrada la primera vez; el nodo **DWPose Estimator** en [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) preprocesará el video de entrada para obtener videos de control de pose y rostro. +5. El `Points Editor` es de [KJNodes](https://github.com/kijai/ComfyUI-KJNodes/); de forma predeterminada, este nodo no cargará el primer fotograma del video de entrada, por lo que debes ejecutar el flujo de trabajo una vez o subir el primer fotograma manualmente. + - Debajo del nodo `Points Editor`, hemos añadido una nota sobre cómo funciona este nodo y cómo editarlo. Consúltala. +6. El grupo "Video Extend" sirve para extender la duración del video de salida. + - Cada `Video Extend` extenderá otros 77 fotogramas (alrededor de 4.8125 segundos). + - Si tu video de entrada dura menos de 5s, es posible que no lo necesites. + - Si quieres extenderlo más, debes copiar y pegar varias veces; debes conectar el `batch_images` del último Video Extend con el siguiente, y también el `video_frame_offset` del último Video Extend con el siguiente. +7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video. #### 4.2 Modo Move -Usamos [Subgraph](/es/interface/features/subgraph) en el flujo de trabajo de Wan2.2 Animate; así es como se cambia al modo Move: +Usamos [subgraph](/es/interface/features/subgraph) en el flujo de trabajo Wan2.2 Animate; así puedes cambiar al modo Move: ![Subgraph](/images/tutorial/video/wan/wan2_2/wan2.2_animate_subgraph.jpg) Si quieres cambiar al modo Move, puedes desconectar las entradas `background_video` y `character_mask` del nodo `Video Sampling and output(Subgraph)`. + diff --git a/es/tutorials/video/wan/wan2-2-fun-control.mdx b/es/tutorials/video/wan/wan2-2-fun-control.mdx index 3947252f37..58ab19287e 100644 --- a/es/tutorials/video/wan/wan2-2-fun-control.mdx +++ b/es/tutorials/video/wan/wan2-2-fun-control.mdx @@ -2,22 +2,24 @@ title: "Wan2.2 Fun Control en ComfyUI: generación de video con control" description: "Ejecuta el flujo de trabajo Wan2.2 Fun Control 14B en ComfyUI para generar video guiado por un video de control, con modelos de alto y bajo ruido y LoRAs de 4 pasos." sidebarTitle: "Wan2.2 Fun Control" -translationSourceHash: 5fe96707 +translationSourceHash: 713ec1d8 translationFrom: tutorials/video/wan/wan2-2-fun-control.mdx translationBlockHashes: "_intro": 239e24b6 "ComfyOrg Wan2.2 Fun InP & Control Youtube Live Stream Replay": 22557a2e + "Wan2.2 Fun Control Video Generation Workflow Example": 0a502468 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Wan2.2-Fun-Control** es un modelo de generación y control de video de nueva generación lanzado por el equipo de Alibaba PAI. Mediante un innovador mecanismo de Control Codes combinado con aprendizaje profundo y entradas condicionales multimodales, puede generar videos de alta calidad que cumplen con condiciones de control predefinidas. El modelo se publica bajo la **licencia Apache 2.0** y admite uso comercial. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Wan2.2-Fun-Control** es un modelo de generación y control de video de nueva generación lanzado por el equipo de Alibaba PAI. Gracias a un innovador mecanismo de Control Codes combinado con aprendizaje profundo y entradas condicionales multimodales, puede generar videos de alta calidad que respetan las condiciones de control predefinidas. El modelo se publica bajo la **licencia Apache 2.0** y admite uso comercial. **Características principales**: - **Control multimodal**: admite varias condiciones de control, como **Canny (arte lineal)**, **Profundidad**, **OpenPose (pose humana)**, **MLSD (bordes geométricos)** y **control de trayectoria** - **Generación de video de alta calidad**: basado en la arquitectura Wan2.2, produce videos con calidad cinematográfica - **Compatibilidad con varios idiomas**: admite prompts en varios idiomas, incluidos el chino y el inglés -A continuación se muestran los pesos del modelo y los repositorios de código relevantes: +A continuación, los pesos del modelo y los repositorios de código relevantes: - [🤗Wan2.2-Fun-A14B-Control](https://huggingface.co/alibaba-pai/Wan2.2-Fun-A14B-Control) - Repositorio de código: [VideoX-Fun](https://github.com/aigc-apps/VideoX-Fun) @@ -37,23 +39,23 @@ A continuación se muestran los pesos del modelo y los repositorios de código r Este flujo de trabajo ofrece dos versiones: -1. Una versión con el LoRA de 4 pasos [Wan2.2-Lightning](https://huggingface.co/lightx2v/Wan2.2-Lightning) de lightx2v: puede provocar cierta pérdida de dinamismo en el video, pero ofrece mayor velocidad +1. Una versión que usa el LoRA de 4 pasos de [Wan2.2-Lightning](https://huggingface.co/lightx2v/Wan2.2-Lightning) de lightx2v: puede causar cierta pérdida en el dinamismo del video, pero ofrece mayor velocidad 2. Una versión fp8_scaled sin LoRA de aceleración -A continuación se muestran los resultados de las pruebas con una GPU RTX4090D de 24 GB de VRAM a una resolución de 640×640 con 81 fotogramas +Estos son los resultados de las pruebas con una GPU RTX4090D de 24 GB de VRAM a una resolución de 640×640 con 81 fotogramas: -| Tipo de modelo | Uso de VRAM | Tiempo de la primera generación | Tiempo de la segunda generación | -| ------------------------ | ---------- | -------------------- | --------------------- | -| fp8_scaled | 83% | ≈ 524s | ≈ 520s | -| fp8_scaled + 4-step LoRA | 89% | ≈ 138s | ≈ 79s | +| Tipo de modelo | Uso de VRAM | Tiempo de primera generación | Tiempo de segunda generación | +| ------------------------ | ----------- | ---------------------------- | ---------------------------- | +| fp8_scaled | 83% | ≈ 524s | ≈ 520s | +| fp8_scaled + LoRA de 4 pasos | 89% | ≈ 138s | ≈ 79s | -Como el LoRA de 4 pasos ofrece una mejor experiencia a quienes usan el flujo de trabajo por primera vez, aunque puede provocar cierta pérdida de dinamismo en el video, hemos activado por defecto la versión con LoRA de aceleración. Si quieres activar el otro flujo de trabajo, selecciónalo y usa **Ctrl+B** para habilitarlo. +Como el LoRA de 4 pasos ofrece una mejor experiencia a quienes usan el flujo de trabajo por primera vez, pero puede causar cierta pérdida en el dinamismo del video, hemos habilitado la versión con LoRA de aceleración de forma predeterminada. Si quieres habilitar el otro flujo de trabajo, selecciónalo y usa **Ctrl+B** para activarlo. -### 1. Descarga el flujo de trabajo y los materiales +### 1. Descargar el flujo de trabajo y los materiales -Actualiza tu ComfyUI a la última versión, luego descarga el archivo del flujo de trabajo y arrástralo a ComfyUI, o busca "Wan2.2 Fun Control" en la Biblioteca de plantillas en `Workflow` → `Browse Templates` → `Video`. +Actualiza tu ComfyUI a la última versión y luego descarga el archivo del flujo de trabajo y arrástralo a ComfyUI, o busca "Wan2.2 Fun Control" en la Biblioteca de plantillas, en `Workflow` → `Browse Templates` → `Video`. -Wan2.2 Fun Control workflow +Flujo de trabajo de Wan2.2 Fun Control @@ -73,42 +75,42 @@ Descarga las siguientes imágenes y videos como materiales de entrada. Fotograma inicial para la generación del video. Descarga y usa esta imagen, o reemplázala por la tuya. - Video de control de pose ya preprocesado. Descarga y usa este video, o reemplázalo por el tuyo. + Video de control de pose preprocesado. Descarga y usa este video, o reemplázalo por el tuyo. -> Aquí usamos un video ya preprocesado. +> Aquí usamos un video preprocesado. ### 2. Modelos -Todos los modelos que se usan en esta guía están [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files). +Puedes encontrar todos los modelos de esta guía [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files). **Modelos de difusión** - wan2.2_fun_control_high_noise_14B_fp8_scaled.safetensors: Modelo de difusión de alto ruido + wan2.2_fun_control_high_noise_14B_fp8_scaled.safetensors: Modelo de difusión de ruido alto - wan2.2_fun_control_low_noise_14B_fp8_scaled.safetensors: Modelo de difusión de bajo ruido + wan2.2_fun_control_low_noise_14B_fp8_scaled.safetensors: Modelo de difusión de ruido bajo -**LoRA Wan2.2-Lightning (opcional, para acelerar)** +**LoRA Wan2.2-Lightning (opcional, para aceleración)** - - wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors: LoRA de aceleración de 4 pasos para alto ruido + + wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors: LoRA de aceleración de 4 pasos para ruido alto - - wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors: LoRA de aceleración de 4 pasos para bajo ruido + + wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors: LoRA de aceleración de 4 pasos para ruido bajo **VAE** - wan_2.1_vae.safetensors: VAE de Wan2.1 para codificar y decodificar + wan_2.1_vae.safetensors: VAE Wan2.1 para codificar y decodificar **Codificador de texto** @@ -132,27 +134,28 @@ ComfyUI/ ### 3. Guía del flujo de trabajo -![Wan2.2 Fun Control Workflow Steps](/images/tutorial/video/wan/wan2_2/wan_2.2_14b_fun_control.jpg) +![Pasos del flujo de trabajo de Wan2.2 Fun Control](/images/tutorial/video/wan/wan2_2/wan_2.2_14b_fun_control.jpg) - Este flujo de trabajo usa LoRA. Asegúrate de que el modelo de difusión y el LoRA correspondientes estén emparejados: los modelos y LoRA de alto ruido y de bajo ruido deben usarse de forma correspondiente. + Este flujo de trabajo usa LoRA. Asegúrate de que el modelo de difusión y la LoRA correspondientes coincidan: los modelos y las LoRA de ruido alto y ruido bajo deben usarse de forma correspondiente. -1. Carga del modelo de **alto ruido** y del **LoRA** +1. Carga del modelo de **ruido alto** y de la **LoRA** - Asegúrate de que el nodo `Load Diffusion Model` cargue el modelo `wan2.2_fun_control_high_noise_14B_fp8_scaled.safetensors` - - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el `wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors` -2. Carga del modelo de **bajo ruido** y del **LoRA** + - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue `wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors` +2. Carga del modelo de **ruido bajo** y de la **LoRA** - Asegúrate de que el nodo `Load Diffusion Model` cargue el modelo `wan2.2_fun_control_low_noise_14B_fp8_scaled.safetensors` - - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el `wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors` + - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue `wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors` 3. Asegúrate de que el nodo `Load CLIP` cargue el modelo `umt5_xxl_fp8_e4m3fn_scaled.safetensors` 4. Asegúrate de que el nodo `Load VAE` cargue el modelo `wan_2.1_vae.safetensors` 5. Sube el fotograma inicial en el nodo `Load Image` -6. En el segundo nodo `Load video`, carga el video de control de pose. El video que se proporciona ya está preprocesado y puedes usarlo directamente -7. Como proporcionamos un video de pose ya preprocesado, hay que desactivar el nodo de preprocesamiento de imagen de video correspondiente. Puedes seleccionarlo y usar `Ctrl + B` para desactivarlo +6. En el segundo nodo `Load video`, carga el video de control de pose. El video proporcionado ya está preprocesado y puedes usarlo directamente +7. Dado que proporcionamos un video de pose preprocesado, debes deshabilitar el nodo correspondiente de preprocesamiento de imágenes de video. Puedes seleccionarlo y usar `Ctrl + B` para deshabilitarlo 8. Modifica el prompt: puedes usar tanto chino como inglés -9. En `Wan22FunControlToVideo`, modifica las dimensiones del video. Por defecto se usa una resolución de 640×640 para evitar tiempos de procesamiento excesivos en equipos con poca VRAM -10. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter`, para ejecutar la generación del video +9. En `Wan22FunControlToVideo`, modifica las dimensiones del video. La resolución predeterminada es de 640×640 para evitar tiempos de procesamiento excesivos en usuarios con poca VRAM +10. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video ### Notas adicionales -Como los nodos integrados de ComfyUI solo incluyen el preprocesador Canny, puedes usar herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para aplicar otros tipos de preprocesamiento de imagen +Como los nodos integrados de ComfyUI solo incluyen el preprocesador Canny, puedes usar herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para implementar otros tipos de preprocesamiento de imágenes. + diff --git a/es/tutorials/video/wan/wan2-2-fun-inp.mdx b/es/tutorials/video/wan/wan2-2-fun-inp.mdx index 8b198033cd..55e805e3fc 100644 --- a/es/tutorials/video/wan/wan2-2-fun-inp.mdx +++ b/es/tutorials/video/wan/wan2-2-fun-inp.mdx @@ -2,25 +2,27 @@ title: "Wan2.2 Fun InP en ComfyUI: video con fotograma inicial y final" description: "Ejecuta el flujo de trabajo Wan2.2 Fun InP 14B en ComfyUI para generar video entre un fotograma inicial y uno final, con modelos de alto y bajo ruido y LoRAs Lightning." sidebarTitle: "Wan2.2 Fun Inp" -translationSourceHash: 16cf1b1c +translationSourceHash: ff570640 translationFrom: tutorials/video/wan/wan2-2-fun-inp.mdx translationBlockHashes: "_intro": 7a3595d7 "ComfyOrg Wan2.2 Fun InP & Control Youtube Live Stream Replay": 22557a2e + "Wan2.2 Fun Inp Start-End Frame Video Generation Workflow Example": bc339657 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Wan2.2-Fun-Inp** es un modelo de generación de video controlado por fotograma inicial y final, lanzado por el equipo de Alibaba PAI. Permite introducir **imágenes de fotograma inicial y final** para generar videos con la transición intermedia, lo que brinda a los creadores un mayor control creativo. El modelo se publica bajo la **licencia Apache 2.0** y admite uso comercial. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Wan2.2-Fun-Inp** es un modelo de generación de video controlado por fotograma inicial y final, lanzado por el equipo de Alibaba PAI. Admite la introducción de **imágenes de fotograma inicial y final** para generar videos de transición intermedios, lo que brinda a los creadores un mayor control creativo. El modelo se publica bajo la **licencia Apache 2.0** y permite uso comercial. **Características principales**: -- **Control por fotograma inicial y final**: permite introducir imágenes de fotograma inicial y final para generar videos con la transición intermedia, lo que mejora la coherencia del video y la libertad creativa +- **Control por fotograma inicial y final**: admite la introducción de imágenes de fotograma inicial y final para generar videos de transición intermedios, lo que mejora la coherencia del video y la libertad creativa - **Generación de video de alta calidad**: basado en la arquitectura Wan2.2, produce videos con calidad de nivel cinematográfico - **Soporte para múltiples resoluciones**: permite generar videos en 512x512, 768x768, 1024x1024 y otras resoluciones para adaptarse a distintos escenarios **Versión del modelo**: - **Versión de alto rendimiento 14B**: el tamaño del modelo supera los 32GB, ofrece mejores resultados pero exige mucha VRAM -A continuación encontrarás los pesos del modelo y los repositorios de código relevantes: +A continuación se muestran los pesos del modelo y los repositorios de código correspondientes: - [🤗Wan2.2-Fun-Inp-14B](https://huggingface.co/alibaba-pai/Wan2.2-Fun-A14B-InP) - Repositorio de código: [VideoX-Fun](https://github.com/aigc-apps/VideoX-Fun) @@ -35,30 +37,30 @@ A continuación encontrarás los pesos del modelo y los repositorios de código allowFullScreen > -## Ejemplo de flujo de trabajo de video con fotograma inicial y final de Wan2.2 Fun Inp +## Ejemplo de flujo de trabajo de generación de video con fotograma inicial y final de Wan2.2 Fun Inp Este flujo de trabajo ofrece dos versiones: -1. Una versión con el LoRA de 4 pasos [Wan2.2-Lightning](https://huggingface.co/lightx2v/Wan2.2-Lightning) de lightx2v para acelerar la generación de video +1. Una versión que usa el LoRA de 4 pasos [Wan2.2-Lightning](https://huggingface.co/lightx2v/Wan2.2-Lightning) de lightx2v para acelerar la generación de video 2. Una versión fp8_scaled sin LoRA de aceleración -A continuación se muestran los resultados de las pruebas con una GPU RTX4090D de 24 GB de VRAM a una resolución de 640x640 con 81 fotogramas +A continuación se muestran los resultados de las pruebas con una GPU RTX4090D de 24GB de VRAM, a una resolución de 640x640 y con 81 fotogramas | Tipo de modelo | Uso de VRAM | Tiempo de la primera generación | Tiempo de la segunda generación | -| ------------------------ | ---------- | -------------------- | --------------------- | -| fp8_scaled | 83% | ≈ 524s | ≈ 520s | -| fp8_scaled + 4-step LoRA | 89% | ≈ 138s | ≈ 79s | +| ------------------------ | ----------- | ------------------------------- | ------------------------------- | +| fp8_scaled | 83% | ≈ 524s | ≈ 520s | +| fp8_scaled + 4-step LoRA | 89% | ≈ 138s | ≈ 79s | -Como la aceleración con LoRA es notable, pero se pierde dinamismo en el video, los flujos de trabajo incluidos activan por defecto la versión con LoRA de aceleración. Si quieres activar el otro flujo de trabajo, selecciónalo y usa **Ctrl+B** para habilitarlo. +Como la aceleración con LoRA es significativa pero se pierde el dinamismo del video, los flujos de trabajo incluidos habilitan por defecto la versión con LoRA acelerado. Si quieres habilitar el otro flujo de trabajo, selecciónalo y usa **Ctrl+B** para activarlo. -### 1. Descarga el archivo del flujo de trabajo +### 1. Descargar el archivo del flujo de trabajo -Actualiza tu ComfyUI a la última versión y busca "**Wan2.2 Fun Inp**" en el menú `Workflow` -> `Browse Templates` -> `Video` para cargar el flujo de trabajo. +Actualiza ComfyUI a la última versión y busca "**Wan2.2 Fun Inp**" en el menú `Flujo de trabajo` -> `Explorar plantillas` -> `Video` para cargar el flujo de trabajo. -O bien, después de actualizar ComfyUI a la última versión, descarga el flujo de trabajo de abajo y arrástralo a ComfyUI para cargarlo. +O bien, después de actualizar ComfyUI a la última versión, descarga el flujo de trabajo que aparece abajo y arrástralo a ComfyUI para cargarlo. -Wan2.2 Fun Inp workflow +Flujo de trabajo de Wan2.2 Fun Inp @@ -75,48 +77,48 @@ Usa los siguientes materiales como fotogramas inicial y final - Fotograma inicial para la generación del video. Descarga y usa esta imagen, o reemplázala por la tuya. + Fotograma inicial para la generación de video. Descarga y usa esta imagen, o reemplázala por una tuya. - Fotograma final para la generación del video. Descarga y usa esta imagen, o reemplázala por la tuya. + Fotograma final para la generación de video. Descarga y usa esta imagen, o reemplázala por una tuya. ### 2. Modelos -Todos los modelos que se usan en esta guía están [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files). +Todos los modelos que se usan en esta guía están disponibles [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files). **Modelos de difusión** - - wan2.2_fun_inpaint_high_noise_14B_fp8_scaled.safetensors: Modelo de difusión de alto ruido para inpainting entre fotograma inicial y final + + wan2.2_fun_inpaint_high_noise_14B_fp8_scaled.safetensors: modelo de difusión de ruido alto para relleno inteligente de fotogramas inicial y final - - wan2.2_fun_inpaint_low_noise_14B_fp8_scaled.safetensors: Modelo de difusión de bajo ruido para inpainting entre fotograma inicial y final + + wan2.2_fun_inpaint_low_noise_14B_fp8_scaled.safetensors: modelo de difusión de ruido bajo para relleno inteligente de fotogramas inicial y final -**LoRA Lightning (opcional, para acelerar)** +**LoRA Lightning (opcional, para aceleración)** - - wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors: LoRA de aceleración de 4 pasos para el modelo de alto ruido + + wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors: LoRA de aceleración de 4 pasos para el modelo de ruido alto - - wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors: LoRA de aceleración de 4 pasos para el modelo de bajo ruido + + wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors: LoRA de aceleración de 4 pasos para el modelo de ruido bajo **VAE** - - wan_2.1_vae.safetensors: VAE de Wan2.1 para codificar y decodificar + + wan_2.1_vae.safetensors: VAE Wan2.1 para codificar y decodificar **Codificador de texto** - umt5_xxl_fp8_e4m3fn_scaled.safetensors: Codificador de texto FP8 escalado + umt5_xxl_fp8_e4m3fn_scaled.safetensors: codificador de texto FP8 escalado ``` ComfyUI/ @@ -135,23 +137,24 @@ ComfyUI/ ### 3. Guía del flujo de trabajo -![Workflow Step Image](/images/tutorial/video/wan/wan2_2/wan_2.2_14b_fun_inp.jpg) +![Imagen del paso del flujo de trabajo](/images/tutorial/video/wan/wan2_2/wan_2.2_14b_fun_inp.jpg) - Este flujo de trabajo usa LoRA. Asegúrate de que el modelo de difusión y el LoRA correspondientes estén emparejados. + Este flujo de trabajo usa LoRA. Asegúrate de que el modelo de difusión y la LoRA correspondientes coincidan. -1. Carga del modelo de **alto ruido** y del **LoRA** +1. Carga del modelo de **ruido alto** y de **LoRA** - Asegúrate de que el nodo `Load Diffusion Model` cargue el modelo `wan2.2_fun_inpaint_high_noise_14B_fp8_scaled.safetensors` - - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el `wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors` -2. Carga del modelo de **bajo ruido** y del **LoRA** + - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el archivo `wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors` +2. Carga del modelo de **ruido bajo** y de **LoRA** - Asegúrate de que el nodo `Load Diffusion Model` cargue el modelo `wan2.2_fun_inpaint_low_noise_14B_fp8_scaled.safetensors` - - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el `wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors` + - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el archivo `wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors` 3. Asegúrate de que el nodo `Load CLIP` cargue el modelo `umt5_xxl_fp8_e4m3fn_scaled.safetensors` 4. Asegúrate de que el nodo `Load VAE` cargue el modelo `wan_2.1_vae.safetensors` -5. Sube las imágenes de fotograma inicial y final como materiales -6. Escribe tu prompt en el grupo Prompt +5. Sube las imágenes del fotograma inicial y del fotograma final como materiales +6. Introduce tu prompt en el grupo Prompt 7. Ajusta el tamaño y la duración del video en el nodo `WanFunInpaintToVideo` - - Ajusta los parámetros `width` y `height`. El valor predeterminado es `640`. Nosotros hemos definido un tamaño más pequeño, pero puedes modificarlo según lo necesites. - - Ajusta `length`, que es el número total de fotogramas. Los fps actuales del flujo de trabajo son 16. Por ejemplo, si quieres generar un video de 5 segundos, debes definirlo en 5*16 = 80. -8. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter`, para ejecutar la generación del video + - Ajusta los parámetros `width` y `height`. El valor predeterminado es `640`. Usamos un tamaño más pequeño, pero puedes modificarlo según tus necesidades. + - Ajusta `length`, que es el número total de fotogramas. Los fps del flujo de trabajo actual son 16. Por ejemplo, si quieres generar un video de 5 segundos, debes establecerlo en 5*16 = 80. +8. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video + diff --git a/es/tutorials/video/wan/wan2_2.mdx b/es/tutorials/video/wan/wan2_2.mdx index f86a0dbe4b..ee8f703de0 100644 --- a/es/tutorials/video/wan/wan2_2.mdx +++ b/es/tutorials/video/wan/wan2_2.mdx @@ -2,7 +2,7 @@ title: "Ejemplo de flujo de trabajo nativo oficial de ComfyUI para generación de video con Wan2.2" description: "Ejecuta flujos de video Wan2.2 en ComfyUI: modelo híbrido TI2V 5B y ejemplos 14B de texto a video, imagen a video y primer/último fotograma, con descargas." sidebarTitle: Wan2.2 -translationSourceHash: bafc80f0 +translationSourceHash: 49dd13ed translationFrom: tutorials/video/wan/wan2_2.mdx translationBlockHashes: "_intro": 3d02f6d3 @@ -10,11 +10,13 @@ translationBlockHashes: "Wan2.2 Open Source Model Versions": 7ed2d913 "ComfyOrg Wan2.2 Live Streams": 48f6d6e0 "Wan2.2 TI2V 5B Hybrid Version Workflow Example": 927f40b9 + "Wan2.2 14B T2V Text-to-Video Workflow Example": 339329e2 "Wan2.2 14B I2V Image-to-Video Workflow Example": c73a3ba4 "Wan2.2 14B FLF2V Workflow Example": 732db33d "Community Resources": 7463b48b --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' -Wan 2.2 es un nuevo modelo generativo multimodal de nueva generación lanzado por WAN AI. Este modelo adopta una innovadora arquitectura MoE (Mixture of Experts), compuesta por modelos expertos de alto ruido y de bajo ruido. Puede dividir los modelos expertos según los pasos de eliminación de ruido (timesteps), generando así contenido de video de mayor calidad. +Wan 2.2 es un modelo generativo multimodal de nueva generación lanzado por WAN AI. Este modelo adopta una innovadora arquitectura MoE (Mixture of Experts), formada por modelos expertos de alto ruido y de bajo ruido. Puede dividir los modelos expertos según los pasos de denoising (timesteps) y así generar contenido de video de mayor calidad. -Wan 2.2 tiene tres características principales: control estético de nivel cinematográfico, que integra profundamente los estándares estéticos de la industria del cine profesional y admite control visual multidimensional como iluminación, color y composición; movimiento complejo a gran escala, que recrea con facilidad diversos movimientos complejos y mejora la fluidez y el control del movimiento; y cumplimiento semántico preciso, que destaca en escenas complejas y en la generación de múltiples objetos, reproduciendo mejor las intenciones creativas del usuario. -El modelo admite varios modos de generación, como texto a video e imagen a video, y es adecuado para la creación de contenido, la creación artística, la educación y la capacitación, entre otros escenarios de aplicación. +Wan 2.2 tiene tres características principales: control estético de nivel cinematográfico, que integra en profundidad los estándares estéticos de la industria del cine profesional y admite control visual multidimensional como iluminación, color y composición; movimiento complejo a gran escala, que reproduce con facilidad diversos movimientos complejos y mejora la fluidez y el control del movimiento; y cumplimiento semántico preciso, que destaca en escenas complejas y en la generación de múltiples objetos, reproduciendo mejor las intenciones creativas de los usuarios. +El modelo admite varios modos de generación, como texto a video e imagen a video, y es adecuado para la creación de contenido, la creación artística, la educación y el entrenamiento, entre otros escenarios de aplicación. -[Wan2.2 Prompt Guide](https://alidocs.dingtalk.com/i/nodes/EpGBa2Lm8aZxe5myC99MelA2WgN7R35y) +[Guía de prompts de Wan2.2](https://alidocs.dingtalk.com/i/nodes/EpGBa2Lm8aZxe5myC99MelA2WgN7R35y) ## Aspectos destacados del modelo -- **Control estético de nivel cinematográfico**: Lenguaje de cámara profesional, admite control visual multidimensional como iluminación, color y composición -- **Movimiento complejo a gran escala**: Restaura suavemente diversos movimientos complejos, mejora la controlabilidad y naturalidad del movimiento -- **Cumplimiento semántico preciso**: Comprensión de escenas complejas, generación de múltiples objetos, mejor restauración de las intenciones creativas -- **Tecnología de compresión eficiente**: Versión 5B con VAE de alta relación de compresión, optimización de memoria, admite entrenamiento mixto +- **Control estético de nivel cinematográfico**: lenguaje de cámara profesional, admite control visual multidimensional como iluminación, color y composición +- **Movimiento complejo a gran escala**: restaura con suavidad diversos movimientos complejos, mejora la controlabilidad y la naturalidad del movimiento +- **Cumplimiento semántico preciso**: comprensión de escenas complejas, generación de múltiples objetos, restaura mejor las intenciones creativas +- **Tecnología de compresión eficiente**: versión 5B con VAE de alta relación de compresión, optimización de memoria, admite entrenamiento mixto ## Versiones de modelos de código abierto Wan2.2 @@ -50,7 +52,7 @@ Los modelos de la serie Wan2.2 se basan en la licencia de código abierto Apache ## Transmisiones en vivo de ComfyOrg Wan2.2 -Para usar ComfyUI Wan2.2, hemos realizado transmisiones en vivo que puedes ver para aprender a usarlos. +Para el uso de ComfyUI Wan2.2, hemos realizado transmisiones en vivo que puedes ver para aprender a usarlos.