Agentes e API

O que é

O i3dify transforma imagens e PDF em peças 3D que você compartilha com um link: um flipbook, um álbum de fotos, uma parede de galeria, um cartão de visita, um lanyard de evento, um mockup de laptop ou de celular. Até agora isso era feito no dashboard. Agora um agente ou um script pode 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.

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 pode listar seus workspaces, enviar arquivos, criar projetos e filmar uma composição no Studio.

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

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 assistente não conseguir saber qual tipo de projeto você quer, ele pergunta em vez de adivinhar.

API keys

Scripts e servidores não podem abrir um navegador para fazer login, então usam uma API key. Uma key é sua e de um único workspace, e começa com i3d_.

1. Abra a página da sua conta no dashboard e vá em API keys.
2. Crie uma key, escolha o que ela pode fazer e copie. Ela é mostrada uma única vez.
3. Envie a key em cada requisição como bearer token.

O cabeçalho fica assim:

Authorization: Bearer i3d_...

Scopes

Cada key carrega os scopes que você deu a ela. Uma chamada que precisa de um scope que a key não tem falha com 403.

Trate uma key como uma senha. Se ela vazar, revogue pela página da sua conta e crie outra. A antiga para de funcionar na hora.

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 chat, MCP ou REST conta no seu plano. O limite por minuto é por credencial (uma key, um cliente conectado). O teto mensal é por workspace.

• Acima do limite por minuto, a API responde 429 com um cabeçalho Retry-After. Quando o teto mensal é atingido, ela responde 402 até o mês seguinte ou até uma mudança de plano.
• Um token de IA é um milésimo de dólar de custo de modelo; um pedido típico usa um ou dois. A cota mensal renova no primeiro dia do mês; na página de cobrança 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}.