Imaginode

Genera desde Claude, Cursor o tus propios scripts con una clave API: los mismos modelos, los mismos créditos, los fallos se reembolsan.

Imaginode más allá del lienzo

Todo lo que el lienzo puede generar también está disponible fuera de él: una API REST y un servidor MCP (Model Context Protocol) permiten que un agente de IA o un script cree imágenes y videos 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. Una vez que Imaginode está conectado, tu asistente puede generar una imagen en mitad de una conversación, ilustrar un artículo que está escribiendo o producir los visuales de un flujo de trabajo automatizado.

Crear una clave API

Ve a tu perfil, sección "API keys". Nombra la clave ("Claude Code", "script del blog"…) y créala: el secreto imk_… se muestra solo una vez, cópialo de inmediato. Máximo cinco claves activas, revocables en cualquier momento con un clic; una clave revocada deja de funcionar inmediatamente.

La creación requiere un correo electrónico verificado, y cada clave está limitada a 10 generaciones por minuto: suficiente para trabajo real, no tanto como para agotar 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 el encabezado "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 el mismo encabezado.

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 inicia un video y devuelve un id de seguimiento. get_generation_status sigue una generación hasta la URL final.

La API REST directa

Para tus scripts, tres endpoints son suficientes. GET /api/models lista los modelos, sus opciones y sus precios, sin necesidad de autenticación. POST /api/generate inicia una generación: un JSON con model, prompt y las opciones del modelo (duration, resolution, aspectRatio, audio, imageUrls), la clave en el encabezado 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

Comienza con un modelo económico (Flux Schnell, 1 crédito) para validar tus prompts antes de pasar a modelos premium. Para video, consulta el estado cada 30 segundos: espera de 1 a 5 minutos en general, hasta 30 para generaciones largas. El costo exacto se devuelve al inicio, antes del resultado en sí.

Una clave es un secreto: no la comprometas en un repositorio ni la compartas. Ante la menor duda, revócala desde tu perfil y crea una nueva.