API y servidor MCP
Genera desde Claude, Cursor o tus propios scripts con una clave API: mismos modelos, mismos créditos, fallos reembolsados.
Imaginode fuera del lienzo
Todo lo que el lienzo sabe generar también está disponible fuera de él: una API REST y un servidor MCP (Model Context Protocol) permiten a un agente de IA o a un script crear imágenes y vídeos con tu cuenta. Las llamadas consumen los créditos de tu saldo, a los mismos precios que el lienzo, y una generación fallida se reembolsa automáticamente, como siempre.
MCP es el estándar que permite a los asistentes de IA (Claude, Cursor y muchos otros) usar herramientas externas. Con Imaginode conectado, tu asistente puede generar una imagen en plena conversación, ilustrar un artículo que está redactando o producir los visuales de un workflow automatizado.
Crear una clave API
Ve a tu perfil, sección "Claves API". Ponle un nombre a la clave ("Claude Code", "script blog"…) y créala: el secreto imk_… se muestra una sola vez, cópialo inmediatamente. Cinco claves activas como máximo, revocables en cualquier momento con un clic; una clave revocada deja de funcionar al instante.
La creación requiere un email verificado, y cada clave está limitada a 10 generaciones por minuto: de sobra para trabajar cómodamente, no lo bastante para vaciar un saldo por accidente si un agente se descontrola.
Conectar el servidor MCP
La dirección del servidor es https://imaginode.ai/api/mcp (transporte Streamable HTTP). Autentícate enviando tu clave en la cabecera "Authorization: Bearer imk_…". En Claude Code, un solo comando: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer tu-clave". En Claude.ai o Cursor, añade un conector personalizado con la misma dirección y la misma cabecera.
Se exponen cuatro herramientas. list_models devuelve el catálogo y los precios en créditos. generate_image crea una imagen y espera el resultado: la URL se devuelve directamente. generate_video lanza un vídeo y devuelve un identificador de seguimiento. get_generation_status sigue una generación hasta la URL final.
La API REST directa
Para tus scripts bastan tres endpoints. GET /api/models lista los modelos, sus opciones y sus precios, sin autenticación. POST /api/generate lanza una generación: un JSON con model, prompt y las opciones del modelo (duration, resolution, aspectRatio, audio, imageUrls), la clave en la cabecera Authorization, y la respuesta contiene requestId, cost y tu nuevo saldo. GET /api/generate/status?requestId=… devuelve running, luego completed con las URLs de salida, o failed con el reembolso.
Las imágenes de entrada (imageUrls) deben ser medios alojados en tu cuenta de Imaginode: impórtalas primero en tus medios, o reutiliza la URL de una generación anterior.
Buenas prácticas
Empieza con un modelo económico (Flux Schnell, 1 crédito) para validar tus prompts antes de pasar a los modelos premium. Para el vídeo, consulta el estado cada 30 segundos: cuenta de 1 a 5 minutos en general, hasta 30 en las generaciones largas. El coste exacto se devuelve al lanzar, antes incluso del resultado.
Una clave es un secreto: no la subas a un repositorio ni la compartas. A la mínima duda, revócala desde tu perfil y crea una nueva.