Агенты и API

Что это

i3dify превращает изображения и PDF в 3D-объекты, которыми вы делитесь по ссылке: flipbook, фотоальбом, галерейную стену, визитку, ленту для бейджа, mockup ноутбука или телефона. Раньше всё это делалось в дашборде. Теперь это может сделать за вас агент или скрипт, теми же инструментами, которыми продукт пользуется внутри.

• Вы описываете, что нужно, и указываете файлы. Агент выбирает тип проекта, загружает страницы, создаёт проект и отдаёт вам ссылку.
• Файлы никогда не проходят через модель. Они попадают прямо в хранилище вашего workspace, а инструменты передают только ссылки на них.
• Всё, что создал агент, появляется в вашем дашборде, где вы редактируете это как обычно.

Четыре способа подключиться

Выберите тот, который ближе к тому, где вы уже работаете.

Подключение через MCP

MCP это стандарт, по которому ассистенты вызывают внешние инструменты. У i3dify один удалённый MCP-сервер. Вы подключаетесь один раз, и после этого ассистент может перечислять ваши workspaces, загружать файлы, создавать проекты и снимать композицию в Studio.

Claude Code

Выполните это в терминале, затем наберите /mcp внутри Claude Code, чтобы войти:

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

Claude.ai и Claude Desktop

Добавьте пользовательский коннектор в настройках и вставьте этот URL:

https://i3dify.com/api/mcp

Экран согласия

При первом подключении клиента i3dify открывает страницу входа в вашем браузере и просит разрешить этому клиенту действовать от имени вашего аккаунта. Это ваш обычный вход в i3dify. Клиент хранит только собственный токен, никогда не ваш пароль.

После подключения просите простыми словами: «сделай flipbook из этого PDF», «преврати эти скриншоты в mockup телефона». Если ассистент не может понять, какой тип проекта вам нужен, он спрашивает, а не угадывает.

API keys

Скрипты и серверы не могут открыть браузер, чтобы войти, поэтому они используют API key. Ключ принадлежит вам и одному workspace и начинается с i3d_.

1. Откройте страницу своего аккаунта в дашборде и перейдите в раздел API keys.
2. Создайте ключ, выберите, что ему разрешено, и скопируйте его. Он показывается только один раз.
3. Передавайте его с каждым запросом как bearer token.

Заголовок выглядит так:

Authorization: Bearer i3d_...

Scopes

Каждый ключ несёт те scopes, которые вы ему дали. Вызов, которому нужен scope, отсутствующий у ключа, завершается ошибкой 403.

Относитесь к ключу как к паролю. Если он утёк, отзовите его на странице аккаунта и создайте новый. Старый перестаёт работать сразу.

Минимальный маршрут через REST

API живёт по адресу https://i3dify.com/api/v1 и говорит на JSON. Это самый короткий путь от файла на вашем диске до ссылки, которой можно поделиться. Id вашего workspace возвращает 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_..."

Файлы, которые уже лежат в сети, пропускают шаги 1 и 2: передайте { "url": "https://..." } как source. А если удобнее отправить байты сразу, POST /api/v1/projects/from-files принимает и multipart form data с файлами в виде частей.

Лимиты

Каждый запрос через чат, MCP или REST учитывается в вашем плане. Лимит в минуту действует на одну учётную запись (один ключ, один подключённый клиент). Месячный потолок действует на workspace.

• При превышении лимита в минуту API отвечает 429 с заголовком Retry-After. Когда исчерпан месячный потолок, API отвечает 402 до следующего месяца или до смены плана.
• Токен ИИ это тысячная доллара стоимости модели; типичный запрос расходует один-два. Месячный лимит обновляется первого числа; на странице оплаты можно купить пакеты по 2 000 токенов за $5, которые не сгорают.
• Квота на хранилище и лимит проектов вашего плана продолжают действовать. Проект, созданный агентом, считается так же, как созданный вручную.
• Бесплатный план сохраняет водяной знак i3dify в просмотрщике, как и в дашборде.

Чего пока нет

• Нет рендера видео без браузера. Агент может создать композицию в Studio и дать на неё ссылку, но само видео рендерится в Studio, в вашем браузере, когда вы нажимаете экспорт.
• Нет webhooks. Чтобы узнать, что задача завершена, читайте проект или саму задачу по GET /api/v1/jobs/{id}.