Agentes e API

O que é

O i3dify transforma imagens e PDF em peças 3D que você compartilha com um link, em qualquer um dos seus tipos de projeto: um flipbook, um álbum de fotos, uma parede de galeria, um mockup, uma caneca, um lanyard e outros. Você pode fazer isso no dashboard, ou deixar um agente ou um script fazer por você, com as mesmas ferramentas que o produto usa por dentro.

• Você descreve o que quer e aponta os arquivos. O agente escolhe o tipo de projeto, envia as páginas, cria o projeto e entrega o link.
• Os arquivos nunca passam pelo modelo. Eles vão direto para o armazenamento do seu workspace, e as ferramentas só movem referências a eles.
• Tudo o que o agente cria aparece no seu dashboard, onde você continua editando como sempre.
• Não é só para projetos novos. Um agente também pode editar e apagar projetos, montar coleções, filmar e editar peças do Studio e lembrar informações da sua marca.

Quatro formas de entrar

Escolha a que combina com o lugar onde você já trabalha.

Conectar por MCP

MCP é o padrão que os assistentes usam para chamar ferramentas externas. O i3dify expõe um único servidor MCP remoto. Você conecta uma vez e, a partir daí, o assistente tem as mesmas ferramentas que o assistente de IA do dashboard usa:

• Projetos: detectar o tipo de projeto certo para seus arquivos, enviá-los, criar um projeto, adicionar páginas ou imagens, mudar configurações ou visibilidade, ler o projeto, listar seus projetos e apagar um.
• Coleções: criar uma coleção com seus projetos, mudar o visual e o conteúdo dela, e ler a coleção.
• Studio: filmar um projeto como composição do Studio, listar as composições e editar uma.
• Workspace: listar seus workspaces, ver um resumo de um deles, e lembrar ou esquecer informações que o assistente deve ter em mente.

Claude Code

Rode isto em um terminal e depois digite /mcp dentro do Claude Code para entrar:

claude mcp add --transport http i3dify https://i3dify.com/api/mcp

Claude.ai e Claude Desktop

Adicione um conector personalizado nas configurações e cole esta URL:

https://i3dify.com/api/mcp

Cursor

Clique no botão para adicionar o i3dify ao Cursor e depois entre quando o Cursor pedir:

Ou adicione à mão em .cursor/mcp.json:

{
  "mcpServers": {
    "i3dify": {
      "url": "https://i3dify.com/api/mcp"
    }
  }
}

VS Code

Rode isto em um terminal e depois inicie o servidor pela lista de MCP do VS Code para entrar:

code --add-mcp '{"name":"i3dify","type":"http","url":"https://i3dify.com/api/mcp"}'

ChatGPT

Ative o modo desenvolvedor (Configurações, Apps e conectores, Avançado), crie um conector com esta URL e escolha OAuth. O modo desenvolvedor só existe em alguns planos do ChatGPT.

https://i3dify.com/api/mcp

Outros clientes MCP

Windsurf, Gemini CLI e qualquer cliente que fale MCP remoto por HTTP: adicione um servidor com a URL acima. O login é o mesmo OAuth.

A tela de consentimento

Na primeira vez que um cliente se conecta, o i3dify abre uma página de login no seu navegador e pede permissão para que esse cliente atue na sua conta. É o seu login normal do i3dify. O cliente guarda apenas um token próprio, nunca a sua senha.

Depois de conectar, peça o que quiser com palavras simples: "faça um flipbook com este PDF", "transforme estas capturas em um mockup de celular". Se o i3dify não conseguir saber qual tipo de projeto você quer, ele não chuta: devolve as opções e o assistente pergunta para você.

Chaves de API

Scripts e servidores não podem abrir um navegador para fazer login, então usam uma chave de API. Uma chave é sua e começa com i3d_. Por padrão ela alcança todos os workspaces de que você participa; marque Limitar a este workspace ao criar para deixá-la em um só.

1. Abra a página da sua conta no dashboard e vá em API keys.
2. Clique em Criar API key, dê um nome, escolha se limita a este workspace e quando ela expira (nunca, em 30 dias, em 90 dias ou em um ano), e copie. Ela é mostrada uma única vez.
3. Envie a chave em cada requisição como bearer token.

O cabeçalho fica assim:

Authorization: Bearer i3d_...

Permissões (scopes)

Uma chave criada na página da sua conta tem as quatro permissões. Uma chave com menos só pode ser criada chamando POST /api/v1/keys com uma lista de scopes enquanto você está conectado ao i3dify no navegador, porque uma chave não pode criar outras chaves. Uma chamada que precisa de uma permissão que a chave não tem falha com 403.

Trate uma chave como uma senha. Se ela vazar, revogue pela página da sua conta e crie outra. A antiga para de funcionar na hora. A lista mostra se cada chave está ativa, revogada ou expirada, e quando foi usada pela última vez.

Um passo a passo mínimo com REST

A API fica em https://i3dify.com/api/v1 e fala JSON. Este é o caminho mais curto entre um arquivo no seu disco e um link para compartilhar. O id do seu workspace vem de GET /api/v1/me.

curl -X POST https://i3dify.com/api/v1/uploads \
  -H "Authorization: Bearer i3d_..." \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"<workspace-id>","files":[{"name":"catalog.pdf","mime":"application/pdf","size":1048576}]}'

curl -X PUT "<uploadUrl>" \
  -H "Content-Type: application/pdf" \
  -H "x-upsert: true" \
  --data-binary @catalog.pdf

curl -X POST https://i3dify.com/api/v1/projects/from-files \
  -H "Authorization: Bearer i3d_..." \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"<workspace-id>","sources":[{"path":"<path>"}],"title":"Spring catalog"}'

curl https://i3dify.com/api/v1/projects/<project-id> \
  -H "Authorization: Bearer i3d_..."

Arquivos que já estão na web pulam os passos 1 e 2: passe { "url": "https://..." } como source. E se preferir mandar os bytes de uma vez, POST /api/v1/projects/from-files também aceita multipart form data com os arquivos como partes.

Limites

Cada requisição feita pelo assistente de IA, MCP, REST ou a linha de comando conta no seu plano. O limite por minuto é por credencial (uma chave, um cliente conectado), e cada tipo de chamada é contado separadamente. As requisições mensais e os tokens de IA são por workspace.

• Acima do limite por minuto, a API responde 429 com um cabeçalho Retry-After. Quando o workspace já usou as requisições do mês, ou ficou sem tokens de IA, as chamadas que mudam algo respondem 402 até o mês seguinte, a compra de um pacote de tokens ou uma mudança de plano.
• Só o assistente de IA gasta tokens de IA. Um token é um milésimo de dólar de custo de modelo. Chamadas por MCP, REST ou linha de comando não gastam nenhum, mas ainda precisam de saldo acima de zero. A cota mensal renova no começo de cada mês (UTC) e não acumula; na página de faturamento dá para comprar pacotes de 2.000 tokens por US$ 5 que não expiram.
• A cota de armazenamento e o limite de projetos do seu plano continuam valendo. Um projeto criado por um agente conta como um criado à mão.
• O plano gratuito mantém a marca d'água do i3dify no visualizador, como no dashboard.

O que ainda não existe

• Não há render de vídeo sem navegador. Um agente pode criar uma composição no Studio e entregar o link, mas o vídeo em si é renderizado no Studio, no seu navegador, quando você clica em exportar.
• Não há webhooks. Para saber quando um job terminou, leia o projeto, ou o job em GET /api/v1/jobs/{id}.