API e servidor MCP
Gere a partir do Claude, do Cursor ou dos seus próprios scripts com uma chave de API: os mesmos modelos, os mesmos créditos, falhas reembolsadas.
O Imaginode fora da tela
Tudo o que a tela sabe gerar também está disponível fora dela: uma API REST e um servidor MCP (Model Context Protocol) permitem a um agente de IA ou a um script criar imagens e vídeos com a sua conta. As chamadas consomem os créditos do seu saldo, aos mesmos preços da tela, e uma geração que falha é reembolsada automaticamente, como sempre.
O MCP é o padrão que permite aos assistentes de IA (Claude, Cursor e muitos outros) usar ferramentas externas. Com o Imaginode ligado, o seu assistente pode gerar uma imagem a meio de uma conversa, ilustrar um artigo que está a redigir ou produzir os visuais de um workflow automatizado.
Criar uma chave de API
Vá ao seu perfil, secção "Chaves de API". Dê um nome à chave ("Claude Code", "script blog"…) e crie-a: o segredo imk_… é mostrado uma única vez, copie-o imediatamente. Cinco chaves ativas no máximo, revogáveis a qualquer momento com um clique; uma chave revogada deixa de funcionar de imediato.
A criação exige um email verificado, e cada chave está limitada a 10 gerações por minuto: o suficiente para trabalhar à vontade, mas não para esvaziar um saldo por acidente se um agente descontrolar.
Ligar o servidor MCP
O endereço do servidor é https://imaginode.ai/api/mcp (transporte Streamable HTTP). Duas formas de ligar. Com a sua conta: no ChatGPT ou no Claude, adicione um conector com este endereço, abre-se uma página do Imaginode, inicia sessão e autoriza a aplicação (OAuth, sem chave para colar; a página ChatGPT e Claude detalha cada assistente). Com chave API: envie a sua chave no cabeçalho "Authorization: Bearer imk_…", como fazem o Cursor e os scripts. No Claude Code, um único comando: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp, o início de sessão com a conta abre-se no navegador na primeira utilização; acrescente --header "Authorization: Bearer sua-chave" para usar uma chave. As aplicações ligadas com a sua conta desligam-se a partir do seu perfil, secção Aplicações ligadas.
Catorze 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, instruções, cabeamento, exemplos, e o link que os abre prontos para executar. generate_image cria uma imagem e espera o resultado: a URL é retornada diretamente. generate_video inicia um vídeo (imagem inicial, imagem final, imagens de referência) e retorna um identificador de acompanhamento. generate_speech lê um texto ou um diálogo com uma voz do catálogo ou uma de suas vozes clonadas, generate_sound produz um efeito sonoro ou uma música, enhance_audio limpa, isola ou separa um áudio. edit_image amplia, remove fundo ou transforma uma foto em objeto 3D; edit_video amplia, remove fundo, prolonga, sincroniza os lábios com 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 2026-07-28 do protocolo, assim como as revisões de handshake de 2025: os clientes de hoje e os de amanhã se conectam sem nenhuma configuração.
A API REST direta
Para os seus scripts bastam três endpoints. GET /api/models lista os modelos, as suas opções e os seus preços, sem autenticação. POST /api/generate lança 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 o seu novo saldo. GET /api/generate/status?requestId=… devolve running, depois completed com as URLs de saída, ou failed com o reembolso.
As imagens de entrada (imageUrls) têm de ser mídia alojada na sua conta Imaginode: importe-as primeiro para a sua mediateca, ou reutilize a URL de uma geração anterior.
Boas práticas
Comece por um modelo económico (Flux Schnell, 1 crédito) para validar os seus prompts antes de passar aos modelos premium. Para o vídeo, consulte o estado a cada 30 segundos: conte 1 a 5 minutos em geral, até 30 nas gerações longas. O custo exato é devolvido logo no lançamento, antes mesmo do resultado.
Uma chave é um segredo: não a comite num repositório nem a partilhe. À mínima dúvida, revogue-a no seu perfil e crie uma nova.