Actualización a la API 3.0
Custom Vision ha alcanzado ahora la disponibilidad general y ha pasado por una actualización de la API. Esta actualización incluye algunas características nuevas y, lo que es más importante, algunos cambios importantes:
- Prediction API ahora se divide en dos, según el tipo de proyecto.
- La opción de exportación del kit para desarrolladores de Vision AI (VAIDK) requiere la creación de un proyecto de una manera específica.
- Las iteraciones predeterminadas se han eliminado en favor de una publicación o cancelación de publicación de una iteración con nombre.
En esta guía se muestra cómo actualizar los proyectos para que funcionen con la nueva versión de API. Consulte las notas de la versión para obtener una lista completa de los cambios.
Uso de la versión de Prediction API actualizada
Las API 2.0 usaban la misma llamada de predicción tanto para los clasificadores de imagen como para los proyectos de detección de objetos. Ambos tipos de proyecto eran aceptables para las llamadas PredictImage y PredictImageUrl. A partir de la versión 3.0, hemos dividimos esta API para que deba relacionar el tipo de proyecto con la llamada:
- Use ClassifyImage y ClassifyImageUrl para obtener predicciones para los proyectos de clasificación de imágenes.
- Use DetectImage y DetectImageUrl para obtener predicciones para los proyectos de detección de objetos.
Uso del nuevo flujo de trabajo de publicación de iteraciones
Las API 2.0 usaban la iteración predeterminada o un identificador de iteración especificado para elegir qué iteración emplear con la predicción. A partir de la versión 3.0, hemos adoptado un flujo de publicación mediante el cual primero se publica una iteración con un nombre especificado desde la API de entrenamiento. A continuación, se pasa el nombre a los métodos de predicción para especificar qué iteración usar.
Importante
Las API 3.0 no usan la característica de iteración predeterminada. Hasta que se pongan en desuso las API anteriores, puede seguir usando las API 2.0 para activar o desactivar una iteración como predeterminada. Estas API se mantendrá durante un tiempo, y puede llamar al método UpdateIteration para marcar una iteración como predeterminada.
Publicación de una iteración
Después de entrenar una iteración, puede hacer que esté disponible para la predicción mediante el método PublishIteration. Para publicar una iteración, necesitará el identificador de recurso de predicción, que está disponible en la página de configuración del sitio web de Custom Vision.
Sugerencia
También puede obtener esta información de Azure Portal; para ello, vaya a recurso de predicción de Custom Vision y seleccione Propiedades.
Después de publicar la iteración, las aplicaciones pueden usarla en la predicción mediante la especificación del nombre en su llamada a la API de predicción. Para que una iteración deje de estar disponible para las llamadas de predicción, use la API UnpublishIteration.