Agents et API

De quoi il s'agit

i3dify transforme des images et des PDF en objets 3D que vous partagez avec un lien, dans tous ses types de projet : un flipbook, un album photo, un mur de galerie, un mockup, un mug, un lanyard et d'autres. Vous pouvez le faire vous-même dans le dashboard, ou laisser un agent ou un script 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.
• Ce n'est pas réservé aux nouveaux projets. Un agent peut aussi modifier et supprimer des projets, monter des collections, filmer et modifier des pièces Studio, et retenir des informations sur votre marque.

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 dispose des mêmes outils que l'assistant IA du dashboard :

• Projets : détecter le type de projet qui convient à vos fichiers, les envoyer, créer un projet, ajouter des pages ou des images, changer ses réglages ou sa visibilité, le lire, lister vos projets et en supprimer un.
• Collections : créer une collection avec vos projets, changer son apparence et son contenu, et la lire.
• Studio : filmer un projet en composition Studio, lister les compositions et en modifier une.
• Workspace : lister vos workspaces, obtenir un aperçu de l'un d'eux, et retenir ou oublier des informations que l'assistant doit garder en tête.

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

Cursor

Cliquez sur le bouton pour ajouter i3dify à Cursor, puis connectez-vous quand Cursor vous le demande :

Ou ajoutez-le à la main dans .cursor/mcp.json :

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

VS Code

Lancez ceci dans un terminal, puis démarrez le serveur depuis la liste MCP de VS Code pour vous connecter :

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

ChatGPT

Activez le mode développeur (Paramètres, Apps et connecteurs, Avancé), créez un connecteur avec cette URL et choisissez OAuth. Le mode développeur n'existe que sur certains forfaits ChatGPT.

https://i3dify.com/api/mcp

Autres clients MCP

Windsurf, Gemini CLI et tout client qui parle MCP distant en HTTP : ajoutez un serveur avec l'URL ci-dessus. La connexion passe par le même OAuth.

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 i3dify n'arrive pas à savoir quel type de projet vous voulez, il ne devine pas : il renvoie les possibilités et l'assistant vous pose la question.

Clés d'API

Les scripts et les serveurs ne peuvent pas ouvrir un navigateur pour se connecter, ils utilisent donc une clé d'API. Une clé vous appartient et commence par i3d_. Par défaut, elle donne accès à tous vos workspaces ; cochez Limiter à ce workspace en la créant pour la réserver à un seul.

1. Ouvrez la page de votre compte dans le dashboard et allez dans API keys.
2. Cliquez sur Créer une API key, donnez-lui un nom, choisissez si vous la limitez à ce workspace et quand elle expire (jamais, dans 30 jours, dans 90 jours ou dans un an), puis 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_...

Autorisations (scopes)

Une clé créée sur la page de votre compte a les quatre autorisations. Une clé qui en a moins ne peut être créée qu'en appelant POST /api/v1/keys avec une liste de scopes en étant connecté à i3dify dans le navigateur, car une clé ne peut pas créer d'autres clés. Un appel qui a besoin d'une autorisation que la clé n'a pas échoue avec un 403.

Traitez une clé 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. La liste indique si chaque clé est active, révoquée ou expirée, et quand elle a servi pour la dernière fois.

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 l'assistant IA, MCP, REST ou la ligne de commande compte pour votre plan. La limite par minute s'applique par identifiant (une clé, un client connecté), et chaque type d'appel est compté séparément. Les requêtes mensuelles et les jetons IA s'appliquent par workspace.

• Au-delà de la limite par minute, l'API répond 429 avec un en-tête Retry-After. Quand le workspace a utilisé ses requêtes du mois, ou n'a plus de jetons IA, les appels qui modifient quelque chose répondent 402 jusqu'au mois suivant, à l'achat d'un pack de jetons ou à un changement de plan.
• Seul l'assistant IA consomme des jetons IA. Un jeton vaut un millième de dollar de coût de modèle. Les appels par MCP, REST ou la ligne de commande n'en consomment aucun, mais ils ont quand même besoin d'un solde supérieur à zéro. L'allocation mensuelle se renouvelle au début de chaque mois (UTC) et n'est pas reportée ; 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}.