Integración y uso de la API de Tareas del Productor

La función principal de la API de Tareas del Productor es consultar el estado de ejecución de una tarea mediante el ID de tarea generado por la API de Generación de Audios del Productor. Este documento detallará las instrucciones de integración de la API de Tareas del Productor, ayudándole a integrar y aprovechar al máximo las potentes funciones de esta API. A través de la API de Tareas del Productor, puede consultar fácilmente el estado de ejecución de las tareas de la API de Generación de Audios del Productor.

Proceso de Solicitud

Para utilizar la API de Generación de Audios del Productor, primero debe obtener su Token de API en el Consola de Ace Data Cloud y guardarlo para su uso posterior.

Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión que le invitará a registrarse e iniciar sesión, y una vez completado, regresará automáticamente a la página actual. Un Token de API es suficiente para acceder a todos los servicios de la plataforma, sin necesidad de solicitar uno por cada servicio. La primera solicitud incluirá un crédito gratuito para que pueda experimentar sin costo; cuando el crédito sea insuficiente, puede recargar el saldo general en la consola.

📘 Documentación completa: API de Generación de Audios del Productor →

Ejemplo de Solicitud

La API de Tareas del Productor se puede utilizar para consultar los resultados de la API de Generación de Audios del Productor. Para saber cómo utilizar la API de Generación de Audios del Productor, consulte la documentación API de Generación de Audios del Productor. Tomaremos como ejemplo un ID de tarea devuelto por el servicio de la API de Generación de Audios del Productor, y demostraremos cómo utilizar esta API. Supongamos que tenemos un ID de tarea: 1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad, a continuación, demostraremos cómo pasar un ID de tarea.

Ejemplo de Tarea

Configuración de Encabezados de Solicitud y Cuerpo de Solicitud

Request Headers incluye:

accept: especifica que se aceptan respuestas en formato JSON, aquí se debe llenar como application/json.
authorization: la clave para llamar a la API, que puede seleccionarse directamente después de la solicitud.

Request Body incluye:

id: el ID de tarea cargado.
action: el método de operación sobre la tarea.

La configuración es como se muestra en la siguiente imagen:

Ejemplo de Código

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

Algunos ejemplos de código son los siguientes:

CURL

curl -X POST 'https://api.acedata.cloud/producer/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
  "action": "retrieve"
}'

Ejemplo de Respuesta

Después de una solicitud exitosa, la API devolverá la información detallada de la tarea aquí. Por ejemplo:

{
  "_id": "69541b81ff2676299ccc3b29",
  "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
  "api_id": "01d96900-9f8c-41d7-814c-95c7a885ba61",
  "application_id": "920ba772-867a-48ae-8efa-9b9f94136199",
  "created_at": 1767119745.524,
  "started_at": 1767119745.584,
  "finished_at": 1767119785.589,
  "elapsed": 40.005,
  "credential_id": "eeae817d-d6ff-493e-8f88-6c62391da7c6",
  "request": {
    "action": "generate",
    "model": "FUZZ-2.0 Pro",
    "instrumental": false,
    "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
    "custom": true,
    "callback_url": "https://webhook.site/0d73431d-f833-4be4-9276-b6e1690d55c1"
  },
  "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb",
  "type": "audios",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
    "data": [
      {
        "id": "1dd08826-478e-43a6-868f-aff5ababac2c",
        "title": "Woke up with the sun in my eyes",
        "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
        "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
        "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
        "video_url": null,
        "image_id": "1dd08826-478e-43a6-868f-aff5ababac2c",
        "topic": null,
        "seed": "1490770667",
        "sound": "",
        "created_at": "2025-12-30T18:36:00.994141Z",
        "model": "FUZZ-2.0 Pro",
        "progress": "100%",
        "state": "succeeded",
        "duration": "135.2330158730159"
      }
    ]
  }
}

El resultado devuelto tiene varios campos, el campo request es el cuerpo de la solicitud al iniciar la tarea, mientras que el campo response es el cuerpo de respuesta devuelto después de completar la tarea. La descripción de los campos es la siguiente.

id，generar el ID de la tarea, utilizado para identificar de manera única esta tarea de generación.
request，información de la solicitud en la tarea de consulta.
response，información de la respuesta en la tarea de consulta.
created_at，hora de creación de la tarea, marca de tiempo Unix (segundos, flotante).
started_at，hora de inicio de ejecución de la tarea, marca de tiempo Unix (segundos, flotante).
finished_at，hora de finalización de la tarea, marca de tiempo Unix (segundos, flotante). No se devuelve este campo si la tarea no está completa.
elapsed，tiempo de ejecución de la tarea, en segundos (flotante, con 3 decimales). No se devuelve este campo si la tarea no está completa.

Operación de consulta por lotes

Esto es para consultar los detalles de múltiples ID de tareas, a diferencia de lo anterior, se necesita seleccionar la acción como retrieve_batch. Cuerpo de la solicitud incluye:

ids：array de IDs de tareas subidos.
action：modo de operación sobre la tarea.

Configurar como se muestra en la imagen a continuación:

Ejemplo de código

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

Parte del ejemplo de código es el siguiente:

Ejemplo de respuesta

Después de una solicitud exitosa, la API devolverá los detalles específicos de todas las tareas por lotes. Por ejemplo:

{
  "items": [
    {
      "_id": "69541b81ff2676299ccc3b29",
      "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
      "api_id": "01d96900-9f8c-41d7-814c-95c7a885ba61",
      "application_id": "920ba772-867a-48ae-8efa-9b9f94136199",
      "created_at": 1767119745.524,
      "started_at": 1767119745.584,
      "finished_at": 1767119785.589,
      "elapsed": 40.005,
      "credential_id": "eeae817d-d6ff-493e-8f88-6c62391da7c6",
      "request": {
        "action": "generate",
        "model": "FUZZ-2.0 Pro",
        "instrumental": false,
        "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
        "custom": true,
        "callback_url": "https://webhook.site/0d73431d-f833-4be4-9276-b6e1690d55c1"
      },
      "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb",
      "type": "audios",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
        "data": [
          {
            "id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "title": "Woke up with the sun in my eyes",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
            "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
            "video_url": null,
            "image_id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "topic": null,
            "seed": "1490770667",
            "sound": "",
            "created_at": "2025-12-30T18:36:00.994141Z",
            "model": "FUZZ-2.0 Pro",
            "progress": "100%",
            "state": "succeeded",
            "duration": "135.2330158730159"
          }
        ]
      }
    }, {
      "_id": "69541b81ff2676299ccc3b29",
      "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
      "api_id": "01d96900-9f8c-41d7-814c-95c7a885ba61",
      "application_id": "920ba772-867a-48ae-8efa-9b9f94136199",
      "created_at": 1767119745.524,
      "started_at": 1767119745.584,
      "finished_at": 1767119785.589,
      "elapsed": 40.005,
      "credential_id": "eeae817d-d6ff-493e-8f88-6c62391da7c6",
      "request": {
        "action": "generate",
        "model": "FUZZ-2.0 Pro",
        "instrumental": false,
        "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
        "custom": true,
        "callback_url": "https://webhook.site/0d73431d-f833-4be4-9276-b6e1690d55c1"
      },
      "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb",
      "type": "audios",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response":
{
        "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
        "data": [
          {
            "id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "title": "Desperté con el sol en mis ojos",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Verso]\nDesperté con el sol en mis ojos\nSin nubes arriba, solo azul en el cielo\nZapatos en mis pies, estoy listo para correr\nCada paso se siente como un arma cargada\n[Estribillo]\nDías felices están llegando\nDeja que la alegría esté debajo de mi piel\nSin más sombras, sin más mentiras\nSolo la verdad que me eleva\n[Verso 2]\nBailando por las calles de la ciudad\nUn ritmo golpeando en mi latido\nDesconocidos sonríen, se contagia\nEste mundo es un escenario, todos somos una canción\n[Estribillo]\nDías felices están llegando\nDeja que la alegría esté debajo de mi piel\nSin más sombras, sin más mentiras\nSolo la verdad que me eleva\n[Puente]\nLanza tus preocupaciones por la puerta\nDéjalas hundirse en el fondo del océano\nEstamos vivos y es suficiente\nLa vida es desordenada, pero es amor\n[Estribillo]\nDías felices están llegando\nDeja que la alegría esté debajo de mi piel\nSin más sombras, sin más mentiras\nSolo la verdad que me eleva",
            "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
            "video_url": null,
            "image_id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "topic": null,
            "seed": "1490770667",
            "sound": "",
            "created_at": "2025-12-30T18:36:00.994141Z",
            "model": "FUZZ-2.0 Pro",
            "progress": "100%",
            "state": "succeeded",
            "duration": "135.2330158730159"
          }
        ]
      }
    }
  ],
  "count": 2
}

La respuesta contiene varios campos, donde items incluye los detalles específicos de la tarea por lotes, cada información de tarea específica es igual a la estructura de resultado de consulta de una sola tarea anterior, la información de los campos es la siguiente.

items, todos los detalles específicos de la tarea por lotes. Es un arreglo, cada elemento del arreglo tiene el mismo formato que el resultado de consulta de una sola tarea anterior.
count, el número de tareas en esta consulta por lotes.

CURL

curl -X POST 'https://api.acedata.cloud/producer/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad","1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad"],
  "action": "retrieve_batch"
}'

Manejo de errores

Al llamar a la API, si se encuentra con un error, la API devolverá el código de error correspondiente y la información. Por ejemplo:

400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
401 invalid_token: No autorizado, token de autorización inválido o faltante.
429 too_many_requests: Demasiadas solicitudes, ha superado el límite de tasa.
500 api_error: Error interno del servidor, algo salió mal en el servidor.

Ejemplo de respuesta de error

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "la recuperación falló"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusión

A través de este documento, ha aprendido cómo usar la API de Tareas del Productor para consultar detalles específicos de tareas individuales o por lotes. Esperamos que este documento le ayude a integrar y utilizar mejor esta API. Si tiene alguna pregunta, no dude en contactar a nuestro equipo de soporte técnico.

Primeros pasos

Chat de IA

Imagen de IA

Video de IA

Audio de IA

Web y datos

CAPTCHA

Identidad

Proxy

Avanzado

Coding

Integración y uso de la API de Tareas del Productor

Proceso de Solicitud

Ejemplo de Solicitud

Ejemplo de Tarea

Configuración de Encabezados de Solicitud y Cuerpo de Solicitud

Ejemplo de Código

CURL

Ejemplo de Respuesta

Operación de consulta por lotes

Ejemplo de código

Ejemplo de respuesta

CURL

Manejo de errores

Ejemplo de respuesta de error

Conclusión

​Proceso de Solicitud

​Ejemplo de Solicitud

​Ejemplo de Tarea

​Configuración de Encabezados de Solicitud y Cuerpo de Solicitud

​Ejemplo de Código

​CURL

​Ejemplo de Respuesta

​Operación de consulta por lotes

​Ejemplo de código

​Ejemplo de respuesta

​CURL

​Manejo de errores

​Ejemplo de respuesta de error

​Conclusión

Proceso de Solicitud

Ejemplo de Solicitud

Ejemplo de Tarea

Configuración de Encabezados de Solicitud y Cuerpo de Solicitud

Ejemplo de Código

CURL

Ejemplo de Respuesta

Operación de consulta por lotes

Ejemplo de código

Ejemplo de respuesta

CURL

Manejo de errores

Ejemplo de respuesta de error

Conclusión