Vídeos

La generación de video se incluye en la estructura de documentos en el extranjero para mantener un mapa de productos coherente, pero la disponibilidad del punto final público debe confirmarse desde el esquema de OpenAPI en el extranjero y la configuración de la cuenta.

Pedido

Cuando los puntos finales de vídeo están habilitados, se espera un modelo de tarea asíncrono. Una solicitud de creación normalmente incluye un mensaje, modelo, duración, relación de aspecto y marco opcional o medio de referencia. Todas las solicitudes utilizan autenticación de portador:

Authorization: Bearer FISHAUDIO_API_KEY

Utilice únicamente rutas de punto final devueltas por GET /api/openapi.json. No copie rutas de otras implementaciones a clientes extranjeros.

Respuesta

Las respuestas a las tareas de video generalmente devuelven primero una identificación de la tarea y un estado, luego una URL del video resultante una vez completada. Guarde la identificación de la tarea y la identificación del proyecto original juntas, porque la generación de video puede durar más que una sesión del navegador.

Facturación y créditos

Las tareas de vídeo pueden resultar costosas. Haga cumplir la confirmación del usuario para larga duración, alta resolución o generación por lotes. Verifique Perfil antes de crear lotes y pausar su cola si no hay créditos suficientes.

Errores

Maneje avisos no válidos, modelos no compatibles, medios de referencia inaccesibles, créditos insuficientes y fallas de procesamiento. Si el esquema no expone puntos finales de vídeo, muestre la capacidad como no disponible en lugar de intentar rutas ocultas.

Endpoints públicos actuales

Consulta modelos verificados con GET /api/open/v1/media/models?mediaType=video, crea trabajos con POST /api/open/v1/media/videos/jobs y consúltalos con GET /api/open/v1/media/videos/jobs/{jobId}. La creación exige un Idempotency-Key único; repetir la misma clave devuelve la primera respuesta sin crear ni cobrar otro trabajo. Se utiliza la cuota de API, no los créditos del sitio, y los fallos de creación, persistencia, procesamiento asíncrono o tiempo de espera se reembolsan de forma idempotente.