Verifique antes de gastar
Leia o saldo e o catálogo ao vivo de preços de imagem/vídeo, incluindo os modelos Gemini aceitos atualmente pela ferramenta MCP.
Remote MCP · OAuth · Streamable HTTP
Dê ao seu agente um pipeline de imagens.
Conecte o Pixapi uma vez para o agente consultar preços ao vivo, enviar tarefas de imagem Gemini e obter o resultado final sem lidar com chaves de API.
Endereço de conexão
https://api.pixapi.ai/mcpSem Node.jsSem copiar chave de APIResultados assíncronos
remote / stateless
01connecthttps://api.pixapi.ai/mcp
02authOAuth + PKCE
03scopepixapi:tools
04transportStreamable HTTP
Três ferramentas Pixapi prontas após a autorização
Adicione esta URL como servidor Remote MCP. O endpoint recebe requisições MCP, não navegação comum do navegador.
O que o MCP faz
Um conjunto pequeno para uma execução completa.
O MVP público concentra-se nas etapas necessárias para o agente cotar, iniciar e concluir uma tarefa de geração de imagem.
Crie uma tarefa de imagem
Envie uma tarefa assíncrona de texto para imagem com modelo Gemini compatível, prompt, quantidade e proporção opcional.
Volte com o resultado
Consulte a tarefa da conta até a conclusão e retorne a URL da imagem ou a falha registrada.
Autorização OAuth
Entre no Pixapi. Não cole um segredo.
Clientes com Remote MCP e OAuth descobrem o servidor de autorização Pixapi e usam o fluxo de código com PKCE S256.
O cliente recebe acesso delegado
A autorização é limitada ao escopo pixapi:tools. Sua senha é inserida somente em pixapi.ai; depois, o cliente usa tokens de acesso e atualização revogáveis.
- 01
Adicione a URL Remote MCP
Nas configurações de conectores ou MCP do cliente, adicione https://api.pixapi.ai/mcp.
- 02
Continue no navegador
O Pixapi abre a página de login. Use a mesma conta que contém seus créditos e histórico.
- 03
Aprove o acesso às ferramentas
Revise e conceda a permissão pixapi:tools solicitada para este cliente.
- 04
Volte ao seu agente
O cliente conclui a troca OAuth, lista as ferramentas e pode chamá-las dentro da sua conta.
Três ferramentas públicas
Ações claras. Resultados estruturados.
Cada ferramenta expõe schemas de entrada e saída para o agente escolher e tratar resultados sem adivinhações.
tool.01
pixapi_get_pricing_and_balance
Retorna seu saldo atual e o catálogo ao vivo de preços de modelos de imagem e vídeo.
Somente itens com mcp_generate_supported=true podem ser enviados à ferramenta MCP de geração.
tool.02
pixapi_generate_image
Cria uma tarefa assíncrona Gemini de texto para imagem e retorna imediatamente um task_id.
A ferramenta MCP atual não gera com GPT Image, não edita imagens e não cria vídeos.
tool.03
pixapi_get_task
Lê status, progresso, custo, URL de resultado ou erro de uma tarefa pertencente à sua conta.
Consulte esta ferramenta para uma tarefa existente em vez de reenviar a geração.
Clientes compatíveis
A compatibilidade começa pelos padrões abertos.
O caminho padrão é Remote MCP com OAuth. Plano, políticas do workspace e versão do cliente podem controlar a disponibilidade de conectores remotos.
Caminho compatível
Clientes Remote MCP + OAuth
Use a URL diretamente quando o cliente oferecer Streamable HTTP, descoberta de recurso protegido, registro dinâmico e PKCE.
Verifique o cliente
ChatGPT, Claude, VS Code e outros
Conecte quando seu plano e versão oferecerem servidores Remote MCP personalizados com OAuth. A disponibilidade é controlada pelo fornecedor.
Bridge não público
Clientes somente stdio
O bridge nativo/npm de um clique para configurações stdio, como algumas do Claude Code ou Cursor, ainda não faz parte do MVP público.
O Pixapi não afirma compatibilidade com todos os clientes MCP. Um cliente só é marcado como compatível após validar autorização, ferramentas, tarefas longas e reconexão.
Créditos e tentativas
Consultar é seguro. Gerar duas vezes não é tentar de novo.
O MCP usa o mesmo saldo e as mesmas regras de créditos do restante do Pixapi. Consulte preços atuais na ferramenta ao vivo e na página de preços.
Chame pixapi_get_pricing_and_balance antes da geração para confirmar custo e saldo disponível.
pixapi_generate_image cria uma nova tarefa e consome os créditos mostrados para o modelo escolhido.
pixapi_get_task é somente leitura. Consulte o task_id até o status ser completed ou failed.
A geração ainda não é idempotente
Repetir pixapi_generate_image cria outra tarefa e pode cobrar novamente. Guarde o task_id e consulte-o; não reenvie automaticamente porque o resultado ainda está processando.
Sua conta, seus dados e seu uso continuam protegidos.
Ao conectar o Pixapi MCP, você usa a mesma conta e aceita as políticas aplicáveis à autenticação, prompts, tarefas, mídia gerada, cobrança e uso do serviço.