Agentes y API

Dejá que un asistente de IA o un script cree proyectos de i3dify por vos. Entregás los archivos y recibís un link.

Disponible en todos los planes. Las solicitudes se cuentan por plan, y un proyecto creado así sigue las mismas reglas que uno creado en el dashboard: el plan gratuito conserva la marca de agua de i3dify y la cuota de almacenamiento sigue aplicando.

Qué es

i3dify convierte imágenes y PDF en piezas 3D que compartís con un link: un flipbook, un álbum de fotos, una pared de galería, una tarjeta de presentación, un lanyard de evento, un mockup de laptop o de teléfono. Hasta ahora eso se hacía en el dashboard. Ahora un agente o un script puede hacerlo por vos, con las mismas herramientas que el producto usa por dentro.

Vos describís lo que querés y señalás los archivos. El agente elige el tipo de proyecto, sube las páginas, crea el proyecto y te entrega el link.
Los archivos nunca pasan por el modelo. Van directo al almacenamiento de tu workspace, y las herramientas solo mueven referencias a ellos.
Todo lo que crea el agente aparece en tu dashboard, donde lo seguís editando como siempre.

Cuatro formas de entrar

Elegí la que encaje con el lugar donde ya trabajás.

Crear con IA, en el dashboard

Un chat dentro de tu workspace. Soltás archivos, decís qué querés y recibís un link. Nada que instalar ni configurar.

MCP, para Claude y otros asistentes

Conectá i3dify a Claude Code, Claude.ai, Claude Desktop o cualquier cliente MCP. Iniciás sesión con tu cuenta de i3dify y el asistente recibe las herramientas.

REST, para scripts

Llamadas HTTP comunes con una API key. Ideal para pipelines de build, procesos por lote y todo lo que corre sin nadie mirando.

La línea de comandos, para una carpeta de archivos

npx @i3dify/cli import convierte una carpeta con un project.json y tus imágenes en un proyecto, con inicio de sesión por el navegador o una API key. Sirve para un paso de build o un script.

Conectar por MCP

MCP es el estándar que usan los asistentes para llamar herramientas externas. i3dify expone un único servidor MCP remoto. Te conectás una vez y, desde ahí, el asistente puede listar tus workspaces, subir archivos, crear proyectos y filmar una composición en Studio.

Claude Code

Ejecutá esto en una terminal y después escribí /mcp dentro de Claude Code para iniciar sesión:

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

Claude.ai y Claude Desktop

Agregá un conector personalizado en la configuración y pegá esta URL:

https://i3dify.com/api/mcp

La pantalla de consentimiento

La primera vez que un cliente se conecta, i3dify abre una página de inicio de sesión en tu navegador y te pide permiso para que ese cliente actúe sobre tu cuenta. Usa tu login normal de i3dify. El cliente solo guarda un token propio, nunca tu contraseña.

Una vez conectado, pedí lo que querés con palabras simples: "armá un flipbook con este PDF", "convertí estas capturas en un mockup de teléfono". Si el asistente no logra saber qué tipo de proyecto querés, pregunta en lugar de adivinar.

API keys

Los scripts y los servidores no pueden abrir un navegador para iniciar sesión, así que usan una API key. Una key es tuya y de un solo workspace, y empieza con i3d_.

Abrí la página de tu cuenta en el dashboard y entrá a API keys.
Creá una key, elegí qué puede hacer y copiala. Se muestra una sola vez.
Enviala en cada solicitud como bearer token.

El encabezado se ve así:

Authorization: Bearer i3d_...

Scopes

Cada key lleva los scopes que le diste. Una llamada que necesite un scope que la key no tiene falla con 403.

projects:read	Listar y leer proyectos, workspaces y el estado de los trabajos.
projects:write	Crear y actualizar proyectos, cambiar visibilidad y ajustes.
assets:write	Obtener URLs de subida y agregar páginas o imágenes a un proyecto.
compositions:write	Crear composiciones en Studio.

Tratá una key como una contraseña. Si se filtra, revocala desde la página de tu cuenta y creá una nueva. La vieja deja de funcionar al instante.

Un recorrido mínimo por la API REST

La API vive en https://i3dify.com/api/v1 y habla JSON. Este es el camino más corto desde un archivo en tu disco hasta un link para compartir. El id de tu workspace sale de GET /api/v1/me.

1. Pedí una URL de subida

Una entrada por archivo, con su nombre, tipo MIME y tamaño en bytes. La respuesta trae, por cada archivo, un path y una uploadUrl firmada que vale por dos horas.

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}]}'

2. Enviá el archivo a esa URL

Un PUT HTTP común con los bytes crudos y los encabezados que te dio la respuesta anterior. El archivo entra directo al almacenamiento de tu workspace, no pasa por la API.

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

3. Creá el proyecto a partir del archivo subido

Pasá el path del paso 1 como source. i3dify detecta el tipo de proyecto a partir de los archivos (o lo fijás vos con type), guarda cada página, filma una composición en Studio y responde con el proyecto, su viewUrl y un jobId. Si la detección no está segura, la respuesta trae needsConfirmation: true y no se crea nada. Volvé a llamar con un type.

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"}'

4. Consultá el proyecto

Leé el proyecto cuando quieras. El campo job muestra el último trabajo de procesamiento con su estado (queued, running, done o error) y su progreso. Cuando está en done, la viewUrl ya se puede compartir.

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

Los archivos que ya están en la web se saltan los pasos 1 y 2: pasá { "url": "https://..." } como source. Y si preferís mandar los bytes de una vez, POST /api/v1/projects/from-files también acepta multipart form data con los archivos como partes.

Límites

Cada solicitud que pasa por el chat, MCP o REST cuenta contra tu plan. El límite por minuto es por credencial (una key, un cliente conectado). El tope mensual es por workspace.

Plan	Solicitudes por minuto	Tokens de IA por mes
Free	30	25
Pro	120	500
Business	300	1.500
Enterprise	600	Ilimitados

Si superás el límite por minuto, la API responde 429 con un encabezado Retry-After. Cuando se alcanza el tope mensual responde 402 hasta el mes siguiente o hasta que cambies de plan.
Un token de IA es una milésima de dólar de costo de modelo; un pedido típico usa uno o dos. La cuota mensual se renueva el primero de cada mes; en la página de facturación se pueden comprar packs de 2.000 tokens por $5 que no vencen.
La cuota de almacenamiento y el límite de proyectos de tu plan siguen aplicando. Un proyecto creado por un agente cuenta igual que uno creado a mano.
El plan gratuito conserva la marca de agua de i3dify en el visor, igual que en el dashboard.

Lo que todavía no está

No hay render de video sin navegador. Un agente puede crear una composición en Studio y darte su link, pero el video se renderiza en Studio, en tu navegador, cuando apretás exportar.
No hay webhooks. Para saber cuándo terminó un trabajo, leé el proyecto, o el trabajo en GET /api/v1/jobs/{id}.

Documentación relacionada

Studio y exportación de video Ajustes de visibilidad Planes y límites