Imaginode

Gere a partir do Claude, Cursor ou seus próprios scripts com uma chave de API: mesmos modelos, mesmos créditos, falhas reembolsadas.

Imaginode além do canvas

Tudo o que o canvas pode gerar também está disponível fora dele: uma API REST e um servidor MCP (Model Context Protocol) permitem que um agente de IA ou um script crie imagens e vídeos com a sua conta. As chamadas consomem os créditos do seu saldo, pelos mesmos preços do canvas, e uma geração com falha é reembolsada automaticamente, como sempre.

MCP é o padrão que permite que assistentes de IA (Claude, Cursor e muitos outros) usem ferramentas externas. Uma vez conectado ao Imaginode, seu assistente pode gerar uma imagem no meio de uma conversa, ilustrar um artigo que está escrevendo ou produzir os visuais de um fluxo de trabalho automatizado.

Crie uma chave de API

Vá para seu perfil, seção "API keys". Dê um nome à chave ("Claude Code", "script do blog"…) e crie-a: o segredo imk_… é exibido apenas uma vez, copie-o imediatamente. No máximo cinco chaves ativas, revogáveis a qualquer momento com um clique; uma chave revogada para de funcionar imediatamente.

A criação exige um e-mail verificado, e cada chave é limitada a 10 gerações por minuto: suficiente para trabalho real, mas não o bastante para drenar um saldo por acidente se um agente sair do controle.

Conecte o servidor MCP

O endereço do servidor é https://imaginode.ai/api/mcp (transporte Streamable HTTP). Duas formas de conectar. Com sua conta: no ChatGPT ou no Claude, adicione um conector com este endereço, uma página do Imaginode abre, você faz login e permite o aplicativo (OAuth, sem chave para colar; a página ChatGPT e Claude detalha cada assistente). Com uma chave de API: envie sua chave no cabeçalho "Authorization: Bearer imk_…", que é o que o Cursor e scripts fazem. No Claude Code, um único comando: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp, o login da conta abre no navegador no primeiro uso; adicione --header "Authorization: Bearer sua-chave" para usar uma chave em vez disso. Aplicativos conectados com sua conta são desconectados do seu perfil, em Connected apps.

Quatorze ferramentas são expostas. list_models retorna o catálogo, o que cada modelo faz e seu preço em créditos; get_balance lê seu saldo, para verificar se uma geração está coberta antes de iniciá-la. list_templates e get_template descrevem os templates do canvas: modelos, prompts, conexões, exemplos e o link que os abre prontos para executar. generate_image cria uma imagem e aguarda o resultado: a URL é retornada diretamente. generate_video inicia um vídeo (imagem inicial, imagem final, imagens de referência) e retorna um id de rastreamento. generate_speech lê um texto ou um diálogo com uma voz do catálogo ou uma das suas vozes clonadas, generate_sound produz um efeito sonoro ou uma faixa musical, enhance_audio limpa, isola ou divide um arquivo de áudio. edit_image aumenta a resolução, recorta ou transforma uma foto em um objeto 3D; edit_video aumenta a resolução, recorta, estende, sincroniza lábios de uma voz ou transfere um movimento. list_voices e list_characters leem suas vozes e seus personagens, get_generation_status acompanha uma geração até a URL final. O servidor fala a revisão de 2026-07-28 do protocolo, bem como as revisões de handshake de 2025: os clientes de hoje e os de amanhã conectam-se sem qualquer configuração.

A API REST direta

Para seus scripts, três endpoints são suficientes. GET /api/models lista os modelos, suas opções e seus preços, sem necessidade de autenticação. POST /api/generate inicia uma geração: um JSON com model, prompt e as opções do modelo (duration, resolution, aspectRatio, audio, imageUrls), a chave no cabeçalho Authorization, e a resposta contém requestId, cost e seu novo saldo. GET /api/generate/status?requestId=… retorna running, depois completed com as URLs de saída, ou failed com o reembolso.

Imagens de entrada (imageUrls) devem ser mídias hospedadas na sua conta Imaginode: importe-as primeiro em sua mídia, ou reutilize a URL de uma geração anterior.

Boas práticas

Comece com um modelo econômico (Flux Schnell, 1 crédito) para validar seus prompts antes de migrar para modelos premium. Para vídeo, consulte o status a cada 30 segundos: espere de 1 a 5 minutos em geral, até 30 para gerações longas. O custo exato é retornado no lançamento, antes do resultado em si.

Uma chave é um segredo: não a envie para um repositório e não a compartilhe. À menor dúvida, revogue-a do seu perfil e crie uma nova.