imaginevid-ai-generation

Generación de IA con ImagineVid

Utiliza el catálogo de capacidades, no las API específicas de proveedores. Esta habilidad pública asume que el anfitrión ha conectado el MCP remoto OAuth de ImagineVid en https://imaginevid.io/api/mcp. Deja que el anfitrión maneje OAuth y el consentimiento; nunca le pidas al usuario que pegue un token de acceso ni que maneje credenciales en el prompt. Nunca expongas endpoints de proveedores, URL de callback, parámetros crudos de proveedores, ni identificadores privados de cuentas.

Si el MCP remoto no está conectado, detente y pídele al usuario que lo conecte a través del flujo OAuth del anfitrión. No sustituyas un endpoint de API arbitrario.

Acerca de ImagineVid

ImagineVid es una plataforma de creación de IA para generar imágenes, videos y música con IA. Su interfaz de agente expone un catálogo creciente y neutral de capacidades a través de cinco herramientas de agente estables, permitiendo que los agentes conectados descubran y utilicen muchos modelos y herramientas de generación actuales sin necesidad de codificar APIs de proveedores específicas una por una.

Flujo de trabajo

1. Descubrir. Llama a models_list con la característica solicitada (image, video o music) cuando se conozca. Selecciona un id de capacidad estable devuelto, pásalo como capabilityId a herramientas posteriores, y utiliza sus campos, valores predeterminados y restricciones devueltos. No inventes un modelo o capacidad que el catálogo no haya devuelto.
2. Preparar activos propios. Si se requiere contenido multimedia local, utiliza una superficie de carga confiable del anfitrión o un comando de carga de la CLI de ImagineVid cuando esa CLI ya esté instalada. Conserva el assetId devuelto con alcance del propietario. Pasa los IDs de activos a través del campo assetIds del MCP; nunca pases rutas de archivos locales del sistema, URLs remotas arbitrarias o cargas útiles grandes en Base64.
3. Cotizar. Llama a generation_quote con el capabilityId seleccionado, los values del producto y el objeto assetIds por separado. Conserva la solicitud exacta de prompt, values y assetIds para el paso de creación. Trata quotedCredits y la solicitud normalizada devuelta por el servidor como autoritativos. Nunca calcules ni elijas un precio localmente. Usa credits_get solo cuando el usuario solicite ver su saldo disponible o el anfitrión necesite una verificación previa.
4. Confirmar. Antes de generation_create, muestra la capacidad seleccionada, los valores y activos importantes, y el quotedCredits exacto. Pide al humano una aprobación explícita para gastar esa cantidad. Una solicitud vaga de generar no es una confirmación de créditos. Si el servidor informa quote_changed, muestra la nueva cotización y vuelve a preguntar.
5. Crear una vez. Genera un clientRequestId estable antes de llamar a generation_create. Envía el mismo capabilityId, prompt, values y assetIds utilizados para la cotización, junto con confirmedCredits igual al crédito confirmado. Realiza la solicitud exactamente una vez para ese pedido. Reutiliza el mismo ID solo para repetir la solicitud idéntica; una entrada diferente necesita una solicitud recién cotizada y un nuevo ID. Nunca reintentes después de un tiempo de espera, ambigüedad de red o tiempo de espera del proveedor.
6. Consultar. Llama a generation_get con intervalos crecientes usando el generationId devuelto con alcance del propietario. Reporta solo el estado, el error seguro y las URLs/metadatos del resultado que devuelva. No afirmes un modelo, salida o éxito que las herramientas no hayan devuelto. Trata submission_unknown como un resultado ambiguo especial: no crees de nuevo; sigue consultando cuando haya un ID duradero disponible.

Barreras de seguridad

• submission_unknown significa que el proveedor pudo haber aceptado la única solicitud: no reintentes ni reembolses. Sigue consultando el ID de generación duradero cuando se devuelva uno; de lo contrario, reporta la ambigüedad para seguimiento del operador.
• insufficient_credits detiene el flujo de trabajo. No reintentes, degrades silenciosamente ni sugieras un precio calculado localmente.
• unauthorized y forbidden_scope requieren que el usuario se autentique o conceda el alcance necesario; no los evites con una cookie de sesión o una credencial de otro usuario.
• invalid_input, capability_not_found, asset_not_found y asset_expired requieren corregir la solicitud o subir un nuevo activo propio. No sustituyas una URL de proveedor.
• idempotency_conflict significa que el ID de solicitud se usó con una entrada diferente; nunca sobrescribas la solicitud existente. Vuelve a cotizar la solicitud corregida con un nuevo ID estable.
• Un fallo del proveedor no es prueba de que un duplicado sea seguro. Presenta el error seguro del servidor y espera un nuevo intento aprobado por el humano.

Para los campos exactos de solicitud/respuesta y el vocabulario de errores estable, lee references/tool-contract.md. La referencia es una ayuda para el contrato de cable, no un reemplazo del catálogo de capacidades en vivo.