Proceso de solicitud
Para utilizar Fish Audios Generation API, primero obtenga su API Token en la consola de Ace Data Cloud y guárdelo para su uso posterior.
Si aún no ha iniciado sesión ni se ha registrado, será redirigido automáticamente a la página de inicio de sesión para invitarle a registrarse e iniciar sesión; una vez completado, regresará 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 para que pueda probar el servicio sin costo; cuando los créditos sean insuficientes, puede recargar el saldo general en la consola.
📘 Documentación completa: Fish Audios Generation API →
Ejemplo de solicitud
Fish Tasks API puede utilizarse para consultar los resultados de Fish Audios Generation API. Para saber cómo utilizar Fish Audios Generation API, consulte la documentación de Fish Videos Generation API 。 Tomamos como ejemplo un ID de tarea devuelto por el servicio Fish Audios Generation API para demostrar cómo utilizar esta API. Supongamos que tenemos un ID de tarea: 2725a2d3-f87e-4905-9c53-9988d5a7b2f5; a continuación, se demuestra cómo mediante la introducción de un ID de tarea.Imagen de ejemplo de tarea
Configurar los encabezados y el cuerpo de la solicitud
Request Headers incluyen:accept: especifica que se reciban resultados de respuesta en formato JSON; aquí se completa comoapplication/json.authorization: la clave para invocar la API, que puede seleccionarse directamente en el menú desplegable después de solicitarla.
id: el ID de tarea cargado.action: el método de operación sobre la tarea.
Ejemplo de código
Puede observarse 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 que la solicitud sea exitosa, la API devolverá la información detallada de la tarea aquí. Por ejemplo:request es el request body al iniciar la tarea, mientras que el campo response es el response body devuelto después de que se complete la tarea. La descripción de los campos es la siguiente.
id, el ID que genera esta tarea, 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 devuelta en la tarea de consulta; cuando finalmente tiene éxito,cost.amountdentro de este representa los Credits realmente deducidos para 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 cuando la tarea no está completada.elapsed, tiempo de ejecución de la tarea, en segundos (punto flotante, conserva 3 decimales). Este campo no se devuelve cuando la tarea no está completada.
Operación de consulta por lotes
Esto sirve para consultar los detalles de tareas para varios ID de tarea; a diferencia de lo anterior, es necesario seleccionar la action como retrieve_batch Request Body incluye:ids: el arreglo de ID de tareas cargados.action: el método de operación sobre las tareas.
Ejemplo de código
Puede observarse 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 que la solicitud sea exitosa, la API devolverá la información detallada específica de todas las tareas por lotes de esta ocasión. Por ejemplo:items contiene la información detallada específica de las tareas por lotes, y la información específica de cada tarea es igual que los campos anteriores. 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, el número de tareas consultadas por lotes aquí.
CURL
Manejo de errores
Al llamar a la API, si se produce un error, la API devolverá el código de error y el mensaje 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.