Agents et API

De quoi il s'agit

i3dify transforme des images et des PDF en objets 3D que vous partagez avec un lien : un flipbook, un album photo, un mur de galerie, une carte de visite, un lanyard d'événement, un mockup d'ordinateur portable ou de téléphone. Jusqu'ici, cela se faisait dans le dashboard. Maintenant, un agent ou un script peut le faire pour vous, avec les mêmes outils que le produit utilise en interne.

• Vous décrivez ce que vous voulez et vous indiquez les fichiers. L'agent choisit le type de projet, envoie les pages, crée le projet et vous remet le lien.
• Les fichiers ne passent jamais par le modèle. Ils vont directement dans le stockage de votre workspace, et les outils ne manipulent que des références.
• Tout ce que l'agent crée apparaît dans votre dashboard, où vous continuez à l'éditer comme d'habitude.

Quatre portes d'entrée

Choisissez celle qui correspond à l'endroit où vous travaillez déjà.

Se connecter via MCP

MCP est le standard que les assistants utilisent pour appeler des outils externes. i3dify expose un seul serveur MCP distant. Vous vous connectez une fois et, à partir de là, l'assistant peut lister vos workspaces, envoyer des fichiers, créer des projets et filmer une composition dans Studio.

Claude Code

Lancez ceci dans un terminal, puis tapez /mcp dans Claude Code pour vous connecter :

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

Claude.ai et Claude Desktop

Ajoutez un connecteur personnalisé dans les paramètres et collez cette URL :

https://i3dify.com/api/mcp

L'écran de consentement

La première fois qu'un client se connecte, i3dify ouvre une page de connexion dans votre navigateur et vous demande d'autoriser ce client à agir sur votre compte. C'est votre identifiant i3dify habituel. Le client ne conserve qu'un jeton qui lui est propre, jamais votre mot de passe.

Une fois connecté, demandez ce que vous voulez avec des mots simples : « fais un flipbook avec ce PDF », « transforme ces captures en mockup de téléphone ». Si l'assistant n'arrive pas à savoir quel type de projet vous voulez, il pose la question au lieu de deviner.

API keys

Les scripts et les serveurs ne peuvent pas ouvrir un navigateur pour se connecter, ils utilisent donc une API key. Une key vous appartient, est liée à un seul workspace et commence par i3d_.

1. Ouvrez la page de votre compte dans le dashboard et allez dans API keys.
2. Créez une key, choisissez ce qu'elle a le droit de faire et copiez-la. Elle n'est affichée qu'une seule fois.
3. Envoyez-la avec chaque requête comme bearer token.

L'en-tête ressemble à ceci :

Authorization: Bearer i3d_...

Scopes

Chaque key porte les scopes que vous lui avez donnés. Un appel qui a besoin d'un scope que la key n'a pas échoue avec un 403.

Traitez une key comme un mot de passe. Si elle fuit, révoquez-la depuis la page de votre compte et créez-en une nouvelle. L'ancienne cesse de fonctionner immédiatement.

Un parcours REST minimal

L'API se trouve sous https://i3dify.com/api/v1 et parle JSON. Voici le chemin le plus court entre un fichier sur votre disque et un lien à partager. L'id de votre workspace vient 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_..."

Les fichiers déjà en ligne sautent les étapes 1 et 2 : passez { "url": "https://..." } comme source. Et si vous préférez envoyer les octets d'un coup, POST /api/v1/projects/from-files accepte aussi du multipart form data avec les fichiers comme parties.

Limites

Chaque requête passée par le chat, MCP ou REST compte pour votre plan. La limite par minute s'applique par identifiant (une key, un client connecté). Le plafond mensuel s'applique par workspace.

• Au-delà de la limite par minute, l'API répond 429 avec un en-tête Retry-After. Quand le plafond mensuel est atteint, elle répond 402 jusqu'au mois suivant ou jusqu'à un changement de plan.
• Un jeton IA vaut un millième de dollar de coût de modèle ; une requête typique en utilise un ou deux. L'allocation mensuelle se renouvelle le premier du mois ; des packs de 2 000 jetons à 5 $ s'achètent sur la page de facturation et n'expirent pas.
• Le quota de stockage et la limite de projets de votre plan s'appliquent toujours. Un projet créé par un agent compte comme un projet créé à la main.
• Le plan gratuit garde le filigrane i3dify sur la visionneuse, comme dans le dashboard.

Ce qui n'existe pas encore

• Pas de rendu vidéo sans navigateur. Un agent peut créer une composition dans Studio et vous donner son lien, mais la vidéo elle-même est rendue dans Studio, dans votre navigateur, quand vous lancez l'export.
• Pas de webhooks. Pour savoir quand une tâche est terminée, lisez le projet, ou la tâche sur GET /api/v1/jobs/{id}.