Guía de migración

Las nuevas integraciones deberían llamarse /api/open/v1. Las rutas heredadas permanecen disponibles durante la ventana de compatibilidad, pero no deben usarse para trabajos nuevos.

Mapeo de rutas

Confirme las formas finales de solicitud y respuesta con:

GET /api/openapi.json

Orden recomendado

1. Cambie primero las llamadas de solo lectura, como perfil, lista de voces y estado del trabajo.
2. Mover los puntos finales de creación después de que las pruebas cubran el análisis de solicitudes y respuestas.
3. Siga registrando tanto el punto final heredado como el nuevo durante la implementación.
4. Elimine las rutas de clientes heredadas solo después de que el tráfico de producción ya no dependa de ellas.

Solicitar cambios

Utilice la autenticación de portador para cada solicitud v1.

Authorization: Bearer FISHAUDIO_API_KEY

Use identificadores estables en los cuerpos de solicitud. Para TTS, envíe el ID de voz en voiceId y el ID del modelo del motor TTS en modelId. Solo reference_id sigue siendo un alias heredado del ID de voz.

Utilice la voz del sistema público 00a1b221-6137-4b73-ad62-b0cbce134167 para una pequeña prueba de humo de migración y luego cambie a la ID de voz de producción seleccionada por su aplicación.

Cambios de respuesta

Los puntos finales V1 están diseñados en torno a recursos explícitos: voces, tareas, trabajos y registros de perfil. Actualice su cliente para analizar campos de respuesta específicos de endpoints en lugar de depender de una forma contenedora global.

Para operaciones de medios asíncronos, persista el trabajo o la identificación de tarea devueltos inmediatamente. Las encuestas, los reintentos y las investigaciones de soporte deben utilizar esa identificación.

Facturación y créditos

La migración en sí no cambia el saldo de la cuenta, pero los nuevos puntos finales pueden exponer créditos y campos de cuota más claros. Durante la implementación, compare rutas de código antiguas y nuevas en trabajos pequeños antes de mover un gran volumen de tráfico.

Si una solicitud falla durante la migración, registre la ruta heredada, la nueva ruta, el código de estado, API requestId y su identificación de trabajo interna. Eso brinda soporte suficiente contexto sin exponer las claves API del portador o las URL de medios privados.