Saltar al contenido principal
La función principal de Producer Tasks API es consultar el estado de ejecución de una tarea introduciendo el ID de la tarea generado por Producer Audios Generation API. Este documento presentará en detalle las instrucciones de integración de Producer Tasks API, ayudándole a integrar fácilmente y aprovechar plenamente las potentes funciones de esta API. A través de Producer Tasks API, puede implementar fácilmente la consulta del estado de ejecución de las tareas de Producer Audios Generation API.

​
Proceso de solicitud

Para utilizar Producer Audios Generation API, primero obtenga su API Token en la consola de Ace Data Cloud y guárdelo para usarlo posteriormente. Si aún no ha iniciado sesión o no se ha registrado, será redirigido automáticamente a la página de inicio de sesión para invitarle a registrarse e iniciar sesión; al completarlo, volverá automáticamente a la página actual. Un API Token puede invocar todos los servicios de la plataforma, sin necesidad de solicitar uno por separado para cada servicio. La primera solicitud incluirá créditos gratuitos, que podrá utilizar para una experiencia gratuita; cuando los créditos sean insuficientes, puede recargar saldo general en la consola.
📘 Documentación completa: Producer Audios Generation API →

​
Ejemplo de solicitud

Producer Tasks API puede utilizarse para consultar los resultados de Producer Audios Generation API. Para saber cómo utilizar Producer Audios Generation API, consulte la documentación Producer Audios Generation API . Tomamos como ejemplo un ID de tarea devuelto por el servicio Producer Audios Generation API, para demostrar cómo utilizar esta API. Supongamos que tenemos un ID de tarea: 1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad; a continuación, se demostrará cómo mediante la introducción de un ID de tarea.

​
Imagen de ejemplo de tarea

​
Configurar encabezados y cuerpo de la solicitud

Request Headers incluyen:
  • accept: especifica la recepción de resultados de respuesta en formato JSON; aquí se rellena como application/json.
  • authorization: la clave para invocar la API, que puede seleccionarse directamente desde la lista desplegable después de solicitarla.
Request Body incluye:
  • id: el ID de la tarea subida.
  • action: el método de operación de la tarea.
La configuración se muestra en la siguiente imagen:

​
Ejemplo de código

Puede observarse que, en el lado derecho de la página, ya se ha generado automáticamente código en varios lenguajes, como se muestra en la imagen:

Algunos ejemplos de código son los siguientes:

​
CURL

​
Ejemplo de respuesta

Después de que la solicitud se realice correctamente, la API devolverá la información detallada de la tarea aquí. Por ejemplo:
El resultado devuelto contiene varios campos. El campo request es el request body al iniciar la tarea, mientras que el campo response es el response body devuelto después de que la tarea se complete. La introducción de los campos es la siguiente.
  • id, el ID de la tarea de generación, utilizado para identificar de forma única esta tarea de generación.
  • request, la información de solicitud en la tarea de consulta.
  • response, la información de respuesta en la tarea de consulta.
  • created_at, la hora de creación de la tarea, marca de tiempo Unix (segundos, punto flotante).
  • started_at, la hora en que la tarea comienza a ejecutarse, marca de tiempo Unix (segundos, punto flotante).
  • finished_at, la hora de finalización de la tarea, marca de tiempo Unix (segundos, punto flotante). Este campo no se devuelve cuando la tarea no ha finalizado.
  • elapsed, el tiempo de ejecución de la tarea, en segundos (punto flotante, conservando 3 decimales). Este campo no se devuelve cuando la tarea no ha finalizado.

​
Operación de consulta por lotes

Esto es para consultar los detalles de la tarea para múltiples ID de tarea. A diferencia de lo anterior, es necesario seleccionar retrieve_batch como action. El Request Body incluye:
  • ids: el array de ID de tareas subidas.
  • action: el método de operación para las tareas.
La configuración se muestra en la siguiente imagen:

​
Ejemplo de código

Se puede observar que en el lado derecho de la página se ha generado automáticamente código en varios lenguajes, como se muestra en la imagen:

Algunos ejemplos de código son los siguientes:

​
Ejemplo de respuesta

Después de que la solicitud se realice correctamente, la API devolverá la información detallada de todas las tareas por lotes de esta ocasión. Por ejemplo:
El resultado devuelto tiene múltiples campos en total, entre los cuales items contiene la información detallada específica de las tareas por lotes; la información específica de cada tarea es igual que los campos anteriores, y la información de los campos es la siguiente.
  • items, toda la información detallada específica de las tareas por lotes. Es un arreglo, y cada elemento del arreglo tiene el mismo formato que el resultado devuelto de la consulta de una sola tarea anterior.
  • count, la cantidad de tareas consultadas por lotes aquí.

​
CURL

​
Manejo de errores

Al llamar a la API, si se encuentra un error, la API devolverá el código de error y la información correspondientes. Por ejemplo:
  • 400 token_mismatched：Solicitud incorrecta, posiblemente debido a parámetros faltantes o no válidos.
  • 400 api_not_implemented：Solicitud incorrecta, posiblemente debido a parámetros faltantes o no válidos.
  • 401 invalid_token：No autorizado, token de autorización no válido o faltante.
  • 429 too_many_requests：Demasiadas solicitudes, ha excedido el límite de frecuencia.
  • 500 api_error：Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de respuesta de error

​
Conclusión

A través de este documento, ya ha comprendido cómo usar la API de Producer Tasks para consultar toda la información detallada específica de una tarea individual o de tareas por lotes. Esperamos que este documento pueda ayudarle a integrar y utilizar mejor esta API. Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de soporte técnico.