Изображение в 3DО модели Seed3D 2.0
3D-модели с богатыми текстурами по одному изображению, особенно персонажи.
Вызывайте его по имени модели bytedance/seed3d-2.0/image-to-3d через POST /jobs/createTask, от 0,48 $.
Введение
Seed3D 2.0 — модель 3D-ассетов от команды Seed компании ByteDance, выпущенная в апреле 2026 года. Она считывает одно изображение и строит показанный на нём объект как полноценную 3D-сетку с материалами, так что снимок товара или рендер персонажа становится моделью, которую можно повернуть, осветить и поместить в сцену. Запрос принимает одно изображение (image_url) и необязательный переключатель плотности (mesh_detail); полей промпта, seed и стиля нет. Результат — один бинарный glTF-файл (.glb) с упакованными внутрь текстурами.
Ключевые возможности
Геометрия и материалы из одного снимка
Seed3D 2.0 генерирует форму и физически корректный материал одновременно. В наших запусках каждая модель вернулась с двумя текстурами 4096×4096: картой базового цвета и картой metal-roughness, поэтому кожа выглядела потёртой и матовой, а латунные люверсы и визор шлема ловили блики. Отдельной карты нормалей нет: детали поверхности заложены в самой сетке.
Плотная замкнутая сетка
На уровне medium по умолчанию обе тестовые модели вернулись с одной сеткой и одним материалом, чуть меньше 500 000 треугольников; на low у того же ботинка было 99 977 граней. По описанию разработчиков уровни соответствуют примерно 100 000, 500 000 и 1 000 000 граней. Более плотная сетка лучше передаёт мелкие детали — шнурки, строчки, пальцы; более лёгкая быстрее загружается в браузере.
Что мы измерили
Мы отправили студийное фото кожаного ботинка 1024×1024 и рендер игрушечного космонавта 682×1024. Оба запроса вернули корректные GLB-файлы: 37,2 МБ и 28,6 МБ, 499 998 и 499 992 треугольника, обработка заняла 356 и 340 секунд. У космонавта сохранились лицо, визор, панель на груди и оранжевая отделка со всех сторон. Ботинок, отправленный прямой фронтальной проекцией, вернулся с задней половиной, отзеркаленной с передней.
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
image_url | Да | Картинка, с которой всё начинается. |
mesh_detail | Нет | Плотность сетки: low (около 100 000 граней), medium (около 500 000) или high (около 1 000 000). Все три стоят одинаково; более высокие уровни сохраняют больше деталей и дают файлы большего размера. low · medium · high · По умолчанию: medium |
Цены
Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
| Вариант | USD за генерацию |
|---|---|
| Стандарт | 0,48 $ |
До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.
Сценарии использования
E-commerce и просмотр товаров
Снимок-пакшот становится интерактивной моделью для карточки товара или предпросмотра в AR. Снимайте или рендерьте товар под углом три четверти на однотонном фоне, держите весь объект в кадре и используйте уровень medium для баланса между деталями и размером загрузки.
Персонажи, игрушки и коллекционные фигурки
Рендеры персонажей и фото фигурок хорошо конвертируются, потому что их формы просты, а цвета яркие. Текстура несёт нарисованные детали — лица, значки, полосы; заднюю часть модель достраивает, поэтому выбирайте позу, в которой видна большая часть персонажа.
Руководство по промптам и советы
Подготовьте изображение
Один объект по центру, с отступом от краёв и без касания рамки кадра. Светлый однотонный фон хорошо отделяет объект. Принимаются JPEG, PNG или WebP до 10 МБ, пропорции изображения должны быть примерно от 2:5 до 5:2.
Выбирайте ракурс осознанно
Модель видит только одну сторону. Прямой фронтальный вид обуви или автомобиля не даёт представления о длине объекта, а скрытая половина может быть достроена зеркальным отражением фронта. Ракурс три четверти, на котором видны перед и одна боковина, даёт заметно более надёжный результат.
Выбирайте уровень детализации под сценарий
Для мобильных превью и сцен с множеством реквизита используйте low, для большинства веб-просмотрщиков — medium, а если модель будут рассматривать вблизи или печатать на 3D-принтере — high.
Проверяйте результат перед публикацией
Откройте GLB в просмотрщике, полностью поверните модель и посмотрите на сторону, которую вы не показывали. Если задняя часть выглядит неправильно, попробуйте другой ракурс фото, а не другой уровень детализации.
Быстрый старт API
Вызов API Seed3D 2.0 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
- Отправьте запрос. Отправьте POST /jobs/createTask с model bytedance/seed3d-2.0/image-to-3d и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seed3d-2.0/image-to-3d",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"mesh_detail": "medium"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Seed3D 2.0
Сколько стоит API Seed3D 2.0?
Seed3D 2.0 стоит 0,48 $ за генерацию. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.
Какое имя модели у Seed3D 2.0 в API?
Укажите bytedance/seed3d-2.0/image-to-3d — Изображение в 3D в поле model запроса POST /jobs/createTask.
Что я получу?
Один файл .glb (бинарный glTF 2.0) со встроенными текстурами: картой базового цвета и картой metal-roughness, обе в наших прогонах — PNG 4096×4096. Blender, three.js, model-viewer, Unity и Unreal импортируют его напрямую.
Нужен ли промпт?
Нет. Обязательно только изображение. mesh_detail необязателен и меняет лишь плотность сетки.
Какое изображение подходит лучше всего?
Один объект целиком в кадре на однотонном фоне в ракурсе три четверти. Загромождённые сцены, обрезанные предметы и строго фронтальные кадры заставляют модель угадывать то, чего она не видит.
Какие ограничения у API Seed3D 2.0?
Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Seed3D 2.0 без кода?
Запускайте Seed3D 2.0 в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.