Добро пожаловать в Quote3D!
Обзор
Quote3D — это REST API и платформа с встраиваемыми виджетами для анализа 3D-печати, асинхронной генерации расчетов стоимости и производственных рабочих процессов. Внешние API-запросы обрабатываются по адресу https://api.quote3d.com/v2. Независимо от того, создаете ли вы сервис 3D-печати, встраиваете расчет стоимости в интернет-магазин или автоматизируете свою ферму 3D-принтеров, Quote3D поможет вам получить точные данные о стоимости и возможности печати.
Эта документация содержит все необходимое для интеграции Quote3D в ваше приложение. Мы разработали ее так, чтобы она была понятной, всеобъемлющей и простой в использовании — независимо от того, являетесь ли вы опытным разработчиком или только начинаете работать с API.
Ключевые особенности
- Асинхронные задания расчёта стоимости - Точная оценка цены, расхода материала и времени печати (FDM, SLA, SLS) посредством обработки заданий
- Поддержка Мульти-Форматов — Профессиональный геометрический анализ файлов STL, 3MF и OBJ
- Печатаемость и безопасность - Предварительная оценка риска отслоения, геометрической целостности (открытые ребра/ошибки non-manifold) и проверки границ
- Расширенные технические метрики - Подробные данные о производстве, включая площадь поверхности, объем поддержек и анализ non-manifold
- История Расчетов Предприятия — Централизованное управление и доступ ко всем вашим профессиональным расчетам
- Расширенные Вебхуки — Интеграция в реальном времени с существующими бизнес-процессами (ERP/CRM)
- Глубокая Аналитика — Детальное отслеживание потребления материалов, тенденций затрат и эффективности производства
- Встраиваемые виджеты - Клиентские потоки получения расценок с использованием postMessage, поддержкой перенаправлений и интеграцией плагинов
Как это работает
- Загрузите файл 3D-модели (формат STL, 3MF или OBJ)
- Настройте параметры принтера и ценовые параметры (или используйте значения по умолчанию)
- Запросите расчет стоимости — Quote3D анализирует вашу модель и рассчитывает цену
- Получите подробные результаты, включая расход материала, время печати и общую стоимость
- Получите доступ к истории расчетов, аналитике и управляйте своими файлами через API
Если в документации нет того, что вы ищете, или что-то кажется неясным, посетите наш репозиторий GitHub и откройте issue или PR — эта документация находится в разработке, и мы приветствуем все вклады!
Мы активно разрабатываем и улучшаем сервис, поэтому ожидайте частых изменений и новых функций, а также обновлений этой документации.
Системная архитектура и основной движок
В основе Quote3D лежит продвинутый движок моделирования 3D-слайсинга и геометрического анализа. В отличие от простых калькуляторов на основе объема, наша система действительно интерпретирует геометрию загруженных моделей, чтобы обеспечить высокоточный расчет стоимости промышленного уровня.
Поддержка нескольких технологий
Наш движок динамически адаптирует свою логику расчетов для трех различных технологий производства:
- FDM (моделирование методом послойного наплавления): Мы вычисляем длину пути нити, генерацию оболочки слой за слоем, геометрию заполнения (infill) и необходимые поддерживающие структуры. Параметры машины, такие как размер сопла, различные скорости (печати, перемещения, втягивания) и ограничения по рывку/ускорению, точно учитываются для оценки реального времени печати.
- SLA (стереолитография): Вычисление переключается на метрики экспозиции светом. Время печати выводится из количества слоев, стандартного времени экспозиции, переопределений экспозиции базового слоя и механических движений подъема/втягивания ванны со смолой.
- SLS (селективное лазерное спекание): Вычисления используют скорость лазера, шаг штриховки, время пересыпания слоев и время предварительного нагрева/охлаждения. SLS позволяет укладывать детали друг на друга в порошковой камере, что учитывается нашим движком пакетной обработки.
Продвинутая 3D-упаковка и пакетная обработка
Когда запрос содержит несколько экземпляров, наш продвинутый 3D-алгоритм упаковки в контейнер вычисляет, сколько деталей поместится в единую производственную партию (batch) на основе объема сборки машины (X, Y, Z). Группируя детали в партии, накладные операции — такие как предварительный нагрев платформы или пересыпание слоев SLS — амортизируются за партию, а не за деталь. Это обеспечивает невероятно экономичное масштабирование для массового производства.
Комплексный расчет стоимости
Ценообразование — это не просто наценка на вес материала. Quote3D формирует окончательную цену путем суммирования:
- Стоимость материала: Вычисляется из точного количества граммов использованного материала (включая сгенерированные опоры), умноженного на стоимость материала за грамм.
- Почасовая ставка машины: Смоделированное время печати умножается на конкретную почасовую операционную стоимость назначенной машины.
- Энергетические издержки: Учитываются местные затраты на электроэнергию (кВтч) по отношению к мощности машины.
- Постобработка и маржа: Фиксированные сборы, опции постобработки (шлифовка, покраска, выемка внутренних полостей) и налоговые ставки применяются в качестве финальных слоев в выбранной вами валюте.
Бесшовная интеграция API и панели управления
Весь движок заключен в элегантный REST API и удобную панель управления. Вы можете определить свои профили принтеров по умолчанию, профили материалов и конфигурации котировок визуально на панели управления. Когда поступают API-запросы, они автоматически наследуют эти настройки, если они явно не переопределены полезной нагрузкой запроса — что обеспечивает абсолютную гибкость для крайних случаев, сохраняя при этом ваши API-вызовы чистыми и минимальными.