> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Ejecuta tu primer flujo de trabajo

> Ejecuta un flujo de trabajo de ejemplo en Comfy Cloud y descarga su resultado con Python o TypeScript.

Ejecuta un flujo de trabajo completo desde código y guarda su salida como `first-result.png`. Este ejemplo crea una **imagen azul sólida de 512 × 512** usando dos nodos integrados. Verifica la autenticación, la ejecución del flujo de trabajo y la descarga de la salida sin necesitar un modelo, una imagen de entrada ni Nodos personalizados.

Para generar una imagen llamando directamente a un modelo alojado, comienza con el [inicio rápido de Comfy Router](https://docs.comfy.org/es/development/comfy-router/quickstart.md).

Este ejemplo se ejecuta en Comfy Cloud. Para otras opciones de alojamiento, incluidas las implementaciones de Comfy API y el autoalojamiento, consulta [Desplegar ComfyUI](https://docs.comfy.org/es/development/deploy/overview.md).

## Antes de empezar

* Una [clave API de Comfy](https://docs.comfy.org/es/development/api-development/getting-an-api-key.md).
* Una [suscripción de pago a Comfy Cloud](https://docs.comfy.org/es/development/deploy/cloud.md). El acceso a la API de flujos de trabajo de Cloud no está incluido en el plan gratis.
* Python 3.10 o posterior, o Node.js 22.18 o posterior para el ejemplo de TypeScript.

Esta guía usa Comfy Cloud, el objetivo predeterminado de los SDK. Si configuraste `COMFY_BASE_URL` anteriormente, elimínala para usar Cloud. Para una implementación existente de la API de Comfy o una instancia autoalojada, consulta [Elegir una URL base](https://docs.comfy.org/es/development/api-development/sdks.md#elegir-una-url-base).

## Descargar el ejemplo

Crea una carpeta para el ejemplo. Descarga [workflow\_api.json](https://docs.comfy.org/files/api-first-result/workflow_api.json) y el script para tu idioma dentro de esa carpeta:

* [Python: first\_workflow.py](https://docs.comfy.org/files/api-first-result/first_workflow.py)
* [TypeScript: first\_workflow.mts](https://docs.comfy.org/files/api-first-result/first_workflow.mts)

El flujo de trabajo ya está en formato API. El nodo `"1"` crea la imagen azul y el nodo `"2"` la guarda. Los scripts leen las salidas de ese nodo SaveImage exacto, así que no necesitas buscar ni editar un ID de nodo.

## 2. Instalar el SDK y configurar tu clave

Abre una terminal en la carpeta donde guardaste los archivos.

```bash Python theme={null}
python -m venv .venv
source .venv/bin/activate
python -m pip install comfy-sdk
```

```bash TypeScript theme={null}
npm init -y
npm install @comfyorg/sdk
```

En Windows, activa el entorno de Python con `.venv\Scripts\Activate.ps1` en PowerShell.

Configura tu clave en la misma terminal:

```bash macOS / Linux theme={null}
export COMFY_API_KEY="comfyui-your-key"
```

```powershell Windows PowerShell theme={null}
$env:COMFY_API_KEY = "comfyui-your-key"
```

Mantén tu Clave API en el entorno de tu servidor. No la incluyas en código de navegador ni la confirmes en el control de código fuente.

## 3. Ejecutar y ver el resultado

```bash Python theme={null}
python first_workflow.py
```

```bash TypeScript theme={null}
node first_workflow.mts
```

El script envía el flujo de trabajo, espera a que finalice y descarga la imagen. Cuando imprima `Saved` seguido de una ruta, abre `first-result.png` desde esa ubicación. Deberías ver un cuadrado azul sólido. Al ejecutar el ejemplo de nuevo, se reemplaza ese archivo local.

> [!NOTE]
>
> Esta es una comprobación de conexión del flujo de trabajo. No utiliza un modelo generativo. Los mismos pasos de envío, espera y descarga funcionan con tus propios flujos de trabajo de generación.

### Si la solicitud falla

* **Clave faltante o no autorizado:** verifica que `COMFY_API_KEY` esté configurada en la terminal que ejecuta el script y que contenga una clave activa.
* **Error de acceso o de créditos:** revisa tu suscripción de Cloud y los créditos disponibles antes de volver a intentarlo.
* **Archivo de flujo de trabajo no encontrado:** mantén `workflow_api.json` junto al script descargado.
* **Endpoint inesperado:** revisa `COMFY_BASE_URL`. Déjala sin establecer para este ejemplo de Cloud.

Para obtener información sobre el manejo de errores y el progreso de las tareas, consulta la [guía del SDK](https://docs.comfy.org/es/development/api-development/sdks.md).

## 4. Ejecutar tu propio flujo de trabajo de generación

Crea o elige un flujo de trabajo en el editor de ComfyUI, ejecútalo correctamente allí y [expórtalo en formato API](https://docs.comfy.org/es/development/api-development/workflow-api-format.md). Reemplaza `workflow_api.json` con tu exportación y actualiza `get_outputs("2")` en Python o `getOutputs("2")` en TypeScript para usar el ID del nodo SaveImage de tu flujo de trabajo. Comprueba que el entorno objetivo tenga los modelos y los Nodos personalizados que usa tu flujo de trabajo.

Para alojar flujos de trabajo con tus propios modelos y Nodos personalizados, sigue la [Guía de inicio rápido de Comfy API](https://docs.comfy.org/es/development/serverless/quickstart.md). Para cambiar las entradas del flujo de trabajo, subir archivos o seguir el progreso, continúa con [Comfy SDKs](https://docs.comfy.org/es/development/api-development/sdks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.