img_uuid devuelto y obtén el resultado mediante sondeo o callback HTTPS.API de efectos de video con IA para flujos creativos automatizados
Accede a los efectos de video con IA mediante la API independiente de GoEnhance. Consulta las plantillas disponibles, envía una imagen de referencia autorizada junto con un ID de efecto, guarda el
Crear una API Key
Capacidades de la API de efectos de video con IA
Descubre los efectos disponibles
Llama a GET /api/v1/videoeffect/list con autenticación Bearer para obtener los IDs de efecto, las etiquetas y las URL de vista previa actuales, en lugar de fijar en el código un catálogo desactualizado.
Genera y sigue una tarea
Envía por POST un reference_img público y un effect_id válido a /api/v1/videoeffect/generate, y luego guarda el img_uuid devuelto para consultar el estado.
Verifica credenciales, acceso al material, identidad de la plantilla y configuración del callback antes de crear una tarea.
Elementos clave de la solicitud a la API de efectos de video con IA
Autenticación Bearer
Envía tu clave de API de GoEnhance en la cabecera <code>Authorization</code> y consérvala en el servidor, nunca en código del lado del cliente.
Descubrimiento de plantillas
Usa <code>GET /api/v1/videoeffect/list</code> para obtener el catálogo actual antes de mostrar las opciones de efectos en tu producto.
Imagen de referencia
Indica en <code>reference_img</code> una URL de imagen HTTPS de acceso público y utiliza solo material que te pertenezca o que tengas autorización para procesar.
Identificador del efecto
Pasa el <code>effect_id</code> exacto de la plantilla elegida y valídalo contra la respuesta actual del listado en lugar de adivinar identificadores.
Callback opcional
Indica <code>custom_callback_url</code> cuando quieras que las notificaciones de estado se envíen a un endpoint HTTPS público.
ID de tarea asíncrona
Guarda de forma persistente el <code>data.img_uuid</code> de una respuesta de envío correcta y asócialo con tu registro interno de la solicitud.
Guíate por datos de plantillas en vivo y por la documentación, no por un precio universal inventado o desactualizado.
Precios de la API de efectos de video con IA
El precio varía según el efecto
El precio de la API de efectos de video con IA depende de la plantilla elegida y del catálogo vigente de GoEnhance. No des por hecho una tarifa fija igual para todos los efectos.
Consulta el catálogo en vivo
Usa la API de listado de plantillas y la documentación vigente de GoEnhance como fuente de verdad para el efecto que vayas a ejecutar.
Calcula el coste antes de enviar
Confirma el <code>effect_id</code> elegido y sus condiciones de facturación actuales antes de encolar lotes de producción, porque las condiciones del catálogo pueden cambiar.
Integra efectos de video con IA en tres pasos
1
1. Descubre y valida
Obtén el listado de efectos, elige un
effect_id exacto y comprueba que tu imagen de referencia HTTPS sea accesible y esté autorizada para su procesamiento. 2
2. Envía y guarda
Haz POST de
reference_img, effect_id y una URL de callback opcional, y luego guarda el data.img_uuid de la respuesta. 3
3. Resuelve el resultado final
Sondea
GET /api/v1/jobs/detail?img_uuid=... o procesa los cuerpos de callback de forma idempotente hasta que la tarea llegue a success o failed.Crea flujos de efectos repetibles en torno a contenido que te pertenece o que tienes permiso para transformar.
Casos de uso de la API de efectos de video con IA
Herramientas para creadores
Permite que tus usuarios elijan efectos aprobados y conviertan imágenes fijas autorizadas en piezas dinámicas breves desde tu aplicación.
Variantes de campaña
Encola variaciones de efectos para conceptos de marketing manteniendo en tu propio flujo la titularidad del material, la moderación y las aprobaciones.
Flujos de contenido de usuarios
Conecta subidas, selección de efecto, procesamiento asíncrono y entrega de resultados en una canalización de backend trazable.
Experiencias de entretenimiento
Crea funciones lúdicas y animaciones temáticas de activación voluntaria, con consentimiento claro y controles de política de contenido.
Operaciones creativas por lotes
Conserva los IDs de tarea y procesa los resultados finales de forma independiente para que los lotes se recuperen de los tiempos de espera sin envíos duplicados.
Automatización de medios
Envía los videos terminados a los sistemas de almacenamiento, revisión, moderación y publicación solo después de validar la respuesta final.
Respuestas sobre endpoints, precios, entradas, entrega asíncrona y salvaguardas en producción.