diff --git a/es/development/cloud/api-reference.mdx b/es/development/cloud/api-reference.mdx index ff2e77f9bc..f42e67c57d 100644 --- a/es/development/cloud/api-reference.mdx +++ b/es/development/cloud/api-reference.mdx @@ -3,14 +3,14 @@ title: "Referencia de la API de Cloud" sidebarTitle: "Ejemplos de código" description: "Referencia completa de la API de Comfy Cloud con ejemplos de código" icon: "book-open" -translationSourceHash: 9dfb0617 +translationSourceHash: e15f0e0e translationFrom: development/cloud/api-reference.mdx translationBlockHashes: "_intro": 1729f5d3 "Setup": 311034bb "Object Info": 7b62a397 "Uploading Inputs": 92df17f8 - "Running Workflows": d6ddd0b4 + "Running Workflows": 2c6519c7 "Checking Job Status": d74b4922 "WebSocket for Real-Time Progress": 02c49b4a "Downloading Outputs": 5e1d63d3 @@ -18,6 +18,7 @@ translationBlockHashes: "Queue Management": 857edaaf "Error Handling": b2513ee9 --- + import PollJobCompletion from "/snippets/es/cloud/poll-job-completion.mdx" import WebSocketProgress from "/snippets/es/cloud/websocket-progress.mdx" import DownloadOutputs from "/snippets/es/cloud/download-outputs.mdx" @@ -274,7 +275,7 @@ def upload_mask(file_path: str, original_ref: dict) -> dict: Envía un flujo de trabajo para ejecutarlo. - **Envíos simultáneos admitidos:** Según tu nivel de suscripción, puedes enviar varios flujos de trabajo sin esperar a que terminen las tareas anteriores. Las tareas se ejecutan en paralelo hasta el límite de tu nivel. Las tareas adicionales se ponen en cola automáticamente. Consulta [Tareas simultáneas](/es/development/deploy/cloud-usage#tareas-simultáneas) para ver los detalles y los límites de simultaneidad. + **Envíos simultáneos admitidos:** Según tu nivel de suscripción, puedes enviar varios flujos de trabajo sin esperar a que terminen las tareas anteriores. Las tareas se ejecutan en paralelo hasta el límite de tu nivel. Las tareas adicionales se ponen en cola automáticamente. Consulta [Tareas simultáneas](/es/development/deploy/cloud-usage#tareas-simultáneas) para ver los detalles. ### Enviar flujo de trabajo diff --git a/es/development/cloud/overview.mdx b/es/development/cloud/overview.mdx index 7aefccf879..01dafe9c83 100644 --- a/es/development/cloud/overview.mdx +++ b/es/development/cloud/overview.mdx @@ -12,13 +12,14 @@ translationBlockHashes: "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. 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. -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 superficie de 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. 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. @@ -26,7 +27,7 @@ Para ejecutar flujos de trabajo, empieza con la [Guía de inicio rápido de Comf **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). -## URL base +## Base URL ``` https://cloud.comfy.org @@ -41,39 +42,39 @@ curl -X GET "https://cloud.comfy.org/api/user" \ -H "X-API-Key: $COMFY_CLOUD_API_KEY" ``` -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`. +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 no vá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. +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#using-partner-nodes) 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. El resto de las funciones de Cloud solo está disponible por HTTP, así que llama a estos endpoints directamente aunque uses un SDK para la ejecución. -| Capacidad | Endpoint | Referencia | +| Funcionalidad | 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) | +| Estado de la cola, tareas en ejecución y pendientes | `GET /api/queue` | [Gestión de la cola](/es/development/cloud/api-reference#gestion-de-la-cola) | +| Interrumpir la ejecución actual | `POST /api/interrupt` | [Gestión de la cola](/es/development/cloud/api-reference#gestion-de-la-cola) | +| Definiciones de nodos y especificaciones de entrada | `GET /api/object_info` | [Información de objetos](/es/development/cloud/api-reference#informacion-de-objetos) | +| 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. +La cancelación de una tarea está cubierta por ambas vías: los SDK cancelan una tarea para 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 | +| [Flujos de trabajo](/es/development/cloud/api-reference#running-workflows) | Envía flujos de trabajo y consulta el estado | +| [Tareas](/es/development/cloud/api-reference#checking-job-status) | Monitorea el estado de las tareas y la cola | +| [Entradas](/es/development/cloud/api-reference#uploading-inputs) | Sube imágenes, máscaras y otras entradas | | [Salidas](/es/development/cloud/api-reference#downloading-outputs) | Descarga 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 | +| [WebSocket](/es/development/cloud/api-reference#websocket-for-real-time-progress) | Actualizaciones de progreso en tiempo real | +| [Información de objetos](/es/development/cloud/api-reference#object-info) | Nodos disponibles y sus definiciones | ## Manejo de errores -Los endpoints REST devuelven códigos de estado HTTP estándar: +Los endpoints REST devuelven los códigos de estado HTTP estándar: | Estado | Descripción | |--------|-------------| @@ -83,9 +84,9 @@ 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 estas situaciones como excepciones tipadas, entre ellas `Unauthorized`, `InvalidWorkflow`, `InsufficientCredits`, `QueueFull` y `JobFailed`, y todas heredan 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#error-handling) para conocer los valores de `exception_type` que se entregan durante la ejecución. ## Próximos pasos @@ -103,6 +104,6 @@ Las fallas de ejecución son independientes de los errores HTTP. Consulta [Manej La API HTTP versionada que sustenta 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 la generación de código. diff --git a/es/development/comfy-router/higgsfield-byok.mdx b/es/development/comfy-router/higgsfield-byok.mdx new file mode 100644 index 0000000000..969e082af2 --- /dev/null +++ b/es/development/comfy-router/higgsfield-byok.mdx @@ -0,0 +1,424 @@ +--- +title: "Usa tu clave API de Higgsfield en Comfy Router" +sidebarTitle: "Higgsfield (tu clave)" +description: "Usa tu clave API de Higgsfield en Comfy Router: las generaciones van a tu cuenta de Higgsfield, no a tus créditos de Comfy, por el mismo endpoint." +translationSourceHash: 77caf0dc +translationFrom: development/comfy-router/higgsfield-byok.mdx +translationBlockHashes: + "_intro": 5cc171ab + "What changes when you bring a key": d6506a33 + "Reading the result": 1ccba71b + "Notes": 240c8b8e +--- +Higgsfield tiene en marcha una [promoción de cashback sobre el gasto en API](https://higgsfield.ai). No vamos a intentar disuadirte. + +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 de Higgsfield y lo que esa promoción valga para ti es tuyo. Sigues teniendo un endpoint, un cliente y la misma forma de solicitud que 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 planificar en torno a ella. + + +## Qué cambia cuando usas 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, respuesta | Igual | Igual | + +Todo lo demás sobre 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 cadena única `id:secret`. Conserva los dos puntos y no la dividas en dos campos. + + + + Abre [**Provider keys**](https://platform.comfy.org/profile/provider-keys) en tu perfil de Comfy, elige **Higgsfield** y pega el valor `id:secret`. + + Tu clave se cifra en reposo y la API nunca la devuelve una vez guardada. Router la lee solo para firmar tus propias llamadas. + + + + Esta es la clave que te autentica ante Comfy, independiente de la de Higgsfield. Créala en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys) y luego define: + + ```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 que seleccionaste. + + + +## Models + + + + Balanced quality and speed. `duration` accepts 3–15 seconds. + + + + ```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+ + # Install: python -m pip install "comfy-sdk>=0.3.0" + + from comfy_sdk import Comfy + + # Comfy reads COMFY_API_KEY from the environment. + 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+ + // Install: 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); + ``` + + + + + + Higher fidelity than `std`, same body. `duration` accepts 3–15 seconds. + + + + ```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+ + # Install: 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+ + // Install: 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); + ``` + + + + + + The 4K tier, same body as `std` and `pro`. `duration` accepts 3–15 seconds. + + + + ```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+ + # Install: 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+ + // Install: 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); + ``` + + + + + + The fastest Kling tier. Its body carries `resolution` instead of `cfg_scale` and `sound`. `duration` accepts 3–15 seconds. + + + + ```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+ + # Install: 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+ + // Install: 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); + ``` + + + + + + Reference-to-video: pass reference images or clips and describe how to use them. `duration` accepts up to 30 seconds. + + + + ```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+ + # Install: 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+ + // Install: 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 +``` + +Router consulta Higgsfield por ti, así que `queued` e `in_progress` nunca te llegan: recibes el documento finalizado o un error. `nsfw`, `failed` y `canceled` son los fallos terminales; `failed` trae el detalle en `error`. + +## Notas + +- **La validación ocurre antes de llamar a Higgsfield.** Un cuerpo fuera de los límites publicados devuelve `422` con el nombre del campo que los infringe, y no se envía nada upstream, 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 en nada cómo se factura cualquier otro proveedor en Router. +- Los esquemas completos de solicitud y respuesta para cada modelo están en la [Referencia de Comfy Router](/es/development/comfy-router/reference). diff --git a/es/development/comfy-router/litellm.mdx b/es/development/comfy-router/litellm.mdx index 1bf583855a..a138096928 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. @@ -91,22 +92,23 @@ X-Litellm-Response-Cost: 0.0592417062 X-Litellm-Total-Tokens: 0 ``` -`X-Comfy-Credits-Used` es el precio de la ejecución en créditos de Comfy, redondeado a dos decimales. `X-Litellm-Response-Cost` es ese mismo precio convertido a USD desde el importe en créditos sin redondear, así que dividir los créditos mostrados entre la tasa de conversión puede diferir de él en las últimas cifras. Los nombres de encabezado no distinguen mayúsculas de minúsculas, así que LiteLLM lo lee como `x-litellm-response-cost`. LiteLLM lo registra exactamente como se envía y lo usa en lugar de tu `cost_per_request`. `x-litellm-total-tokens` siempre es `0`, porque las ejecuciones de medios no se miden en tokens. +`X-Comfy-Credits-Used` es el precio de la ejecución en créditos de Comfy, redondeado a dos decimales. `X-Litellm-Response-Cost` es ese mismo precio convertido a USD a partir del importe en créditos sin redondear, así que dividir los créditos mostrados entre la tasa de conversión puede dar un resultado distinto en las últimas cifras. Los nombres de los encabezados no distinguen mayúsculas de minúsculas, así que LiteLLM lo lee como `x-litellm-response-cost`. LiteLLM lo registra exactamente como se envía y lo usa en lugar de tu `cost_per_request`. `x-litellm-total-tokens` siempre es `0`, porque las ejecuciones de medios no se miden en tokens. -Igual que con `X-Comfy-Credits-Used`, el encabezado informa un precio y no un cargo liquidado. Concilia con la [facturación del espacio de trabajo](https://platform.comfy.org), no con los totales de LiteLLM. +Al igual que con `X-Comfy-Credits-Used`, el encabezado informa un precio, no un cargo liquidado. Concilia con la [facturación del espacio de trabajo](https://platform.comfy.org), no con los totales de LiteLLM. ### 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; aun así, nunca 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 está ausente, LiteLLM recurre al `cost_per_request` del endpoint. Eso se aplica a todos los casos anteriores. Por lo 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í tuvo precio, así que lee su costo en ese encabezado, y algunos otros fallos, como una generación que Router no pudo entregarte, pueden facturarse 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 que tuvo precio y 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..da14eaf44d 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` @@ -160,8 +159,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Image Edit Remove Background Guided](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/es/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/es/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [Image Edit Reseason](/es/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Image Edit Replace Object By Text](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text`- [Image Edit Reseason](/es/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` - [Image Edit Restore](/es/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` - [Image](/es/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` @@ -197,7 +195,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` @@ -213,8 +210,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Recraft V4.1 Utility](/es/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/es/development/comfy-router/models/recraft/recraftv4-1-vector/code): `recraft/recraftv4_1_vector` - [Recraft V4.1](/es/development/comfy-router/models/recraft/recraftv4-1/code): `recraft/recraftv4_1` -- [Recraft V4 Pro](/es/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro` -- [Recraft V4 Styles Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` +- [Recraft V4 Pro](/es/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro`- [Recraft V4 Styles Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/es/development/comfy-router/models/recraft/recraftv4-styles-pro/code): `recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/es/development/comfy-router/models/recraft/recraftv4-styles-vector/code): `recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/es/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` @@ -268,14 +264,13 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Wan 2.5 T2V Preview](/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/es/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` - [Wan 2.6 R2V](/es/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` -- [Wan 2.6 T2V](/es/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` -- [Wan 2.7 I2V](/es/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` +- [Wan 2.6 T2V](/es/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v`- [Wan 2.7 I2V](/es/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` - [Wan 2.7 T2V](/es/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/es/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` - [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 +284,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 +313,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` @@ -331,11 +325,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [GPT 5](/es/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [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` +- [GPT 6 Sol](/es/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol`- [o3](/es/development/comfy-router/models/openai/o3/code): `openai/o3` - [Chat Completions](/es/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions` @@ -447,7 +437,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 +532,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 +546,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 +571,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 +585,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/bria/image-edit-product-virtual-tryon/code.mdx b/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code.mdx index bb971c572f..ff052b5252 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,13 +2,15 @@ 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"; @@ -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( "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 para 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", @@ -67,16 +69,16 @@ curl https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon \ ``` - -El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon/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/bria/image-edit-product-virtual-tryon/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 u otro. [Queued delivery](/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(): "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. + # Sondea 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 fallida o cancelada 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("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. +// Sondea 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 fallida o cancelada 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. Enviar. 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. Sondear 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. Recoger. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras todavía se ejecuta. curl https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -149,15 +151,15 @@ curl https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon/reque ### Entrada - Relación de aspecto de la imagen de salida, una de "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16" o "16:9". Por defecto, la relación de aspecto de person_image. + Relación de aspecto de la imagen de salida, uno de "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16" o "16:9". Por defecto, la relación de aspecto de person_image. - 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 en la persona. Cada entrada es una URL de acceso público o un valor codificado en Base64, igual que person_image. - Indicación adicional opcional para esta toma, por ejemplo "He wears the navy blazer over the white t-shirt he already has". Envía solo el detalle que quieres dirigir, no un prompt completo. + Indicación adicional opcional para esta toma, por ejemplo "He wears the navy blazer over the white t-shirt he already has". Envía solo el detalle que quieres orientar, no un prompt completo. @@ -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 valor codificado en Base64. Formatos aceptados: JPEG, JPG, PNG, WEBP. @@ -173,14 +175,14 @@ curl https://api.comfy.org/v2/models/bria/image-edit-product-virtual-tryon/reque - Debe ser false u omitirse. El modo síncrono de Bria (true) se rechaza en lugar de reenviarse, tanto en Comfy Router como en la ruta `/proxy/` propia de esta operación: Comfy Router fija el modo de retorno antes del despacho y consulta el resultado dentro de la llamada, y la ruta `/proxy/` devuelve el request_id y el status_url que hay que consultar. + Debe ser false u omitirse. El modo síncrono de Bria (true) se rechaza en lugar de reenviarse, tanto en Comfy Router como en la ruta `/proxy/` propia de esta operación: Comfy Router fija el modo de retorno antes del despacho y consulta el resultado dentro de la llamada, y la ruta `/proxy/` devuelve el request_id y status_url que hay que consultar. Si es true, devuelve 422 cuando falla la moderación de la salida visual. -Generado a partir del esquema que Router sirve en `GET /v2/models/bria/image-edit-product-virtual-tryon/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. +Generado a partir del esquema que Router publica en `GET /v2/models/bria/image-edit-product-virtual-tryon/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -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 nullable porque la clave está PRESENTE con valor null en lugar de omitirse; observado 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 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/byteplus/dreamina-seedance-2-0-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 3720641017..73928b1cf3 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,15 +2,16 @@ title: "Usa Dreamina Seedance 2.0 260128 con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-0-260128 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 98890ddf +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": 5c27d10f + "Schema": 8c0478c9 "Examples": 641c458b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + Se ignora. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía un callback; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -289,26 +290,24 @@ ID de recurso: Formato asset://\ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final en 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). - Rango: `2` a `30` + Valores posibles: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` Umbral de tiempo de espera de la tarea en segundos. Valor predeterminado 172800 (48 h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: El modelo genera un video con audio sincronizado. false: El modelo genera un video silencioso. -En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. - - - +En los modelos que lo admiten, el proveedor verifica el contenido de la pista de audio generada por separado del video; un rechazo allí se reporta como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso vuelve a crear el Draft con `false`. + El ID del modelo que se va a llamar. Modelos compatibles: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo; el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama al Router lo omite. @@ -321,14 +320,14 @@ mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta - Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro por defecto: adaptive. + Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro, por defecto: adaptive. Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite por defecto: 720p. Seedance 1.0 pro y pro-fast por defecto: 1080p. + Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite, por defecto: 720p. Seedance 1.0 pro y pro-fast, por defecto: 1080p. Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p. Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -336,14 +335,14 @@ Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 48 Indica si se devuelve la imagen del último fotograma del video generado. -true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. +true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma consultando la información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último fotograma del video generado. Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -356,9 +355,7 @@ false: No devuelve la imagen del último fotograma del video generado. Indica si el video generado incluye una marca de agua. -Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida +Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.### Salida La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se REALOJAN en el almacenamiento de Comfy; cualquier otro campo de aquí es propio de BytePlus. Anulable: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o nulo. @@ -372,6 +369,20 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. + + Hora RFC 3339 en que las URL del proveedor dejan de funcionar: la hora de firma más temprana más la vigencia que las propias URL llevan, nunca posterior a la `updated_at` de la tarea más 24 horas (la vida útil documentada de las URL de BytePlus) cuando `updated_at` está presente; de lo contrario, la `updated_at` de la tarea más 24 horas. Presente solo cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vigencia de `video_url` / `last_frame_url` realojadas. + + Formato: `date-time` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo para espacios de trabajo que lo hayan habilitado, solo en Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a la `video_url` realojada. Presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado del lado del servidor (no existe un parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica sin alcance a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el propio realojamiento de Router. + + URL de descarga del video de salida. Router realoja el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memo de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -396,16 +407,15 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream El mensaje de error - - El ID de la tarea de generación de video +El ID de la tarea de generación de video - El nombre y la versión del modelo usado por la tarea + El nombre y la versión del modelo que usa la tarea - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde lo devuelve la consulta de tareas de video de Seedance. Campo propio de BytePlus, reenviado sin cambios. + El formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: así es donde lo devuelve la consulta de tareas de video de Seedance. Es un campo propio de BytePlus, reenviado sin cambios. @@ -413,7 +423,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. + La semilla de generación que realmente se usó en la tarea. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. Formato: `int64` @@ -425,7 +435,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - La hora en que la tarea se actualizó por última vez. El valor es un timestamp UNIX en segundos. + La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index c12f1d7343..3dd375524e 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,14 +2,15 @@ title: "Usa Dreamina Seedance 2.0 Fast 260128 con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-0-fast-260128 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: acad6428 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": a00368da + "Schema": 90b60b2e "Examples": 7714eccd --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + Se ignora. Se acepta por compatibilidad con la forma de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía un callback; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -275,26 +276,24 @@ Asset ID: Formato asset://\ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final de 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). - Rango: `2` a `30` + Valores posibles: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. false: el modelo genera un video sin audio. -En los modelos que lo admiten, el proveedor revisa la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. - - - +En los modelos que lo admiten, el proveedor verifica el contenido de la pista de audio generada de forma independiente del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio era la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Una renderización final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso vuelve a crear el Draft con `false`. + El ID del modelo que se va a llamar. Modelos compatibles: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada directa a la v1 de POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde el Router lo omite. @@ -329,7 +328,7 @@ false: No devuelve la imagen del último fotograma del video generado. Entero de semilla para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -342,24 +341,36 @@ false: No devuelve la imagen del último fotograma del video generado. Indica si el video generado incluye una marca de agua. -Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida +Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.### Salida La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Router vuelve a alojar tanto `video_url` como `last_frame_url` en el almacenamiento de Comfy; cualquier otro campo aquí es propio de BytePlus. Anulable: BytePlus borra las URL 24 horas después de la tarea, y un documento en estado succeeded consultado después de eso puede traer `content` ausente o null. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del origen o de una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memoria de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo volver a alojar, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace vence, así que descarga el fotograma en lugar de almacenar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del origen o de una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memoria de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace vence, así que descarga el fotograma en lugar de almacenar la URL. Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente de los dos. + + Fecha y hora RFC 3339 en la que las URL del origen dejan de funcionar: la hora de firma más temprana más la vigencia que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Presente solo cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes proporciona una hora. No está relacionado con la vida útil de `video_url` / `last_frame_url` realojadas. + + Formato: `date-time` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a `last_frame_url` realojada, en los mismos términos que `upstream_video_url`: solo espacios de trabajo que hayan optado por ello, solo Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url` realojada. Presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado del lado del servidor (no hay ningún parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no limitada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que venza, así que trátala como un secreto. Vence en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, de las cuales el propio realojamiento de Router consume una. + + - URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memoria de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo volver a alojar, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace vence, así que descarga el video en lugar de almacenar la URL. + URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memoria de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace vence, así que descarga el video en lugar de almacenar la URL. @@ -412,6 +423,35 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr La hora en que se actualizó la tarea por última vez. El valor es una marca de tiempo UNIX en segundos. +El ID de la tarea de generación de video + + + + El nombre y la versión del modelo que usa la tarea + + + + Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: ahí es donde la consulta de tarea de video de Seedance lo devuelve. Campo propio de BytePlus, reenviado sin cambios. + + + + La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en las tareas de video que finalizaron correctamente y reenviado sin cambios. + + + + La semilla de generación que realmente se usó en la tarea. Campo propio de BytePlus, devuelto en las tareas de video que finalizaron correctamente y reenviado sin cambios. + + Formato: `int64` + + + + El estado de la tarea + + Valores posibles: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + + + + La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 8a3c8917e8..698fe2e541 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,14 +2,15 @@ title: "Usa Dreamina Seedance 2.0 Mini con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-0-mini desde Comfy Router: endpoint, forma de la solicitud y respuesta." sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69d38df7 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 2279819f + "Schema": ebf1fc3a "Examples": db01067e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-mini.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### Entrada - Dirección de notificación callback para el resultado de esta tarea de generación + Se ignora. Se acepta por compatibilidad con la forma de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía un callback; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -250,7 +251,7 @@ veces este tamaño en el envío. Limita este único campo, no la solicitud: `content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita el documento completo. Comfy Router (/v2/models/byteplus/\{model}) es la superficie que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de BytePlus. -Está configurado muy por encima del tráfico real, de modo que nunca entre a juzgar un +Está configurado muy por encima del tráfico real, de modo que nunca llegue a juzgar un prompt genuino: auméntalo si un cliente necesita más. @@ -275,10 +276,10 @@ Asset ID: formato asset://\ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final de 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). - Rango: `2` a `30` + Posibles valores: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` @@ -291,10 +292,8 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo produce un video con audio sincronizado. false: el modelo produce un video sin audio. -En los modelos que lo admiten, la pista de audio generada es revisada por contenido por el proveedor de forma independiente al video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. - - - +En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en su lugar recrea el Draft con `false`. + El ID del modelo a llamar. Modelos compatibles: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO aparece en la lista `required` de este esquema porque Comfy Router lo rellena a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través del Router lo omite. @@ -321,7 +320,7 @@ Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 48 - Indica si se devuelve la imagen del último fotograma del video generado. + Si la respuesta incluye la imagen del último fotograma del video generado. true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último fotograma del video generado. @@ -329,7 +328,7 @@ false: No devuelve la imagen del último fotograma del video generado. Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -339,12 +338,10 @@ false: No devuelve la imagen del último fotograma del video generado. - Indica si el video generado incluye una marca de agua. + Si el video generado incluye una marca de agua. -Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida +Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.### Salida El resultado una vez completada la tarea de generación de video, que contiene la URL de descarga del video generado y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se vuelven a alojar en el almacenamiento de Comfy; cualquier otro campo aquí es propio de BytePlus. Puede ser null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. @@ -358,6 +355,20 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente de los dos. + + Hora RFC 3339 en la que las URL del origen dejan de funcionar: el primer momento de firma más la validez que las propias URL llevan, nunca posterior al `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; de lo contrario, el `updated_at` de la tarea más 24 horas. Presente solo cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` re-alojadas. + + Formato: `date-time` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` re-alojada en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a la `video_url` re-alojada. Presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado en el servidor (no existe ningún parámetro en la solicitud); ausente para todos los demás, incluida una credencial que no se resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el propio re-alojamiento de Router. + + URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se genera y se reproduce desde una caché de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -382,24 +393,23 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream El mensaje de error - - El ID de la tarea de generación de video +El ID de la tarea de generación de video - El nombre y la versión del modelo utilizado por la tarea + El nombre y la versión del modelo que utiliza la tarea - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde lo devuelve la consulta de tareas de video de Seedance. Es un campo propio de BytePlus, reenviado sin cambios. + Formato de contenedor del video generado (mp4 o mov), que se devuelve en el NIVEL SUPERIOR como campo hermano de `content`; aquí es donde la consulta de tareas de video de Seedance lo devuelve. Es un campo propio de BytePlus, reenviado sin cambios. - La resolución del video generado, por ejemplo `1080p`. Es un campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. + La resolución del video generado, por ejemplo `1080p`. Es un campo propio de BytePlus, devuelto en las tareas de video completadas con éxito y reenviado sin cambios. - La semilla de generación que realmente se usó para la tarea. Es un campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. + La semilla de generación que realmente se utilizó para la tarea. Es un campo propio de BytePlus, devuelto en las tareas de video completadas con éxito y reenviado sin cambios. Formato: `int64` @@ -411,7 +421,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - La hora en que se actualizó la tarea por última vez. El valor es una marca de tiempo UNIX en segundos. + La hora de la última actualización de la tarea. El valor es una marca de tiempo UNIX en segundos. diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 293ce4f0fb..ca6bde1d89 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,15 +2,16 @@ title: "Usa Dreamina Seedance 2.5 260628 con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-5-260628 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 9a342bd4 +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": 0467a987 + "Schema": d2c28a84 "Examples": 5465695b --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/byteplus/dreamina-seedance-2-5-260628.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -191,7 +192,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + Ignorado. Lo aceptamos por compatibilidad con la estructura de solicitud de BytePlus, pero lo eliminamos antes de enviar la tarea, así que nunca se envía una callback; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -288,23 +289,22 @@ ID de recurso: Formato asset://\ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final en 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático). - Rango: `2` a `30` + Valores posibles: `-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` Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con lo visual. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video silencioso. -En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio varía en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. +false: el modelo genera un video silencioso.En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio varía en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. @@ -334,7 +334,7 @@ Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 48 - Si se devuelve la imagen del último fotograma del video generado. + Indica si devolver la imagen del último fotograma del video generado. true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a Querying the information about a video generation task. La imagen del último fotograma está en formato PNG, con su ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado previamente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último fotograma del video generado. @@ -342,7 +342,7 @@ false: No devuelve la imagen del último fotograma del video generado. Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -352,27 +352,39 @@ false: No devuelve la imagen del último fotograma del video generado. - Si el video generado incluye una marca de agua. + Indica si el video generado incluye una marca de agua. -Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida +Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.### Salida La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se RE-ALOJAN en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del upstream o de una inspección del contenido, e `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del upstream o de una inspección del contenido, e `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una caché en memoria de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo más comúnmente como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. + + + + Hora RFC 3339 en la que las URL del upstream dejan de funcionar: el primer instante de firma más la vigencia que las propias URL llevan, nunca posterior al `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; de lo contrario, el `updated_at` de la tarea más 24 horas. Solo está presente cuando lo están `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes aporta una hora. No guarda relación con la vigencia de `video_url` / `last_frame_url` re-alojadas. + + Formato: `date-time` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` re-alojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo que lo hayan habilitado, solo Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial bearer hasta `upstream_expires_at`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a la `video_url` re-alojada. Presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado del lado del servidor (no existe un parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica que no esté asociada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial bearer: cualquiera que la tenga puede descargar el video hasta que expire, así que trátala como un secreto. Expira en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el propio re-alojamiento de Router. - URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una caché en memoria de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -395,24 +407,23 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream El mensaje de error - - El ID de la tarea de generación de video +El ID de la tarea de generación de video - El nombre y la versión del modelo utilizado por la tarea + El nombre y la versión del modelo que usó la tarea - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde lo devuelve la consulta de tareas de video de Seedance. Campo propio de BytePlus, reenviado sin cambios. + Formato de contenedor del video generado (mp4 o mov), que se devuelve en el NIVEL SUPERIOR como hermano de `content`; ahí es donde la consulta de tarea de video de Seedance lo devuelve. Es un campo propio de BytePlus, reenviado sin cambios. - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, que se devuelve en las tareas de video con estado succeeded y se reenvía sin cambios. + La resolución del video generado, por ejemplo `1080p`. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. - La semilla de generación que se usó realmente para la tarea. Campo propio de BytePlus, que se devuelve en las tareas de video con estado succeeded y se reenvía sin cambios. + La semilla de generación que realmente se usó para la tarea. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. Formato: `int64` diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 525db588a0..301f61f311 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,24 +2,26 @@ title: "Usa Seedance 1.0 Pro 250528 con Comfy Router" description: "Llama a byteplus/seedance-1-0-pro-250528 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: caf03877 +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d - "Schema": af62a34c + "Quick start": c762675f + "Schema": b57b84de "Examples": 815d621e --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/byteplus/seedance-1-0-pro-250528.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; -Referencia de API para `byteplus/seedance-1-0-pro-250528`, que Comfy Router sirve desde BytePlus. +Referencia de API para `byteplus/seedance-1-0-pro-250528`, servido por Comfy Router desde BytePlus. **Entrada:** Texto, Imagen · **Salida:** Video ## 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 mediante HTTP directo. **ID del modelo:** `byteplus/seedance-1-0-pro-250528` @@ -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( "byteplus/seedance-1-0-pro-250528", @@ -55,8 +57,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("byteplus/seedance-1-0-pro-250528", { content: [ { @@ -81,7 +83,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528 \ ``` - + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/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. @@ -89,8 +91,8 @@ El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/byteplus/seedan 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( @@ -107,14 +109,14 @@ async def main(): "resolution": "720p", }, ) - 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) @@ -125,8 +127,8 @@ 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("byteplus/seedance-1-0-pro-250528", { content: [ { @@ -138,33 +140,33 @@ const handle = await comfy.models.submit("byteplus/seedance-1-0-pro-250528", { ratio: "16:9", resolution: "720p", }); -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/byteplus/seedance-1-0-pro-250528/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"content\": [{\"text\":\"A red fox trotting through a snowy pine forest\",\"type\":\"text\"}], \"duration\": 5, \"ratio\": \"16:9\", \"resolution\": \"720p\"}" -# 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/byteplus/seedance-1-0-pro-250528/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/byteplus/seedance-1-0-pro-250528/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -177,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + Se ignora. Se acepta por compatibilidad con la forma de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; en su lugar, consulta el estado de la tarea en la ruta de estado. Formato: `uri` @@ -191,15 +193,15 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ - URL de audio, codificación Base64 o ID de recurso. + URL de audio, codificación Base64 o Asset ID. URL de audio: URL pública del audio (wav, mp3). Base64: formato data:audio/\;base64,\ -ID de recurso: formato asset://\ +Asset ID: formato asset://\ Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution tiene 1080p como valor predeterminado y solo admite 1080p. +El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution tiene como valor predeterminado 1080p y solo admite 1080p. @@ -214,7 +216,7 @@ El video final reutiliza el prompt, los recursos de entrada, la duración, la re Contenido de imagen para la generación de imagen a video (cuando type es "image_url") URL de la imagen: asegúrate de que la URL de la imagen sea accesible. Contenido codificado en Base64: el formato debe ser data:image/\;base64,\ -ID de recurso: formato asset://\ +Asset ID: formato asset://\ @@ -229,7 +231,7 @@ Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). La información de texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales. -Prompt de texto (requerido): descripción del video que se va a generar con caracteres chinos e ingleses. +Prompt de texto (requerido): descripción del video que se va a generar con caracteres en chino e inglés. Parámetros (opcionales): agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: - --resolution (--rs): 480p, 720p, 1080p (predeterminado: 720p) @@ -242,15 +244,7 @@ Parámetros (opcionales): agrega --[parameters] después del prompt de texto par Ejemplo: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Límite de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no -publica un límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17). -Cuenta caracteres, no bytes, así que un prompt multibyte puede ocupar en la red varias -veces este tamaño. Limita este único campo, no la solicitud: -`content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita el -documento completo. Comfy Router (/v2/models/byteplus/\{model}) es la superficie -que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de -BytePlus. Está establecido muy por encima del tráfico real para que nunca determine el -resultado de un prompt genuino; auméntalo si un cliente necesita más. +Protección del lado de Comfy, no una restricción de BytePlus. BytePlus no publica ningún límite de longitud de texto y aceptó 40,000 caracteres en las pruebas (2026-09-17). Cuenta caracteres, no bytes, así que un prompt multibyte puede ser varias veces de este tamaño en la red. Limita este único campo, no la solicitud: `content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita todo el documento. Comfy Router (/v2/models/byteplus/\{model}) es la superficie que lo aplica; en una llamada directa v1 /proxy responde el validador propio de BytePlus. Se estableció muy por encima del tráfico real para que nunca juzgue un prompt genuino: auméntalo si algún cliente necesita más. @@ -264,38 +258,37 @@ resultado de un prompt genuino; auméntalo si un cliente necesita más. - URL de video o ID de recurso. + URL de video o Asset ID. URL de video: URL pública del video (mp4, mov). -ID de recurso: formato asset://\ +Asset ID: formato asset://\ - Solo Seedance 2.5. Genera un video Draft de 480p; la resolution debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final de 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. + Solo Seedance 2.5. Genera un video Draft en 480p; resolution debe ser 480p. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final en 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 1.0 pro y 1.0 pro fast: [2,12]. - Rango: `2` a `30` + Valores posibles: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` - Umbral de tiempo de espera de la tarea en segundos. Valor predeterminado 172800 (48 h). Alcance: [3600, 259200]. + Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video sin audio. -En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso vuelve a crear el Draft con `false`. +false: el modelo genera un video silencioso. +En los modelos que lo admiten, el proveedor verifica el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso vuelve a crear el Draft con `false`. - - -El ID del modelo que se va a llamar. Modelos compatibles: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza con un 400 cualquier otro valor y también la omisión. NO está en la lista `required` de este esquema porque Comfy Router lo completa desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde Router lo omite. + + ID del modelo que se va a llamar. Modelos admitidos: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, así como su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, por lo que un llamador de Router lo omite. @@ -307,29 +300,29 @@ mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta - Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro, predeterminado: adaptive. + Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro valor predeterminado: adaptive. Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite, predeterminado: 720p. Seedance 1.0 pro y pro-fast, predeterminado: 1080p. + Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite valor predeterminado: 720p. Seedance 1.0 pro y pro-fast valor predeterminado: 1080p. Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p. Valores posibles: `480p`, `720p`, `1080p`, `4k` - Indica si se debe devolver la imagen del último fotograma del video generado. -true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto de píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. + Indica si se devuelve la imagen del último fotograma del video generado. +true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de la información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último fotograma del video generado. Entero de semilla para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -342,24 +335,36 @@ false: No devuelve la imagen del último fotograma del video generado. Indica si el video generado incluye una marca de agua. -Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida +Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.### Salida - La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus devuelve una, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se VUELVEN A ALOJAR en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite nulo: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o nulo. + La salida después de que se completa la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus devuelve una, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se vuelven a alojar en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Puede ser null: BytePlus borra las URL 24 horas después de la tarea, y un documento en estado succeeded consultado después de eso puede traer `content` ausente o null. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de la imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG del lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo según el Content-Type del origen o una detección de contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type de origen o de una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta por 24 horas: se firma por 24 horas cuando se emite y se vuelve a servir desde una memoización de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el nuevo alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo como un hermano de NIVEL SUPERIOR de `content`; consulta el campo `output_format` de nivel superior, y Router lee el que de los dos esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Es más habitual que los modelos Seedance lo devuelvan como un campo hermano de `content` en el nivel superior; consulta el campo `output_format` de nivel superior, y Router lee el que de los dos esté presente. + + + + Hora RFC 3339 en la que las URL de origen dejan de funcionar: el momento de firma más temprano, más la vigencia que las propias URL conllevan, nunca posterior al `updated_at` de la tarea más 24 horas (la vida útil documentada de las URL de BytePlus) cuando `updated_at` está presente; de lo contrario, el `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes proporciona una hora. No guarda relación con la vida útil de `video_url` / `last_frame_url`, que se vuelven a alojar. + + Formato: `date-time` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` que se vuelve a alojar, en los mismos términos que `upstream_video_url`: solo para espacios de trabajo que hayan optado por ello, solo para Seedance 2.x, ausente una vez que BytePlus la borra y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url`, que se vuelve a alojar. Solo está presente para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado del lado del servidor (no existe un parámetro de solicitud); está ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no limitada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at` y, en Seedance 2.5, BytePlus la limita a 100 descargas, una de las cuales consume el nuevo alojamiento que hace el propio Router. - URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta por 24 horas: se firma por 24 horas cuando se emite y se vuelve a servir desde una memoización de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el nuevo alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -367,39 +372,39 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. + La duración del video generado en segundos. Se declara como número en lugar de entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y que las superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Es un campo propio de BytePlus, que se devuelve en tareas de video con estado succeeded y se reenvía sin cambios. - La información del error. Si la tarea tiene éxito, devuelve null. Si la tarea falla, devuelve la información del error. + La información del error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información del error. - Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en envoltorios de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas, sin sobrescribir los fallos de transporte. + Código de error de ModelArk de origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation o OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las respuestas de error HTTP 400 y en las respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte. - El mensaje de error + Mensaje de error - + El ID de la tarea de generación de video - El nombre y la versión del modelo usado por la tarea + El nombre y la versión del modelo que usa la tarea - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`; aquí es donde lo devuelve la consulta de tareas de video de Seedance. Campo propio de BytePlus, reenviado sin cambios. + Formato de contenedor del video generado (mp4 o mov), que se devuelve en el NIVEL SUPERIOR como hermano de `content`; aquí es donde la consulta de la tarea de video de Seedance lo devuelve. Es un campo propio de BytePlus, reenviado sin cambios. - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. + La resolución del video generado, por ejemplo `1080p`. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. - La semilla de generación que se usó realmente para la tarea. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. + La semilla de generación que realmente se usó para la tarea. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. Formato: `int64` @@ -411,7 +416,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - La hora en que se actualizó la tarea por última vez. El valor es una marca de tiempo UNIX en segundos. + La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 19ba643e1b..95d835d08c 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedance 1.0 Pro Fast 251015 con Comfy Router" description: "Llama a byteplus/seedance-1-0-pro-fast-251015 desde Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 600f57b4 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 1df5b053 + "Schema": dd74b012 "Examples": 1469ab97 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-fast-251015.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + Se ignora. Se acepta por compatibilidad con la forma de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; en su lugar, consulta el resultado en la ruta de estado de la tarea. Formato: `uri` @@ -275,26 +276,26 @@ Asset ID: Formato asset://\ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final en 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 1.0 pro y 1.0 pro fast: [2,12]. - Rango: `2` a `30` + Valores posibles: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. false: el modelo genera un video silencioso. -En los modelos que lo admiten, el proveedor revisa la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si esto ocurre; eso ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso recrea el Draft con `false`. - + El ID del modelo al que se llama. Modelos compatibles: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada directa a la v1 mediante POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo; el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo completa a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. @@ -321,7 +322,7 @@ Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 48 - Indica si se devuelve la imagen del último frame del video generado. + Indica si devolver la imagen del último frame del video generado. true: Devuelve la imagen del último frame del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último frame llamando a la consulta de información de una tarea de generación de video. La imagen del último frame está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último frame del video generado anteriormente se usa como primer frame de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último frame del video generado. @@ -329,7 +330,7 @@ false: No devuelve la imagen del último frame del video generado. Entero de semilla para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -342,9 +343,7 @@ false: No devuelve la imagen del último frame del video generado. Indica si el video generado incluye una marca de agua. -Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida +Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.### Salida La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se realojan en el almacenamiento de Comfy; todos los demás campos de aquí son propios de BytePlus. Anulable: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado `succeeded` consultado después de eso puede traer `content` ausente o nulo. @@ -355,7 +354,21 @@ Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seed - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo más a menudo como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente. + + + + Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: la hora de firma más temprana más la vigencia que las propias URL incluyen, nunca posterior a la `updated_at` de la tarea más 24 horas (la vida útil documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, la `updated_at` de la tarea más 24 horas. Presente solo cuando `upstream_video_url` o `upstream_last_frame_url` están presentes, y se omite cuando ninguna de las dos fuentes proporciona una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. + + Formato: `date-time` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a `last_frame_url` realojada, en los mismos términos que `upstream_video_url`: solo para espacios de trabajo que hayan optado por ello, solo para Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url` realojada. Presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo en el que Comfy haya optado por ello del lado del servidor (no hay ningún parámetro de solicitud); ausente para todos los demás, incluida una credencial que no se resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el propio realojamiento de Router. @@ -410,6 +423,35 @@ Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seed Valores posibles: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + + La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. +El ID de la tarea de generación de video + + + + El nombre y la versión del modelo que usa la tarea + + + + Formato de contenedor del video generado (mp4 o mov), que la consulta de tarea de video de Seedance devuelve en el NIVEL SUPERIOR, como hermano de `content`. Es un campo propio de BytePlus, reenviado sin cambios. + + + + La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. + + + + La semilla de generación que realmente se utilizó para la tarea. Campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. + + Formato: `int64` + + + + El estado de la tarea + + Valores posibles: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + + La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. diff --git a/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 0b1455dc86..02472b9626 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedance 1.5 Pro 251215 con Comfy Router" description: "Llama a byteplus/seedance-1-5-pro-251215 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 13f3fe20 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 6d6d6ec1 + "Schema": f4d67fb6 "Examples": 7e73ac5c --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-5-pro-251215.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + Ignorado. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -199,7 +200,7 @@ ID de recurso: formato asset://\ - Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. + Solo Seedance 2.5. La tarea Draft que se renderizará como el video final. Debe ser el único elemento de contenido. El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution toma el valor predeterminado 1080p y solo admite 1080p. @@ -251,7 +252,7 @@ este tamaño en el cable. Limita este campo, no la solicitud: todo el documento. Comfy Router (/v2/models/byteplus/\{model}) es la superficie que lo aplica; en una llamada directa a v1 /proxy responde el propio validador de BytePlus. Está configurado muy por encima del tráfico real para que nunca juzgue un -prompt genuino. Auméntalo si un cliente necesita más. +prompt genuino; auméntalo si un cliente necesita más. @@ -275,27 +276,26 @@ ID de recurso: formato asset://\ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final de 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 1.5 pro: [4,12] o -1 (automático). - Rango: `2` a `30` + Valores posibles: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` Umbral de tiempo de espera de la tarea en segundos. Predeterminado: 172800 (48 h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. false: el modelo genera un video silencioso. -En los modelos que lo admiten, el proveedor somete la pista de audio generada a una verificación de contenido independiente de la del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta por lo demás. Envía `false` para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. +En los modelos que lo admiten, el proveedor verifica el contenido de la pista de audio generada por separado del video; un rechazo ahí se reporta como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio era la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. - -El ID del modelo al que se llama. Modelos compatibles: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada directa de v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. +El ID del modelo al que se llama. Modelos compatibles: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada directa de v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. @@ -342,20 +342,32 @@ false: No devuelve la imagen del último fotograma del video generado. Indica si el video generado incluye una marca de agua. -Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida +Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor.### Salida - El resultado después de que se completa la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se RE-ALOJAN en el almacenamiento de Comfy; cualquier otro campo aquí es propio de BytePlus. Admite null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. + El resultado una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se RE-ALOJAN en el almacenamiento de Comfy; cualquier otro campo aquí es propio de BytePlus. Admite null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router re-aloja los bytes que recibe y les asigna un tipo a partir del Content-Type upstream o de una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router re-aloja el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memoria de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, devuelta cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router re-aloja los bytes que recibe y les asigna un tipo a partir del Content-Type upstream o de una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router re-aloja el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memoria de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo con más frecuencia como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven con más frecuencia como hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. + + + + Hora RFC 3339 en la que las URL upstream dejan de funcionar: el primer instante de firma más la vigencia que las propias URL incluyen, nunca posterior al `updated_at` de la tarea más 24 horas (la vida útil documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, el `updated_at` de la tarea más 24 horas. Presente solo cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes aporta una hora. No tiene relación con la vida útil de las `video_url` / `last_frame_url` re-alojadas. + + Formato: `date-time` + + + + URL de descarga del último fotograma propia de BytePlus, devuelta byte por byte junto a la `last_frame_url` re-alojada, en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga del video de salida propia de BytePlus, devuelta byte por byte junto a la `video_url` re-alojada. Presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado en el servidor (no existe un parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no limitada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at` y, en Seedance 2.5, BytePlus la limita a 100 descargas, una de las cuales consume el propio re-alojamiento de Router. @@ -382,24 +394,23 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda El mensaje de error - - El ID de la tarea de generación de video + El ID de la tarea de generación de video - El nombre y la versión del modelo que usa la tarea + El nombre y la versión del modelo utilizado por la tarea - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde la consulta de la tarea de video de Seedance lo devuelve. Campo propio de BytePlus, reenviado sin cambios. + Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde lo devuelve la consulta de tarea de video de Seedance. Campo propio de BytePlus, reenviado sin cambios. - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. + La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. - La semilla de generación que se usó realmente para la tarea. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. + La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. Formato: `int64` 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..2aa6c55094 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"; @@ -72,7 +74,7 @@ curl https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-trans -El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0/requests`. Router responde `201` con un `request_id` en cuanto la ejecución es admitida, y el resultado se recoge cuando está listo, desde este proceso u 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/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0/requests`. Router responde `201` con un `request_id` tan pronto como admite la ejecución, y recoges el resultado cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. ```python Python @@ -144,7 +146,7 @@ REQUEST_ID="" curl -i https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" -# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. curl https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -169,7 +171,7 @@ curl https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-trans - URL del video de origen del que se conservan el movimiento, la cámara y la sincronización. Mínimo 4 segundos; los videos más largos se recortan a 30 segundos. + URL del video de origen cuyo movimiento, cámara y sincronización se conservan. Mínimo 4 segundos; los videos más largos se recortan a 30 segundos. Generado a partir del esquema que Router expone en `GET /v2/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. @@ -181,7 +183,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/higgsfield/hi - Detalle del fallo, establecido cuando `status` es `failed`. + Detalle del fallo, presente cuando `status` es `failed`. @@ -235,5 +237,4 @@ Generado a partir del esquema que Router expone en `GET /v2/models/higgsfield/hi } ``` - 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..3d12623fc0 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"; @@ -19,7 +21,7 @@ Referencia de la API para `recraft/recraftv4_1_utility_vector`, servida por Comf ## 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 sin procesar. **ID del modelo:** `recraft/recraftv4_1_utility_vector` @@ -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.", @@ -68,15 +70,15 @@ 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 el resultado se recoge cuando está listo, desde este proceso u 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 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 indique 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. + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud fallida o cancelada 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 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 indique 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 fallida o cancelada 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 indique 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" ``` @@ -153,9 +155,9 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests - Define el tono artístico de tu imagen. En un nivel simple, la persona mira directamente a la cámara con un estilo estático y limpio. Los niveles dinámicos y excéntricos introducen movimiento y creatividad. + Define el tono artístico de tu imagen. En un nivel simple, la persona mira directamente a la cámara con un estilo estático y limpio. Los niveles dinámico y excéntrico introducen movimiento y creatividad. - Rango: `0` a `5` + Alcance: `0` a `5` @@ -179,13 +181,13 @@ 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 a usar para la generación (por ejemplo, "recraftv3"). Este campo NO está restringido a un enum: el proxy reenvía lo que envíe quien llama. Las grafías que Comfy distribuye, el conjunto al que Comfy Router se dirige 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 ningún elemento hace `$ref` al componente RecraftGenerationModel que las declara y, por lo tanto, se poda del spec que se sirve en GET /openapi, así que un puntero hacia él quedaría colgado en el documento servido. Las cuatro grafías `recraftv4_styles*` además requieren `style_id`. Consulta ese campo. - La cantidad de imágenes a generar. Recraft acepta de 1 a 6. + El número de imágenes a generar. Recraft acepta de 1 a 6. - Rango: `1` a `6` + Alcance: `1` a `6` @@ -201,14 +203,14 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests - El estilo que se aplicará a la imagen generada (por ejemplo, "digital_illustration") + El estilo a aplicar a la imagen generada (por ejemplo, "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 a aplicar a la imagen generada (por ejemplo, "123e4567-e89b-12d3-a456-426614174000"). Si proporcionas style_id, no deberías proporcionar style. Los cuatro modelos `recraftv4_styles*` lo REQUIEREN: Recraft los rechaza si no llevan 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 hace cumplir ese 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. +Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraftv4_1_utility_vector/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -217,7 +219,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraf - Cantidad de créditos usados para la generación + Número de créditos usados para la generación @@ -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 (presentes en lugar de `url` cuando la solicitud estableció `response_format: b64_json`) @@ -237,7 +239,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraf - El id de estilo resuelto, que Recraft devuelve cuando se usan referencias de estilo (en particular en los modelos con entrada requerida recraftv4_styles*); se puede reutilizar como `style_id` en solicitudes posteriores. + El id de estilo resuelto, que Recraft devuelve cuando se usan referencias de estilo (enparticular en los modelos con entrada requerida recraftv4_styles*); se puede reutilizar como `style_id` en solicitudes posteriores. ## Ejemplos 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..8ee12afc2f 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 con la que sincronizar los labios. El video dura lo mismo que el audio. Se rechaza con 400 cuando el audio supera el límite de entrada por llamada. @@ -174,7 +175,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/fabric-1. - Créditos que VEED cobró por la tarea. Presente cuando la tarea está COMPLETED. + Créditos que VEED cobró por la tarea. Presente una vez que la tarea está COMPLETED. @@ -182,7 +183,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/fabric-1. - Información del fallo. Presente cuando la tarea está FAILED. + Información del fallo. Presente una vez que la tarea está FAILED. @@ -202,7 +203,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/fabric-1. - El contenido multimedia producido. Presente cuando la tarea está COMPLETED. Las rutas de video responden `video`, Clean Audio responde `audio` y Video Background Removal responde `files`. + El contenido multimedia producido. Presente una vez que 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/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..ef598f6b32 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,24 +2,26 @@ 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"; Referencia de API de `veed/video-background-removal`, servida por Comfy Router desde Veed. -**Entrada:** video · **Salida:** video +**Entrada:** Video · **Salida:** Video ## 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 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, @@ -79,8 +81,8 @@ El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/veed/video-back 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 otro proceso necesita - # Poll until the request completes, waiting the Retry-After the server names. + # Sondea 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 fallida o cancelada 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 otro proceso necesita -// Poll until the request completes, waiting the Retry-After the server names. +// Sondea 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 fallida o cancelada 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. Sondea 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/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. 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,7 +167,7 @@ curl https://api.comfy.org/v2/models/veed/video-background-removal/requests/$REQ - Establécelo en falso cuando el sujeto no sea una persona. + Establece en false cuando el sujeto no sea una persona. @@ -209,7 +211,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/video-bac - 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 generado. Presente una vez que 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/queue.mdx b/es/development/comfy-router/queue.mdx index 99dcd34f0a..16c44b7c1a 100644 --- a/es/development/comfy-router/queue.mdx +++ b/es/development/comfy-router/queue.mdx @@ -13,9 +13,10 @@ translationBlockHashes: "Queue error responses": 01118a93 "Next": af716b3d --- -`POST /v2/models/{provider}/{model}` mantiene la conexión abierta hasta que el modelo termina. La entrega en cola usa el mismo ID de modelo y el mismo cuerpo de solicitud nativo, pero responde en cuanto Router ha admitido la ejecución. Recibes un `request_id` de inmediato y recuperas el resultado cuando está listo, desde el mismo proceso o desde otro. -**La ruta síncrona está limitada a 10 minutos.** El plazo predeterminado de Router se puede configurar por implementación. Una llamada síncrona que lo alcanza se corta con `504` / `deadline_exceeded`, sin importar si el proveedor sigue trabajando. Pon en cola una ejecución si puede superar el plazo o si quien llama no puede mantener una conexión abierta tanto tiempo. Consulta [Las llamadas se cortan en el plazo del servidor](/es/development/comfy-router/limitations#las-llamadas-se-cortan-por-un-plazo-límite-del-servidor) para saber qué te dice el plazo sobre la facturación y qué no. +`POST /v2/models/{provider}/{model}` mantiene la conexión abierta hasta que el modelo termina. La entrega en cola usa el mismo ID de modelo y el mismo cuerpo de solicitud nativo, pero responde en cuanto Router admite la ejecución. Recibes un `request_id` de inmediato y recoges el resultado cuando está listo, desde el mismo proceso o desde otro. + +**La ruta síncrona está limitada a 10 minutos.** El plazo predeterminado de Router es configurable en cada implementación. Una llamada síncrona que lo alcanza se corta con `504` / `deadline_exceeded`, sin importar si el proveedor sigue trabajando. Pon en cola una ejecución si puede superar el plazo o si quien llama no puede mantener una conexión abierta tanto tiempo. Consulta [Las llamadas se cortan en el plazo del servidor](/es/development/comfy-router/limitations#las-llamadas-se-cortan-por-un-plazo-límite-del-servidor) para saber qué te dice y qué no te dice el plazo sobre la facturación. Usa la cola cuando una generación pueda durar más que la conexión que puedes mantener, cuando una solicitud web tenga que responder de inmediato, cuando envíes en un proceso y recojas en otro, o cuando quieras muchas generaciones en curso a la vez. El orden, la admisión, los reintentos, los tiempos de espera, la facturación y la caducidad se deciden en el servidor. Los SDK solo añaden sondeo y comodidad de uso, nada más. @@ -53,29 +54,29 @@ Los dos IDs hacen falta en todas partes porque ambos direccionan la solicitud: l No hay eventos de progreso, webhooks ni niveles de prioridad: la ruta de estado es la forma de seguir una solicitud. La [referencia de la API](/es/development/comfy-router/reference#endpoints) contiene el contrato completo de cada ruta. -## Enviar y recoger una solicitud +## Submit and collect a request -Esto encola la misma solicitud que envía el [inicio rápido](/es/development/comfy-router/quickstart) y recoge la imagen. Primero exporta tu clave como `COMFY_API_KEY`. +This queues the same request the [quickstart](/development/comfy-router/quickstart) sends and collects the image. Export your key as `COMFY_API_KEY` first. ```python Python from comfy_sdk import Comfy -# Lee COMFY_API_KEY del entorno. -# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +# Reads COMFY_API_KEY from the environment. +# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. with Comfy() as client: handle = client.models.submit( "bfl/flux-2-pro", {"prompt": "a red teapot on a windowsill, morning light"}, ) - print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + print("request_id:", handle.request_id) # with the model ID, all another process needs - # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + # Poll until the request completes, waiting the Retry-After the server names. for update in handle.iter_events(): print(update.status, update.queue_position) - # 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. + # The provider's own payload, the same value models.run() returns. + # A request that failed or was cancelled raises the typed Router error here. result = handle.get() print("image:", result["result"]["sample"]) @@ -84,20 +85,20 @@ print("image:", result["result"]["sample"]) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Lee COMFY_API_KEY del entorno. -// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +// Reads COMFY_API_KEY from the environment. +// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. type FluxResult = { result: { sample: string } }; const handle = await comfy.models.submit("bfl/flux-2-pro", { prompt: "a red teapot on a windowsill, morning light", }); -console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso +console.log("requestId:", handle.requestId); // with the model ID, all another process needs -// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +// Poll until the request completes, waiting the Retry-After the server names. for await (const update of handle.events()) { console.log(update.status, update.queuePosition); } -// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +// The same result models.run() returns. A request that failed or was cancelled rejects here. const result = await handle.get(); if (result.kind !== "json") throw new Error("expected a JSON result"); @@ -107,30 +108,30 @@ console.log("image:", result.data.result.sample); ```bash cURL BASE="https://api.comfy.org/v2/models/bfl/flux-2-pro" -# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. curl "$BASE/requests" \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{"prompt": "a red teapot on a windowsill, morning light"}' -# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. REQUEST_ID="" curl -i "$BASE/requests/$REQUEST_ID/status" -H "X-API-Key: $COMFY_API_KEY" -# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue ejecutándose. +# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. curl "$BASE/requests/$REQUEST_ID" -H "X-API-Key: $COMFY_API_KEY" -# 4. Cancela una solicitud que no ha terminado. Una petición, no una garantía. +# 4. Cancel a request that has not finished. A request, not a guarantee. curl -X PUT "$BASE/requests/$REQUEST_ID/cancel" -H "X-API-Key: $COMFY_API_KEY" ``` -Cada [página de modelo](/es/development/comfy-router/models) incluye esta forma para su propio modelo en **Poner en cola y recoger después**, junto al fragmento síncrono. +Every [model page](/development/comfy-router/models) carries this shape for its own model under **Queue and collect later**, beside the synchronous snippet. -### Seguir el progreso y recoger en una sola llamada +### Follow progress and collect in one call -Cuando sí quieres esperar pero también quieres mostrar el progreso, `subscribe` combina envío, consulta y recogida en una sola llamada: +When you do want to wait but also want to show progress, `subscribe` folds submit, poll and collect into one call: ```python Python @@ -157,11 +158,11 @@ const result = await comfy.models.subscribe( ``` -El tiempo de espera es un límite del lado del cliente, sin significado en el servidor. Cuando se agota, `subscribe` hace un intento de cancelación de mejor esfuerzo antes de lanzar. Una cancelación solo surte efecto en una solicitud que aún no ha empezado a ejecutarse: una generación que ya está en curso en el socio se completa y se cobra, la recoja alguien o no. Usa `submit` cuando la solicitud deba sobrevivir a quien la llama. +The timeout is a client-side bound with no server-side meaning. When it runs out, `subscribe` makes one best-effort cancel before raising. A cancel only takes effect on a request that has not started running: a generation already in flight at the partner completes and is charged whether or not anyone collects it. Use `submit` when the request should outlive the caller. -### Recoger desde otro proceso +### Collect from another process -Guarda el `request_id` junto al ID del modelo. Ambos son necesarios para reconstruir un handle, y no se hace ninguna llamada hasta que lo uses. +Store the `request_id` next to the model ID. Both are needed to rebuild a handle, and no call is made until you use it. ```python Python @@ -175,9 +176,9 @@ const result = await handle.get(); ``` -### Consultar el estado o cancelar +### Check status or cancel -`status()` es una sola consulta y devuelve el estado actual. `cancel()` pide al servidor que detenga una solicitud que no ha terminado. Es una petición, no una garantía: una ejecución que ya está en marcha en el socio puede completarse de todos modos, y el siguiente `status()` es lo que es cierto. +`status()` is one poll and returns the current state. `cancel()` asks the server to stop a request that has not finished. It is a request, not a guarantee: a run already on the wire at the partner may complete anyway, and the next `status()` is what is true. ```python Python @@ -195,9 +196,9 @@ await handle.cancel(); ``` -### Python asíncrono +### Async Python -`AsyncComfy` replica cada nombre, argumento y orden de argumentos. No existe `submit_async`, por la misma razón por la que no existe `run_async`. +`AsyncComfy` mirrors every name, argument and argument order. There is no `submit_async`, for the same reason there is no `run_async`. ```python from comfy_sdk import AsyncComfy @@ -212,13 +213,13 @@ async with AsyncComfy() as client: result = await handle.get() ``` -### Errores que lanzan los SDK +### Errors the SDKs raise -Una solicitud que terminó sin éxito se reporta como `COMPLETED` con un `error_type`. `get()` y `subscribe()` lo convierten en el error tipado de Router que corresponde al grupo: las clases de `comfy_sdk.router_exceptions` en Python, y `routerErrors.*` en TypeScript. El iterador de eventos no lanza en ese caso, porque es una vista del progreso de la cola: una finalización que lleva un `error_type` se entrega como la última observación, y es `get()` el que recoge. Un `403` `not_enabled` en el envío llega como `NotEnabled` y es terminal, así que los SDK no lo reintentan. +A request that finished without succeeding is reported as `COMPLETED` with an `error_type`. `get()` and `subscribe()` turn that into the typed Router error for the bucket: the classes in `comfy_sdk.router_exceptions` in Python, and `routerErrors.*` in TypeScript. The event iterator does not raise for that case, because it is a view of the queue's progress: a completion carrying an `error_type` is yielded as the last observation, and `get()` is what collects. A `403` `not_enabled` on submit arrives as `NotEnabled` and is terminal, so the SDKs do not retry it. ## Formas de respuesta de la cola -**Enviar, `201`.** En este punto, `status` siempre es `IN_QUEUE`. Las tres URL son absolutas y usan la misma clave que el envío para autenticarse. +**Enviar, `201`.** En este punto, `status` siempre es `IN_QUEUE`. Las tres URL son absolutas y se autentican con la misma clave que el envío. ```json { @@ -231,9 +232,9 @@ Una solicitud que terminó sin éxito se reporta como `COMPLETED` con un `error_ } ``` -`request_id` también es el valor del encabezado `X-Comfy-Request-Id` del envío. Mantén el ID del modelo junto a él: la solicitud se identifica por ambos. +`request_id` también es el valor del encabezado `X-Comfy-Request-Id` del envío. Guarda junto a él el ID del modelo: la solicitud se direcciona con ambos. -**Estado, `200`.** La misma forma, con el estado actual. `queue_position` cuenta las solicitudes que tienes por delante y llega a `0` cuando la ejecución está al frente. `Retry-After` en esta respuesta es la estimación de Router de cuándo merece la pena volver a consultar. Es una indicación, no un límite, y a una solicitud al final de la cola se le indica que espere más que a una que ya se está ejecutando. Consultar más rápido no permite enterarte antes de nada y consume tu propio margen de límite de velocidad. +**Estado, `200`.** La misma forma, con el estado actual. `queue_position` cuenta las solicitudes que tienes por delante y llega a `0` cuando la ejecución está al frente. El `Retry-After` de esta respuesta es la estimación de Router sobre cuándo merece la pena el viaje de ida y vuelta de volver a consultar. Es una pista, no un límite, y a una solicitud al final de la cola se le indica que espere más que a una que ya se está ejecutando. Consultar más rápido no te adelanta nada y consume tu propio cupo de límite de velocidad. ```json { @@ -246,7 +247,7 @@ Una solicitud que terminó sin éxito se reporta como `COMPLETED` con un `error_ } ``` -Una solicitud que finalizó sin éxito es `COMPLETED` con un `error_type`, que lleva la misma categoría general que la lectura del resultado asigna a `X-Comfy-Error-Type`. El campo está ausente en caso de éxito en lugar de ser `null`. +Una solicitud que terminó sin éxito es `COMPLETED` con un `error_type`, y lleva el mismo grupo genérico que la lectura del resultado pone en `X-Comfy-Error-Type`. En caso de éxito, el campo está ausente en lugar de ser `null`. ```json { @@ -259,34 +260,34 @@ Una solicitud que finalizó sin éxito es `COMPLETED` con un `error_type`, que l } ``` -**Resultado.** `200` contiene la salida nativa propia del modelo, byte por byte lo que la ruta síncrona devuelve para el mismo modelo y entrada, bajo el `Content-Type` propio del proveedor. Mientras la solicitud no ha finalizado, la lectura responde `202` con el cuerpo de estado anterior, de modo que un cliente que solo consulta la URL del resultado analiza un único tipo. Una solicitud fallida vuelve como una respuesta de error con `X-Comfy-Error-Type` establecido, las mismas categorías que la ruta síncrona. +**Resultado.** `200` lleva la salida nativa propia del modelo, byte por byte lo que devuelve la ruta síncrona para el mismo modelo y la misma entrada, con el `Content-Type` propio del proveedor. Mientras la solicitud no ha terminado, la lectura responde `202` con el cuerpo de estado anterior, de modo que un cliente que solo consulta la URL del resultado analiza un único tipo. Una solicitud que falló vuelve como una respuesta de error con `X-Comfy-Error-Type` establecido, con los mismos grupos que la ruta síncrona. -**Cancelar.** `202` con `CANCELLATION_REQUESTED` significa que la solicitud se aceptó, no que la ejecución se haya detenido. Una ejecución que ya está en curso en el socio puede completarse de todos modos, y una generación del socio que se completa se cobra tanto si alguien la recoge como si no. Consulta el estado después: una cancelación que surtió efecto aparece como `COMPLETED` con `error_type: cancelled`. Una solicitud que caducó antes de poder ejecutarse muestra `queue_timeout` de la misma manera. Una solicitud que ya había finalizado responde `409` con `ALREADY_COMPLETED`. +**Cancelar.** `202` con `CANCELLATION_REQUESTED` significa que la petición se aceptó, no que la ejecución se haya detenido. Una ejecución que ya está en curso en el socio puede completarse de todos modos, y una generación del socio que se completa se cobra, la recoja alguien o no. Lee el estado después: una cancelación que surtió efecto aparece como `COMPLETED` con `error_type: cancelled`. Una solicitud que caducó antes de poder ejecutarse muestra `queue_timeout` de la misma forma. Una solicitud que ya había terminado responde `409` con `ALREADY_COMPLETED`. ## Idempotencia y facturación -- **El mismo cargo que en la ruta síncrona.** Se te factura cuando el proveedor factura a Comfy. El tiempo de espera en la cola no se cobra. -- **Una `Idempotency-Key` por envío.** El SDK genera una clave nueva por cada llamada a `submit`, así que dos envíos deliberados de la misma entrada son dos solicitudes. Un reintento de la misma llamada con la misma clave no encola una segunda ejecución: devuelve el handle original con `Idempotent-Replayed: true`. Pasa tu propia clave cuando una respuesta perdida podría haberte costado el `request_id`. Consulta [Encabezados](/es/development/comfy-router/headers). -- **Los resultados caducan.** Una solicitud finalizada permanece disponible durante 24 horas después de completarse. Después de eso, las lecturas de estado y resultado responden `410` y el resultado desaparece. Recoge el resultado de inmediato y descarga las URL de recursos que incluya la salida. -- **Las consultas de sondeo también son solicitudes.** Las lecturas de estado y resultado cuentan para la [tasa de solicitudes por solicitante](/es/development/comfy-router/limitations#límite-de-tasa-de-solicitudes-por-solicitante). Respeta `Retry-After` en lugar de sondear a un intervalo corto fijo. +- **El mismo cargo que la ruta síncrona.** Se te factura cuando el proveedor factura a Comfy. El tiempo de espera en la cola no genera ningún cargo. +- **Una `Idempotency-Key` por envío.** El SDK genera una clave nueva por cada llamada a `submit`, así que dos envíos deliberados de la misma entrada son dos solicitudes. Un reintento de la misma llamada con la misma clave no encola una segunda ejecución: devuelve el identificador original con `Idempotent-Replayed: true`. Pasa tu propia clave cuando una respuesta perdida podría haberte costado el `request_id`. Consulta [Encabezados](/es/development/comfy-router/headers). +- **Los resultados caducan.** Una solicitud finalizada se conserva 24 horas después de completarse. Después de eso, las lecturas de estado y de resultado responden `410` y el resultado ya no existe. Recógelo pronto y descarga las URL de los recursos que incluya la salida. +- **Las consultas de sondeo también son solicitudes.** Las lecturas de estado y de resultado cuentan para el [límite de solicitudes por solicitante](/es/development/comfy-router/limitations#límite-de-tasa-de-solicitudes-por-solicitante). Respeta `Retry-After` en lugar de sondear con un intervalo corto fijo. ## Respuestas de error de la cola | Estado | `X-Comfy-Error-Type` | Significado | | --- | --- | --- | -| `402` | `insufficient_credits` | El espacio de trabajo no puede financiar la ejecución. No se encola ni se cobra nada, y puedes reenviar la misma `Idempotency-Key` una vez que se haya financiado. | -| `403` | `not_enabled` | Este solicitante no puede usar la cola: una clave sin un espacio de trabajo detrás (claves clásicas anteriores a los espacios de trabajo), una solicitud de bring-your-own-key, o un modelo que la cola no puede ejecutar. Es terminal para esa solicitud, no reintentes. | +| `402` | `insufficient_credits` | El espacio de trabajo no puede financiar la ejecución. No se encola ni se cobra nada, y puedes volver a enviar la misma `Idempotency-Key` una vez que tenga fondos. | +| `403` | `not_enabled` | Este solicitante no puede usar la cola: una clave sin un espacio de trabajo detrás (claves clásicas anteriores a los espacios de trabajo), una solicitud con tu propia clave (bring-your-own-key) o un modelo que la cola no puede ejecutar. Es terminal para esa solicitud, no reintentes. | | `404` | `model_not_found` | El ID `{provider}/{model}` no corresponde a ningún modelo de Router. | | `404` | `request_not_found` | No existe ninguna solicitud con ese ID para este solicitante y modelo. | -| `409` | `concurrency_limit_exceeded` | La misma `Idempotency-Key` todavía se está admitiendo. Espera el `Retry-After` y reenvía la misma clave para obtener el identificador original. | -| `409` | `invalid_input` | La `Idempotency-Key` está retenida para una solicitud diferente. Envía esta con una clave nueva. | +| `409` | `concurrency_limit_exceeded` | La misma `Idempotency-Key` todavía se está admitiendo. Espera el `Retry-After` y vuelve a enviar la misma clave para obtener el handle original. | +| `409` | `invalid_input` | La `Idempotency-Key` está reservada para una solicitud diferente. Envía esta con una clave nueva. | | `409` | `ALREADY_COMPLETED` en el cuerpo | Solo en la ruta de cancelación: la solicitud ya había finalizado, así que no había nada que cancelar. | -| `410` | | La solicitud existía y está fuera de su ventana de retención, 24 horas después de que se completó. Es permanente para ese ID. | +| `410` | | La solicitud existió y está fuera de su ventana de retención, 24 horas después de completarse. Es permanente para ese ID. | | `422` | `invalid_input` | El modelo rechazó la entrada. El cuerpo incluye el detalle por campo, exactamente como en la ruta síncrona. | -Cada respuesta de error incluye `X-Comfy-Request-Id`. Cítalo cuando contactes con soporte. +Todas las respuestas de error incluyen `X-Comfy-Request-Id`. Cítalo cuando contactes a soporte. -## Próximos pasos +## Siguiente -- [Errores y reintentos](/es/development/comfy-router/errors): consulta las respuestas de error y reintenta sin un segundo cargo. +- [Errores y reintentos](/es/development/comfy-router/errors): consulta las respuestas de error y reintenta sin un segundo cobro. - [Referencia de la API](/es/development/comfy-router/reference#endpoints): el contrato completo de cada ruta de la cola. diff --git a/es/development/comfy-router/reference.mdx b/es/development/comfy-router/reference.mdx index 970a45c97b..bbc44c6be0 100644 --- a/es/development/comfy-router/reference.mdx +++ b/es/development/comfy-router/reference.mdx @@ -2,18 +2,19 @@ title: "Referencia de la API de Comfy Router" sidebarTitle: "Referencia de la API" description: "Todos los endpoints, parámetros, respuestas y errores de Comfy Router, según el contrato de la API de Comfy." -translationSourceHash: 1b971d1c +translationSourceHash: aee933a1 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": fbcaaf0e - "Error buckets": 36170340 + "Endpoints": e0879d3c + "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 3ecabac6 - "Result assets": 65fc939b + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": c1245cc9 --- + {/* ARCHIVO GENERADO -- NO EDITAR A MANO. @@ -45,29 +46,29 @@ Consulta los IDs de modelo disponibles y los datos de facturación. Usa `next_cu Cursor de paginación opaco. - Tipo: [`RouterPageCursor`](#routerpagecursor) -- Cursor opaco devuelto como `next_cursor`, de 1 a 512 caracteres + Tipo: [`RouterPageCursor`](#routerpagecursor) -- Cursor opaco devuelto como `next_cursor`, de 1–512 caracteres - Cantidad de modelos que se devuelven en una página. + Cantidad de modelos a devolver en una página. - Hasta 100, Predeterminado: 20 + Hasta 100, valor predeterminado: 20 - El `ETag` que el solicitante conserva de un `200` anterior. + El `ETag` que el cliente conserva de una respuesta `200` anterior. **Respuestas** - OK: una página del catálogo de modelos. + OK - una página del catálogo de modelos. Cuerpo: [`RouterModelListResponse`](#routermodellistresponse) -- Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - Not Modified: la página no cambió desde el `ETag` que el solicitante envió en `If-None-Match`. + Not Modified - la página no ha cambiado desde el `ETag` que el cliente envió en `If-None-Match`. Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` @@ -85,39 +86,37 @@ Consulta los IDs de modelo disponibles y los datos de facturación. Usa `next_cu - La solicitud no está permitida para este solicitante o modelo. + La solicitud no está permitida para este cliente o modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - El router no está disponible temporalmente. Reintenta con retroceso exponencial. + El router no está disponible temporalmente. Reintenta con espera progresiva. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - - -### `GET /v2/models/{provider}/{model}` +### `GET /v2/models/{provider}/{model}` **Lee la entrada del catálogo de un modelo socio por su ID de modelo canónico.** -Lee los detalles de un modelo sin listar el catálogo completo. +Consulta los detalles de un modelo sin listar el catálogo completo. **Parámetros** - Parte del proveedor en el ID de modelo canónico `{provider}/{model}`. + Parte de proveedor del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterProviderSegment`](#routerprovidersegment). Slug alfanumérico, p. ej. `anthropic`. Hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, hasta 64 caracteres - Parte del modelo en el ID de modelo canónico `{provider}/{model}`. + Parte de modelo del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterModelSegment`](#routermodelsegment). Slug alfanumérico, p. ej. `claude-opus-4-6`. Hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, hasta 128 caracteres - El `ETag` que un llamador conserva de un `200` anterior. + El `ETag` que conserva quien llama de una respuesta `200` anterior. **Respuestas** @@ -125,67 +124,65 @@ Lee los detalles de un modelo sin listar el catálogo completo. OK: la entrada del catálogo del modelo. - Cuerpo: [`RouterModelDetail`](#routermodeldetail). Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` + Cuerpo: [`RouterModelDetail`](#routermodeldetail) -- Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - No modificado: la entrada no ha cambiado desde el `ETag` que el llamador envió en `If-None-Match`. + Not Modified: la entrada no ha cambiado desde el `ETag` que quien llama envió en `If-None-Match`. Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - Credenciales faltantes o inválidas. + Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para este llamador ni para este modelo. + La solicitud no está permitida para quien llama ni para este modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` No se encontró el ID de modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - - -### `POST /v2/models/{provider}/{model}` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` +### `POST /v2/models/{provider}/{model}` -**Ejecuta un modelo socio de forma sincrónica mediante el ID canónico del modelo.** +**Ejecuta un modelo socio de forma síncrona mediante su ID de modelo canónico.** Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. **Parámetros** - Parte del proveedor en el ID canónico `{provider}/{model}` del modelo. + Porción de proveedor del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, de hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - Parte del modelo en el ID canónico `{provider}/{model}` del modelo. + Porción de modelo del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, de hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres Clave generada por quien llama que hace seguro reintentar una misma llamada lógica. - De 1 a 255 caracteres + 1–255 caracteres - Selecciona un proveedor alternativo para servir este modelo, en lugar de su valor predeterminado actual; `fal`, `wavespeed`, `runware` y `higgsfield` son los alternativos, y `GET /v2/models/{provider}/{model}` informa cuáles de ellos admite un modelo dado. Sus rechazos se comprueban en un orden fijo, y los anteriores responden tanto si los posteriores lo harían como si no: un valor no reconocido, que no es un proveedor registrado en absoluto, se rechaza con `400`; después, un proveedor alternativo en una solicitud cuyo cuerpo selecciona una operación multipart (una edición) se rechaza con `409` y un `detail` que comienza con "this request's `image` selects the edit operation", pero solo cuando el traductor de ese proveedor para este modelo no puede servir la operación: una opción cuyo traductor sí admite el medio continúa con normalidad; después, cualquier proveedor alternativo en una solicitud que resolvió una credencial de tipo bring-your-own-key se rechaza con `409` y un `detail` que comienza con `this request resolved a BYOK credential` (consulta esa respuesta), sirva o no ese proveedor a este modelo; después, la compuerta propia del proveedor indicado, que rechaza con `403` y `error_type: not_enabled` cuando ese proveedor no está activado para ti y con `503` y `error_type: service_unavailable` cuando la compuerta no se puede evaluar; y solo después de las cuatro se rechaza con `400` y `error_type: invalid_input` un proveedor real sin opción para este modelo, la misma respuesta que la de un valor no reconocido. `fallback_provider` queda inerte en lugar de rechazarse en una solicitud bring-your-own-key, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`. + Selecciona un proveedor alternativo para servir este modelo en lugar de su valor predeterminado actual; `fal`, `wavespeed`, `runware` y `higgsfield` son los alternativos, y `GET /v2/models/{provider}/{model}` informa cuáles de ellos admite un modelo dado. Sus rechazos se comprueban en un orden fijo, y los anteriores responden tanto si los posteriores lo harían como si no: un valor no reconocido (que no es un proveedor registrado en absoluto) se rechaza con `400`; luego, un proveedor alternativo en una solicitud cuyo cuerpo selecciona una operación multipart (una edición) se rechaza con `409` con `detail` que empieza por "this request's `image` selects the edit operation", pero solo cuando el traductor de ese proveedor para este modelo no puede servir la operación: un tramo cuyo traductor sí admite los medios continúa con normalidad; luego, cualquier proveedor alternativo en una solicitud que resolvió una credencial bring-your-own-key se rechaza con `409` con `detail` que empieza por `this request resolved a BYOK credential` (consulta esa respuesta), tanto si ese proveedor sirve este modelo como si no; luego, la compuerta propia del proveedor nombrado, que rechaza con `403` con `error_type: not_enabled` cuando ese proveedor no está habilitado para ti y con `503` con `error_type: service_unavailable` cuando la compuerta no se puede evaluar; y solo después de las cuatro se rechaza con `400` con `error_type: invalid_input` un proveedor real sin tramo para este modelo, la misma respuesta que un valor no reconocido. `fallback_provider` queda inerte en lugar de rechazarse en una solicitud bring-your-own-key, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`. @@ -195,11 +192,11 @@ Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. - Controla si Router reintenta esta llamada contra el otro proveedor registrado del modelo cuando el primer intento falla por un motivo atribuible a Router o al proveedor probado. Si se omite, o con cualquier valor distinto de `false`, el fallback queda activo; `false` lo desactiva. Una respuesta de fallback exitosa incluye `X-Comfy-Router-Fallback-Provider`. En una solicitud que resolvió una credencial de tipo bring-your-own-key el fallback no está disponible diga lo que diga este parámetro: el intento simplemente no se hace y el primer fallo te llega sin cambios, lo cual es inerte, no un rechazo: aquí no se origina ningún `409`. Lo mismo ocurre, por la misma razón, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`: cada una vincula la llamada a un único proveedor que no se puede reproducir fielmente contra otro, así que el fallback simplemente se omite en lugar de rechazarse. Solo un `model_provider` explícito se rechaza con ese `409`, y a diferencia de esta omisión incondicional, su `409` por multipart se aplica únicamente a una opción cuyo traductor no puede servir la operación. + Controla si Router reintenta esta llamada contra el otro proveedor registrado del modelo cuando el primer intento falla por un motivo atribuible a Router o al proveedor probado. Si se omite, o con cualquier valor distinto de `false`, el fallback permanece activo; `false` lo desactiva. Una respuesta de fallback exitosa incluye `X-Comfy-Router-Fallback-Provider`. En una solicitud que resolvió una credencial bring-your-own-key el fallback no está disponible diga lo que diga este parámetro: el intento simplemente no se hace y el primer fallo te llega sin cambios, lo cual es inerte, no un rechazo: ningún `409` se origina aquí. Lo mismo ocurre, por la misma razón, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`: cada una vincula la llamada a un único proveedor que no se puede reproducir fielmente contra otro, así que el fallback simplemente se omite en lugar de rechazarse. Solo un `model_provider` explícito se rechaza con ese `409`, y, a diferencia de esta omisión incondicional, su `409` de multipart se aplica únicamente a un tramo cuyo traductor no puede servir la operación. - Actívalo para rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declara, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada para un modelo cuyo esquema permite campos no declarados o que no tiene esquema creado, ni en un envío en cola enviado con `strict_mode=true`. + Opta por rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declara, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada para un modelo cuyo esquema permite campos no declarados o que no tiene esquema redactado, ni en un envío en cola enviado con `strict_mode=true`. Predeterminado: False @@ -208,12 +205,10 @@ Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. `application/json` -- [`RouterModelInput`](#routermodelinput) (requerido) -La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejecuta el despacho nativo en el proveedor predeterminado del modelo y este cuerpo es el propio esquema nativo del modelo, reenviado sin cambios (`strict_mode` no tiene sentido ahí y no cambia nada). Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=false` (el valor predeterminado), el cuerpo se traduce al esquema real de ese proveedor antes de enviarse: cualquier campo nativo que no se pueda expresar con exactitud se descarta y se divulga mediante el encabezado `X-Comfy-Router-Dropped-Params` de la respuesta, nunca en silencio. Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=true` no se ejecuta ninguna traducción: el cuerpo ya debe ser el esquema real propio de ese proveedor alternativo, no el nativo de este modelo (consulta `strict_mode`), y se reenvía sin cambios. Los propios campos del cuerpo también seleccionan qué operación ejecuta Router en un modelo que admite más de una: para un modelo de imagen editable, incluir una imagen de entrada lo cambia de la operación texto a imagen a la operación imagen a imagen (edición), que puede facturarse con su propia tarifa; para un modelo de video Seedance, `content[].role` selecciona la operación (una imagen de primer fotograma selecciona imagen a video, y una imagen o un clip de referencia selecciona referencia a video). En el despacho nativo, la facturación de Seedance sigue los tipos de medio en `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; si no, texto a video, salvo que un render final de un elemento `draft_task` se factura como la operación del Draft que renderiza; algunos modelos cobran la misma tarifa para texto a video e imagen a video. Con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. - -**Respuestas** +La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejecuta el despacho nativo en el proveedor predeterminado del modelo y este cuerpo es el esquema nativo propio del modelo, reenviado sin cambios (`strict_mode` no tiene sentido ahí y no cambia nada). Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=false` (el valor predeterminado), el cuerpo se traduce al esquema real de ese proveedor antes de enviarse: cualquier campo nativo que no se pueda expresar con exactitud se descarta y se revela mediante el encabezado `X-Comfy-Router-Dropped-Params` de la respuesta, nunca en silencio. Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=true` no se ejecuta ninguna traducción: el cuerpo ya debe ser el esquema real propio de ese proveedor alternativo, no el nativo de este modelo (consulta `strict_mode`), y se reenvía sin cambios. Los campos del propio cuerpo también seleccionan qué operación ejecuta Router en un modelo que admite más de una: para un modelo de imagen editable, incluir una imagen de entrada lo cambia de texto a imagen a la operación imagen a imagen (edición), que puede facturarse con su propia tarifa; para un modelo de video Seedance, `content[].role` selecciona la operación (una imagen de primer fotograma selecciona imagen a video, y una imagen o un clip de referencia seleccionan referencia a video). En el despacho nativo, la facturación de Seedance sigue los tipos de medios 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; si no, texto a video, salvo que un render final de un elemento `draft_task` se factura como la operación del Draft que renderiza; algunos modelos cobran la misma tarifa por texto a video y por imagen a video. Con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. - - OK: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado; se traduce de vuelta al contrato nativo de este modelo cuando es posible, y si la traducción falla se recurre a la respuesta sin procesar del proveedor alternativo, registrada en el log y nunca silenciosa), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde a una generación directamente como bytes, el cuerpo son esos bytes con el `Content-Type` propio del socio en lugar de `application/json`; ramifica según el `Content-Type` de la respuesta y no des por hecho que se trata de un documento JSON. +**Respuestas** + OK: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado; se traduce de vuelta al contrato nativo de este modelo cuando es posible, y si la traducción falla se recurre a la respuesta sin procesar del proveedor alternativo, lo que se registra en el log y nunca es silencioso), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde una generación directamente como bytes, el cuerpo son esos bytes con el `Content-Type` propio del socio en lugar de `application/json`; ramifica según el `Content-Type` de la respuesta y no supongas que hay un documento JSON. Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes sin procesar (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` @@ -221,7 +216,7 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec Solicitud no válida. Revisa el tipo de error y el cuerpo de la solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `Idempotent-Replayed` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `X-Comfy-Credits-Used`, `Idempotent-Replayed` @@ -231,7 +226,7 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. + Una falla a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -249,9 +244,9 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera el `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: se rechaza un `model_provider` que nombra a un proveedor alternativo cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, y cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial de tipo bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. + Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: se rechaza `model_provider` cuando nombra un proveedor alternativo si el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, y cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando es `concurrency_limit_exceeded`) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando ocurre `concurrency_limit_exceeded`) @@ -261,53 +256,51 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - El contenido de la solicitud fue rechazado contra el esquema del modelo. + El contenido de la solicitud fue rechazado según el esquema del modelo. Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que debes reducir las llamadas en curso; `rate_limited` significa que debes esperar a que se abra la ventana de cupo. + Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa reducir las llamadas en curso; `rate_limited` significa esperar la ventana de cuota. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining` - La propia respuesta del proveedor no se pudo convertir en un resultado (`provider_error`). + La respuesta propia del proveedor no se pudo convertir en un resultado (`provider_error`). Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status` - Router no está disponible temporalmente. Reintenta con retroceso exponencial. + Router no está disponible temporalmente. Reintenta con retroceso. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo en los rechazos por capacidad) La solicitud superó un plazo límite. Revisa el tipo de error antes de reintentar. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After` - - -### `POST /v2/models/{provider}/{model}/estimate` +### `POST /v2/models/{provider}/{model}/estimate` **Calcula el precio de una llamada a un modelo antes de ejecutarla, sin ejecutarla.** -Devuelve una estimación previa, en dólares estadounidenses, de lo que costará ejecutar este cuerpo en este modelo, con precios tomados de la misma tarifa con la que se factura la ejecución. Es una estimación, no el cargo final: lo que pagas es el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo. El cuerpo se valida primero contra el esquema de entrada del modelo, tal como lo valida una ejecución predeterminada (sin `strict_mode`, sin `reject_unknown_fields`), así que un cuerpo que no cumple el esquema del modelo produce aquí el mismo `422` que en la ejecución; no se despacha nada a un proveedor y no se cobra nada. La respuesta no es un bloqueo de precio: se calcula con las tarifas vigentes en `pricing_as_of`, y una ejecución se cobra con las tarifas vigentes cuando se tarifica. Mientras la función se está desplegando, la ruta responde `403` con `error_type: not_enabled`. +Devuelve una estimación previa, en dólares estadounidenses, de lo que costará ejecutar este body en este modelo, con el precio de la misma tarifa contra la que se factura la ejecución (un modelo que se factura por el costo que reporta su proveedor se estima a partir de la lista de precios publicada por el proveedor). Es una estimación, no el cargo final: lo que pagas es el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo. Primero se valida el body contra el esquema de entrada del modelo, tal como lo valida una ejecución predeterminada (sin `strict_mode` ni `reject_unknown_fields`), así que un body que no cumple el esquema del modelo produce el mismo `422` aquí que en la ejecución; no se despacha nada a un proveedor y no se cobra nada. La respuesta no es un bloqueo de precio: se cotiza con las tarifas vigentes en `pricing_as_of`, y una ejecución se cobra con las tarifas vigentes cuando se tarifica. Mientras la función se está implementando gradualmente, la ruta responde `403` con `error_type: not_enabled`; un modelo que Router aún no puede ejecutar responde el mismo `403` con el `detail` propio de la ruta de ejecución, así que lee `detail` para distinguir ambos casos. **Parámetros** - Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se ejecuta. + Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`, es decir, el socio cuyo modelo se ejecuta. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, de hasta 64 caracteres - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`, es decir, el modelo a ejecutar dentro de ese proveedor. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, de hasta 128 caracteres @@ -318,92 +311,90 @@ Devuelve una estimación previa, en dólares estadounidenses, de lo que costará `application/json` -- [`RouterModelInput`](#routermodelinput) (requerido) -La entrada JSON nativa del modelo del socio, idéntica al cuerpo que la ruta síncrona acepta para este modelo. Se valida contra el esquema de entrada propio del modelo tal como lo valida una ejecución predeterminada (esta ruta no acepta `strict_mode` ni `reject_unknown_fields`), y sus propios campos (el número de salidas, la operación que selecciona una imagen de entrada) deciden qué se tarifica. +La entrada JSON nativa del modelo del socio, idéntica al body que acepta la ruta síncrona para este modelo. Se valida contra el esquema de entrada propio del modelo tal como lo valida una ejecución predeterminada (esta ruta no acepta `strict_mode` ni `reject_unknown_fields`), y sus propios campos (la cantidad de salidas, la operación que selecciona una imagen de entrada) determinan qué se cotiza. **Respuestas** La cotización. - Cuerpo: [`RouterCostEstimate`](#routercostestimate) -- Encabezados: `X-Comfy-Request-Id` + Body: [`RouterCostEstimate`](#routercostestimate) -- Headers: `X-Comfy-Request-Id` Solicitud no válida. Revisa el tipo de error y el cuerpo de la solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` La solicitud no está permitida para este solicitante o modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` No se encontró el ID de modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` El cuerpo de la solicitud es demasiado grande. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - El cuerpo de la estimación se rechazó contra el esquema del modelo, o nombraba un modelo distinto del de la ruta. + El body de la estimación se rechazó contra el esquema del modelo, o nombraba un modelo distinto del de la ruta. - Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router no está disponible temporalmente. Reintenta aplicando backoff. - - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) - + Router no está disponible temporalmente. Reintenta con retroceso exponencial. -### `GET /v2/models/{provider}/{model}/openapi.json` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo en rechazos por capacidad) +### `GET /v2/models/{provider}/{model}/openapi.json` **Lee los esquemas de entrada y salida de un modelo socio como documento OpenAPI.** -Lee los esquemas de entrada y salida de un modelo como un documento OpenAPI independiente. +Lee los esquemas de entrada y salida de un modelo como documento OpenAPI independiente. **Parámetros** - Parte del proveedor en el ID de modelo canónico `{provider}/{model}`. + Parte de proveedor del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterProviderSegment`](#routerprovidersegment). Slug alfanumérico, p. ej. `anthropic`. Hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - Parte del modelo en el ID de modelo canónico `{provider}/{model}`. + Parte de modelo del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterModelSegment`](#routermodelsegment). Slug alfanumérico, p. ej. `claude-opus-4-6`. Hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - El `ETag` que el solicitante conserva de una respuesta `200` anterior. + El `ETag` que el solicitante conserva de un `200` anterior. **Respuestas** - OK: los esquemas de entrada y salida del modelo, como un documento OpenAPI independiente. + OK - los esquemas de entrada y salida del modelo, como documento OpenAPI independiente. - Cuerpo: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument). Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` + Cuerpo: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - Not Modified: el documento no ha cambiado desde el `ETag` que el solicitante envió en `If-None-Match`. + Not Modified - el documento no ha cambiado desde el `ETag` que el solicitante envió en `If-None-Match`. Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` @@ -411,55 +402,53 @@ Lee los esquemas de entrada y salida de un modelo como un documento OpenAPI inde Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para este solicitante ni para este modelo. + La solicitud no está permitida para este solicitante o modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - No se encontró el ID del modelo. + No se encontró el ID de modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router no pudo completar la solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - - -### `POST /v2/models/{provider}/{model}/requests` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` +### `POST /v2/models/{provider}/{model}/requests` -**Envía una ejecución de modelo asociado a la cola y regresa de inmediato.** +**Envía una ejecución de modelo de socio a la cola y regresa de inmediato.** -El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es la misma entrada JSON nativa del socio que `POST /v2/models/{provider}/{model}` acepta para este modelo: una sola forma de cuerpo, un esquema por modelo, dos modos de entrega; pero esta ruta no mantiene la conexión para el resultado. Admite la ejecución, responde `201` con un identificador y quien llama recoge el resultado más tarde mediante las tres lecturas que aparecen a continuación. +El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es la misma entrada JSON nativa del socio que `POST /v2/models/{provider}/{model}` acepta para este modelo -una sola forma de cuerpo, un esquema por modelo, dos modos de entrega-, pero esta ruta no mantiene la conexión para el resultado. Admite la ejecución, responde `201` con un identificador y quien llama recoge el resultado más tarde mediante las tres lecturas que aparecen abajo. **Parámetros** - Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`, es decir, el socio cuyo modelo se está ejecutando. + Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está ejecutando. Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, hasta 64 caracteres - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`, es decir, el modelo que se ejecutará dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecuta dentro de ese proveedor. Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, hasta 128 caracteres - Selecciona un proveedor alternativo para atender este modelo en lugar de su proveedor predeterminado actual. + Selecciona un proveedor alternativo para servir este modelo, en lugar de su valor predeterminado actual. @@ -471,11 +460,11 @@ El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es la mism Clave generada por quien llama que hace seguro reintentar una misma llamada lógica. - 1–255 caracteres + De 1 a 255 caracteres - Actívalo para rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declare, en lugar de aceptarlo; los campos anidados no se revisan, y no se rechaza nada en un modelo cuyo esquema permita campos no declarados o que no tenga esquema definido, ni en un envío en cola enviado con `strict_mode=true`. + Actívalo para rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declara, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada en un modelo cuyo esquema permite campos no declarados o que no tiene esquema definido, ni en un envío en cola hecho con `strict_mode=true`. Predeterminado: False @@ -484,81 +473,80 @@ El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es la mism `application/json` -- [`RouterModelInput`](#routermodelinput) (requerido) -La entrada JSON nativa del modelo asociado, idéntica al cuerpo que la ruta síncrona acepta para este modelo, y que selecciona la operación y se factura de la misma manera: los campos del propio cuerpo eligen qué operación ejecuta Router en un modelo que admite más de una (una imagen de entrada cambia un modelo de imagen editable a imagen a imagen, lo que puede facturarse con su propia tarifa; una imagen de primer fotograma de Seedance selecciona imagen a video, y una imagen o clip de referencia selecciona referencia a video). En el despacho nativo, una solicitud de Seedance se factura según los tipos de medio en `content`, no según los roles: cualquier entrada de video se factura como video a video; de lo contrario, cualquier imagen se factura como imagen a video; de lo contrario, texto a video; salvo que un render final a partir de un elemento `draft_task` se factura como la operación del Draft que renderiza, con algunos modelos cobrando la misma tarifa para texto a video e imagen a video; y con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. El mismo contrato de selección de proveedor se aplica en el despacho: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado), el cuerpo es el documento nativo del modelo y se valida contra el esquema de entrada propio del modelo antes de admitir la ejecución, por lo que un cuerpo que el modelo rechazaría es un `422` aquí en vez de una solicitud en cola que falla minutos después; además, un cuerpo no estricto de proveedor alternativo se traduce al esquema real de ese proveedor en el despacho. Con `strict_mode=true`, el cuerpo ya debe ser el esquema propio del proveedor alternativo y se reenvía sin cambios: la validación del esquema nativo se omite, exactamente como en la ruta síncrona (consulta `model_provider` y `strict_mode`). +La entrada JSON nativa del modelo del socio, idéntica al cuerpo que la ruta síncrona acepta para este modelo, y que selecciona la operación y se factura de la misma manera: los propios campos del cuerpo eligen qué operación ejecuta Router en un modelo que admite más de una (una imagen de entrada cambia un modelo de imagen editable a imagen a imagen, que puede facturarse a su propia tarifa; una imagen de primer fotograma de Seedance selecciona imagen a video y una imagen o un clip de referencia selecciona referencia a video). En el despacho nativo, una solicitud de Seedance se factura según los tipos de medio en `content`, no según los roles: cualquier entrada de video se factura como video a video; de lo contrario, cualquier imagen se factura como imagen a video; de lo contrario, texto a video, salvo que un render final a partir de un elemento `draft_task` se factura como la operación del Draft que renderiza, y algunos modelos cobran la misma tarifa para texto a video e imagen a video; con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse a la tarifa propia de ese proveedor. El mismo contrato de selección de proveedor se aplica en el despacho: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado), el cuerpo es el documento nativo del modelo y se valida contra el esquema de entrada propio del modelo antes de admitir la ejecución, así que un cuerpo que el modelo rechazaría es un `422` aquí en lugar de una solicitud en cola que falla minutos después; un cuerpo no estricto de proveedor alternativo además se traduce al esquema real de ese proveedor en el despacho. Con `strict_mode=true` el cuerpo ya debe ser el esquema propio del proveedor alternativo y se reenvía sin cambios: la validación del esquema nativo se omite, exactamente como en la ruta síncrona (consulta `model_provider` y `strict_mode`). **Respuestas** Created: la ejecución se admitió en la cola. - Cuerpo: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- Encabezados: `X-Comfy-Request-Id`, `Idempotent-Replayed` + Body: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- Headers: `X-Comfy-Request-Id`, `Idempotent-Replayed` Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Solicitud no válida. Revisa el tipo de error y el cuerpo de la solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` El cuerpo de la solicitud es demasiado grande. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo de nivel de solicitud de Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para quien llama ni para este modelo. Un modelo cuyo socio responde una generación directamente como bytes aún no se puede poner en cola y se rechaza con `not_enabled`; ejecútalo en la ruta síncrona en su lugar. + La solicitud no está permitida para quien llama ni para este modelo. Un modelo cuyo socio responde una generación directamente como bytes todavía no se puede poner en cola y se rechaza con `not_enabled`; ejecútalo en la ruta síncrona. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - No se encontró el ID de modelo. + No se encontró el ID del modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera el `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos de `invalid_input` en esta ruta no tienen nada que ver con la clave y ninguna clave nueva resuelve ninguno de los dos: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede servir, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya ha resuelto una credencial de tipo bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando es `concurrency_limit_exceeded`) +Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original aún se está ejecutando, así que espera `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos de `invalid_input` en esta ruta no tienen nada que ver con la clave y ninguna clave nueva los resuelve: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya ha resuelto una credencial BYOK para el proveedor en la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Elimina `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. + + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando `concurrency_limit_exceeded`) - El contenido de la solicitud se rechazó contra el esquema del modelo. + El contenido de la solicitud fue rechazado según el esquema del modelo. Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - Revisa `X-Comfy-Error-Type`: `queue_backlog_full` significa que ya tienes tantas solicitudes en cola sin terminar como se te permite, así que vuelve a enviar cuando una de ellas termine; `rate_limited` significa que debes esperar a la ventana de margen. + Inspecciona `X-Comfy-Error-Type`: `queue_backlog_full` significa que ya tienes tantas solicitudes en cola sin terminar como se te permite, así que envía de nuevo una vez que una de ellas termine; `rate_limited` significa que esperes la ventana de límite. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - El router no está disponible temporalmente. Reintenta con retroceso exponencial. - - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo para rechazos por capacidad) - + Router no está disponible temporalmente. Reintenta con retroceso exponencial. -### `GET /v2/models/{provider}/{model}/requests/{request_id}` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) +### `GET /v2/models/{provider}/{model}/requests/{request_id}` -**Recupera el resultado de una solicitud enviada.** +**Recoge el resultado de una solicitud enviada.** -El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, devuelve la salida nativa del modelo del socio, byte por byte lo que la ruta síncrona entrega en su `200` para el mismo modelo y la misma entrada, de modo que los dos modos de entrega producen una sola forma de resultado y un cliente puede pasar de uno a otro sin necesidad de un segundo analizador. +El endpoint de recolección. En una solicitud que ha finalizado correctamente, devuelve la salida nativa propia del modelo socio, byte por byte lo que el `200` de la ruta síncrona entrega para el mismo modelo y la misma entrada, de modo que los dos modos de entrega producen una sola forma de resultado y quien llama puede pasar de uno a otro sin un segundo parser. **Parámetros** @@ -569,13 +557,13 @@ El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, de - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecutará dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - La solicitud en cola a la que se dirige: el `request_id` que el envío devolvió en su cuerpo. + La solicitud en cola que se va a consultar: el `request_id` que el envío devolvió en su cuerpo. Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres @@ -583,13 +571,13 @@ El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, de **Respuestas** - OK: el resultado almacenado para una solicitud que produjo uno, una solicitud que se completó correctamente, o una terminal que lleva tanto un cargo registrado como un resultado almacenado, devuelto sin cambios bajo el tipo de medio propio del socio, exactamente como lo devuelve el `200` de la ruta síncrona, y bajo el mismo contrato de selección de proveedor que aceptó el envío: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, traducido de vuelta al contrato nativo de este modelo cuando sea posible, recurriendo a la respuesta sin procesar del propio proveedor alternativo cuando falle la traducción, registrado en el log, nunca de forma silenciosa), la forma es la salida nativa de este modelo; con `strict_mode=true`, es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde a una generación directamente como bytes, el cuerpo son esos bytes bajo el `Content-Type` del propio socio en lugar de `application/json`; decide según el `Content-Type` de la respuesta y no asumas que hay un documento JSON. + OK: el resultado almacenado para una solicitud que produjo uno, ya sea una solicitud que se completó correctamente o una terminal que lleva tanto un cargo registrado como un resultado almacenado, devuelto sin cambios bajo el tipo de medio propio del socio, exactamente como lo devuelve el `200` de la ruta síncrona, y bajo el mismo contrato de selección de proveedor que aceptó el envío: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, traducido de vuelta al contrato nativo de este modelo cuando es posible, y recurriendo a la respuesta sin procesar del proveedor alternativo si falla la traducción, lo que se registra en el log y nunca ocurre en silencio), la forma es la salida nativa propia de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. En un modelo cuyo socio responde a una generación directamente como bytes, el cuerpo son esos bytes bajo el `Content-Type` propio del socio en lugar de `application/json`; ramifica según el `Content-Type` de la respuesta y no supongas que se trata de un documento JSON. Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes sin procesar (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` - Aceptado: la solicitud aún no ha finalizado. + Aceptado: la solicitud no ha finalizado. Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After` @@ -601,71 +589,69 @@ El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, de - La solicitud no está permitida para este cliente ni para este modelo. + La solicitud no está permitida para este llamador ni para este modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - No se encontró el ID del modelo. + No se encontró el ID de modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router no está disponible temporalmente. Reintenta con un retroceso progresivo. + Router no está disponible temporalmente. Reintenta con retroceso exponencial. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud está en un estado que entra en conflicto con la operación. Comprueba el tipo de error. + La solicitud está en un estado que entra en conflicto con la operación. Revisa el tipo de error. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud superó un plazo límite. Comprueba el tipo de error antes de reintentar. + La solicitud superó un plazo límite. Revisa el tipo de error antes de reintentar. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - +### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` -### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` +**Solicita la cancelación de una solicitud enviada.** -**Solicitar la cancelación de una solicitud enviada.** - -Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una solicitud, no una garantía, y el `202` lo dice exactamente: `CANCELLATION_REQUESTED` significa que la petición fue aceptada, no que la ejecución se haya detenido. Una ejecución que ya está en curso en un socio puede completarse de todos modos, y una generación del socio que se completa se cobra, se haya recogido o no, así que quien llama y necesita saber qué pasó realmente consulta el endpoint de estado después, donde una cancelación que surtió efecto aparece como `COMPLETED` con un `error_type`, igual que cualquier otro resultado terminal. +Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una petición, no una garantía, y el `202` dice exactamente eso: `CANCELLATION_REQUESTED` significa que la petición se aceptó, no que la ejecución se haya detenido. Una ejecución que ya está en curso en un socio puede completarse de todos modos, y una generación del socio que se completa se cobra, sin importar si alguien la recogió, así que quien necesite saber qué ocurrió realmente consulta el endpoint de estado después, donde una cancelación que surtió efecto aparece como `COMPLETED` con un `error_type` igual que cualquier otro resultado terminal. **Parámetros** Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está ejecutando. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, Hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, hasta 64 caracteres Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, Hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, hasta 128 caracteres - La solicitud en cola que se va a atender: el `request_id` que el envío devolvió en su cuerpo. + La solicitud en cola a la que se dirige la acción: el `request_id` que devolvió el envío en su cuerpo. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres **Respuestas** @@ -695,7 +681,7 @@ Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una solicitud - La solicitud no está permitida para quien llama ni para este modelo. + La solicitud no está permitida para este solicitante o modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -707,88 +693,86 @@ Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una solicitud - Router no está disponible temporalmente. Reintenta con retroceso exponencial. + El Router no está disponible temporalmente. Reintenta con retroceso exponencial. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - - -### `GET /v2/models/{provider}/{model}/requests/{request_id}/status` +### `GET /v2/models/{provider}/{model}/requests/{request_id}/status` -**Lee el estado en la cola de una solicitud enviada.** +**Consulta el estado en cola de una solicitud enviada.** -El endpoint de sondeo. Responde con el estado actual de la solicitud y nunca con el resultado, así que un cliente puede seguir una generación larga sin transferir su salida en cada sondeo: el resultado se recoge una sola vez, desde la lectura de abajo, cuando este indica `COMPLETED`. +El endpoint de sondeo. Responde con el estado actual de la solicitud y nunca con el resultado, así un cliente puede seguir una generación larga sin transferir su salida en cada sondeo: el resultado se recoge una sola vez, con la lectura de abajo, cuando este indica `COMPLETED`. **Parámetros** Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está ejecutando. - Tipo: [`RouterProviderSegment`](#routerprovidersegment). Slug alfanumérico, por ejemplo `anthropic`. Hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecuta dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. - Tipo: [`RouterModelSegment`](#routermodelsegment). Slug alfanumérico, por ejemplo `claude-opus-4-6`. Hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - La solicitud en cola que se quiere consultar: el `request_id` que devolvió el envío en su cuerpo. + La solicitud en cola que se va a consultar: el `request_id` que la entrega devolvió en su cuerpo. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid). `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres **Respuestas** - OK: el estado actual de la solicitud en la cola. + OK: el estado actual en cola de la solicitud. - Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse). Encabezados: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` + Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Credits-Used`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para este solicitante o modelo. + La solicitud no está permitida para este llamador o modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - No se encontró el ID del modelo. + No se encontró el ID de modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por una razón que el propio modelo no reportó. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router no está disponible temporalmente. Reintenta con retroceso progresivo. + El Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por una razón que el propio modelo no reportó. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` -Las descripciones aquí son breves. Usa [Uso de la API de Comfy Router](/es/development/comfy-router/api) para la selección de modelos, la validación, los reintentos y la facturación, y [Encabezados](/es/development/comfy-router/headers) para el comportamiento de los encabezados. +Las descripciones aquí son breves. Consulta [Usar la API de Comfy Router](/es/development/comfy-router/api) para la selección de modelos, la validación, los reintentos y la facturación, y [Encabezados](/es/development/comfy-router/headers) para el comportamiento de los encabezados. ## Categorías de error @@ -796,16 +780,16 @@ Categoría de error del Router legible por máquina, que también se envía en e ### Categorías a nivel de solicitud -Se generan para una solicitud que el Router aceptó y luego no pudo completar. +Se generan cuando el Router aceptó una solicitud y después no pudo completarla. | `error_type` | Significado | | --- | --- | -| `invalid_input` | La solicitud se rechazó antes de llegar al modelo: un cuerpo mal formado, un cursor de paginación mal formado o vencido, una entrada que el propio esquema del modelo no acepta, o un `Idempotency-Key` que no puede servir a esta solicitud (ya usado para una solicitud diferente, porque el método, la ruta y los parámetros de consulta, o el cuerpo difieren, o ya consumido por una llamada cuya respuesta no se puede reproducir). | +| `invalid_input` | La solicitud se rechazó antes de llegar al modelo: un cuerpo mal formado, un cursor de paginación mal formado o vencido, una entrada que el propio esquema del modelo no acepta, o un `Idempotency-Key` que no puede servir a esta solicitud (ya usado para una solicitud diferente, porque difieren el método, la ruta y la consulta, o el cuerpo; o ya consumido por una llamada cuya respuesta no se puede reproducir). | | `content_policy_violation` | El proveedor rechazó la solicitud por motivos de política de contenido. | | `provider_error` | El proveedor socio informó un fallo propio, o devolvió una respuesta que Router no pudo interpretar como resultado. | | `provider_timeout` | El proveedor socio no respondió dentro de su plazo. | | `insufficient_credits` | El espacio de trabajo que llama no tiene créditos suficientes para ejecutar el modelo. | -| `model_not_found` | El ID `{provider}/{model}` no nombra ningún modelo que Router pueda ejecutar: un proveedor desconocido, un id no enrolado, uno que el catálogo ya retiró después de su fecha de retiro, o un ID catalogado que el proveedor no sirve actualmente para Comfy. | +| `model_not_found` | El ID `{provider}/{model}` no identifica ningún modelo que Router pueda ejecutar: un proveedor desconocido, un id no inscrito, uno que el catálogo ya retiró después de su fecha de retiro, o un ID catalogado que el proveedor no sirve actualmente para Comfy. | ### Categorías a nivel de transporte @@ -819,13 +803,14 @@ Las genera el propio Router, antes de la llamada al modelo o en torno a ella. | `client_disconnected` | Quien llama cerró la conexión antes de que Router pudiera devolver un resultado. | | `internal_error` | El propio Router falló. | | `deadline_exceeded` | Comfy dejó de mantener la conexión en su propio límite configurado antes de que llegara una respuesta. | -| `not_enabled` | Comfy Router aún no está habilitado para quien llama. | +| `not_enabled` | Comfy Router aún no está activado para quien llama. | | `service_unavailable` | Un servicio del que depende Comfy Router no está disponible temporalmente y quien llama no hizo nada mal. | | `rate_limited` | Quien llama agotó un cupo medido sobre una ventana y debe esperar a que esa ventana avance. | | `cancelled` | Una solicitud en cola se retiró (mediante la ruta de cancelación o por un operador) antes de producir un resultado; es terminal y no constituye por sí misma una declaración sobre el cobro. | | `queue_timeout` | Una solicitud en cola esperó más allá de su tiempo de espera en cola sin llegar a ser admitida. | | `request_not_found` | El `request_id` no identifica ninguna solicitud de quien llama con este modelo. | | `queue_backlog_full` | Quien llama ya tiene demasiadas solicitudes en cola esperando ejecutarse, por lo que este envío se rechazó. | +| `result_expired` | La solicitud existió y finalizó, pero su resultado ya no se almacena, así que la operación de recogida no tiene nada que devolver. | ## Encabezados de respuesta @@ -955,14 +940,15 @@ Las genera el propio Router, antes de la llamada al modelo o en torno a ella. ## Estimaciones de costos previas a la ejecución -`POST /v2/models/{provider}/{model}/estimate` tarifica un cuerpo sin ejecutarlo, y un envío en cola (`POST /v2/models/{provider}/{model}/requests`) devuelve el mismo [`RouterCostEstimate`](#routercostestimate) que `estimate` en su `201`. Ambos se calculan con la tarjeta de tarifas contra la que Comfy factura la ejecución. Cada cifra que devuelve cualquiera de los dos es una estimación, no el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. Comfy no factura una ejecución con tu propia clave de proveedor (ver abajo). Mientras la estimación se está implementando, la ruta responde `403` con `error_type: not_enabled` y la respuesta del envío omite `estimate`. El catálogo sigue sin mostrar precios. +`POST /v2/models/{provider}/{model}/estimate` tarifica un cuerpo sin ejecutarlo, y un envío en cola (`POST /v2/models/{provider}/{model}/requests`) devuelve el mismo [`RouterCostEstimate`](#routercostestimate) que `estimate` en su `201`. Ambos se tarifican con la tarjeta de tarifas contra la que Comfy factura la ejecución, excepto un modelo que se factura por el costo que reporta su proveedor, que se calcula como `estimated` a partir de la lista de precios publicada por el proveedor. Toda cifra que devuelve cualquiera de los dos es una estimación, no el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. Comfy no factura una ejecución hecha con tu propia clave de proveedor (ver abajo). Mientras la estimación se está implementando, la ruta responde `403` con `error_type: not_enabled` y la respuesta del envío omite `estimate`. El catálogo sigue sin mostrar precios. -Lee `source` antes de cualquier cantidad. Que falte una cifra nunca significa que sea gratis. +Lee `source` antes de cualquier cantidad. Una cifra faltante nunca significa que sea gratis. | `source` | Contiene | Cómo leerlo | | --- | --- | --- | | `exact` | `amount`, `amount_cents`, `credits` | Una estimación igual al cargo de este cuerpo con las tarifas de `pricing_as_of`; el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. | -| `estimated` | `min_amount`, `max_amount` y sus formas `_cents`, sin `amount` | Una estimación cuyo cargo depende de una cantidad que el proveedor reporta de vuelta y que el cuerpo acota; se espera que el cargo esté entre los límites, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. | +| `estimated` | `min_amount`, `max_amount` y sus formas `_cents`, sin `amount` | Una estimación cuyo cargo depende de una cantidad que el proveedor reporta de vuelta y que el cuerpo acota; se espera que el cargo esté entre esos límites, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. | +| `free` | `amount` "0", `amount_cents` y `credits` `0` | La tarjeta de tarifas valora esta solicitud en cero, así que la estimación es `0`; el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. Solo una cotización `free` se lee como `0`. | | `unknown` | `reason`, sin cifra | No se pudo dar un precio antes de la ejecución. Trata cualquier otro valor de `source` como `unknown`. | El `reason` de una estimación `unknown` es uno de los siguientes: @@ -982,12 +968,11 @@ Cuándo la estimación falla de forma segura: Límites de la estimación. Una cifra de `200` no garantiza que la ejecución se acepte ni que se cobre exactamente eso: -- `/estimate` no acepta `strict_mode` ni `reject_unknown_fields`, así que solo comprueba el contrato nativo del modelo: un cuerpo que una ejecución con `strict_mode=true` acepta en el esquema propio del proveedor alternativo puede recibir aquí un `422`, y aquí se calcula el precio de un campo de nivel superior no declarado que una ejecución con `reject_unknown_fields=true` rechazaría. -- `pricing_as_of` indica cuándo se obtuvo la tarjeta de tarifas (o, cuando no se leyó ninguna, cuándo se respondió la estimación). No es un bloqueo de precio: la ejecución se cobra con las tarifas vigentes cuando se tarifica. +- `/estimate` no acepta `strict_mode` ni `reject_unknown_fields`, así que solo comprueba el contrato nativo del modelo: un cuerpo que una ejecución con `strict_mode=true` acepta en el esquema propio del proveedor alternativo puede recibir aquí un `422`, y aquí se calcula el precio de un campo de nivel superior no declarado que una ejecución con `reject_unknown_fields=true` rechazaría. Un modelo de Anthropic Messages es la excepción: su esquema permite campos no declarados, así que una ejecución con `reject_unknown_fields=true` no rechaza ninguno, y la estimación solo calcula el precio de los campos de nivel superior no declarados `tools`, `tool_choice`, `temperature`, `top_p`, `top_k`, `stop_sequences`, `metadata`, `thinking` y un `mcp_servers` vacío. Cualquier otro campo de nivel superior no declarado hace que responda `unknown` con `reason: not_quotable`. +- `pricing_as_of` indica cuándo se obtuvo la tarjeta de tarifas. Una cotización `estimated` tomada de la lista de precios publicada por el proveedor lleva la fecha en que se leyó esa lista. Una cotización `exact` o `estimated` cuya cantidad facturada se predice a partir de un calendario publicado por el proveedor lleva la fecha de lectura de ese calendario cuando es anterior a la de la tarjeta. Cuando no se leyó ni la tarjeta ni un calendario, es el momento en que se respondió la estimación. No es un bloqueo de precio: la ejecución se cobra con las tarifas vigentes cuando se tarifica. - `/estimate` cotiza el tramo que indica `model_provider`, o el proveedor nativo. No acepta el parámetro `fallback_provider` ni `strict_mode`. Una ejecución síncrona cuyo reintento de respaldo recae en otro proveedor se cobra con la tarifa de ese proveedor, que la estimación no cotizó; `X-Comfy-Router-Fallback-Provider` en la respuesta de la ejecución indica que ocurrió. Un envío en cola no tiene respaldo, así que su `estimate` cotiza el tramo que se ejecuta. - `/estimate` y el `estimate` de un envío en cola pueden calcular el precio de documentos ligeramente distintos para el mismo cuerpo en un tramo de `model_provider`, o para un cuerpo que se ejecuta en una operación hermana. El `estimate` del envío se calcula sobre el documento que envía la ejecución. -- `/estimate` siempre cotiza el cargo de la plataforma. Comfy no factura una ejecución con tu propia clave de proveedor, pero `/estimate` no lo detecta y aun así devuelve una cifra; solo un envío en cola responde `reason: byok`. -- Los dólares se calculan a partir de centavos sin redondear, con hasta 8 decimales, y una `amount` cobrable inferior a un centavo nunca se muestra como `0`. `credits` es `round(amount × 211, 2)`, la misma conversión que `X-Comfy-Credits-Used` aplica a un cargo, así que `credits` puede redondearse a `0` para un precio muy pequeño distinto de cero; presupuesta con `amount` o `amount_cents`, no con `credits`, cuando eso importe. Ese encabezado sigue siendo la cifra a posteriori de una ejecución; los saldos están en la plataforma de Comfy. +- `/estimate` siempre cotiza el cargo de la plataforma. Comfy no factura una ejecución con tu propia clave de proveedor, pero `/estimate` no lo detecta y aun así devuelve una cifra; solo un envío en cola responde `reason: byok`.- Los dólares se muestran a partir de centavos sin redondear, con hasta 8 decimales, y una `amount` cobrable inferior a un centavo nunca se muestra como `0`. `credits` es `round(amount × 211, 2)`, la misma conversión que `X-Comfy-Credits-Used` aplica a un cargo, así que `credits` puede redondearse a `0` para un precio muy pequeño distinto de cero; cuando eso importe, presupuesta con `amount` o `amount_cents`, no con `credits`. Ese encabezado sigue siendo la cifra posterior a una ejecución; los saldos están en la plataforma de Comfy. ## Recursos del resultado @@ -1000,7 +985,7 @@ Un modelo puede devolver URL de recursos, bytes en línea o ambos. Los proveedor | `minimax/*` | el video finalizado | 12 horas | | `xai/*` | cada imagen generada, y el video finalizado | 24 horas | -Estos tiempos de vida empiezan cuando se firma la URL, no cuando la abres. Las URL en caché o de una llamada repetida pueden tener menos tiempo restante; repetir la llamada no las renueva. Descarga el recurso cuanto antes. Solo se copian los recursos indicados en cada fila: las imágenes `byteplus/seedream-*` y `byteplus/seededit-*` no están cubiertas por la fila de video de BytePlus. +Estos tiempos de vida empiezan cuando se firma la URL, no cuando la abres. Las URL en caché o de una llamada repetida pueden tener menos tiempo restante; repetirlas no las renueva. Un registro de `Idempotency-Key` puede sobrevivir a las URL que contiene, así que desde una hora antes de que expire una de esas URL, un reintento con la misma clave recibe `409 invalid_input` en lugar de la respuesta grabada; una respuesta que ya estaba tan cerca de expirar cuando se sirvió sigue siendo repetible durante 5 minutos. Descarga el recurso cuanto antes. Solo se copian los recursos indicados en cada fila: las imágenes `byteplus/seedream-*` y `byteplus/seededit-*` no están cubiertas por la fila de video de BytePlus. La copia la realiza únicamente el proveedor nativo del modelo. Una ejecución atendida por un proveedor alternativo (`model_provider` que nombre uno, o una ejecución nativa cuyo reintento de respaldo haya recaído en uno, indicado por `X-Comfy-Router-Fallback-Provider`) devuelve las URL propias de ese proveedor, que siguen la caducidad del proveedor y no se copian. Los valores `default`, `comfy` y `comfyui` de `model_provider` no nombran ningún proveedor alternativo, por lo que esas ejecuciones son nativas y se copian como se describe arriba, igual que una ejecución con `model_provider` cuyo reintento de respaldo haya vuelto a recaer en el proveedor nativo. @@ -1008,7 +993,9 @@ La copia la realiza únicamente el proveedor nativo del modelo. Una ejecución a Otros modelos devuelven referencias a recursos del proveedor o bytes en línea. Las URL del proveedor siguen la caducidad del proveedor, que puede ser mucho más corta que los tiempos de vida anteriores y no está especificada por el contrato del Router. -La copia se hace con el mejor esfuerzo en cada recurso. Si una copia falla, esa entrada conserva su referencia del proveedor; la respuesta puede contener tanto URL de Comfy como del proveedor, sin un campo explícito de estado de copia por recurso. La generación se completa igualmente y se cobra. No deduzcas el tiempo de vida de todas las URL a partir de un recurso realojado con éxito. +**URL originales de BytePlus (Seedance 2.x, opcional).** Para un espacio de trabajo en el que Comfy haya habilitado esta opción en el servidor, un resultado de Seedance 2.x también incluye las URL propias de BytePlus en `content.upstream_video_url` y `content.upstream_last_frame_url`, junto a las copiadas, además de `content.upstream_expires_at`. No hay ningún parámetro de solicitud y ningún espacio de trabajo está habilitado por defecto. Estas URL expiran 24 horas después de la generación y desaparecen una vez que BytePlus las borra; en Seedance 2.5, BytePlus limita cada una a 100 descargas, y la copia propia del Router consume una. Cada una es una credencial al portador para su objeto: cualquiera que la tenga puede descargar el recurso hasta que expire. + +La copia se realiza con el mejor esfuerzo en cada recurso. Si una copia falla, esa entrada conserva su referencia del proveedor; la respuesta puede contener tanto URL de Comfy como del proveedor, sin un campo explícito de estado de copia por recurso. La generación se completa igualmente y se cobra. No deduzcas el tiempo de vida de todas las URL a partir de un recurso realojado con éxito. Que un resultado esté alojado en Comfy también determina si más tarde aún es posible repetir una llamada completada desde su registro de `Idempotency-Key`; el parámetro `Idempotency-Key` de arriba indica qué recibe un reintento cuando no es posible. @@ -1018,22 +1005,36 @@ Que un resultado esté alojado en Comfy también determina si más tarde aún es Lee los campos de cada modelo desde `GET /v2/models/{provider}/{model}/openapi.json`. Esa llamada requiere una clave API. El mismo documento, para cada modelo con un esquema definido explícitamente, también se publica en este sitio sin clave, en `/router-schemas/{provider}/{model}.json`. Esa copia es una instantánea tomada en la última actualización de la documentación, así que el endpoint es la fuente autoritativa cuando hay diferencias. El `requestBody` de la operación describe la validación de la entrada; su respuesta `200` describe la forma de la salida y el tipo de medio cuando este está definido explícitamente. Cuando `x-comfy-input-schema-authored` es `false`, Router acepta cualquier objeto JSON sin prevalidación específica del modelo. Los requisitos del proveedor siguen aplicando. Los esquemas de salida describen resultados; Router no valida contra ellos las cargas útiles que devuelve el proveedor. Una salida sin esquema definido explícitamente puede usar `*/*` en lugar de `application/json`; revisa el tipo de contenido de la respuesta antes de decodificarla. -## Esquemas +## Esquema -### RouterChargesOnPolicyRejection +### RouterBilledWorkspace -Indica si un rechazo por política de contenido se cobra en este modelo. Trata un valor desconocido como potencialmente cobrado. +La cartera a la que se habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a «¿qué cartera está vacía?»: no es necesariamente el espacio de trabajo que la interfaz de quien llama tiene seleccionado en este momento, y la credencial personal de un miembro del equipo indica aquí su cartera personal incluso mientras hay un equipo con fondos abierto. Solo aparece junto con `denied_reason`. -Tipo: `string` +**Campos** -### RouterCostEstimate + + El id del espacio de trabajo de Cloud. No aparece en la vía Clásica. + -Una estimación previa de cuánto costará esta llamada, en dólares estadounidenses, calculada antes del despacho a partir de la misma tabla de tarifas con la que se factura la ejecución. No es el cargo final: el cargo que pagas es el liquidado en los registros de uso y facturación de tu espacio de trabajo. `X-Comfy-Credits-Used`, que se informa después de la ejecución, es una cifra redondeada calculada a posteriori, no un recibo. `source` indica cuánto puedes confiar en el número: `exact` incluye `amount`; `estimated` incluye `min_amount` y `max_amount` y ningún `amount`; `unknown` no incluye ninguno de los dos y sí un `reason`. Nunca interpretes un `amount` ausente como gratis. No es un bloqueo de precio: consulta `pricing_as_of`. + + `personal` o `team`. Es una cadena abierta: trata cualquier otro valor como `personal`. + + + + `legacy` cuando la llamada factura al cliente de Metronome anterior a los espacios de trabajo de quien llama en lugar de a un espacio de trabajo de Cloud; ese cliente no tiene id de espacio de trabajo. No aparece en el caso de un espacio de trabajo de Cloud. +### RouterChargesOnPolicyRejection + +Indica si se cobra por un rechazo por política de contenido en este modelo. Trata un valor desconocido como potencialmente cobrado. + +Tipo: `string`### RouterCostEstimate + +Una estimación previa de lo que costará esta llamada, en dólares estadounidenses, calculada antes del despacho a partir de la misma tarjeta de tarifas con la que se factura la ejecución (o, en el caso de un modelo que se factura según el costo que reporta su proveedor, estimada a partir de la lista de precios publicada por el proveedor). No es el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es lo que pagas. `X-Comfy-Credits-Used`, que se reporta después de la ejecución, es una cifra redondeada calculada a posteriori, no un recibo. `source` indica cuánto puedes confiar en la cifra: `exact` incluye `amount`; `free` incluye `amount` "0" (la tarjeta de tarifas fija el precio de esta solicitud en cero); `estimated` incluye `min_amount` y `max_amount`, y ningún `amount`; `unknown` no incluye ninguno de los dos, sino un `reason`. Nunca interpretes un `amount` ausente como gratis. No es un bloqueo de precio: consulta `pricing_as_of`. **Campos** - `exact` | `estimated` | `unknown`; interpreta cualquier otro valor como `unknown`. Tanto `exact` como `estimated` etiquetan una estimación; ninguno es el cargo final. `unknown` no incluye ninguna cifra. + `exact` | `estimated` | `free` | `unknown`; interpreta cualquier otro valor como `unknown`. `exact` y `estimated` identifican una estimación; ninguno es el cargo final. `free` significa que la tarjeta de tarifas fija el precio de esta solicitud en cero, por lo que `amount` es "0". `unknown` no incluye ninguna cifra. @@ -1041,37 +1042,37 @@ Una estimación previa de cuánto costará esta llamada, en dólares estadounide - El costo estimado en dólares como cadena decimal, por ejemplo "0.04", con hasta 8 decimales y sin exponente. Un precio inferior a un centavo que sí se cobra nunca se representa como "0". Presente solo cuando `source` es `exact`. No es el cargo final: lo es el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo. + El costo estimado en dólares como una cadena decimal, p. ej., "0.04", con hasta 8 decimales y sin exponente. Un precio facturable inferior a un centavo nunca aparece como "0"; solo una cotización `free` se lee como "0". Solo está presente cuando `source` es `exact` o `free`. No es el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. - El extremo inferior de la estimación en dólares como cadena decimal. Es una estimación, no un mínimo garantizado: una llamada puede facturarse menos, por ejemplo cuando el proveedor devuelve menos de lo que pedía la solicitud (como ninguna imagen), cuando la estimación es un precio típico aprendido de llamadas anteriores, o cuando el precio no sube de forma constante con la cantidad solicitada. Presente solo cuando `source` es `estimated`. + El extremo inferior de la estimación en dólares como una cadena decimal. Es una estimación, no un mínimo garantizado: una llamada puede generar un cargo menor, por ejemplo, cuando el proveedor devuelve menos de lo solicitado (como ninguna imagen), cuando la estimación es un precio típico aprendido de llamadas anteriores o cuando el precio no aumenta de forma constante con la cantidad solicitada. Solo está presente cuando `source` es `estimated`. - El extremo superior de la estimación en dólares como cadena decimal. Es una estimación, no un máximo garantizado: una llamada puede facturarse más, por ejemplo cuando el proveedor devuelve más de lo pedido (como más imágenes de las solicitadas), cuando la estimación se aprende de llamadas anteriores, o cuando el precio no sube de forma constante con la cantidad solicitada. Presente solo cuando `source` es `estimated`. + El extremo superior de la estimación en dólares como una cadena decimal. Es una estimación, no un máximo garantizado: una llamada puede generar un cargo mayor, por ejemplo, cuando el proveedor devuelve más de lo solicitado (como más imágenes de las pedidas), cuando la estimación proviene de un aprendizaje de llamadas anteriores o cuando el precio no aumenta de forma constante con la cantidad solicitada. Solo está presente cuando `source` es `estimated`. - La misma cifra en centavos de dólar, sin redondear, para operaciones aritméticas. Presente junto con `amount`. + La misma cifra en centavos de USD, sin redondear, para cálculos aritméticos. Está presente junto con `amount`. double - `min_amount` en centavos de dólar, sin redondear. Presente junto con `min_amount`. + `min_amount` en centavos de USD, sin redondear. Está presente junto con `min_amount`. double - `max_amount` en centavos de dólar. Presente junto con `max_amount`. + `max_amount` en centavos de USD. Está presente junto con `max_amount`. double - `amount` en créditos de Comfy usando la conversión de la plataforma ($1 = 211 créditos), redondeado a 2 decimales: la cifra que se espera que lleve `X-Comfy-Credits-Used` para una cotización `exact`. Ese encabezado es una cifra redondeada calculada a posteriori, no un recibo; el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. + `amount` en créditos de Comfy usando la conversión de la plataforma ($1 = 211 créditos), redondeado a 2 decimales: la cifra que se espera que `X-Comfy-Credits-Used` contenga para una cotización `exact`. Ese encabezado es una cifra redondeada calculada a posteriori, no un recibo; el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. double @@ -1081,72 +1082,76 @@ Una estimación previa de cuánto costará esta llamada, en dólares estadounide - Un ID de modelo canónico de Comfy Router, `{provider}/{model}`, exactamente el valor que direcciona el modelo en `POST /v2/models/{provider}/{model}`, de modo que quien llama pueda interpolarlo en esa ruta sin volver a derivarlo de nada. Su `pattern` es `RouterProviderSegment` y `RouterModelSegment` unidos por un solo `/`, y `maxLength` es su suma más ese separador. + Un ID de modelo canónico de Comfy Router, `{provider}/{model}`, exactamente el valor que direcciona el modelo en `POST /v2/models/{provider}/{model}`, de modo que quien llama pueda interpolarlo en esa ruta sin volver a derivarlo de nada. Su `pattern` está formado por `RouterProviderSegment` y `RouterModelSegment` unidos por una sola `/`, y `maxLength` es su suma más ese separador. - Tipo: [`RouterModelId`](#routermodelid) -- ID de modelo, por ejemplo `anthropic/claude-opus-4-6`, hasta 193 caracteres + Tipo: [`RouterModelId`](#routermodelid): ID de modelo, p. ej. `anthropic/claude-opus-4-6`, hasta 193 caracteres - Cuándo se obtuvo la tabla de tarifas con la que se calculó esta cotización. La estimación no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifica, no en este instante. Siempre que no se leyó ninguna tabla de tarifas (`reason: pricing_unavailable`, `byok`, o una llamada `not_quotable` que no puede cotizarse con ninguna tabla), esto es el momento en que se respondió la cotización. + Cuándo se obtuvo la tarjeta de tarifas con la que se calculó el precio de esta cotización. La estimación no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifica, no en este instante. Una cotización `estimated` tomada de la lista de precios publicada por el proveedor (un modelo facturado según el costo que reporta su proveedor) lleva en su lugar la fecha en que se leyó esa lista. Una cotización cuya cantidad facturada se predice a partir de un calendario publicado por el proveedor y luego se tarifica con la tarjeta de tarifas lleva la más antigua entre la fecha de lectura de ese calendario y la hora de obtención de la tarjeta, tanto para una respuesta `exact` como para una `estimated` (un modelo facturado según los créditos que reporta su proveedor es el caso `estimated`). Siempre que no se haya leído ninguna tarjeta de tarifas (`reason: pricing_unavailable`, `byok` o una llamada `not_quotable` que no se pueda tarificar con ninguna tarjeta), este valor es el momento en que se respondió la cotización. date-time - Presente solo cuando `source` es `unknown`: `not_quotable` (el Router no puede poner precio a esta llamada antes de que se ejecute: su precio depende de lo que el proveedor informe de vuelta, o el cuerpo no delimita una cantidad facturable), `unpriced_model` (la tabla de tarifas no da precio a esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella), o `pricing_unavailable` (solo envío en cola: no se pudo leer la tabla de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se cobra igual que siempre). Interpreta cualquier otro valor como `not_quotable`. - - -### RouterErrorResponse + Solo está presente cuando `source` es `unknown`: `not_quotable` (Router no puede calcular el precio de esta llamada antes de que se ejecute: su precio depende de lo que reporte el proveedor, o el cuerpo no acota una cantidad facturable), `unpriced_model` (la tarjeta de tarifas no asigna un precio a esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella) o `pricing_unavailable` (solo envío en cola: no se pudo leer la tarjeta de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se sigue cobrando como de costumbre). Interpreta cualquier otro valor como `not_quotable`. +### RouterErrorResponse -Cuerpo de error para fallos de autenticación, acceso, búsqueda de modelos, cuota y transporte del proveedor. +Cuerpo de error para fallos de autenticación, acceso, búsqueda de modelo, cuota y transporte del proveedor. **Campos** - Descripción legible del fallo, apta para mostrarse a un usuario final. No se analiza automáticamente: en su lugar, ramifica según `error_type`. Para `model_not_found` en un modelo retirado, `detail` contiene ` was retired on ; use ` cuando hay un sucesor registrado y visible para quien llama, o solo ` was retired on ` cuando no lo hay, en lugar de la lista de sugerencias habitual. Un sucesor nombrado aquí es siempre un ID de catálogo vigente al que se puede redirigir la llamada. Un modelo cuya fecha de retiro todavía está en el futuro no está retirado: sigue apareciendo en `GET /v2/models` y se puede ejecutar hasta esa fecha. Como el resto de `detail`, este texto de retiro es solo para mostrar y no conlleva ninguna garantía de compatibilidad. Dos excepciones documentadas a la regla de no analizar automáticamente: en `POST /v2/models/{provider}/{model}` el `409` responde a tres condiciones no relacionadas que comparten el grupo `invalid_input`, y solo `detail` las distingue: un `detail` que empieza por "this request's `image` selects the edit operation" es el rechazo multipart de `model_provider`, y un `detail` que empieza por `this request resolved a BYOK credential` es el rechazo BYOK de `model_provider`; ninguno se resuelve con una nueva `Idempotency-Key`. Cualquier otro `409` de `invalid_input` en esa ruta es el conflicto de clave. Ambos prefijos son términos de contrato estables y se pueden comparar. En ningún otro caso ramificar según `detail` conlleva una garantía de compatibilidad. + Descripción legible por humanos del fallo, apta para mostrarse a un usuario final. No está pensada para análisis automático: ramifica según `error_type` en su lugar. Para `model_not_found` en un modelo retirado, `detail` dice ` was retired on ; use ` cuando hay un sucesor registrado y visible para quien llama, o solo ` was retired on ` cuando no lo hay, en lugar de la lista de sugerencias habitual. Un sucesor nombrado aquí es siempre un ID de catálogo activo al que se puede redirigir la llamada. Un modelo cuya fecha de fin de soporte aún está en el futuro no está retirado: sigue apareciendo en `GET /v2/models` y se puede ejecutar hasta esa fecha. Como el resto de `detail`, este texto de retirada es solo para mostrar y no conlleva ninguna garantía de compatibilidad. Dos excepciones documentadas a la regla de no analizar automáticamente: en `POST /v2/models/{provider}/{model}` el `409` responde a tres condiciones no relacionadas que comparten la categoría `invalid_input`, y solo `detail` las distingue: un `detail` que empieza por "this request's `image` selects the edit operation" es el rechazo multipart de `model_provider`, y un `detail` que empieza por `this request resolved a BYOK credential` es el rechazo BYOK de `model_provider`; ninguno se resuelve con un nuevo `Idempotency-Key`. Cualquier otro `409` de `invalid_input` en esa ruta es el conflicto de clave. Ambos prefijos son términos de contrato estables y se pueden comparar. En ningún otro caso ramificar según `detail` conlleva una garantía de compatibilidad. - Grupo amplio y legible por máquina para un fallo del Router, replicado en el encabezado de respuesta `X-Comfy-Error-Type` para que quien llama pueda ramificar sin analizar el cuerpo. El conjunto está cerrado en diecinueve valores: los seis grupos de nivel de solicitud `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits` y `model_not_found`, más los de nivel de transporte `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found` y `queue_backlog_full`. «Cerrado» describe el conjunto tal como se documenta hoy, no un límite que se mantenga para siempre: se espera que el conjunto crezca, y por eso esto es deliberadamente una cadena simple y no un `enum`, de modo que un cliente debe tratar cualquier valor no reconocido como `internal_error` en lugar de hacer un switch exhaustivo sobre la lista anterior y romperse con la próxima adición. + Categoría gruesa y legible por máquina para un fallo del Router, replicada en el encabezado de respuesta `X-Comfy-Error-Type` para que quien llama pueda ramificar sin analizar el cuerpo. El conjunto es cerrado y tiene veinte valores: las seis categorías de nivel de solicitud `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits` y `model_not_found`, más las de nivel de transporte `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full` y `result_expired`. Que sea cerrado describe el conjunto tal como está documentado hoy, no un límite que se mantenga para siempre: se espera que el conjunto crezca, y por eso esto es deliberadamente una cadena simple y no un `enum`, de modo que un cliente debe tratar cualquier valor no reconocido como `internal_error` en lugar de ramificar de forma exhaustiva sobre la lista anterior y romperse con la siguiente adición. Tipo: [`RouterErrorType`](#routererrortype) - Motivo acotado y saneado que dio el proveedor del modelo para rechazar la solicitud; solo está presente cuando `error_type` es `invalid_input` y `X-Comfy-Upstream-Status` es un `4xx` o `2xx` del proveedor, es decir, el proveedor rechazó la solicitud por malformada y explicó por qué. Normalmente ese estado es un `4xx`; es un `2xx` para un proveedor que informa de una generación rechazada dentro de una envoltura de éxito (una consulta de tarea fallida de BytePlus es HTTP `200` con el motivo en su cuerpo). Está ausente en cualquier otro fallo, incluidos los `5xx` del proveedor, los fallos de transporte, los rechazos por políticas de contenido y cualquier rechazo que el Router haya generado sobre sí mismo. Replica el encabezado `X-Comfy-Upstream-Detail`. + Un motivo acotado y saneado que dio el proveedor del modelo para rechazar la solicitud; solo está presente cuando `error_type` es `invalid_input` y `X-Comfy-Upstream-Status` es un `4xx` o un `2xx` del proveedor, es decir, cuando el proveedor rechazó la solicitud por malformada y explicó por qué. Normalmente ese estado es un `4xx`; es un `2xx` en un proveedor que informa de una generación rechazada dentro de un sobre de éxito (una consulta de tarea fallida de BytePlus es HTTP `200` con el motivo en el cuerpo). Está ausente en cualquier otro fallo, incluidos los `5xx` del proveedor, los fallos de transporte, los rechazos por políticas de contenido y cualquier rechazo que el Router emita sobre sí mismo. Replica el encabezado `X-Comfy-Upstream-Detail`. - Sobre qué entrada o salida se produjo un rechazo por políticas de contenido, como vocabulario cerrado a nivel del Router: `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`. Los valores simples `input` / `output` indican el lado cuando el proveedor no especificó una modalidad. Solo está presente cuando `error_type` es `content_policy_violation` y el proveedor indicó el sujeto rechazado con un código legible por máquina; en caso contrario, está ausente. Nunca es texto del proveedor. Hoy se rellena para rechazos de BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI y Wan, y para los rechazos de Gemini de las vertientes Nano Banana del Router de MiniMax; un proveedor cuyo rechazo no indica de qué lado se trataba lo deja ausente. Replica el encabezado `X-Comfy-Refusal-Subject`. + Sobre qué entrada o salida versaba un rechazo por políticas de contenido, como vocabulario cerrado a nivel del Router: `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`. Los valores simples `input` / `output` indican el lado cuando el proveedor no nombró una modalidad. Solo está presente cuando `error_type` es `content_policy_violation` y el proveedor nombró el sujeto rechazado con un código legible por máquina; en caso contrario, está ausente. Nunca es texto del proveedor. Hoy se nombra en los rechazos de BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI y Wan, y en los rechazos de Gemini de los tramos Nano Banana del Router de MiniMax; un proveedor cuyo rechazo no indica de qué lado se trataba lo deja ausente. Replica el encabezado `X-Comfy-Refusal-Subject`. -### RouterErrorType + + La rama de política de facturación para una denegación de gasto en un nodo socio: `no_funds` cuando la cartera facturada está vacía, `unspecified` cuando la llamada se rechazó sin una lectura de fondos que lo indique. Solo está presente cuando `error_type` es `insufficient_credits` y el despliegue informa de datos de la cartera; en caso contrario, está ausente. Es un código legible por máquina, no texto para mostrar: muestra `detail` y ramifica según este campo. + -Categoría de error del Router legible por máquina, que también se envía en el encabezado `X-Comfy-Error-Type`. + + La cartera que habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a la pregunta ¿qué cartera está vacía?: no es necesariamente el espacio de trabajo que la interfaz de quien llama tiene seleccionado en ese momento, y la credencial personal de un miembro del equipo nombra aquí su cartera personal incluso mientras hay un equipo con fondos abierto. Solo está presente junto con `denied_reason`. -Tipo: `string` + Tipo: [`RouterBilledWorkspace`](#routerbilledworkspace) + -### RouterModelBilling + + Cómo se autenticó la solicitud rechazada: `personal_api_key`, `team_api_key`, `personal_session` o `team_session`. Responde a la pregunta ¿a qué credencial cambio para cobrar a la otra cartera?. No es un permiso y no concede nada. Solo está presente junto con `denied_reason`. +### RouterErrorType + +Categoría de error del Router legible por máquina, que también se envía en el encabezado `X-Comfy-Error-Type`. + +Tipo: `string`### RouterModelBilling Comportamiento de facturación que debes revisar antes de invocar un modelo. No incluye precios ni uso. **Campos** - Si una llamada que este modelo rechaza por motivos de política de contenido se cobra de todos modos a quien realiza la llamada. Los proveedores difieren, la diferencia es invisible en el momento de la llamada, y un usuario que ve un error y un cargo por la misma llamada no tendría forma de saberlo, así que se indica por modelo, antes de la llamada, en lugar de dejarlo a la tradición de cada proveedor. + Si una llamada que este modelo rechaza por motivos de política de contenido se cobra de todos modos al solicitante. Los proveedores difieren, la diferencia es invisible en el momento de la llamada, y un usuario que ve un error y un cargo por la misma llamada no tiene forma de haberlo sabido. Por eso se indica por modelo, antes de la llamada, en lugar de dejarlo a la tradición de cada proveedor. Cuando es `yes`, un error `content_policy_violation` en la ruta síncrona puede incluir `X-Comfy-Credits-Used`: lo incluye cuando el proveedor rechazó la salida generada del modelo y Comfy registró uso para esa generación rechazada, e incluye esa cantidad. Un rechazo del lado de la entrada, una repetición con la misma clave (`Idempotent-Replayed: true`) y un cargo demasiado pequeño para mostrarse en los dos decimales del encabezado no lo incluyen; un rechazo sin el encabezado no se reporta, lo que no es prueba de que haya sido gratis. Tipo: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) - - -### RouterModelDetail - -Detalle por modelo de un modelo de Comfy Router: todo lo que el listado del catálogo reporta para ese modelo, más los campos por modelo que solo incluye la ruta de modelo único. +### RouterModelDetail -Combina [`RouterModelListEntry`](#routermodellistentry) y [`RouterModelDetailFields`](#routermodeldetailfields). +Detalle por modelo de un modelo de Comfy Router: todo lo que informa el listado del catálogo para ese modelo, más los campos por modelo que solo incluye la ruta de modelo único. -Tipo: `object` +Compone [`RouterModelListEntry`](#routermodellistentry), [`RouterModelDetailFields`](#routermodeldetailfields). -### RouterModelDetailFields +Tipo: `object`### RouterModelDetailFields Campos opcionales que devuelve el endpoint de detalles del modelo. @@ -1155,64 +1160,54 @@ Campos opcionales que devuelve el endpoint de detalles del modelo. URL del documento OpenAPI de este modelo, incluidos sus esquemas de entrada y salida. - URL HTTPS, por ejemplo, `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`, hasta 2048 caracteres - - -### RouterModelId - -El ID del modelo que se usa en `POST /v2/models/{provider}/{model}`. + URL HTTPS, p. ej. `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`, hasta 2048 caracteres +### RouterModelId -Tipo: `string`. ID del modelo, p. ej. `anthropic/claude-opus-4-6`. Hasta 193 caracteres. +El ID de modelo que se usa en `POST /v2/models/{provider}/{model}`. -### RouterModelInput +Tipo: `string`. ID de modelo, por ejemplo `anthropic/claude-opus-4-6`. Hasta 193 caracteres.### RouterModelInput El objeto de entrada del modelo. Consulta el documento OpenAPI del modelo seleccionado para ver los campos y la validación. -Tipo: `object` - -### RouterModelInputSchemaDocument +Tipo: `object`### RouterModelInputSchemaDocument Un documento OpenAPI independiente para la entrada y la salida de un modelo. -Tipo: `object` - -### RouterModelListEntry +Tipo: `object`### RouterModelListEntry El ID de un modelo y sus datos de facturación. **Campos** - Un ID de modelo canónico de Comfy Router, `{provider}/{model}`: exactamente el valor que direcciona el modelo en `POST /v2/models/{provider}/{model}`, así que quien llama puede interpolarlo en esa ruta sin volver a derivarlo de otra cosa. Su `pattern` es `RouterProviderSegment` y `RouterModelSegment` unidos por un solo `/`, y `maxLength` es su suma más ese separador. + Un ID de modelo canónico de Comfy Router, `{provider}/{model}`, exactamente el valor que direcciona el modelo en `POST /v2/models/{provider}/{model}`, de modo que quien llama puede interpolarlo en esa ruta sin volver a derivarlo de nada. Su `pattern` es `RouterProviderSegment` y `RouterModelSegment` unidos por una sola `/`, y `maxLength` es la suma de ambos más ese separador. Tipo: [`RouterModelId`](#routermodelid) -- ID de modelo, p. ej. `anthropic/claude-opus-4-6`, hasta 193 caracteres - Segmento `provider` en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está direccionando. El parámetro de ruta `provider` de la ruta de invocación y el campo `provider` de una entrada de catálogo hacen referencia a este mismo esquema, y eso es lo que evita que los IDs listados y los IDs aceptados se separen con el tiempo. + Segmento `provider` en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está direccionando. El parámetro de ruta `provider` de la ruta de invocación y el campo `provider` de una entrada del catálogo hacen referencia a este mismo esquema, y eso es lo que evita que los ID listados y los ID aceptados se desalineen. Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - Segmento `model` en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. Lo comparten el parámetro de ruta `model` de la ruta de invocación y el campo `model` de una entrada de catálogo, por la misma razón de evitar divergencias que en `RouterProviderSegment`. + Segmento `model` en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. Lo comparten el parámetro de ruta `model` de la ruta de invocación y el campo `model` de una entrada del catálogo, por la misma razón de evitar desalineaciones que en `RouterProviderSegment`. Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - Datos de facturación por modelo que quien llama necesita antes de invocar, no precios. Las cifras de uso y de costo nunca aparecen aquí. + Datos de facturación por modelo que quien llama necesita antes de invocar; no son precios. Las cifras de uso y costo nunca aparecen aquí. Tipo: [`RouterModelBilling`](#routermodelbilling) - El `ETag` fuerte actual del documento `GET /v2/models/{provider}/{model}/openapi.json` de este modelo. Envíalo como `If-None-Match` en esa lectura para obtener un `304` mientras el esquema no cambie, o compáralo con el valor visto la última vez para saber qué esquemas de modelos cambiaron sin descargar todos los documentos. Está ausente siempre que esa lectura no vaya a responder `200` para quien llama en este momento: el servicio de esquemas no está disponible, el documento del modelo no se puede renderizar, o el modelo dejó de estar disponible para quien llama mientras se construía la respuesta. Una etiqueta ausente no es un cambio de esquema; vuelve a leer el documento del modelo para conocer su etiqueta actual. - - -### RouterModelListResponse + El `ETag` fuerte actual del documento `GET /v2/models/{provider}/{model}/openapi.json` de este modelo. Envíalo como `If-None-Match` en esa lectura para obtener un `304` mientras el esquema no cambie, o compáralo con el valor visto la última vez para saber qué esquemas de modelos cambiaron sin descargar todos los documentos. Está ausente siempre que esa lectura no vaya a responder `200` a quien llama en este momento: el servicio de esquemas no está disponible, el documento del modelo no se puede renderizar, o el modelo dejó de estar disponible para quien llama mientras se construía la respuesta. Una etiqueta ausente no es un cambio de esquema; vuelve a leer el documento del modelo para conocer su etiqueta actual. +### RouterModelListResponse -Una página del catálogo de modelos del Router. +Una página del catálogo de modelos de Router. **Campos** @@ -1223,101 +1218,81 @@ Una página del catálogo de modelos del Router. - Indica si existe otra página después de esta. Sigue avanzando mientras sea verdadero; no deduzcas el final del catálogo a partir de un `data` corto o vacío. + Indica si existe otra página más allá de esta. Sigue avanzando mientras esto sea verdadero; no infieras el final del catálogo a partir de un `data` corto o vacío. - Un cursor opaco hacia una lista del Router. Lo produce el servidor y solo se reenvía tal cual: no es un offset, no es un ID de modelo, no está ordenado y no es estable entre reconstrucciones del catálogo, así que analizarlo, incrementarlo o persistirlo más allá del recorrido del que proviene queda fuera del contrato. Se usa un cursor en lugar de un offset porque el catálogo es una lista cambiante: un recorrido por offset omite o repite entradas de forma silenciosa cuando se agregan o quitan entradas a mitad del recorrido, y quien llama no puede detectar que eso ocurrió. + Un cursor opaco hacia una lista de Router. Lo produce el servidor y solo se usa de ida y vuelta: no es un offset, no es un ID de modelo, no está ordenado y no es estable entre reconstrucciones del catálogo, por lo que analizarlo, incrementarlo o persistirlo más allá del recorrido del que proviene quedan fuera del contrato. Se usa un cursor en lugar de un offset porque el catálogo es una lista cambiante: un recorrido por offset omite o repite entradas de forma silenciosa cuando se agregan o eliminan entradas a mitad del recorrido, y quien llama no puede saber que eso ocurrió. - Tipo: [`RouterPageCursor`](#routerpagecursor) -- Cursor opaco devuelto como `next_cursor`, de 1 a 512 caracteres + Tipo: [`RouterPageCursor`](#routerpagecursor): cursor opaco devuelto como `next_cursor`, de 1–512 caracteres - El tamaño de página que realmente se entregó. Un `limit` solicitado por encima del máximo se ajusta al máximo en lugar de rechazarse, así que puede ser menor que el valor pedido: pagina con este número, no con el que enviaste, o supondrás filas que nunca recibiste. + El tamaño de página que realmente se entregó. Un `limit` solicitado por encima del máximo se ajusta al máximo en lugar de rechazarse, por lo que este puede ser menor que el valor solicitado: pagina con este número, no con el que enviaste, o asumirás filas que nunca recibiste. 1–100 - - -### RouterModelOutput +### RouterModelOutput El objeto de resultado del modelo. Consulta el esquema de salida del modelo seleccionado para conocer su forma exacta. -Tipo: `object` - -### RouterModelSegment +Tipo: `object`### RouterModelSegment -La parte del modelo de un ID de modelo `{provider}/{model}`. +La parte correspondiente al modelo en un ID de modelo `{provider}/{model}`. -Tipo: `string`. Slug alfanumérico, p. ej. `claude-opus-4-6`, de hasta 128 caracteres +Tipo: `string`. Slug alfanumérico, p. ej. `claude-opus-4-6`, de hasta 128 caracteres### RouterPageCursor -### RouterPageCursor +Un cursor opaco de catálogo. Devuélvelo sin cambios como `cursor`. -Un cursor de catálogo opaco. Devuélvelo sin cambios como `cursor`. +Tipo: `string`: cursor opaco devuelto como `next_cursor`, de 1 a 512 caracteres### RouterProviderSegment -Tipo: `string`. Cursor opaco devuelto como `next_cursor`, de 1 a 512 caracteres. +La parte de proveedor de un ID de modelo `{provider}/{model}`. -### RouterProviderSegment +Tipo: `string` -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres### RouterQueueCancelResponse -La parte del proveedor de un ID de modelo `{provider}/{model}`. - -Tipo: `string`: slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - -### RouterQueueCancelResponse - -La respuesta a una solicitud de cancelación en los dos estados que describen una solicitud que esta ruta resolvió: el `202` y el `409`. Una sola forma de cuerpo para ambos en lugar de un envelope de éxito más un envelope de error, porque ambos son la misma afirmación (lo que encontró la cancelación) y un cliente que tiene que analizar un tipo distinto por código de estado no gana nada con la separación. +La respuesta a una pregunta de cancelación en los dos estados que describen una solicitud que esta ruta resolvió: el `202` y el `409`. Una sola forma de cuerpo para ambos en lugar de un sobre de éxito más un sobre de error, porque ambos son la misma declaración (lo que encontró la cancelación), y un cliente que tiene que analizar un tipo distinto por código de estado no gana nada con la separación. **Campos** - Identificador de una solicitud de Router en cola: el identificador por el que un cliente consulta, cancela y recoge un resultado. + Identificador de una solicitud de Router en cola: el identificador con el que quien llama consulta, cancela y recoge un resultado. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid). `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres - Lo que encontró una solicitud de cancelación, para los dos resultados que describen una solicitud que esta ruta efectivamente resolvió. Ambos se reflejan en el estado HTTP, así que un cliente puede ramificar según cualquiera de los dos. + Lo que encontró una pregunta de cancelación, para los dos resultados que describen una solicitud que esta ruta resolvió realmente. El estado HTTP refleja ambos, así que un cliente puede ramificar según cualquiera de los dos. Tipo: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) - - -### RouterQueueCancelStatus - -Qué encontró una solicitud de cancelación, para los dos resultados que describen una solicitud que esta ruta realmente resolvió. Ambos se reflejan en el estado HTTP, así que un cliente puede ramificar según cualquiera de los dos. - -Tipo: `string` - -### RouterQueuePosition +### RouterQueueCancelStatus -Cuántas solicitudes hay por delante de esta en la cola, en el instante en que se compuso la respuesta. Cero significa que esta solicitud está al frente. +Lo que encontró una solicitud de cancelación, para los dos resultados que describen una solicitud que esta ruta resolvió realmente. Ambos quedan reflejados en el estado HTTP, por lo que un cliente puede ramificar según cualquiera de los dos. -Tipo: `integer` -- Al menos 0 +Tipo: `string`### RouterQueuePosition -### RouterQueueRequestId +Cuántas solicitudes hay delante de esta en la cola, en el instante en que se compuso la respuesta. Cero significa que esta solicitud está al frente. -Identificador de una solicitud de Router en cola: el identificador que usa quien llama para consultar, cancelar y recoger un resultado. +Tipo: `integer`. Al menos 0### RouterQueueRequestId -Tipo: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres +Identificador de una solicitud de Router en cola: el identificador con el que quien llama consulta, cancela y recoge un resultado. -### RouterQueueStatus +Tipo: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres### RouterQueueStatus -El estado de una solicitud Router en cola. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas están cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica los fallos y se espera que su conjunto crezca, por lo que un cliente generado que rechazara de forma estricta un bucket no reconocido fallaría más justo cuando algo ya hubiera salido mal. Este es un ciclo de vida, y un ciclo de vida al que se le añade más tarde un cuarto estado es un cambio incompatible para todos los bucles de sondeo escritos contra él, se declare como enum o no, así que se declara como uno y la restricción se indica donde un cliente pueda verla. +El estado de una solicitud Router en cola. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas son cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma dura una categoría no reconocida fallaría con más fuerza justo cuando algo ya había salido mal. Este es un ciclo de vida, y añadir más tarde un cuarto estado a un ciclo de vida es un cambio incompatible para todos los bucles de sondeo escritos contra él, se declare como enum o no. Por eso se declara como uno y la restricción se indica donde un cliente pueda verla. -Tipo: `string` +Tipo: `string`### RouterQueueStatusFields -### RouterQueueStatusFields - -La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad de una solicitud en cola, su estado actual y, cuando ese estado es terminal y la ejecución no tuvo éxito, el grupo genérico que indica por qué. +La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad de una solicitud en cola, su estado actual y, cuando ese estado es terminal y la ejecución no tuvo éxito, la categoría general que indica por qué. **Campos** - Identificador de una solicitud en cola del Router: el identificador que usa quien llama para consultar, cancelar y recoger un resultado. + Identificador de una solicitud de Router en cola: el identificador con el que quien llama consulta, cancela y recoge un resultado. Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres - El estado de una solicitud en cola del Router. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas son cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma estricta un grupo no reconocido fallaría con más fuerza justo cuando algo ya había salido mal. Este es un ciclo de vida, y un ciclo de vida al que más tarde se le añade un cuarto estado es un cambio incompatible para todos los bucles de polling escritos contra él, se declare como enum o no; por eso se declara como uno y la restricción se indica donde un cliente puede verla. + El estado de una solicitud de Router en cola. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas son cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma rígida una categoría no reconocida fallaría con más fuerza justo cuando algo ya había salido mal. Este es un ciclo de vida, y un ciclo de vida al que más tarde se le añade un cuarto estado es un cambio incompatible para todo bucle de sondeo escrito contra él, se declare como enum o no, así que se declara como uno, y la restricción se enuncia donde un cliente pueda verla. Tipo: [`RouterQueueStatus`](#routerqueuestatus) @@ -1329,20 +1304,16 @@ La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad - Presente solo en una solicitud `COMPLETED` que no tuvo éxito, y lleva el mismo grupo genérico que la lectura del resultado pone en `X-Comfy-Error-Type` cuando devuelve ese fallo. Es lo que distingue una solicitud terminal que tuvo éxito de una que falló o se canceló (no hay un estado terminal separado para ninguna de las dos), y está ausente en caso de éxito en lugar de ser null, así que ramifica en función de su presencia. + Presente solo en una solicitud `COMPLETED` que no tuvo éxito, y lleva la misma categoría general que la lectura del resultado pone en `X-Comfy-Error-Type` cuando devuelve ese fallo. Es lo que distingue una solicitud terminal que tuvo éxito de una que falló o se canceló (no hay un estado terminal aparte para ninguna de las dos), y está ausente en caso de éxito en lugar de ser null, así que ramifica según su presencia. Tipo: [`RouterErrorType`](#routererrortype) - - -### RouterQueueStatusResponse +### RouterQueueStatusResponse Estado actual de una solicitud en cola, compuesto con las mismas tres URL que devolvió el envío. Compone [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueStatusFields`](#routerqueuestatusfields). -Tipo: `object` - -### RouterQueueSubmitFields +Tipo: `object`### RouterQueueSubmitFields La mitad de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad de la nueva solicitud y su estado en el instante en que fue admitida. @@ -1351,11 +1322,11 @@ La mitad de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad Identificador de una solicitud de Router en cola: el identificador con el que un llamador consulta, cancela y recoge un resultado. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres - El estado de una solicitud de Router en cola. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas se cierran en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma estricta una categoría no reconocida fallaría con más fuerza justo cuando algo ya había salido mal. Este otro es un ciclo de vida, y añadir más tarde un cuarto estado a un ciclo de vida es un cambio incompatible para todo bucle de consulta escrito contra él, se declare como enum o no; por eso se declara como uno, y la restricción se indica donde un cliente puede verla. + El estado de una solicitud de Router en cola. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas están cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma dura un grupo no reconocido fallaría con más fuerza justo cuando algo ya había ido mal. Este es un ciclo de vida, y añadir un cuarto estado más adelante a un ciclo de vida es un cambio incompatible para cada bucle de consulta escrito contra él, tanto si está declarado como enum como si no, así que se declara como uno y la restricción se indica donde un cliente puede verla. Tipo: [`RouterQueueStatus`](#routerqueuestatus) @@ -1367,91 +1338,79 @@ La mitad de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad - La estimación de costo previa para esta solicitud, presente en una admisión nueva cuando la estimación de costo está habilitada para el llamador. Cotiza el tramo del proveedor al que se fijó esta solicitud (la cola no tiene bucle de respaldo, así que `fallback_provider` nunca cambia el tramo que se ejecuta). Cuando no se puede dar una cifra, sigue presente, con `source: unknown`; el envío nunca falla por la estimación. Se omite en una repetición idempotente (`Idempotent-Replayed: true`), porque la cotización original no se almacena. Es una estimación, no el cargo final, y no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifica, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es definitivo. + La estimación de costo previa al envío para esta solicitud, presente en una admisión nueva cuando la estimación de costo está habilitada para el llamador. Cotiza el tramo del proveedor al que se fijó esta solicitud (la cola no tiene bucle de respaldo, así que `fallback_provider` nunca cambia el tramo que se ejecuta). Cuando no se puede dar ninguna cifra, sigue presente, con `source: unknown`; el envío nunca falla por la estimación. Se omite en una repetición idempotente (`Idempotent-Replayed: true`), porque la cotización original no se almacena. Es una estimación, no el cargo final, y no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifica, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. Tipo: [`RouterCostEstimate`](#routercostestimate) - - -### RouterQueueSubmitResponse +### RouterQueueSubmitResponse -El identificador que se devuelve cuando una ejecución se admite en la cola: la identidad y el estado de la solicitud, compuesto con las tres URL que direccionan el resto de su ciclo de vida. +El identificador que se devuelve cuando una ejecución se admite en la cola: la identidad y el estado de la solicitud, junto con las tres URL que abarcan el resto de su ciclo de vida. -Está compuesto por [`RouterQueueUrls`](#routerqueueurls) y [`RouterQueueSubmitFields`](#routerqueuesubmitfields). +Compone [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueSubmitFields`](#routerqueuesubmitfields). -Tipo: `object` +Tipo: `object`### RouterQueueUrls -### RouterQueueUrls - -Las tres URL que abarcan el resto del ciclo de vida de una solicitud en cola y que se devuelven en cada respuesta que incluye un handle activo, para que el cliente nunca tenga que componer por su cuenta una URL de cola. +Las tres URL que dan acceso al resto del ciclo de vida de una solicitud en cola y que se devuelven en cada respuesta que incluye un handle activo, para que el cliente nunca tenga que componer por su cuenta una URL de cola. **Campos** - URL absoluta de la lectura de estado de esta solicitud. + URL absoluta para consultar el estado de esta solicitud. URI - URL absoluta desde la que se recopila el resultado de esta solicitud. + URL absoluta desde la que se recoge el resultado de esta solicitud. URI - URL absoluta en la que se solicita una cancelación. + URL absoluta a la que se envía la solicitud de cancelación. URI - +### RouterValidationErrorContext -### RouterValidationErrorContext +Detalles proporcionados por el proveedor acerca de la regla de validación que falló. -Detalles proporcionados por el proveedor sobre la regla de validación que falló. +Tipo: `object`### RouterValidationErrorDetail -Tipo: `object` - -### RouterValidationErrorDetail - -Un fallo de validación a nivel de campo. +Un error de validación a nivel de campo. **Campos** - Ruta al campo que causó el error, con el segmento más externo primero; por ejemplo `["body", "image_url"]`, o `["body", "images", 0]` donde un entero indexa dentro de un arreglo. + Ruta al campo que provocó el error, con el segmento más externo primero; por ejemplo `["body", "image_url"]`, o `["body", "images", 0]`, donde un entero actúa como índice dentro de un arreglo. - Descripción legible para humanos de este fallo individual. + Descripción legible por humanos de este error individual. - Motivo específico y legible por máquina de este fallo, que el proveedor entrega sin cambios. Es el valor sobre el que se ramifica una jerarquía tipada de excepciones del SDK; `error_type` en el encabezado de la respuesta es solo su categoría general. + Motivo específico y legible por máquinas de este error, transmitido desde el proveedor sin cambios. Este es el valor que una jerarquía de excepciones tipada del SDK usa para ramificar; `error_type` en el encabezado de la respuesta es solo su categoría general. - El límite violado para un `RouterValidationErrorDetail`, tomado literalmente del proveedor; por ejemplo `{"limit_value": 8}` junto con `greater_than`, `{"min_width": 512}` junto con `image_too_small`, o `{"max_size_bytes": 10485760}` junto con `file_too_large`. El conjunto de claves es específico del proveedor y del tipo de error, así que este objeto es deliberadamente abierto: reducirlo a una lista fija de campos, o incorporarlo a la cadena `msg`, es justo la forma en que una integración portada compila y luego pierde en silencio la rama que leía el límite. No está presente cuando el tipo de error no lleva ningún límite. + El límite violado para un `RouterValidationErrorDetail`, transportado tal cual desde el proveedor; por ejemplo `{"limit_value": 8}` junto con `greater_than`, `{"min_width": 512}` junto con `image_too_small`, o `{"max_size_bytes": 10485760}` junto con `file_too_large`. El conjunto de claves es específico del proveedor y del tipo de error, así que este es deliberadamente un objeto abierto: restringirlo a una lista fija de campos, o fusionarlo con la cadena `msg`, es exactamente la forma en que una integración portada compila y luego pierde en silencio la rama que leía el límite. No está presente cuando el tipo de error no incluye un límite. Tipo: [`RouterValidationErrorContext`](#routervalidationerrorcontext) - El valor de entrada que causó el error, devuelto literalmente para que quien llama pueda ver qué se rechazó sin volver a deducirlo a partir de `loc`. Puede ser cualquier tipo JSON (cadena, número, booleano, arreglo, objeto o null), por lo que este esquema se deja deliberadamente sin tipar en lugar de reducirlo a un objeto. No está presente cuando el proveedor no devuelve la entrada. + El valor de entrada que provocó el error, devuelto tal cual para que quien llama pueda ver qué se rechazó sin volver a deducirlo a partir de `loc`. Cualquier tipo JSON (cadena, número, booleano, arreglo, objeto o null), por lo que este esquema se deja deliberadamente sin tipo en lugar de restringirlo a un objeto. No está presente cuando el proveedor no devuelve la entrada. Tipo: [`RouterValidationErrorInput`](#routervalidationerrorinput) - - -### RouterValidationErrorInput - -El valor de entrada rechazado, cuando el proveedor lo incluye. +### RouterValidationErrorInput -### RouterValidationErrorResponse +El valor de entrada rechazado, cuando el proveedor lo incluye.### RouterValidationErrorResponse El cuerpo del error de validación `422`. Lee `X-Comfy-Error-Type` para conocer su categoría. **Campos** - Todos los fallos de validación encontrados en la solicitud, una entrada por cada campo no válido. + Cada fallo de validación encontrado en la solicitud, una entrada por cada campo con problemas. Tipo: array de [`RouterValidationErrorDetail`](#routervalidationerrordetail) diff --git a/es/development/comfyui-server/api-examples.mdx b/es/development/comfyui-server/api-examples.mdx index f99d134548..9445ccbc87 100644 --- a/es/development/comfyui-server/api-examples.mdx +++ b/es/development/comfyui-server/api-examples.mdx @@ -1,14 +1,16 @@ --- 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). @@ -23,7 +25,7 @@ Todos los ejemplos usan el [flujo de trabajo predeterminado de SD1.5](https://gi Fuente: [`basic_api_example.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/script_examples/basic_api_example.py) -El enfoque más sencillo: envía un flujo de trabajo y no esperes los resultados. Es útil para tareas en las que envías y te olvidas, y revisas las salidas más tarde. +El enfoque más sencillo: envía un flujo de trabajo y no esperes los resultados. Es útil para tareas de tipo enviar y olvidar, en las que revisas las salidas más tarde. ```python """basic_api_example.py: envía un flujo de trabajo solo por HTTP.""" @@ -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 @@ -158,7 +160,7 @@ def get_images(ws, prompt): if message["type"] == "executing": data = message["data"] if data["node"] is None and data["prompt_id"] == prompt_id: - break # Ejecución terminada + break # Ejecución finalizada # Los frames binarios son imágenes de vista previa, omítelos aquí continue @@ -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 escenarios en los que no quieras guardar las imágenes en disco, usa el nodo `SaveImageWebsocket`. Las imágenes llegan directamente mediante tramas binarias 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 completada current_node = data["node"] else: - # Binary frame — image data from SaveImageWebsocket + # Trama binaria: 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 sea aceptable obtener los resultados más tarde. - - **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. La mejor combinación de 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..6e910a9ba0 100644 --- a/es/development/comfyui-server/api-key-integration.mdx +++ b/es/development/comfyui-server/api-key-integration.mdx @@ -10,6 +10,7 @@ translationBlockHashes: "Prerequisites": a15cafa5 "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). Esto significa que puedes crear flujos de trabajo que combinen: @@ -36,12 +37,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 obtener información sobre cómo comprar créditos para tu cuenta. -## Ejemplo en Python +## Python Example -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: +Here is an example of how to send a workflow containing Partner Nodes to the ComfyUI API using Python code: ```python """Using Partner Nodes when running ComfyUI headless or with alternative frontend @@ -123,6 +124,6 @@ request.urlopen(req) ## Documentación relacionada -- [Descripción general de los Nodos asociados](https://docs.comfy.org/tutorials/partner-nodes/overview) +- [Descripción general de Nodos asociados](https://docs.comfy.org/tutorials/partner-nodes/overview) - [Gestión de la cuenta](https://docs.comfy.org/interface/user) - [Créditos](https://docs.comfy.org/interface/credits) diff --git a/es/development/comfyui-server/startup-flags.mdx b/es/development/comfyui-server/startup-flags.mdx index b2775ec68a..b913d3d558 100644 --- a/es/development/comfyui-server/startup-flags.mdx +++ b/es/development/comfyui-server/startup-flags.mdx @@ -18,13 +18,14 @@ translationBlockHashes: "Logging & Misc": 4d81c96d --- -ComfyUI acepta argumentos de línea de comandos cuando se inicia con `python main.py`. Esta página documenta todos los flags definidos en [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). + +ComfyUI accepts command-line arguments when started with `python main.py`. This page documents every flag defined in [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). - Los usuarios de **Windows Portable** pueden añadir flags a los archivos `.bat` de inicio (por ejemplo, `run_nvidia_gpu.bat`). Consulta la [guía de Windows Portable](/es/installation/comfyui_portable_windows) para ver los detalles. + **Windows Portable** users can add flags to the `.bat` launch files (for example, `run_nvidia_gpu.bat`). See the [Windows Portable guide](/installation/comfyui_portable_windows) for details. -Ejecuta `python main.py --help` en tu directorio de ComfyUI para ver el texto de ayuda integrado. Combina varios flags según necesites: +Run `python main.py --help` in your ComfyUI directory for the built-in help text. Combine multiple flags as needed: ```bash python main.py --listen 0.0.0.0 --port 8288 --disable-auto-launch --lowvram @@ -34,13 +35,13 @@ 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, el predeterminado es `0.0.0.0,::` (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]` | disabled | 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. | +| `--enable-compress-response-body` | disabled | Habilita la compresión del cuerpo de la respuesta HTTP. | ```bash @@ -57,26 +58,26 @@ 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`. | +| `--base-directory` `PATH` | Raíz de ComfyUI | Directorio base para las carpetas models, custom_nodes, input, output, temp y user. | +| `--models-directory` `PATH` | ComfyUI root/models | Directorio de modelos. Reemplaza la carpeta models de `--base-directory`. | | `--extra-model-paths-config` `PATH` | — | Carga uno o más archivos `extra_model_paths.yaml`. Se puede especificar 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`. | -| `--user-directory` `PATH` | — | Directorio de usuario (ruta absoluta). Anula `--base-directory`. La ruta debe existir y ser legible. | +| `--output-directory` `PATH` | — | Directorio de salida. Reemplaza `--base-directory`. | +| `--temp-directory` `PATH` | — | Directorio temporal. Reemplaza `--base-directory`. | +| `--input-directory` `PATH` | — | Directorio de entrada. Reemplaza `--base-directory`. | +| `--user-directory` `PATH` | — | Directorio de usuario (ruta absoluta). Reemplaza `--base-directory`. La ruta debe existir y ser legible. | -## Inicio y navegador +## Launch & Browser -| Flag | Predeterminado | Descripción | +| Flag | Default | Description | |------|---------|-------------| -| `--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` | disabled | Automatically open ComfyUI in the default browser on startup. | +| `--disable-auto-launch` | disabled | Disable auto-launching the browser. | +| `--windows-standalone-build` | disabled | Windows portable build convenience mode. Enables auto-launch on startup (equivalent to `--auto-launch`) and turns on the assets system. | - `--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` sets `auto_launch` to `true` and enables the assets system. `--disable-auto-launch` overrides the browser launch and `--disable-assets` overrides the assets system. To run as a server without opening a browser, use `--disable-auto-launch`. ```bash @@ -86,14 +87,14 @@ python main.py --disable-auto-launch ## Dispositivos y CUDA -| Flag | Predeterminado | Descripción | +| Opción | 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`. | -| `--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. | +| `--cuda-device` `DEVICE_ID` | — | IDs de dispositivos CUDA que se deben usar, separados por comas (p. ej. `0` o `0,1`), o `all` para mantener visibles todos los dispositivos visibles actualmente. Los demás dispositivos quedan ocultos. | +| `--default-device` `ID` | — | ID del dispositivo predeterminado. Todos los demás dispositivos permanecen visibles. | +| `--cuda-malloc` | Automático (torch 2.0+) | Activa cudaMallocAsync. Es mutuamente excluyente con `--disable-cuda-malloc`. | +| `--disable-cuda-malloc` | — | Desactiva cudaMallocAsync. Es mutuamente excluyente con `--cuda-malloc`. | +| `--directml` `[DEVICE]` | — | Usa torch-directml. Índice de dispositivo opcional; toma el valor `-1` cuando no se especifica ninguno. | +| `--oneapi-device-selector` `STRING` | — | Cadena selectora de dispositivo 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 +103,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 a continuación son mutuamente excluyentes dentro de cada grupo. Solo se puede usar un flag por grupo a la vez. ### Punto flotante global @@ -116,18 +117,18 @@ 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. | -| `--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): +| `--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 la UNet en fp8 (e4m3fn). | +| `--fp8_e5m2-unet` | Almacena los pesos de la UNet en fp8 (e5m2). | +| `--fp8_e8m0fnu-unet` | Almacena los pesos de la UNet en fp8 (e8m0fnu). | + +Cada sufijo de flag FP8 nombra un formato de punto 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. -- **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). +- **e8m0fnu**: 8 bits de exponente, 0 bits de mantisa. Rango dinámico máximo sin precisión fraccionaria. Suele usarse como factor de escala de bloque (solo potencias de dos). ### Precisión de VAE @@ -155,7 +156,7 @@ 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. | +| `--force-channels-last` | deshabilitado | Forzar el formato de memoria de los 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`. | @@ -164,7 +165,7 @@ Consulta la sección [Precisión de UNET](#precisión-de-unet) para ver la expli | 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é @@ -175,37 +176,37 @@ Consulta la sección [Precisión de UNET](#precisión-de-unet) para ver la expli | 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 la caché activa en GB. Segundo valor opcional: umbral de la 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` | - | Usa 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 nodos en caché. Sin límite superior estricto; está limitada 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. | - 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 nodos 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, 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. + Los flags de método de atención cruzada 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-split-cross-attention` | Usar la optimización de atención cruzada split. | | `--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-sage-attention` | Usar Sage attention. | | `--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. | +| `--disable-xformers` | Deshabilitar xformers. | +| `--force-upcast-attention` | Forzar el upcasting de atención. Reportar si esto soluciona las imágenes negras. Mutuamente excluyente con `--dont-upcast-attention`. | +| `--dont-upcast-attention` | Deshabilitar 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á habilitada de forma predeterminada en GPUs Nvidia y AMD, y el VRAM dinámico se habilita automáticamente donde es compatible. Los flags siguientes anulan esos valores predeterminados. Los flags de modo de VRAM (`--gpu-only`, `--highvram`, `--lowvram`, `--novram`, `--cpu`) son mutuamente excluyentes. @@ -215,35 +216,35 @@ La descarga asíncrona de pesos está activada por defecto en GPU Nvidia y AMD, |------|---------|-------------| | `--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. | +| `--lowvram` | — | No tiene efecto cuando el VRAM dinámico está habilitado. 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. | -| `--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). | +| `--reserve-vram` `GB` | Depende del SO | VRAM en GB que se reserva para el SO y otro software. | +| `--vram-headroom` `GB` | `0` | VRAM extra en GB que el VRAM dinámico mantiene libre por encima del margen predeterminado. ComfyUI intenta mantener esa cantidad de VRAM totalmente 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 del VRAM dinámico. | +| `--async-offload` `[NUM_STREAMS]` | habilitado en Nvidia y AMD | Descarga asíncrona de pesos. Cantidad opcional de streams (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-dynamic-vram` | — | Deshabilita el VRAM dinámico; usa carga de modelos basada en estimaciones. | +| `--enable-dynamic-vram` | automático en Nvidia, ROCm 7.14+ | Habilita el VRAM dinámico en sistemas donde no está habilitado de forma predeterminada. | +| `--fast-disk` | falso | Fuerza la carga dinámica y la descarga respaldadas por disco en lugar de usar RAM no fijada. Útil con NVMe rápido. Cuando no se define este 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, de modo que se usa 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. | +| `--assert-graph-breaks` | deshabilitado | Hace fallar la ejecución ante cortes de gráfico 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-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 +## Performance & Debugging -| Flag | Predeterminado | Descripción | +| Flag | Default | Description | |------|---------|-------------| -| `--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...]` | disabled | Enable experimental optimizations that may affect quality or stability. `--fast` alone enables all. Specific options: `fp16_accumulation`, `fp8_matrix_mult`, `cublas_ops`, `autotune`. | +| `--deterministic` | disabled | Use slower deterministic PyTorch algorithms where possible. Does not guarantee identical images in all cases. | +| `--default-hashing-function` | `sha256` | Hash function for duplicate filename/content comparison. Choices: `md5`, `sha1`, `sha256`, `sha512`. | +| `--debug-hang` | disabled | Enable stack trace dumps on Ctrl-C for debugging hangs. | ```bash # Enable all fast optimizations (experimental) @@ -255,28 +256,28 @@ python main.py --fast fp16_accumulation cublas_ops ## 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 ver 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` | Habilitar ComfyUI-Manager. | +| `--disable-manager-ui` | Desactivar 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` | Usar la interfaz clásica del Administrador. Implica `--enable-manager`. Es mutuamente excluyente con `--disable-manager-ui`. | -## Nodos personalizados y nodos de API +## Custom Nodes & API Nodes -| Flag | Predeterminado | Descripción | +| Flag | Default | Description | |------|---------|-------------| -| `--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 | Disable loading all custom nodes. | +| `--whitelist-custom-nodes` `FOLDER...` | — | Custom node folders to load even when `--disable-all-custom-nodes` is set. | +| `--disabled-nodes-config` `PATH` | — | Path to a YAML file that lists node IDs to disable. The file must contain a `disabled_nodes` list of node ID strings. | +| `--disable-partner-nodes` | disabled | Disable loading Partner Nodes (the paid API nodes). The frontend keeps its internet access. | +| `--offline` | disabled | Prevent the frontend from communicating with the internet by adding a restrictive Content-Security-Policy. Also disables Partner Nodes. | +| `--disable-api-nodes` | disabled | Deprecated alias for `--offline`. Use `--offline`, or `--disable-partner-nodes` to only disable Partner Nodes. | +| `--disable-metadata` | disabled | Disable saving prompt metadata in output files. | - `--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` also changes what the browser is allowed to load. The flag adds a Content-Security-Policy that keeps the page on resources served by ComfyUI itself, so images, fonts, media, frames, and network requests from other origins are blocked, and Partner Nodes (API nodes) are not registered at all. If a preview or a thumbnail that normally loads goes missing after a restart, check the launch arguments for this flag before troubleshooting the node. `--disable-partner-nodes` only stops Partner Nodes from loading and leaves the rest of the frontend's internet access intact. ```bash @@ -287,19 +288,19 @@ python main.py --disable-all-custom-nodes python main.py --disable-all-custom-nodes --whitelist-custom-nodes ComfyUI-Manager ``` -## Frontend y API +## Frontend & API -| Flag | Predeterminado | Descripción | +| Flag | Default | Description | |------|---------|-------------| -| `--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-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). | -| `--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. | +| `--front-end-version` | `comfyanonymous/ComfyUI@latest` | Frontend version in `[owner]/[repo]@[version]` format. Requires internet to download from GitHub releases. Version can be `latest` or a semver (e.g. `1.0.0`). | +| `--front-end-root` `PATH` | — | Local filesystem path to the frontend directory. Overrides `--front-end-version`. | +| `--comfy-api-base` | `https://api.comfy.org` | Base URL for the ComfyUI API. | +| `--database-url` | `sqlite:////user/comfyui.db` | Database URL. Use `sqlite:///:memory:` for in-memory. | +| `--enable-assets` | disabled | Enable the assets system (API routes, database sync, background scanning). | +| `--disable-assets` | disabled | Disable the assets system, even when `--enable-assets` or `--windows-standalone-build` is turned on. | +| `--enable-asset-hashing` | disabled | Compute blake3 content hashes when scanning assets. Enables future asset portability features such as deduplication and cross-machine model resolution, at the cost of startup time and per-output hashing on large model directories. Off by default; requires the assets system (`--enable-assets` or `--windows-standalone-build`). | +| `--feature-flag` `KEY[=VALUE]` | — | Set a server feature flag. Bare `KEY` sets true. Can be repeated. Booleans and numbers are auto-converted. | +| `--list-feature-flags` | — | Print known CLI-settable feature flags as JSON and exit. | ```bash # List available feature flags @@ -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 acerca de los productos comerciales y las implementaciones 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. Finaliza 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 el archivo [`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..5f5030d2bb 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 --- @@ -11,11 +11,11 @@ Los flujos de trabajo enviados a través de la API de Comfy Cloud usan los mismo ## Créditos y uso -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. +Las solicitudes a la API toman de 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. -## 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: @@ -25,19 +25,19 @@ Puedes enviar varios flujos de trabajo sin esperar a que terminen las tareas ant | Creator | 3 | | Pro | 5 | -Los planes de equipo ejecutan más flujos de trabajo simultáneos por miembro que Pro. Consulta [platform.comfy.org](https://platform.comfy.org) para ver la simultaneidad de tu cuenta. Las tareas adicionales quedan en cola y se ejecutan a medida que se liberan espacios. +Los planes de equipo ejecutan más flujos de trabajo simultáneos por miembro que Pro. Consulta [platform.comfy.org](https://platform.comfy.org) para ver la simultaneidad de tu cuenta. Las tareas adicionales quedan en cola y se ejecutan a medida que se liberan ranuras. -Si la cola está llena, los SDK reintentan dentro de un presupuesto limitado antes de generar el error `QueueFull`. +Si la cola está llena, los SDK reintentan dentro de un presupuesto acotado antes de lanzar `QueueFull`. -En los planes Team y Enterprise, la simultaneidad es por miembro: cada persona del espacio de trabajo tiene su propio límite de simultaneidad, así que las tareas en ejecución de un miembro nunca bloquean las de otro. +En los planes de equipo y empresa, la simultaneidad es por miembro: cada persona del espacio de trabajo tiene su propio límite de simultaneidad, así que las tareas en ejecución de un miembro nunca bloquean las de otro. - La ejecución de más de una tarea a la vez solo se admite a través de la API. La interfaz de Comfy Cloud ejecuta un flujo de trabajo a la vez por persona, y los flujos de trabajo en cola en el editor se ejecutan en orden. Consulta los [planes de precios](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api) para ver los detalles de la suscripción. + Solo puedes ejecutar más de una tarea a la vez a través de la API. La interfaz de Comfy Cloud ejecuta un flujo de trabajo a la vez por persona, y los flujos de trabajo en cola en el editor se ejecutan en orden. Consulta los [planes de precios](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api) para ver los detalles de la suscripción. ## Límites de ejecución y de cola -Cada flujo de trabajo de Cloud tiene un tiempo máximo de ejecución. Una tarea que supera ese límite se cancela automáticamente: +Cada flujo de trabajo de Cloud tiene un tiempo máximo de ejecución. Una tarea que se ejecuta más allá de ese límite se cancela automáticamente: | Plan | Tiempo máximo de ejecución | | :------- | :------------------------- | diff --git a/es/development/serverless/overview.mdx b/es/development/serverless/overview.mdx index f7c49310c2..bdf1db4ab5 100644 --- a/es/development/serverless/overview.mdx +++ b/es/development/serverless/overview.mdx @@ -15,7 +15,8 @@ translationBlockHashes: "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. + +Comfy API permite que tu aplicación ejecute flujos de trabajo de ComfyUI mediante 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,32 +35,32 @@ 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 +## The Build file -`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` stores the Build definition and last known remote state. The CLI uses that state to detect when the remote Build has changed. Keep the file with the project. It describes the environment but does not contain model files. -Comprueba cómo se compara el Build local con la instalación y con la versión remota antes de publicar cambios: +Check how the local Build compares with the install and remote version before pushing changes: ```bash comfy build status ``` -## Actualizar y publicar +## Update and release -Después de cambiar la instalación local, actualiza la definición del Build: +After changing the local install, refresh the Build definition: ```bash comfy build update --yes ``` -Para crear otra versión a partir de un Build existente, consulta los destinos admitidos y selecciona uno: +To create another release from an existing Build, check the supported targets and select one: ```bash comfy build refs build-targets comfy build release create --target linux/nvidia --watch ``` -Sigue el registro de compilación de una versión con: +Follow one release's build log with: ```bash comfy build release logs rel_123456 --target linux/nvidia --follow @@ -67,31 +68,31 @@ 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 al elegir un destino 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 +## Monitorear y llamar a una implementación -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. +Las opciones `--min` y `--max` establecen los límites de workers. Ejecuta `comfy deploy status --watch` para seguir el estado de la implementación, la vigencia de las versiones publicadas 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 [SDK de Comfy](/es/development/api-development/sdks). Establece `COMFY_BASE_URL` con la URL de la implementación y proporciona una clave API. Consulta [Elegir una URL base](/es/development/api-development/sdks#elegir-una-url-base). -## Operar un despliegue +## Operate a deployment ```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 ``` @@ -99,7 +100,7 @@ comfy deploy start --deployment dep_123456 ## Inspeccionar y limpiar ```bash -# Estado del build +# Estado de la compilación comfy build ls comfy build show --id bld_123456 comfy build release ls @@ -118,39 +119,39 @@ comfy deploy events --deployment dep_123456 ## 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. - Cada despliegue usa un solo tipo de GPU. Para ejecutar flujos de trabajo en distintos tipos de GPU, crea despliegues separados del mismo Build. + Cada despliegue usa un 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 versiones se almacenan en tu cuenta sin cargo. No se te cobra por el espacio de almacenamiento de un Build hasta que lo despliegas. - La facturación de almacenamiento comienza con un despliegue: + El cobro por 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`. - - 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. + - Cuando despliegas una versión, sus modelos se preparan en un almacenamiento de red compartido por los workers del despliegue. El almacenamiento es de solo lectura después del despliegue y se cobra por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso cuando un despliegue está en pausa con `comfy deploy stop`. + - Cada worker también tiene un disco de contenedor fijo de 50 GB. Es efímero y solo se cobra 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 eliminar el último despliegue que lo usa en esa región, y su cobro finaliza. - 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 cobra 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 cobra por segundo desde el momento en que se inicia (incluidos 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 cobra 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. - 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 cotizan por hora de worker y se cobran por segundo. La disponibilidad de GPU por región proviene del catálogo de cómputo: ejecuta `comfy deploy refs compute` para obtener 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: ```bash @@ -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, la versión y el 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 versiones. Después de eliminar el último despliegue que usa ese Build en una región, su almacenamiento de red preparado se limpia y el cobro por almacenamiento finaliza 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 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 de API o para solucionar problemas con sus entradas y salidas. - Úsala para automatizar los comandos de compilación, publicación, despliegue y flujos de trabajo desde una terminal. + Úsala para automatizar los comandos de compilación, publicación, despliegue y flujo de trabajo desde una terminal. diff --git a/es/tutorials/3d/hunyuan3D-2.mdx b/es/tutorials/3d/hunyuan3D-2.mdx index 577a584714..1b338191ae 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 @@ -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 un uso real, 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 @@ -129,13 +131,13 @@ Si necesitas añadir más vistas, asegúrate de cargar las otras imágenes de vi ## Flujo de trabajo Hunyuan3D-2mv-turbo -En el flujo de trabajo Hunyuan3D-2mv-turbo, usaremos el modelo Hunyuan3D-2mv-turbo para generar modelos 3D. Este modelo es una versión con destilación por pasos de Hunyuan3D-2mv, lo que permite generar modelos 3D más rápido. En esta versión del flujo de trabajo, establecemos `cfg` en 1.0 y añadimos un nodo `flux guidance` para controlar la generación con `distilled cfg`. +En el flujo de trabajo Hunyuan3D-2mv-turbo, usaremos el modelo Hunyuan3D-2mv-turbo para generar modelos 3D. Este modelo es una versión con destilación por pasos de Hunyuan3D-2mv, lo que permite generar modelos 3D más rápidamente. En esta versión del flujo de trabajo, establecemos `cfg` en 1.0 y agregamos un nodo `flux guidance` para controlar la generación con `distilled cfg`. ### HY 3D 2.0 MV Turbo {#3d_hunyuan3d_multiview_to_model_turbo} Genera modelos 3D a partir de múltiples vistas con Hunyuan3D 2.0 MV Turbo. -HY 3D 2.0 MV Turbo workflow preview +Vista previa del flujo de trabajo HY 3D 2.0 MV Turbo @@ -169,14 +171,14 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: Descarga las siguientes imágenes y arrástralas a ComfyUI para cargar el flujo de trabajo. -![Hunyuan3D-2mv-turbo workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/hunyuan-3d-turbo.webp) +![Flujo de trabajo Hunyuan3D-2mv-turbo](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/hunyuan-3d-turbo.webp) 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) +![imagen de entrada](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/front.png) +![imagen de entrada](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 @@ -232,7 +234,7 @@ Descarga la imagen de abajo y arrástrala a ComfyUI para cargar el flujo de trab ![Flujo de trabajo de Hunyuan3D-2](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d-non-multiview-train.webp) -Descarga la imagen de abajo; la usaremos como imagen de entrada. +Descarga la imagen de abajo, la usaremos como imagen de entrada. ![Flujo de trabajo de ComfyUI Hunyuan 3D 2](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan_3d_v2_non_multiview_train.png) ### 2. Instalación manual del modelo @@ -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 por separado. 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} @@ -314,7 +316,7 @@ La malla `.glb` generada se guarda en `ComfyUI/output/mesh/`. ## Recursos de la comunidad -A continuación, encontrarás recursos de la comunidad de ComfyUI relacionados con Hunyuan3D-2: +A continuación encontrarás recursos de la comunidad de ComfyUI relacionados con Hunyuan3D-2: - [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper) - [Kijai/Hunyuan3D-2_safetensors](https://huggingface.co/Kijai/Hunyuan3D-2_safetensors/tree/main) - [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack) @@ -325,22 +327,22 @@ Actualmente, Hunyuan3D 2.0 ha publicado como código abierto varios modelos que **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 con 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 multivista a forma, adecuado para creaciones 3D que requieren varios ángulos para comprender 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 con 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 eliminación de iluminación 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/3d/pixal3d.mdx b/es/tutorials/3d/pixal3d.mdx index 9a2aa2df41..1016964fe3 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. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Pixal3D** es un modelo de código 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. 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. @@ -19,7 +21,7 @@ La mayoría de los generadores nativos 3D sintetizan formas en un espacio canón Sube una sola imagen. Genera un modelo 3D de alta fidelidad con texturas PBR completas, alineado a tu vista de entrada. -Este flujo de trabajo también incluye el pipeline de TRELLIS.2. El nodo `Boolean (Switch to Trellis2)` tiene `false` por defecto, lo que ejecuta el pipeline de Pixal3D y carga el modelo Pixal3D automáticamente. +Este flujo de trabajo también incluye el pipeline de TRELLIS.2. El nodo `Boolean (Switch to Trellis2)` tiene `false` de forma predeterminada, lo que ejecuta el pipeline de Pixal3D y carga el modelo Pixal3D automáticamente. Vista previa del flujo de trabajo de Pixal3D @@ -50,9 +52,9 @@ Sube este archivo al nodo `LoadImage`: ### Pixal3D: de varias vistas a 3D {#pixal3d-multi-views} -Genera un modelo 3D a partir de una hoja de rotación de personaje (vistas de frente, perfil y espalda en una sola imagen). El modelo multivista usa los puntos de vista adicionales para reconstruir geometría que el pipeline de una sola imagen no puede ver, lo que da perfiles laterales y traseros más precisos. +Genera un modelo 3D a partir de una hoja de vistas de personaje (vistas de frente, perfil y espalda en una sola imagen). El modelo multivista usa los puntos de vista adicionales para reconstruir geometría que el pipeline de una sola imagen no puede ver, lo que da perfiles laterales y traseros más precisos. -Usa la plantilla `Character Turnaround Sheet Generator` de la biblioteca de plantillas para producir la hoja de rotación con Nano Banana 2, o prepara tu propia imagen multivista con el sujeto separado del fondo. +Usa la plantilla `Character Turnaround Sheet Generator` de la biblioteca de plantillas para producir la hoja de vistas con Nano Banana 2, o prepara tu propia imagen multivista con el sujeto separado del fondo. Vista previa del flujo de trabajo de varias vistas de Pixal3D @@ -97,9 +99,9 @@ Este flujo de trabajo usa los modelos que se indican a continuación. Descárgal ## Cómo funciona -Pixal3D combina una generación consciente de la cámara y alineada por píxeles con un pipeline completo de posprocesamiento de malla: +Pixal3D combina la generación alineada por píxeles y consciente de la cámara 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 +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 omitir 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) @@ -110,33 +112,33 @@ Pixal3D combina una generación consciente de la cámara y alineada por píxeles 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/`. +3. **Espera el pipeline**: las etapas de estructura, forma y textura se ejecutan en secuencia, seguidas del posprocesamiento. +4. **Consulta el resultado**: inspecciona 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. Se requieren ambos checkpoints de difusión: el switch determina cuál se ejecuta. Colócalos en las subcarpetas 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, 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, se carga cuando el switch se establece 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 la estructura y la 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 CLIP vision 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 diff --git a/es/tutorials/3d/trellis2.mdx b/es/tutorials/3d/trellis2.mdx index 4c1c2c761c..5fa144c463 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. +**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 de 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 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 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,9 +52,9 @@ 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 +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 saltarte 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) 4. **Generación de textura**: una etapa de difusión de textura produce vóxeles de material PBR (color base, metalicidad, rugosidad) @@ -63,19 +65,19 @@ 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 +4. **Espera a que termine el 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/` -## 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. Ambos checkpoints de difusión son obligatorios: el switch selecciona cuál se ejecuta. Colócalos en las subcarpetas 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 difusión TRELLIS.2, se carga cuando el switch se establece en `true` - pixal3d_int8_convrot.safetensors: modelo de difusión de Pixal3D, cargado de forma predeterminada + pixal3d_int8_convrot.safetensors: modelo de difusión Pixal3D, se carga de forma predeterminada trellis_2_shape_vae_bf16.safetensors: VAE para la decodificación de estructura y forma @@ -84,7 +86,7 @@ Descarga los modelos que usa este flujo de trabajo. Los dos checkpoints de difus 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 diff --git a/es/tutorials/3d/triposplat.mdx b/es/tutorials/3d/triposplat.mdx index f8f3124ab0..b60606d2ef 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,7 +10,9 @@ translationBlockHashes: "Workflow node guide": 83cd15a0 "Steps to run": 3bf53f69 "Output options": 9a1cc408 + "Model downloads": 33be821b --- + 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. @@ -109,7 +111,7 @@ El nodo de subgrafo principal procesa la imagen y genera el splat gaussiano 3D. ## Pasos para ejecutar 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 +2. **Ejecuta el subgrafo TripoSplat**: el modelo generará una representación de Gaussian splat 3. **Elige el formato de salida**: exporta como GLB, SPZ, video o renderiza a malla 4. **Consulta los resultados**: usa el archivo 3D creado o la vista previa renderizada @@ -122,24 +124,24 @@ El nodo de subgrafo principal procesa la imagen y genera el splat gaussiano 3D. | **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 diff --git a/es/tutorials/controlnet/pose-controlnet-2-pass.mdx b/es/tutorials/controlnet/pose-controlnet-2-pass.mdx index bec3d42158..650e1ed465 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 representa 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 @@ -32,8 +34,8 @@ Descarga la imagen del flujo de trabajo que aparece a continuación y arrástral ![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. +Puedes arrastrar directamente a ComfyUI las imágenes que contienen el JSON del flujo de trabajo en sus metadatos, o cargarlas con el menú `Workflows` -> `Open (ctrl+o)`. +Esta imagen ya incluye los enlaces de descarga de los modelos correspondientes, y al arrastrarla a ComfyUI aparecerá automáticamente la solicitud de descarga. Descarga la imagen que aparece a continuación, la cual usaremos como entrada: @@ -76,42 +78,42 @@ Sigue estos pasos según los marcadores numerados de la imagen: 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 usa un enfoque de generación de imágenes en dos pasadas, dividiendo 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: +En la primera fase, el modelo **majicmixRealistic_v7** se combina con Pose ControlNet para generar una imagen de pose inicial del personaje: 1. Primero, carga el modelo majicmixRealistic_v7 mediante el nodo `Load Checkpoint` 2. Carga el modelo de control de pose a través del nodo `Load ControlNet Model` 3. La imagen de pose de entrada se introduce en el nodo `Apply ControlNet` y se combina con las condiciones de prompt positivo y negativo -4. El primer nodo `KSampler` (normalmente con 20-30 pasos) genera una imagen básica de la pose del personaje +4. El primer nodo `KSampler` (normalmente con 20-30 pasos) genera una imagen de pose básica 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, asegurando que el personaje generado se ajuste a la pose esquelética 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 se usa 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` usa una fuerza de `denoise` más baja (normalmente 0.4-0.6) para el refinamiento, preservando la estructura básica de la primera fase +4. Finalmente, se obtiene una imagen de mayor calidad y resolución mediante el segundo `VAE Decode` y los nodos `Save Image` -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 coherencia de 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. +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 la GPU**: Generar en dos pasadas permite obtener imágenes grandes de alta calidad con recursos limitados de GPU. +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). diff --git a/es/tutorials/flux/flux-1-fill-dev.mdx b/es/tutorials/flux/flux-1-fill-dev.mdx index 5a3759d37e..2f2af6ac89 100644 --- a/es/tutorials/flux/flux-1-fill-dev.mdx +++ b/es/tutorials/flux/flux-1-fill-dev.mdx @@ -2,14 +2,16 @@ 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 @@ -20,21 +22,20 @@ 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]. - 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. +- Términos de licencia flexibles: puedes usar las salidas generadas 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. 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. +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 algunas explicaciones relacionadas. -## Instalación de Flux.1 Fill dev y de los modelos relacionados +## Instalar Flux.1 Fill dev y los 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 comenzar, completemos la instalación de los archivos del modelo Flux.1 Fill dev. Los flujos de trabajo de relleno inteligente y de outpainting usarán exactamente los mismos archivos de modelo. +Si ya usaste anteriormente la versión completa del [flujo de trabajo Flux.1 de texto a imagen](/es/tutorials/flux/flux-1-text-to-image), entonces solo necesitas descargar el archivo de modelo **flux1-fill-dev.safetensors** de 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. -![Acuerdo de Flux](/images/tutorial/flux/flux1_fill_dev_agreement.jpg) +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. +![Flux Agreement](/images/tutorial/flux/flux1_fill_dev_agreement.jpg) Lista completa de modelos: |- [clip_l.safetensors](https://huggingface.co/comfyanonymous/flux_text_encoders/blob/main/clip_l.safetensors) @@ -54,21 +55,20 @@ ComfyUI/ │ └── diffusion_models/ │ └── flux1-fill-dev.safetensors ``` - ## Flujo de trabajo de relleno inteligente con Flux.1 Fill dev ### Flux.1 Inpaint {#flux_fill_inpaint_example} Rellena las partes faltantes de las imágenes con Flux.1 Fill Inpainting. -Vista previa del flujo de trabajo Flux.1 Inpaint +Vista previa del flujo de trabajo de relleno inteligente de 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 +78,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,42 +90,42 @@ Sube este archivo al nodo `LoadImage` correspondiente:
Imagen de entrada - Salida de ejemplo de Flux.1 Inpaint + Salida de ejemplo de relleno inteligente de 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 contiene 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 sobre el 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 -![Flujo de trabajo de relleno inteligente con Flux.1 Fill dev de ComfyUI](/images/tutorial/flux/flow_diagram_inpaint.jpg) +![Flujo de trabajo de relleno inteligente con ComfyUI Flux.1 Fill dev](/images/tutorial/flux/flow_diagram_inpaint.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: - 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 incluida 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} -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 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 Abrir en Comfy Cloud - Descarga el JSON o busca "Flux.1 Outpaint" en la Biblioteca de plantillas + Descarga el JSON o busca "Flux.1 Outpaint" en la biblioteca de plantillas @@ -135,7 +135,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - Nodo `LoadImage` 17 · `flux_fill_outpaint_example_input_image.png` + `LoadImage`, nodo 17 · `flux_fill_outpaint_example_input_image.png` @@ -143,7 +143,7 @@ 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 @@ -154,5 +154,5 @@ Sube este archivo al nodo `LoadImage` correspondiente: - 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 incluida en el documento al nodo `Load Image`. -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 proporcionada en el documento al nodo `Load Image` +5. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo diff --git a/es/tutorials/flux/flux-1-kontext-dev.mdx b/es/tutorials/flux/flux-1-kontext-dev.mdx index c196d2edc8..5ae91ac977 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, mejor comprensión visual y 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 diff --git a/es/tutorials/flux/flux-2-klein.mdx b/es/tutorials/flux/flux-2-klein.mdx index 09c3acb227..0a91419a2a 100644 --- a/es/tutorials/flux/flux-2-klein.mdx +++ b/es/tutorials/flux/flux-2-klein.mdx @@ -2,21 +2,24 @@ 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" ## 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: unifica la generación de texto a imagen y la 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. **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 @@ -81,14 +84,14 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: ### FLUX.2 [Klein] 4B destilado: 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 destilada 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 de edición de imagen 4B destilada. @@ -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 destilada 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/ @@ -144,19 +147,18 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` - ## Flujos de trabajo de FLUX.2 Klein 9B ### 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. @@ -166,13 +168,13 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: ### FLUX.2 [Klein] 9B: Edición de imagen {#image_flux2_klein_image_edit_9b_base} -Vista previa del flujo de trabajo base de edición de imagen de FLUX.2 Klein 9B +Vista previa del flujo de trabajo de edición de imagen base de FLUX.2 Klein 9B Ejecuta este flujo de trabajo en Comfy Cloud - + Descarga el flujo de trabajo de edición de imagen con el modelo base 9B. @@ -197,18 +199,18 @@ 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} -Vista previa del flujo de trabajo destilado de edición de imagen de FLUX.2 Klein 9B +Vista previa del flujo de trabajo de edición de imagen destilada de FLUX.2 Klein 9B 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 de edición de imagen con el modelo 9B destilado. @@ -232,9 +234,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 de modelos FLUX.2 Klein 9B Para los modelos de difusión, visita el repositorio de BFL, acepta el acuerdo y luego descarga los modelos. diff --git a/es/tutorials/flux/flux-3-klein.mdx b/es/tutorials/flux/flux-3-klein.mdx index ff263a9586..88f91bdb20 100644 --- a/es/tutorials/flux/flux-3-klein.mdx +++ b/es/tutorials/flux/flux-3-klein.mdx @@ -2,15 +2,17 @@ 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] @@ -52,7 +54,7 @@ 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 +4. El upsampler de prompt está activado por defecto, por lo que el upsampler Qwen3.5 9B expande un prompt corto 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} @@ -90,7 +92,7 @@ Edita una foto a partir de un prompt de instrucción, con la imagen original con Abrir en Comfy Cloud
- Descarga el JSON o busca "FLUX 3 Image Klein: Image Edit" en la Biblioteca de plantillas + Descarga el JSON o busca "FLUX 3 Image Klein: Image Edit" en Template Library
@@ -108,7 +110,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: fashion_portrait_blue_silk_gown_vis.png -1. Carga tu imagen fuente en el nodo `LoadImage` +1. Carga tu imagen de origen 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` 4. Ajusta el lienzo con `Empty Flux 2 Latent` (1024 x 1024 en la plantilla) si quieres un tamaño de salida diferente @@ -155,12 +157,12 @@ Sube este archivo al nodo `LoadImage` correspondiente: 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. 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 mayor fidelidad. @@ -171,7 +173,7 @@ Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo d Modelo de difusión, checkpoint destilado por pasos para 4 a 16 pasos.
- Codificador de texto para ambos checkpoints. Cárgalo con `CLIPLoader` de tipo `flux3`. + Codificador de texto para ambos checkpoints. Cárgalo con `CLIPLoader` tipo `flux3`. Upsampler de prompt que usan las plantillas de texto a imagen. @@ -195,11 +197,10 @@ Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo d │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` +## Consejos de prompting y referencias -## 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. +- **Describe 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 condicionamientos.** Conecta imágenes adicionales a `Set Reference Multi Latent` en orden, haz referencia 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 la referencia es un ajuste de costo.** Las plantillas redimensionan cada referencia a aproximadamente 1 megapíxel y el latente de salida adopta ese tamaño. Mantener las referencias en su tamaño nativo, algo que el pipeline propio de Black Forest Labs hace 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 con 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 se muestra en el nodo `Preview Any` para que puedas incorporar las regiones al prompt. diff --git a/es/tutorials/llm/gemma4/gemma4.mdx b/es/tutorials/llm/gemma4/gemma4.mdx index 5ad1c758e2..9a53e6063d 100644 --- a/es/tutorials/llm/gemma4/gemma4.mdx +++ b/es/tutorials/llm/gemma4/gemma4.mdx @@ -2,30 +2,32 @@ 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" -**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, 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. Se admite de forma nativa en ComfyUI como el modelo **Text Generation** predeterminado. **Aspectos destacados del modelo**: - **Multimodal por diseño**: acepta entradas de texto, imagen, video y audio de forma simultánea - **Tres tamaños disponibles**: - **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 + - **E4B (4B)**: rendimiento equilibrado, predeterminado recomendado + - **12B**: la mejor calidad, requiere más VRAM +- **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 desde el primer uso, con preentrenamiento en más de 140 - **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**: usa los nodos integrados `TextGenerate` y `CLIPLoader` para cargarlo y ejecutarlo **Enlaces relacionados**: - [Hugging Face (Comfy-Org/gemma-4)](https://huggingface.co/Comfy-Org/gemma-4) @@ -76,7 +78,7 @@ Este flujo de trabajo demuestra las capacidades principales de **generación de **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**: @@ -88,15 +90,15 @@ Este flujo de trabajo demuestra las capacidades principales de **generación de ## 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 GPU de consumo. - Rendimiento equilibrado. El modelo predeterminado del flujo de trabajo. + Rendimiento equilibrado. Es el modelo predeterminado del flujo de trabajo. @@ -104,7 +106,7 @@ Los modelos Gemma 4 se cargan como codificadores de texto en ComfyUI. Descarga e -Coloca el archivo `.safetensors` descargado en: +Coloca el archivo `.safetensors` que descargaste en: ``` 📂 ComfyUI/ diff --git a/es/tutorials/llm/qwen/qwen3.mdx b/es/tutorials/llm/qwen/qwen3.mdx index b4073fd05c..4814879be2 100644 --- a/es/tutorials/llm/qwen/qwen3.mdx +++ b/es/tutorials/llm/qwen/qwen3.mdx @@ -2,13 +2,15 @@ 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" @@ -19,8 +21,8 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" - **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 formato de codificador de texto de Qwen3.5, disponible en variantes de 2B, 4B y 9B para ajustarse a diferentes configuraciones de hardware ## Casos de uso @@ -35,7 +37,7 @@ Qwen 3.0 es adecuado para tareas que requieren generación de texto estructurado ### Qwen3.0: generación de texto {#llm_qwen3_text_gen} -Introduce un prompt de texto para generar respuestas detalladas y razonadas con el modelo Qwen3-4B-Thinking. +Ingresa un prompt de texto para generar respuestas detalladas y razonadas con el modelo Qwen3-4B-Thinking. Vista previa del flujo de trabajo de generación de texto de Qwen 3.0 @@ -68,7 +70,7 @@ Este flujo de trabajo demuestra las capacidades fundamentales de **generación d ## 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 codificadores de texto en ComfyUI. Los archivos del modelo se comparten con Qwen3.5. Descarga la variante que mejor se adapte a tu hardware: @@ -76,7 +78,7 @@ 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. diff --git a/es/tutorials/llm/qwen/qwen3_5.mdx b/es/tutorials/llm/qwen/qwen3_5.mdx index 4818144e0a..0f5de8b321 100644 --- a/es/tutorials/llm/qwen/qwen3_5.mdx +++ b/es/tutorials/llm/qwen/qwen3_5.mdx @@ -2,13 +2,15 @@ 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" @@ -18,10 +20,10 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" **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 +- **Etiquetado 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, apto para GPUs de consumo ## Casos de uso @@ -37,9 +39,9 @@ Qwen3.5 destaca en escenarios donde combinar la comprensión visual con la gener ### 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 automática 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,17 +63,17 @@ 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 automática 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) +- **Max length**: número máximo de tokens a generar (256 de forma predeterminada) - **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 @@ -84,7 +86,7 @@ Este flujo de trabajo demuestra las capacidades de **generación de texto y comp ## 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. 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..078ea97203 100644 --- a/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx +++ b/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx @@ -2,14 +2,16 @@ 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"; @@ -34,7 +36,7 @@ Ampliación creativa de una imagen generada por IA, con nuevos detalles y textur ## Topaz Image Enhance 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 imágenes generadas por IA con el modelo de ampliación creativa de Bloom 2, que añade nuevos detalles, texturas y elementos visuales. El control Creativity abarca 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 @@ -43,18 +45,18 @@ Mejora imágenes generadas por IA con el modelo de ampliación creativa de Bloom 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
Materiales de entrada -Descarga esta imagen de entrada de ejemplo para probar el flujo de trabajo: +Descarga esta imagen de entrada de muestra para probar el flujo de trabajo: - Descargar imagen de entrada de ejemplo + Descargar imagen de entrada de muestra
@@ -66,19 +68,19 @@ Descarga esta imagen de entrada de ejemplo para probar el 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 +- **ImageCompare**: muestra el resultado mejorado junto al original para comparar ### Pasos para ejecutar 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/partner-nodes/topaz/overview.mdx b/es/tutorials/partner-nodes/topaz/overview.mdx index b54b5643d6..2b495c9055 100644 --- a/es/tutorials/partner-nodes/topaz/overview.mdx +++ b/es/tutorials/partner-nodes/topaz/overview.mdx @@ -2,7 +2,7 @@ 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 --- @@ -18,8 +18,8 @@ Topaz Labs lleva a ComfyUI la mejora de imágenes y video con IA de nivel empres - **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. - **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. +- **Ampliación optimizada para ilustraciones**: modelo especializado en obras de colores planos, line art e ilustraciones digitales que preserva los bordes definidos y los degradados limpios. +- **Pipeline de mejora de video**: procesamiento de video completo que incluye reducción de ruido, desentrelazado, estabilización y ampliación inteligente cuadro por cuadro. @@ -33,7 +33,7 @@ Topaz Labs ofrece una suite de modelos de mejora con IA tanto para imágenes com Mejora generativa de imágenes con restauración de detalle y fuerza ajustable.
- Mejora creativa de imágenes con estilo bloom. + Mejora creativa de imágenes al estilo bloom. Mejora y ampliación precisa de video. 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..cc8bd0b56f 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"; @@ -15,7 +15,7 @@ Topaz Starlight Precise 2.5 es un modelo de ampliación de video disponible en C - **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**: menos artefactos lo hacen 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..9c787e8080 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 --- diff --git a/es/tutorials/video/bytedance/bernini-r.mdx b/es/tutorials/video/bytedance/bernini-r.mdx index 6a796a6bce..69c52b7a58 100644 --- a/es/tutorials/video/bytedance/bernini-r.mdx +++ b/es/tutorials/video/bytedance/bernini-r.mdx @@ -2,25 +2,27 @@ 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 **solo de renderizado** de ByteDance para el acondicionamiento de imágenes y video en contexto. Utiliza 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 +- **Acondicionamiento en contexto**: las imágenes y los 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. - **Soporte flexible de entradas**: referencias de una o varias imágenes, video a video, edición guiada por referencia @@ -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) @@ -69,23 +71,22 @@ ComfyUI/ │ ├── diffusion_models/ │ │ └── wan2.2_bernini_r_fp16.safetensors ``` - ## Flujos de trabajo de ejemplo --- -## 1. Edición de imagen +## 1. Edición de imágenes -**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 antes/después en paralelo. Ideal para la reliuminación de retratos y productos, la iluminación coherente en conjuntos de fotos y la fotografía de catálogo de 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 @@ -103,11 +104,11 @@ ComfyUI/ ### Pasos para ejecutar 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 +2. **Conecta las entradas**: carga la imagen fuente y las imágenes de referencia opcionales +3. **Escribe el prompt**: describe la edición deseada 4. **Ejecuta**: 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, atuendo, escena, accesorios). En el prompt, usa `image0`, `image1`, … para hacer referencia a cada imagen. No se necesita para **Image Editing**: esa tarea usa `source_image` en su lugar. @@ -115,11 +116,9 @@ 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 un cambio de iluminación coherente 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. Vista previa del flujo de trabajo de edición de video con Bernini-R @@ -128,7 +127,7 @@ ComfyUI/ 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 +145,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**: una o varias imágenes de referencia, o un video de referencia 3. **Selecciona el tipo de tarea**: v2v, rv2v, r2v o ads2v -4. **Escribe el prompt**: describe la edición que quieres +4. **Escribe el prompt**: describe la edición que deseas 5. **Ejecuta**: 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 varias 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 desempeñan roles distintos. - 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 extender el flujo de trabajo. @@ -163,6 +162,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: Latent Semantic Planning for Video Diffusion](https://arxiv.org/abs/2605.22344): Artículo de investigación +- [Bernini en 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 para 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..f0868fd14f 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. @@ -18,25 +21,25 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; ## Aspectos destacados del modelo -- **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. -- **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). +- **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 texto a video e imagen a video (5-10s) de alta calidad con una consistencia excepcional. +- **Control preciso**: gran capacidad de 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). ## Modelos comunes para todos los flujos de trabajo -Los siguientes modelos se usan tanto en los flujos de trabajo de texto a video como en los de imagen a video. Descárgalos y guárdalos en los directorios indicados: +Estos modelos se usan tanto en los flujos de trabajo de texto a video como en los de imagen a video. Descárgalos y guárdalos en los directorios indicados: - qwen_2.5_vl_7b_fp8_scaled.safetensors — guárdalo en ComfyUI/models/text_encoders/ + qwen_2.5_vl_7b_fp8_scaled.safetensors: guarda en ComfyUI/models/text_encoders/ - byt5_small_glyphxl_fp16.safetensors — guárdalo en ComfyUI/models/text_encoders/ + byt5_small_glyphxl_fp16.safetensors: guarda en ComfyUI/models/text_encoders/ - - hunyuanvideo15_vae_fp16.safetensors — guárdalo en ComfyUI/models/vae/ + + hunyuanvideo15_vae_fp16.safetensors: guarda en ComfyUI/models/vae/ @@ -51,10 +54,9 @@ ComfyUI/ │ └── 📂 vae/ │ └── hunyuanvideo15_vae_fp16.safetensors ``` - ## Flujo de trabajo de texto a video de 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 una calidad mejorada 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,7 +73,7 @@ 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. Guárdalo en ComfyUI/models/diffusion_models/ @@ -94,26 +96,26 @@ ComfyUI/ 1. Asegúrate de que el nodo `DualCLIPLoader` tenga cargados estos modelos: - clip_name1: `qwen_2.5_vl_7b_fp8_scaled.safetensors` - clip_name2: `byt5_small_glyphxl_fp16.safetensors` -2. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `hunyuanvideo1.5_720p_t2v_fp16.safetensors` -3. Asegúrate de que el nodo `Load VAE` tenga cargado `hunyuanvideo15_vae_fp16.safetensors` +2. Asegúrate de que el nodo `Load Diffusion Model` haya cargado `hunyuanvideo1.5_720p_t2v_fp16.safetensors` +3. Asegúrate de que el nodo `Load VAE` haya cargado `hunyuanvideo15_vae_fp16.safetensors` 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 escalado de superresolución. Cuando está habilitado, usa `hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors` para hacer upscale de la salida a 1080p. ## Flujo de trabajo de imagen a video con 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) +![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) Abrir en Comfy Cloud - Descarga el JSON o busca "Hunyuan Video 1.5 I2V" en la Biblioteca de plantillas + Descarga el JSON o busca "Hunyuan Video 1.5 I2V" en la biblioteca de plantillas @@ -129,10 +131,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/ @@ -154,22 +156,22 @@ ComfyUI/ ### Pasos para ejecutar el flujo de trabajo -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: `qwen_2.5_vl_7b_fp8_scaled.safetensors` - clip_name2: `byt5_small_glyphxl_fp16.safetensors` -2. Asegúrate de que el nodo `CLIPVisionLoader` haya cargado `sigclip_vision_patch14_384.safetensors` -3. Asegúrate de que el nodo `Load Diffusion Model` haya cargado `hunyuanvideo1.5_720p_i2v_fp16.safetensors` -4. Asegúrate de que el nodo `Load VAE` haya cargado `hunyuanvideo15_vae_fp16.safetensors` +2. Asegúrate de que el nodo `CLIPVisionLoader` tenga cargado `sigclip_vision_patch14_384.safetensors` +3. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `hunyuanvideo1.5_720p_i2v_fp16.safetensors` +4. Asegúrate de que el nodo `Load VAE` tenga 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 aplicar upscale al video de salida de 720p a 1080p. Este upscaler opcional usa un modelo destilado para generar una salida de alta resolución de forma 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: +Combinación de todos los modelos compartidos y específicos de los flujos de trabajo: ``` ComfyUI/ diff --git a/es/tutorials/video/hunyuan/hunyuan-video.mdx b/es/tutorials/video/hunyuan/hunyuan-video.mdx index d905fdc10d..f9315fd834 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";