> ## 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.

# Proxy de API para ComfyUI autoalojado

> Sirve la Comfy API v2 delante de tu propio ComfyUI para que los SDK oficiales ejecuten flujos de trabajo

Los [SDK de Comfy](https://docs.comfy.org/es/development/api-development/sdks.md) hablan [Comfy API v2](https://docs.comfy.org/es/api-reference/v2/overview.md). Un ComfyUI autoalojado sirve la v2 mediante [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy), un pequeño servicio de código abierto que se ejecuta junto a tu instancia.

## Instalar y ejecutar

```bash theme={null}
pip install comfy-api-proxy
comfy-api-proxy
```

De forma predeterminada, hace de proxy del ComfyUI en `127.0.0.1:8188` y sirve la API v2 en `127.0.0.1:8189`. Usa `--comfyui` y `--port` para cambiar cualquiera de los dos.

Ejecútalo con `--comfyui-base-dir /path/to/ComfyUI` si además quieres subir archivos de modelo a tu instalación.

## Apuntar el SDK al proxy

Establece la URL base y crea el cliente como de costumbre:

```bash theme={null}
export COMFY_BASE_URL="http://127.0.0.1:8189"
```

```python Python theme={null}
from comfy_sdk import Comfy

client = Comfy()
```

```typescript TypeScript theme={null}
import { Comfy } from "@comfyorg/sdk";

const client = new Comfy();
```

Todo lo que aparece en la [guía del SDK](https://docs.comfy.org/es/development/api-development/sdks.md) funciona igual con el proxy que con Comfy Cloud.

## Autenticación

La autenticación no es requerida de forma predeterminada. Si el proxy está configurado con un token de portador estático, pasa ese token como la clave API del SDK: `Comfy(api_key="...")`.

> [!WARNING]
>
> El proxy se enlaza solo a loopback de forma predeterminada. Si lo expones más allá de loopback, por ejemplo frente a un ComfyUI en una GPU alquilada, configura un token de portador o coloca un proxy inverso con autenticación delante de él.

## Próximos pasos

* [SDK de Comfy](https://docs.comfy.org/es/development/api-development/sdks.md): la guía del cliente
* [Referencia de Comfy API v2](https://docs.comfy.org/es/api-reference/v2/overview.md): el contrato HTTP que sirve el proxy
* [Opciones de autoalojamiento](https://docs.comfy.org/es/development/deploy/self-hosting.md): dónde ejecutar el ComfyUI detrás del proxy
* [Notas de diseño](https://docs.comfy.org/es/development/api-development/sdks-design.md#el-proxy-local): por qué existe el proxy


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