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). Autentique-se enviando a sua chave no cabeçalho "Authorization: Bearer imk_…". No Claude Code, um único comando: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer sua-chave". No Claude.ai ou no Cursor, adicione um conector personalizado com o mesmo endereço e o mesmo cabeçalho.
Quatro ferramentas estão expostas. list_models devolve o catálogo e os preços em créditos. generate_image cria uma imagem e espera pelo resultado: a URL é devolvida diretamente. generate_video lança um vídeo e devolve um identificador de acompanhamento. get_generation_status segue uma geração até à URL final.
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.