Instrucciones de integración de la API Fish Model Get

Esta interfaz se basa en la API Model oficial de Fish Audio y se utiliza para consultar los detalles completos de un solo tono de clonación por _id. La dirección es GET https://api.acedata.cloud/fish/model/{id}.

Para crear un tono, consulte la API Fish Model Create; para la búsqueda paginada, consulte la API Fish Model Query.

Proceso de solicitud

Para utilizar la API Fish Model, primero dirígete a la consola de Ace Data Cloud para obtener tu token de API, que debes guardar como respaldo.

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 invita a registrarte e iniciar sesión; una vez completado, volverás automáticamente a la página actual. Un token de API es suficiente para acceder a todos los servicios de la plataforma, no es necesario 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 Fish Model →

Parámetros de ruta

Parámetro	Requerido	Descripción
`id`	Sí	El `_id` del tono (cadena hexadecimal de 32 bits). Se puede obtener al crear a través de Fish Model Create o mediante la búsqueda en Fish Model Query.

Sin cuerpo de solicitud, sin parámetros de consulta.

Ejemplo: Obtener los detalles completos de un tono público en español

curl 'https://api.acedata.cloud/fish/model/8d2c17a9b26d4d83888ea67a1ee565b2' \
  -H 'authorization: Bearer {token}'

Respuesta (en pruebas, se eliminó la cadena de consulta de firma en samples[].audio para facilitar la lectura):

{
  "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
  "type": "tts",
  "title": "Valentino Narración Biblica Fer",
  "description": "Una voz masculina madura y autoritaria con un tono calmado y espiritual. Es adecuada para narraciones religiosas, contenido educativo y narración profesional en español.",
  "cover_image": "coverimage/8d2c17a9b26d4d83888ea67a1ee565b2",
  "train_mode": "fast",
  "state": "trained",
  "tags": [
    "male", "old", "narration", "calm", "serious",
    "authoritative", "professional", "clear", "Spanish"
  ],
  "samples": [
    {
      "title": "Muestra Predeterminada",
      "text": "Hermanos míos, recordemos las palabras del Señor en estos tiempos difíciles. Como dice la Escritura, la fe mueve montañas, y el amor de Dios nos guía en cada paso del camino. Mantengamos firme nuestra confianza en Su divina providencia.",
      "task_id": "59ce7df6935c42249759327ddf70f37b",
      "audio": "https://c97f3361a1c971323738e24f451a0225.r2.cloudflarestorage.com/fish-platform-data/task/59ce7df6935c42249759327ddf70f37b.mp3?X-Amz-...signed..."
    }
  ],
  "created_at": "2025-03-13T08:11:10.326000Z",
  "updated_at": "2026-05-03T09:01:41.437000Z",
  "languages": ["es"],
  "visibility": "public",
  "lock_visibility": false,
  "dmca_taken_down": false,
  "default_text": "Hermanos míos, recordemos las palabras del Señor...",
  "quality": null,
  "like_count": 4344,
  "mark_count": 4409,
  "shared_count": 590,
  "task_count": 708461,
  "unliked": false,
  "liked": false,
  "marked": false,
  "author": {
    "_id": "1b82fb6a329c4462b67aa9ee0a42046f",
    "nickname": "Fernando Caicedo",
    "avatar": "avatars/1b82fb6a329c4462b67aa9ee0a42046f.jpg"
  }
}

El _id obtenido se puede usar directamente como reference_id en Fish TTS para sintetizar voz con el mismo tono:

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Hermanos míos, hoy es un buen día.",
    "reference_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
    "format": "mp3"
  }'

Diferencias con la interfaz de lista

Campo	`GET /fish/model` (lista)	`GET /fish/model/{id}` (detalles)
`samples[].audio`	URL de caché R2 a corto plazo	Enlace directo R2 firmado (incluye firma de consulta)
`unliked` / `liked` / `marked` / `dmca_taken_down`	También existen	También existen
`default_text` / `lock_visibility`	También existen	También existen

Si solo deseas escuchar, el samples[].audio de la interfaz de lista es suficiente; para enlaces de descarga más estables, se recomienda usar esta interfaz.

Campos de respuesta (extracto)

Campo	Tipo	Descripción
`_id`	string	ID del tono (utilizado como `reference_id` en `/fish/tts`).
`type`	string	Tipo de modelo, generalmente `tts`.
`title`	string	Nombre del tono.
`description`	string	Descripción larga.
`state`	string	Estado de entrenamiento: `trained` significa disponible, `training` significa que aún está en entrenamiento.
`tags`	string[]	Etiquetas de la biblioteca pública.
`samples`	object[]	Muestras predefinidas, que incluyen `title`, `text`, `task_id`, `audio` enlace directo.
`languages`	string[]	Códigos de idiomas en los que el tono es competente.
`visibility`	string	`public` o `private`.
`like_count`	integer	Número de “me gusta” en la biblioteca pública.
`task_count`	integer	Número de síntesis históricas (puede usarse para referencia de popularidad).
`author`	object	Información del autor: `_id` / `nickname` / `avatar`.
`created_at`	string	Fecha de creación en formato ISO 8601.
`updated_at`	string	Última fecha de actualización en formato ISO 8601.

Instrucciones de facturación

Esta interfaz no tiene costo: consultar los detalles de un tono por ID es una operación gratuita. Crear un tono (Fish Model Create) también es gratuito, los costos solo se generan al llamar a Fish TTS para sintetizar voz según el uso.

Manejo de errores

400 token_mismatched: El id en la ruta no tiene un formato válido, o el upstream reporta “Modelo no encontrado”.
401 invalid_token: El token de autenticación no existe o es inválido.
404 not_found: El _id especificado no es visible en el upstream de Fish (el tono ha sido eliminado, es privado, o pertenece a otra cuenta).
429 too_many_requests: Se ha activado el límite de velocidad de la cuenta.
500 api_error: Error interno del servidor.

Al solicitar un ID que no existe, el upstream devolverá directamente 400 Model not found (comprobado):

curl 'https://api.acedata.cloud/fish/model/test123' \
  -H 'authorization: Bearer {token}'

Devuelve:

{ "status": 400, "message": "Model not found" }

Ejemplo de respuesta de error:

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusión

Al conocer el _id del tono, se puede usar directamente esta interfaz para obtener el ModelEntity completo. El uso más común es: (1) escuchar samples[].audio, (2) proporcionar el _id a reference_id de /fish/tts para completar la síntesis. Si solo se tiene el título o las etiquetas, primero se debe usar Fish Model Query para realizar la búsqueda.

Primeros pasos

Chat de IA

Imagen de IA

Video de IA

Audio de IA

Web y datos

CAPTCHA

Identidad

Proxy

Avanzado

Coding

Instrucciones de integración de la API Fish Model Get

Proceso de solicitud

Parámetros de ruta

Ejemplo: Obtener los detalles completos de un tono público en español

Diferencias con la interfaz de lista

Campos de respuesta (extracto)

Instrucciones de facturación

Manejo de errores

Conclusión

​Proceso de solicitud

​Parámetros de ruta

​Ejemplo: Obtener los detalles completos de un tono público en español

​Diferencias con la interfaz de lista

​Campos de respuesta (extracto)

​Instrucciones de facturación

​Manejo de errores

​Conclusión

Proceso de solicitud

Parámetros de ruta

Ejemplo: Obtener los detalles completos de un tono público en español

Diferencias con la interfaz de lista

Campos de respuesta (extracto)

Instrucciones de facturación

Manejo de errores

Conclusión