Skip to main content
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:
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.
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. 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 y descarga pronto los recursos que expiran. Las repeticiones no renuevan las URL.

Próximos pasos