Usa el Explorador de API

En esta guía de inicio rápido, se te guiará por los siguientes procesos:

  • Crear un bucket de Cloud Storage.
  • Subir tu imagen a Cloud Storage y hacerla pública.
  • Realizar una solicitud a la API de Vision con esa imagen.

Completar estos pasos lleva unos 5 minutos. Puedes almacenar hasta 5 GB de datos en Cloud Storage gratis y realizar hasta 1000 solicitudes de características a la API de Vision gratis por mes.

Antes de comenzar

Si todavía no lo hiciste, configura tu proyecto y crea un bucket de Google Cloud Storage, de la manera en que se explica a continuación.

Configura tu proyecto

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyecto

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita la API Cloud Vision.

    Habilita la API

Crea un bucket de Cloud Storage

  1. En Cloud Console, ve a la página Navegador de Cloud Storage.

    Ir al navegador

  2. Haz clic en Crear bucket.
  3. En la página Crear un bucket, ingresa la información de tu bucket. Para ir al siguiente paso, haz clic en Continuar.
    • Para Asignar un nombre a tu depósito, ingresa un nombre de bucket único. No incluyas información sensible en el nombre del bucket porque su espacio de nombres es global y públicamente visible.
    • Para Elige dónde almacenar tus datos, sigue estos pasos:
      • Seleccione una opción de Tipo de ubicación.
      • Selecciona una opción de Ubicación.
    • Para Elegir una clase de almacenamiento predeterminado para tus datos, selecciona lo siguiente:Estándar.
    • En Elegir cómo controlar el acceso a los objetos, selecciona una opción Control de acceso.
    • En Configuración avanzada (opcional), especifica un método de encriptación, una política de retención o etiquetas de depósito.
  4. Haga clic en Crear.

Realiza una solicitud al servicio de la API de Cloud Vision

  1. Descarga demo-img.jpg. (tal vez debas hacer clic con el botón derecho en el vínculo).

  2. Abre el navegador de Cloud Console Storage.

  3. Selecciona el bucket que creaste en la sección anterior.

  4. Haz clic en Subir archivos y selecciona el archivo demo-img.jpg para subirlo desde tu máquina local al depósito de Cloud Storage.

    Este es el archivo de imagen que acabas de subir:
    Imagen de mujeres andando en bicicleta en Yakarta
    Crédito de la imagen: Rohiim Ariful en Unsplash.

  5. Después de subir y enumerar el archivo en el navegador de Cloud Storage, comparte la imagen de manera pública.

  6. Completa la plantilla interactiva del Explorador de API que aparece a continuación. Para ello, reemplaza cloud-samples-data/vision en el campo image.source.imageUri por el nombre del depósito de Cloud Storage en el que subiste el archivo demo-img.jpg. El cuerpo de la solicitud debe verse de la siguiente manera:

    {
      "requests": [
        {
          "features": [
            {
              "type": "LABEL_DETECTION"
            }
          ],
          "image": {
            "source": {
              "imageUri": "gs://cloud-samples-data/vision/demo-img.jpg"
            }
          }
        }
      ]
    }

  7. Haz clic en Ejecutar para enviar la solicitud al servicio. La respuesta JSON aparece arriba.

Felicitaciones Realizaste tu primera solicitud images.annotate al servicio de la API de Cloud Vision.

Limpia

Si deseas evitar cargos innecesarios de Google Cloud Platform, usa Cloud Console para borrar tu bucket de Cloud Storage (y tu proyecto) si no los necesitas.

¿Qué sigue?