Documentação

Conecte o Repo / Studio ao seu assistente de IA e gere imagens e vídeos conversando.

Visão geral

O Repo / Studio expõe um servidor MCP (Model Context Protocol). MCP é o padrão que Claude, ChatGPT, Cursor, Gemini CLI, Codex e outros usam para chamar ferramentas externas. Depois de conectar, o assistente ganha ferramentas para criar imagens, criar vídeos de 10 a 60 s, acompanhar pedidos e melhorar prompts, tudo na sua conta.

• Transporte: Streamable HTTP, uma única URL:
• Autenticação: chave de API da sua conta (rs_…).
• Idioma: as ferramentas aceitam prompts em português ou qualquer idioma.

Início rápido

1. Crie uma conta (ou entre). Ela já vem com 1 teste gratuito.
2. Abra Conectar, escolha o seu cliente e clique em Adicionar o Repo. A chave é gerada na hora e já vem preenchida nos comandos.
3. Cole o prompt ou o comando no cliente.
4. Peça: “Use o Repo Studio para criar uma imagem de um gato astronauta”.

Para testar sem nenhum cliente, rode no terminal:

curl -s MCPURL \
  -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Chave de API

Cada chave pertence a uma conta e começa com rs_. Gerar, ver e apagar chaves: Conectar → Suas chaves. Até 5 chaves por conta.

Há duas maneiras de enviar a chave:

A chave aparece uma vez quando é criada; o servidor guarda só um hash, então não consegue mostrá-la de novo. Se perder, apague e crie outra. Chave apagada deixa de funcionar na hora.

Endpoint

Chamar a ferramenta criar_imagem na mão:

curl -s MCPURL \
  -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"criar_imagem","arguments":{"prompt":"Um gato astronauta flutuando perto da Lua, estilo ilustração","formato":"1:1"}}}'

Ferramentas

criar_imagem

Gera uma imagem. Espera até ~45 segundos e devolve a imagem pronta (como conteúdo de imagem, quando é pequena, e sempre com o link). Se passar do tempo, devolve o id para consultar com ver_pedido. Gasta 1 geração.

criar_video

Cria um vídeo com áudio, de 10 a 60 segundos. Devolve na hora um id; o vídeo leva de ~1 a ~7 minutos (cerca de 1 minuto a cada 10 s de vídeo). Use ver_pedido para acompanhar. Gasta 1 geração, qualquer que seja a duração.

ver_pedido

Mostra status, progresso (0 a 100) e, quando pronto for verdadeiro, a url do arquivo. Só enxerga pedidos da própria conta.

listar_pedidos

Lista os pedidos mais recentes. Parâmetro opcional limite (1 a 30, padrão 10).

melhorar_prompt

Reescreve uma ideia curta como um prompt profissional. Não gasta gerações do plano.

minha_conta

Devolve o nome, o plano e os testes gratuitos que restam.

Como funcionam os pedidos

1. Imagem: a chamada espera o resultado. Em geral volta pronta.
2. Vídeo: a chamada volta na hora com um id, status Na fila e progresso. O assistente consulta com ver_pedido até pronto: true.
3. O arquivo pronto fica no link /dl/…, que funciona sem login e abre direto no navegador (o link é assinado e só se obtém pela sua chave).
4. Tudo o que você gera por aqui também aparece na sua Galeria no Studio.
5. Pedido que falha devolve o teste gratuito automaticamente.

Erros

Conectar: Claude

Vale para o claude.ai e o app de desktop (planos com conectores personalizados).

1. Configurações → Conectores → Adicionar conector personalizado.
2. Nome Repo Studio e a URL com a chave: . Deixe os campos de OAuth em branco.
3. Ative o conector no chat e peça a imagem ou o vídeo.

Conectar: ChatGPT

1. Configurações → Apps e conectores → Avançado e ligue o Modo desenvolvedor.
2. Criar: nome Repo Studio, URL do servidor MCP , autenticação Sem autenticação.
3. No chat, + → Mais e escolha o Repo Studio.

O modo desenvolvedor depende do plano do ChatGPT e pode mudar de lugar nas configurações. Mesma observação sobre endereço público do Claude.

Conectar: Claude Code

claude mcp add --transport http repo-studio MCPURL --header "Authorization: Bearer SUA_CHAVE"

Confira com claude mcp list. Você também pode colar no Claude Code o prompt que aparece em Conectar e deixar que ele configure.

Conectar: Gemini CLI

{
  "mcpServers": {
    "repo-studio": {
      "httpUrl": "MCPURL",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

Reinicie e rode /mcp. O app do Gemini no navegador ainda não aceita servidores MCP próprios, até onde sabemos.

Conectar: Cursor

{
  "mcpServers": {
    "repo-studio": {
      "url": "MCPURL",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

Conectar: Codex CLI

[mcp_servers.repo-studio]
url = "MCPURL"
http_headers = { Authorization = "Bearer SUA_CHAVE" }

Conectar: outros (Grok, bots, seus agentes)

Qualquer cliente MCP por HTTP funciona com a URL e o cabeçalho de Chave de API. Para clientes que só falam MCP local (stdio), use o mcp-remote:

npx -y mcp-remote MCPURL --header "Authorization: Bearer SUA_CHAVE"

Se o seu bot não fala MCP, use a mesma ideia com chamadas JSON-RPC diretas, como no Endpoint.

Planos e limites

• Conta nova: 1 teste gratuito, de vídeo ou imagem. Vale também pelo MCP.
• Teste esgotado: a ferramenta responde que os testes acabaram e indica os planos.
• Planos Starter, Pro e MAX: a cobrança e a contagem de créditos ainda estão em preparação.
• Até 3 vídeos em paralelo; os demais ficam na fila.
• Imagens de referência ainda não são aceitas pelo MCP (apenas no Studio).

Segurança

• Trate a chave como uma senha. Ela gasta as suas gerações.
• A chave na URL pode ficar registrada em histórico de conectores. Se achar que vazou, apague e crie outra.
• Use uma chave por dispositivo ou serviço, para poder revogar uma sem afetar as outras.
• Só use o endereço público do Studio com HTTPS.

Dúvidas