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

# Descripción general de la API de Cloud v1

> La superficie obsoleta de la API de Cloud v1: autenticación y los endpoints propios de Cloud que Comfy API v2 no expone

> [!WARNING]
>
> **Obsoleto:** La API de Cloud v1 está obsoleta en favor de [Comfy API v2](https://docs.comfy.org/es/api-reference/v2/overview.md). 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](https://docs.comfy.org/es/development/deploy/cloud.md), 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](https://docs.comfy.org/es/api-reference/v2/overview.md) 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](https://docs.comfy.org/es/development/deploy/cloud.md) y los [SDK de Comfy](https://docs.comfy.org/es/development/api-development/sdks.md). Los créditos y los límites de concurrencia se tratan en [Uso y límites](https://docs.comfy.org/es/development/deploy/cloud-usage.md); los ejemplos ejecutables de v1 están en la [Referencia de la API de Cloud](https://docs.comfy.org/es/development/cloud/api-reference.md). Esta página cubre la superficie específica de v1: la autenticación y los endpoints que v2 no expone.

> [!NOTE]
>
> **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

```
https://cloud.comfy.org
```

## Autenticación

Todas las solicitudes v1 requieren una clave API enviada en el encabezado `X-API-Key`:

```bash theme={null}
curl -X GET "https://cloud.comfy.org/api/user" \
  -H "X-API-Key: $COMFY_CLOUD_API_KEY"
```

Consulta [Obtener una clave API](https://docs.comfy.org/es/development/api-development/getting-an-api-key.md) para ver las instrucciones sobre cómo crear y administrar claves. Una clave inválida o faltante devuelve `401`. Una clave con una suscripción inactiva devuelve `429`.

La misma clave se usa para los [Nodos asociados](https://docs.comfy.org/es/tutorials/partner-nodes/overview.md). Por HTTP, la vuelves a pasar en `extra_data.api_key_comfy_org`; consulta [Usar Nodos asociados](https://docs.comfy.org/es/development/cloud/api-reference.md#usar-nodos-asociados) para ver ejemplos.

## Lo que los SDK aún no cubren

Los SDK cubren cómo ejecutar un flujo de trabajo, obtener los resultados y cancelar una tarea. El resto de la superficie de Cloud solo está disponible por HTTP, así que llama directamente a estos endpoints aunque uses un SDK para la ejecución.

| Capacidad | Endpoint | Referencia |
| - | - | - |
| Estado de la cola, tareas en ejecución y pendientes | `GET /api/queue` | [Gestión de la cola](https://docs.comfy.org/es/development/cloud/api-reference.md#gestión-de-la-cola) |
| Interrumpir la ejecución actual | `POST /api/interrupt` | [Gestión de la cola](https://docs.comfy.org/es/development/cloud/api-reference.md#gestión-de-la-cola) |
| Definiciones de nodos y especificaciones de entradas | `GET /api/object_info` | [Información de objetos](https://docs.comfy.org/es/development/cloud/api-reference.md#información-de-objetos) |
| Explorar modelos disponibles | Endpoints de modelos | [Especificación OpenAPI](https://docs.comfy.org/es/development/cloud/openapi.md) |
| Información de la cuenta y del usuario | `GET /api/user` | [Especificación OpenAPI](https://docs.comfy.org/es/development/cloud/openapi.md) |
| Subidas de máscaras que hacen referencia a una imagen existente | `POST /api/upload/mask` | [Subir entradas](https://docs.comfy.org/es/development/cloud/api-reference.md#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.

## Endpoints disponibles

| Categoría | Descripción |
| - | - |
| [Flujos de trabajo](https://docs.comfy.org/es/development/cloud/api-reference.md#ejecutar-flujos-de-trabajo) | Envía flujos de trabajo y consulta su estado |
| [Tareas](https://docs.comfy.org/es/development/cloud/api-reference.md#comprobar-el-estado-de-la-tarea) | Supervisa el estado y la cola de las tareas |
| [Entradas](https://docs.comfy.org/es/development/cloud/api-reference.md#subir-entradas) | Sube imágenes, máscaras y otras entradas |
| [Salidas](https://docs.comfy.org/es/development/cloud/api-reference.md#downloading-outputs) | Descarga el contenido generado |
| [WebSocket](https://docs.comfy.org/es/development/cloud/api-reference.md#websocket-para-el-progreso-en-tiempo-real) | Actualizaciones de progreso en tiempo real |
| [Información de objetos](https://docs.comfy.org/es/development/cloud/api-reference.md#información-de-objetos) | Nodos disponibles y sus definiciones |

## Manejo de errores

Los endpoints REST devuelven códigos de estado HTTP estándar:

| Estado | Descripción |
| - | - |
| `400` | Solicitud inválida (flujo de trabajo incorrecto, campos faltantes) |
| `401` | No autorizado (clave API inválida o faltante) |
| `402` | Créditos insuficientes |
| `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`.

Las fallas de ejecución son independientes de los errores HTTP. Consulta [Manejo de errores](https://docs.comfy.org/es/development/cloud/api-reference.md#manejo-de-errores) para conocer los valores de `exception_type` que se entregan durante la ejecución.

## Próximos pasos

> **[Comfy Cloud Quickstart](https://docs.comfy.org/es/development/deploy/cloud.md)**
>
> Ejecuta un flujo de trabajo desde Python o TypeScript.

> **[Uso y límites](https://docs.comfy.org/es/development/deploy/cloud-usage.md)**
>
> Revisa los créditos de Cloud, la concurrencia y las integraciones v1 existentes.

> **[Referencia de la API de Cloud](https://docs.comfy.org/es/development/cloud/api-reference.md)**
>
> Documentación completa de los endpoints con ejemplos en curl, Python y TypeScript.

> **[Referencia de Comfy API v2](https://docs.comfy.org/es/api-reference/v2/overview.md)**
>
> La API HTTP versionada que sustenta ambos SDK. Úsala desde cualquier idioma.

> **[Especificación OpenAPI](https://docs.comfy.org/es/development/cloud/openapi.md)**
>
> Especificación de API legible por máquina para generar código.


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