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

# Esquemas y resultados de modelos de Comfy Router

> Obtén el esquema OpenAPI de entrada y salida de un modelo de Router, guárdalo en caché con ETags y lee la forma del resultado nativo del modelo.

Cada modelo de Router acepta su propio cuerpo de solicitud nativo y devuelve su propio resultado nativo. Lee el esquema del modelo para conocer ambos.

## Leer los esquemas de entrada y salida

Cada modelo expone un documento OpenAPI independiente:

```bash theme={null}
curl --dump-header schema-headers.txt \
  -H "X-API-Key: $COMFY_API_KEY" \
  https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json
```

Dentro de la operación del modelo, `requestBody` describe la entrada y la respuesta `200` describe la salida cuando se ha creado un esquema de salida. La validación de entrada y la documentación de salida son cosas distintas: Router valida contra su esquema de entrada, pero no valida el resultado del proveedor devuelto contra su esquema de salida.

Revisa el tipo de medio de la salida además de sus campos. Una salida sin esquema creado puede usar `*/*`, y algunos modelos devuelven datos binarios en lugar de JSON.

### Almacenar un esquema en caché

Guarda el esquema y su `ETag`. En una consulta posterior del esquema, pasa ese ETag en `If-None-Match`. Una respuesta `304` no tiene cuerpo; conserva el documento en caché. Una `200` proporciona un documento de reemplazo y un ETag.

```bash theme={null}
curl -H "X-API-Key: $COMFY_API_KEY" \
  -H 'If-None-Match: "previous-etag-value"' \
  https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json
```

La ruta del esquema usa `Cache-Control: private, must-revalidate`. Mantén las respuestas autenticadas fuera de las cachés compartidas. Este comportamiento de ETag/304 se aplica solo al endpoint del esquema.

## Validación y esquemas de respaldo

Un esquema de entrada creado rechaza los campos inválidos antes de la llamada al proveedor con `422` y un arreglo `detail[]`. Lee las rutas de los campos en `loc`; consulta [errores de validación](https://docs.comfy.org/es/development/comfy-router/errors.md#errores-de-validación).

Algunos esquemas aceptan cualquier objeto JSON y establecen `x-comfy-input-schema-authored: false`. Router reenvía esas solicitudes sin validación específica del modelo, así que el proveedor todavía puede rechazarlas.

## Leer el resultado

Router devuelve la forma del resultado terminal de cada modelo. No hay un sobre común de imagen, video o texto: la salida de imagen de BFL usa `result.sample`, mientras que otros modelos pueden devolver listas de URL o bytes en línea.

Comfy realoja algunas URL de recursos; otras siguen siendo URL del proveedor o bytes en línea. Consulta [recursos del resultado](https://docs.comfy.org/es/development/comfy-router/reference.md#recursos-del-resultado) y descarga pronto los recursos que expiran. Las repeticiones no renuevan las URL.

## Próximos pasos

* [Solicitudes en cola](https://docs.comfy.org/es/development/comfy-router/queue.md): envía una ejecución y recoge el resultado más tarde.
* [Errores y reintentos](https://docs.comfy.org/es/development/comfy-router/errors.md): maneja los fallos sin pagar dos veces.


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