Агенты и API

Что это

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

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

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

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

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

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

• Проекты: определить подходящий тип проекта для ваших файлов, загрузить их, создать проект, добавить страницы или изображения, изменить настройки или видимость, прочитать проект, перечислить ваши проекты и удалить проект.
• Коллекции: создать коллекцию из ваших проектов, изменить её оформление и состав, прочитать её.
• Studio: снять проект как Studio-композицию, перечислить композиции и отредактировать одну из них.
• Workspace: перечислить ваши workspaces, получить обзор одного из них, запомнить или забыть сведения, которые ассистент должен учитывать.

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

Cursor

Нажмите кнопку, чтобы добавить i3dify в Cursor, затем войдите, когда Cursor попросит:

Или добавьте вручную в .cursor/mcp.json:

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

VS Code

Выполните это в терминале, затем запустите сервер из списка MCP в VS Code, чтобы войти:

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

ChatGPT

Включите режим разработчика (Настройки, Приложения и коннекторы, Дополнительно), создайте коннектор с этим URL и выберите OAuth. Режим разработчика есть не во всех тарифах ChatGPT.

https://i3dify.com/api/mcp

Другие MCP-клиенты

Windsurf, Gemini CLI и любой клиент, который поддерживает удалённый MCP по HTTP: добавьте сервер с URL выше. Вход через тот же OAuth.

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

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

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

API-ключи

Скрипты и серверы не могут открыть браузер, чтобы войти, поэтому они используют API-ключ. Ключ принадлежит вам и начинается с i3d_. По умолчанию он действует во всех ваших workspaces; чтобы ограничить его одним, при создании отметьте «Ограничить этим workspace».

1. Откройте страницу своего аккаунта в дашборде и перейдите в раздел API keys.
2. Нажмите «Создать API key», дайте ключу имя, решите, ограничить ли его этим workspace и когда он истечёт (никогда, через 30 дней, через 90 дней или через год), и скопируйте его. Он показывается только один раз.
3. Передавайте его с каждым запросом как bearer token.

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

Authorization: Bearer i3d_...

Права доступа (scopes)

Ключ, созданный на странице аккаунта, получает все четыре права. Ключ с меньшим набором можно создать только вызовом POST /api/v1/keys со списком scopes, войдя в i3dify в браузере: ключ не может создавать другие ключи. Вызов, которому нужно право, отсутствующее у ключа, завершается ошибкой 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. Когда workspace израсходовал месячные запросы или у него не осталось ИИ-токенов, вызовы, которые что-то меняют, получают ответ 402 до следующего месяца, покупки пакета токенов или смены тарифа.
• ИИ-токены тратит только ИИ-ассистент. Один токен — это тысячная доля доллара стоимости модели. Вызовы через MCP, REST и командную строку токены не тратят, но баланс всё равно должен быть больше нуля. Месячный лимит обновляется в начале каждого месяца (по UTC) и не переносится; на странице оплаты можно купить пакеты по 2 000 токенов за $5, которые не сгорают.
• Квота на хранилище и лимит проектов вашего плана продолжают действовать. Проект, созданный агентом, считается так же, как созданный вручную.
• Бесплатный план сохраняет водяной знак i3dify в просмотрщике, как и в дашборде.

Чего пока нет

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