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). Dos formas de conectarse. Con tu cuenta: en ChatGPT o Claude, añade un conector con esta dirección, se abre una página de Imaginode, inicias sesión y autorizas la aplicación (OAuth, sin clave que pegar; la página ChatGPT y Claude detalla cada asistente). Con clave API: envía tu clave en la cabecera "Authorization: Bearer imk_…", como hacen Cursor y los scripts. En Claude Code, un solo comando: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp, el inicio de sesión con tu cuenta se abre en el navegador en el primer uso; añade --header "Authorization: Bearer tu-clave" para usar una clave. Las aplicaciones conectadas con tu cuenta se desconectan desde tu perfil, sección Aplicaciones conectadas.
Se exponen catorce herramientas. list_models ofrece el catálogo, lo que hace cada modelo y su precio en créditos; get_balance lee su saldo, para comprobar que una generación está cubierta antes de lanzarla. list_templates y get_template describen las plantillas del canvas: modelos, indicaciones, cableado, ejemplos, y el enlace que las abre listas para lanzar. generate_image crea una imagen y espera el resultado: la URL se devuelve directamente. generate_video inicia un vídeo (imagen de inicio, imagen final, imágenes de referencia) y devuelve un identificador de seguimiento. generate_speech lee un texto o un diálogo con una voz del catálogo o una de sus voces clonadas, generate_sound produce un efecto de sonido o una música, enhance_audio limpia, aísla o separa un audio. edit_image amplía, recorta o transforma una foto en un objeto 3D; edit_video amplía, recorta, alarga, sincroniza los labios con una voz o transfiere un movimiento. list_voices y list_characters leen sus voces y sus personajes, get_generation_status sigue una generación hasta la URL final. El servidor habla la revisión 2026-07-28 del protocolo, así como las revisiones de handshake de 2025: los clientes de hoy y los de mañana se conectan sin ningún ajuste.
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.