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

# Especificación OpenAPI

> Especificación OpenAPI legible por máquina para la API de Comfy Cloud

> [!WARNING]
>
> **Obsoleto:** la API v1 de Cloud está obsoleta en favor de [Comfy API v2](https://docs.comfy.org/es/api-reference/v2/overview.md). Los endpoints, los formatos de solicitud y respuesta, y el comportamiento pueden modificarse sin previo aviso.

# Especificación de la API de Comfy Cloud

Esta página proporciona la especificación completa de OpenAPI 3.0 para la API de Comfy Cloud.

> [!NOTE]
>
> **Suscripción requerida:** ejecutar flujos de trabajo mediante la API requiere una suscripción activa a Comfy Cloud. Consulta los [planes de precios](https://www.comfy.org/cloud/pricing?utm_source=docs\&utm_campaign=cloud-api) para obtener más detalles.

## Referencia interactiva de la API

Explora la API completa con documentación interactiva:

> **[Referencia de la API de Cloud](https://docs.comfy.org/es/api-reference/cloud/overview)**
>
> Explora los endpoints, consulta los esquemas y prueba solicitudes

## Usar la especificación

La especificación OpenAPI sirve para:

* **Generar bibliotecas cliente** en cualquier idioma con herramientas como [OpenAPI Generator](https://openapi-generator.tech/)
* **Importar en herramientas de API** como Postman, Insomnia o Paw
* **Generar documentación** con herramientas como Redoc o Swagger UI
* **Validar solicitudes** en tu aplicación

## Descargar

Puedes descargar el archivo de especificación OpenAPI sin procesar:

> **[openapi-cloud.yaml](https://raw.githubusercontent.com/Comfy-Org/docs/main/openapi-cloud.yaml)**
>
> Descarga la especificación OpenAPI 3.0

## Autenticación

Todas las solicitudes a la API requieren una clave API que se envía en el encabezado `X-API-Key`.

### Obtener una clave API

Consulta [Obtener una clave API](https://docs.comfy.org/es/development/api-development/getting-an-api-key.md) para ver instrucciones paso a paso con capturas de pantalla.

### Usar la clave API

```yaml theme={null}
X-API-Key: your-api-key
```

## URL base

| Entorno | URL |
| - | - |
| Producción | `https://cloud.comfy.org` |

## Conexión WebSocket

Para recibir actualizaciones en tiempo real, conéctate al endpoint de WebSocket:

```
wss://cloud.comfy.org/ws?clientId={uuid}&token={api_key}
```

Consulta la [Referencia de la API de Cloud](https://docs.comfy.org/es/development/cloud/api-reference.md#websocket-para-el-progreso-en-tiempo-real) para conocer los tipos de mensajes y cómo manejarlos.


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