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