Перейти к содержимому

TRELLIS.2 LoRA Inference

Интеграция

ID модели trellis-2-lora
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Этот запрос: 0,25 $ 250 API-кредитов · ≈ 26,37 ₽ Запустить на этой странице

Получить API-ключ

Преобразование изображения в 3D с помощью Trellis 2, с применением пользовательских LoRA-адаптеров для структуры, геометрии и текстуры

Microsoft · 3D

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

•обязательно image_url
Перетащите файл или

URL исходного изображения для преобразования в 3D-модель.

resolution по умолчанию 512

Разрешение генерации: значение 1024 выбирает каскадный конвейер. Выберите разрешение, на котором обучались переданные адаптеры LoRA; совпадение обязательно.

Расширенные texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · decimation_target · seed · enable_safety_checker

Необязательный checkpoint LoRA в формате safetensors, специально обученный для шумоподавителя текстур.

texture_size по умолчанию 2048

Разрешение текстур, запечённых в экспорт GLB.

Необязательный checkpoint LoRA в формате safetensors, специально обученный для шумоподавителя разреженной структуры.

Необязательный checkpoint LoRA в формате safetensors, специально обученный для шумоподавителя геометрии.

по умолчанию 7.5

Сила classifier-free guidance при генерации разреженной структуры.

по умолчанию 0.7

Масштабирование guidance при генерации разреженной структуры. Большие значения делают выход стабильнее.

по умолчанию 0.6

Доля прогресса шумоподавления, при которой начинается guidance разреженной структуры.

по умолчанию 1

Используйте долю шумоподавления не меньше `ss_guidance_interval_start`, чтобы указать момент остановки guidance разреженной структуры.

по умолчанию 12

Количество шагов шумоподавления при генерации разреженной структуры.

по умолчанию 5

Резкость расписания шума при генерации разреженной структуры.

по умолчанию 7.5

Сила classifier-free guidance при генерации формы.

по умолчанию 0.5

Масштабирование guidance при генерации формы; увеличьте значение, если геометрия выглядит зашумлённой.

по умолчанию 0.6

Доля шумоподавления, при которой начинается guidance этапа формы.

по умолчанию 1

Точка остановки guidance этапа формы, заданная как доля шумоподавления не меньше shape_slat_guidance_interval_start.

по умолчанию 12

Количество шагов шумоподавления при генерации формы.

по умолчанию 3

Резкость расписания шума при генерации формы.

по умолчанию 1

Сила classifier-free guidance при генерации текстуры.

по умолчанию 0

Масштабирование guidance при генерации текстуры; увеличьте значение, если текстуры выглядят зашумлёнными.

по умолчанию 0.6

Доля шумоподавления, при которой начинается guidance этапа текстуры.

по умолчанию 0.9

Точка остановки guidance этапа текстуры, заданная как доля шумоподавления не меньше tex_slat_guidance_interval_start.

по умолчанию 12

Количество шагов шумоподавления при генерации текстуры.

по умолчанию 3

Резкость расписания шума при генерации текстуры.

по умолчанию 500000

Желаемое количество вершин в экспорте GLB.

Случайный seed, обеспечивающий воспроизводимость генерации.

POST /run/trellis-2-lora?wait=20 стоимость → 0,25 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О TRELLIS.2 LoRA Inference

Генерирует GLB из `image_url`, при необходимости применяя LoRA в формате safetensors через `sparse_structure_lora_url`, `geometry_lora_url` и `texture_lora_url`. `resolution` равен 512 или 1024 и должен соответствовать разрешению обучения адаптеров. Также доступны настройки guidance и шагов для каждого этапа, `decimation_target` и `texture_size`.

Параметры

Передавайте либо каноническое имя, либо исходное имя, но не оба. Канонические имена

ИмяТип По умолчаниюДопустимые значения Описание
image_urlобязательно image
Типurl · image
URL исходного изображения для преобразования в 3D-модель.
sparse_structure_lora_urlнеобязательно
Типstring | null
Необязательный checkpoint LoRA в формате safetensors, специально обученный для шумоподавителя разреженной структуры.
geometry_lora_urlнеобязательно
Типstring | null
Необязательный checkpoint LoRA в формате safetensors, специально обученный для шумоподавителя геометрии.
texture_lora_urlнеобязательно
Типstring | null
Необязательный checkpoint LoRA в формате safetensors, специально обученный для шумоподавителя текстур.
seedнеобязательно
Типinteger | null
Случайный seed, обеспечивающий воспроизводимость генерации.
resolutionнеобязательно
Типenum
По умолчанию512
5121024
Разрешение генерации: значение 1024 выбирает каскадный конвейер. Выберите разрешение, на котором обучались переданные адаптеры LoRA; совпадение обязательно.
ss_guidance_strengthнеобязательно
Типnumber
По умолчанию7.5
0 – 10
Сила classifier-free guidance при генерации разреженной структуры.
ss_guidance_rescaleнеобязательно
Типnumber
По умолчанию0.7
0 – 1
Масштабирование guidance при генерации разреженной структуры. Большие значения делают выход стабильнее.
ss_guidance_interval_startнеобязательно
Типnumber
По умолчанию0.6
0 – 1
Доля прогресса шумоподавления, при которой начинается guidance разреженной структуры.
ss_guidance_interval_endнеобязательно
Типnumber
По умолчанию1
0 – 1
Используйте долю шумоподавления не меньше `ss_guidance_interval_start`, чтобы указать момент остановки guidance разреженной структуры.
ss_sampling_stepsнеобязательно
Типinteger
По умолчанию12
1 – 50
Количество шагов шумоподавления при генерации разреженной структуры.
ss_rescale_tнеобязательно
Типnumber
По умолчанию5
1 – 6
Резкость расписания шума при генерации разреженной структуры.
shape_slat_guidance_strengthнеобязательно
Типnumber
По умолчанию7.5
0 – 10
Сила classifier-free guidance при генерации формы.
shape_slat_guidance_rescaleнеобязательно
Типnumber
По умолчанию0.5
0 – 1
Масштабирование guidance при генерации формы; увеличьте значение, если геометрия выглядит зашумлённой.
shape_slat_guidance_interval_startнеобязательно
Типnumber
По умолчанию0.6
0 – 1
Доля шумоподавления, при которой начинается guidance этапа формы.
shape_slat_guidance_interval_endнеобязательно
Типnumber
По умолчанию1
0 – 1
Точка остановки guidance этапа формы, заданная как доля шумоподавления не меньше shape_slat_guidance_interval_start.
shape_slat_sampling_stepsнеобязательно
Типinteger
По умолчанию12
1 – 50
Количество шагов шумоподавления при генерации формы.
shape_slat_rescale_tнеобязательно
Типnumber
По умолчанию3
1 – 6
Резкость расписания шума при генерации формы.
tex_slat_guidance_strengthнеобязательно
Типnumber
По умолчанию1
0 – 10
Сила classifier-free guidance при генерации текстуры.
tex_slat_guidance_rescaleнеобязательно
Типnumber
По умолчанию0
0 – 1
Масштабирование guidance при генерации текстуры; увеличьте значение, если текстуры выглядят зашумлёнными.
tex_slat_guidance_interval_startнеобязательно
Типnumber
По умолчанию0.6
0 – 1
Доля шумоподавления, при которой начинается guidance этапа текстуры.
tex_slat_guidance_interval_endнеобязательно
Типnumber
По умолчанию0.9
0 – 1
Точка остановки guidance этапа текстуры, заданная как доля шумоподавления не меньше tex_slat_guidance_interval_start.
tex_slat_sampling_stepsнеобязательно
Типinteger
По умолчанию12
1 – 50
Количество шагов шумоподавления при генерации текстуры.
tex_slat_rescale_tнеобязательно
Типnumber
По умолчанию3
1 – 6
Резкость расписания шума при генерации текстуры.
decimation_targetнеобязательно
Типinteger
По умолчанию500000
5 000 – 2 000 000
Желаемое количество вершин в экспорте GLB.
texture_sizeнеобязательно
Типenum
По умолчанию2048
102420484096
Разрешение текстур, запечённых в экспорт GLB.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Проверку можно ослабить, установив false, если вызывающая сторона авторизована.
обязательно Каноническое имя, также принимается

Параметры файлов принимают общедоступный https:// URL, data: URI размером до 10 MB или file_url загруженного файла. Файлы

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2-lora",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 250,
    "usd": "0.25",
    "charged": 250,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "seed": 42,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
model_glb
object {url, content_type, file_name, file_size}Файл GLB с созданной 3D-моделью.
seed
integerSeed, применённый при генерации.
resolution
integerРазрешение, при котором выполнялась генерация.
sparse_structure_lora_url
string | nullCheckpoint LoRA разреженной структуры, использованный при генерации, если он применялся.
geometry_lora_url
string | nullCheckpoint LoRA геометрии, использованный при генерации, если он применялся.
texture_lora_url
string | nullCheckpoint LoRA текстуры, использованный при генерации, если он применялся.
decimation_target
integerЦелевое количество вершин для экспорта GLB.
texture_size
integerРазрешение текстур, запечённых в экспорт GLB.

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/ru/developers/models/trellis-2-lora.md. Все модели и руководства: https://doitong.com/developers/llms.txt