openapi

Ultralytics OpenAPI es una herramienta que lee especificaciones OpenAPI (versiones 3.0 a 3.2.0) y genera dos salidas a partir de un único contrato: documentación interactiva de API y un SDK de Python tipado. Soporta todas las operaciones HTTP estándar (GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD, TRACE). La configuración se realiza mediante un archivo `openapi.config.json`, donde se especifica la fuente (archivo local o URL), el nombre del paquete generado, la variable de entorno para la clave de API, la ruta base de la documentación y varios metadatos del paquete de Python (autores, clasificadores, versión, licencia, etc.). La herramienta también admite la generación opcional de CLI incluyendo un archivo fuente de Python propiedad del consumidor. Las características clave incluyen: - Clientes de Python síncronos y asíncronos - Recursos tipados y respuestas TypedDict - Soporte de carga multiparte - Reintentos automáticos para fallos temporales - Errores de API estructurados - Manejo de claves de API que permanece en la memoria del navegador para la documentación - Construcciones de documentación estática deterministas - Marca personalizable (logotipo, favicon, tokens de gradiente) - Módulo opcional de proveedor de autenticación para descubrimiento de credenciales personalizado Los SDK generados tienen por defecto la licencia AGPL-3.0, pero se pueden configurar. El proyecto se desarrolla con Bun y uv, e incluye comandos para desarrollo, pruebas y generación. Se planean futuros SDK para TypeScript, Go y Java.