Proceso de solicitud
Para utilizar la API de Fish Audios Generation, primero dirígete a la consola de Ace Data Cloud para obtener tu token de API, que debes guardar para uso futuro.
Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión; una vez completado, serás redirigido de nuevo 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 te otorgará un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.
📘 Documentación completa: API de Fish Audios Generation →
Ejemplo de solicitud
La API de Fish Tasks se puede utilizar para consultar los resultados de la API de Fish Audios Generation. Para saber cómo utilizar la API de Fish Audios Generation, consulta la documentación API de Fish Videos Generation. Tomaremos como ejemplo un ID de tarea devuelto por el servicio de Fish Audios Generation, y mostraremos cómo utilizar esta API. Supongamos que tenemos un ID de tarea: 2725a2d3-f87e-4905-9c53-9988d5a7b2f5, a continuación, se mostrará 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 ingresarapplication/json.authorization: la clave para llamar a la API, que se puede seleccionar directamente después de solicitarla.
id: el ID de tarea subido.action: el método de operación sobre la tarea.
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:
CURL
Ejemplo de respuesta
Después de una solicitud exitosa, la API devolverá la información detallada de la tarea aquí. Por ejemplo:id, el ID que generó esta tarea, utilizado para identificar de manera única esta tarea generada.request, información de la solicitud en la tarea consultada.response, información de respuesta en la tarea consultada; al final, si es exitoso, elcost.amountes el crédito realmente deducido en esta síntesis.created_at, hora de creación de la tarea, marca de tiempo Unix (segundos, punto flotante).started_at, hora de inicio de ejecución de la tarea, marca de tiempo Unix (segundos, punto flotante).finished_at, hora de finalización de la tarea, marca de tiempo Unix (segundos, punto flotante). Este campo no se devuelve si la tarea no se ha completado.elapsed, tiempo de ejecución de la tarea, en segundos (punto flotante, con 3 decimales). Este campo no se devuelve si la tarea no se ha completado.
Operación de consulta por lotes
Esto es para consultar los detalles de varias tareas mediante múltiples IDs de tarea, a diferencia de lo anterior, se debe seleccionar la acción como retrieve_batch. Request Body incluye:ids: un array de IDs de tarea subidos.action: el método de operación sobre la tarea.
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:
Ejemplo de respuesta
Después de una solicitud exitosa, la API devolverá la información detallada de todas las tareas en lote. Por ejemplo:items，批量任务的所有具体详情信息。它是一个数组，每个数组的元素和上文查询单个任务的返回结果格式是一样的。count，此处批量查询任务的个数。
CURL
错误处理
在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：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.