Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions es/development/cloud/api-reference.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,21 +3,22 @@ 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
"Complete End-to-End Example": 2c800815
"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"
Expand Down Expand Up @@ -274,7 +275,7 @@ def upload_mask(file_path: str, original_ref: dict) -> dict:
Envía un flujo de trabajo para ejecutarlo.

<Info>
**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.
</Info>

### Enviar flujo de trabajo
Expand Down
45 changes: 23 additions & 22 deletions es/development/cloud/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,21 +12,22 @@ translationBlockHashes:
"Error Handling": f5e3c80a
"Next Steps": 962d77bb
---

<Warning>
**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.
</Warning>

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.

<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).
</Note>

## URL base
## Base URL

```
https://cloud.comfy.org
Expand All @@ -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 |
|--------|-------------|
Expand All @@ -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

Expand All @@ -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.
</Card>
<Card title="Especificación OpenAPI" icon="file-code" href="/es/development/cloud/openapi">
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.
</Card>
</CardGroup>
Loading
Loading