Leer los esquemas de entrada y salida
Cada modelo expone un documento OpenAPI independiente: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 suETag. 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.
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 con422 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 usaresult.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
- Solicitudes en cola: envía una ejecución y recoge el resultado más tarde.
- Errores y reintentos: maneja los fallos sin pagar dos veces.