Acceso autenticado mediante un token

Requisitos previos

Ha obtenido un token de usuario, ruta local al archivo de inferencia, URL del servicio en tiempo real y parámetros de entrada del servicio en tiempo real.

• Para obtener detalles sobre cómo obtener un token de usuario, consulte Autenticación basada en token. Las API de servicio en tiempo real generadas por ModelArts no admiten tokens cuyo alcance es dominio. Por lo tanto, es necesario obtener el token cuyo alcance es proyecto.
• La ruta local al archivo de inferencia puede ser una ruta absoluta (por ejemplo, D:/test.png para Windows y /opt/data/test.png para Linux) o una ruta relativa (por ejemplo, ./test.png).
• Puede obtener URL del servicio y los parámetros de entrada de un servicio en tiempo real en la página de ficha Usage Guides de su página de detalles del servicio.

  La URL de API es la URL de servicio del servicio en tiempo real. Si se define una ruta para apis en el archivo de configuración del modelo, la URL debe ir seguida de la ruta definida por el usuario, por ejemplo, {URL of the real-time service}/predictions/poetry.

  Figura 1 Obtención de la URL de la API y los parámetros de entrada de predicción de archivos de un servicio en tiempo real
  
  Figura 2 Obtención de la URL de la API y los parámetros de entrada de predicción de texto de un servicio en tiempo real
  

Método 1: Usar software basado en GUI para inferencia (Postman)

1. Descargue Postman e instalarlo, o instalar la extensión Postman Chrome. Alternativamente, utilice otro software que pueda enviar solicitudes POST. Se recomienda Postman 7.24.0.
2. Active Postman. Figura 3 muestra la interfaz de Postman.
   Figura 3 Interfaz de Postman
   
3. Establezca los parámetros en Postman. A continuación se utiliza la clasificación de imágenes como ejemplo.
   • Seleccione una tarea de POST y copie URL de la API en el cuadro de texto POST. En la página de pestaña Headers, establezca Key en X-Auth-Token y Value en el token de usuario.
     NOTA:

     También puede utilizar las AK y SK para cifrar las solicitudes de invocaciones a la API. Para obtener más información, véase Descripción de autenticación de sesión.

     Figura 4 Configuración de parámetros
     
   • En la página de la ficha Body, la entrada de archivo y la entrada de texto están disponibles.
     • Ingreso de archivo

       Seleccione form-data. Establezca KEY en el parámetro de entrada de la aplicación de IA, que debe ser el mismo que el parámetro de entrada del servicio en tiempo real. En este ejemplo, KEY es images. Establezca VALUE en una imagen que se va a inferir (solo se puede inferir una imagen). Consulte Figura 5.

       Figura 5 Configuración de parámetros en la página de ficha Body
       
     • Ingreso de texto

       Seleccione raw y luego JSON(application/json). Introduzca el cuerpo de la solicitud en el cuadro de texto siguiente. Un cuerpo de solicitud de ejemplo es el siguiente:

       {
         "meta": {
           "uuid": "10eb0091-887f-4839-9929-cbc884f1e20e"
         },
         "data": {
           "req_data": [
             {
               "sepal_length": 3,
               "sepal_width": 1,
               "petal_length": 2.2,
               "petal_width": 4
             }
           ]
         }
       }

       meta puede llevar un identificador único universal (UUID). Cuando se devuelve el resultado de la inferencia después de invocar a la API, se devuelve el UUID para rastrear la solicitud. Si no necesita esta función, deje meta en blanco. data contiene una matriz req_data para una o varias piezas de datos de entrada. Los parámetros de cada pieza de datos, como sepal_length y sepal_width en este ejemplo son determinados por la aplicación de IA.

4. Después de establecer los parámetros, haga clic en send para enviar la solicitud. El resultado se mostrará en Response.
   • Resultado de inferencia usando la entrada de archivo: Figura 6 muestra un ejemplo. Los valores de campo en el resultado devuelto varían según la aplicación de IA.
   • Resultado de inferencia usando la entrada de texto: Figura 7 muestra un ejemplo. El cuerpo de la solicitud contiene meta y data. Si la solicitud contiene uuid, uuid se devolverá en la respuesta. De lo contrario, el uuid se deja en blanco. data contiene una matriz resp_data para los resultados de inferencia de una o varias piezas de datos de entrada. Los parámetros de cada resultado se determinan mediante la aplicación de IA, por ejemplo, sepal_length y predictresult en este ejemplo.
     Figura 6 Resultado de inferencia de archivo
     
     Figura 7 Resultado de inferencia de texto
     

Método 2: Ejecutar el comando cURL para enviar una solicitud de inferencia

El comando para enviar solicitudes de inferencia se puede introducir como un archivo o texto.