Trellis 2

Интеграция

ID модели trellis-2

# 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?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"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/ru/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "trellis-2",
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }
}

Вызовите модель Trellis 2 (trellis-2) через Doitong API. Документация для агентов: https://doitong.com/ru/developers/models/trellis-2.md

POST https://api.doitong.com/v1/run/trellis-2?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}

Если статус ответа — "queued" или "running", выполняйте опрос GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20, пока он не станет "succeeded"; файлы находятся в outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 с тем же телом возвращает точную цену до запуска.

Этот запрос: 0,30 $ 300 API-кредитов · ≈ 31,64 ₽ Запустить на этой странице

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

Microsoft Изображение в 3D #image-to-3d

Превращает одно изображение в текстурированную 3D-сетку GLB с настройками структуры, формы, текстуры и UV

OpenAPI Markdown

Microsoft · 3D

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

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

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

Цена

Точная стоимость

0,30 $за запуск

300 API-кредитов · ≈ 31,64 ₽

Цена: от 0,25 $

1 запрос × 0,30 $ Запустить · 0,30 $

Списание выполняется только при успехе; при ошибке средства автоматически возвращаются.

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

Правила расчёта стоимости

Если resolution = 1024: 0,30 $ / запрос
Если resolution = 1536: 0,35 $ / запрос

Оплата один раз за запрос.

Эндпоинт расчёта стоимости: POST /quote/{id}

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

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

image •обязательно image_url

Перетащите файл или

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

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

Разрешение выходных данных; его увеличение добавляет детали, но занимает больше времени.

Расширенные texture_size · 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 · remesh_band · remesh_project · uv_unwrap_angle_threshold_deg · uv_unwrap_refine_iterations · uv_unwrap_global_iterations · uv_unwrap_smooth_strength · seed · remesh

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

Разрешение текстуры сетки для запекания. При увеличении разрешения повышается детализация поверхности, но увеличивается размер файлов.

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

Управление точностью исходной 3D-структуры: увеличение повышает соответствие входному изображению, но может добавить шум.

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

Управление артефактами на этапе 1: низкие значения усиливают эффекты управления, а высокие обеспечивают более стабильные выходные данные.

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

Начальная граница окна classifier-free guidance на этапе 1 (разреженная структура), заданная как доля шумоподавления. Меньшие значения включают guidance раньше; только интервал от interval_start до interval_end использует guidance, остальная обработка выполняется без него.

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

Ограничение guidance для этапа 1 (разреженная структура): выберите значение не меньше ss_guidance_interval_start. Оно задаёт долю шумоподавления, при достижении которой classifier-free guidance прекращается.

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

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

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

Задаёт резкость переходов через расписание шума генерации структуры: увеличение значения делает переходы резче.

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

Управление точностью детальной геометрии: большее соответствие входному изображению добавляет детали, но может привести к дополнительному шуму.

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

Увеличьте это значение, если геометрия выглядит зашумлённой: оно уменьшает артефакты, вызванные сильным управлением на этапе формы.

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

Точка включения classifier-free guidance для уточнения формы на этапе 2. Задаётся как доля прогресса шумоподавления и устанавливает interval_start; guidance работает только в окне между interval_start и interval_end.

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

Ограничение guidance для этапа 2 (уточнение формы): выберите значение не меньше shape_slat_guidance_interval_start. Оно задаёт долю шумоподавления, при достижении которой classifier-free guidance прекращается.

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

Количество шагов удаления шума для уточнения формы: дополнительные шаги могут сделать геометрию более гладкой, но снижают скорость.

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

Задаёт резкость геометрических деталей через расписание шума уточнения формы; увеличение значения делает детали резче.

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

Управление точностью цвета текстуры: большее соответствие цветам входного изображения при высоких значениях повышает насыщенность, но может вызвать перенасыщение.

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

Увеличьте это значение для устранения зашумлённых текстур или цветовых полос: оно уменьшает артефакты, вызванные сильным управлением на этапе текстуры.

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

Точка включения classifier-free guidance для генерации текстуры на этапе 3. Задаётся как доля прогресса шумоподавления и устанавливает interval_start; guidance работает только в окне между interval_start и interval_end.

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

Ограничение guidance для этапа 3 (текстура): выберите значение не меньше tex_slat_guidance_interval_start. Оно задаёт долю шумоподавления, при достижении которой classifier-free guidance прекращается.

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

Количество шагов удаления шума для создания текстур. Увеличение количества шагов занимает больше времени, но может дать более чистые текстуры.

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

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

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

Целевое количество вершин сетки: для общего использования рекомендуется 500k, для веба и мобильных устройств — 20k–50k. Уменьшение цели снижает детализацию сетки и уменьшает размер файлов.

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

Допуск перемещения при перестроении сетки: увеличение значения усиливает сглаживание и может жертвовать мелкими деталями. Параметр ограничивает смещение вершин относительно исходной поверхности.

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

Сила проекции возвращения вершин перестроенной сетки на исходную поверхность: 1 сохраняет детали полной проекцией, а 0 отключает проекцию, обеспечивая более гладкий результат.

uv_unwrap_angle_threshold_deg по умолчанию 90

Предельный угол UV-карты в градусах, ограничивающий различие нормалей соседних граней в одной карте. Увеличение значения даёт меньше крупных карт, но повышает риск растяжения; уменьшение — больше карт и меньше искажений.

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

Количество локальных проходов уточнения для вычисления UV-карт.

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

Баланс UV-карт можно улучшить, увеличив количество глобальных проходов кластеризации для их вычисления.

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

Настройка силы сглаживания границ UV-карт; при больших значениях швы менее заметны, но возрастает риск искажения UV.

seed

Сид для воспроизводимой случайной генерации.

POST /run/trellis-2?wait=20 стоимость → 0,30 $

# 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?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"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "trellis-2",
      "input": {
        "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "wait_seconds": 20
    }
  }
}

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

API-ключ

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

О Trellis 2

Создаёт 3D-объект из одного изображения (`image_url`) и возвращает файл GLB. `resolution` принимает значение 512, 1024 или 1536, а `texture_size` — 1024, 2048 или 4096. Для каждого из трёх этапов (структура, форма, текстура) доступны собственные настройки guidance и шагов сэмплирования. `decimation_target` задаёт количество вершин сетки (от 5,000 до 2,000,000), а также доступны ремешинг и развёртка UV.

Параметры

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

ИмяТип По умолчаниюДопустимые значения Описание

seedнеобязательно

Типinteger | null

Сид для воспроизводимой случайной генерации.

resolutionнеобязательно

Типenum

По умолчанию1024

51210241536

Разрешение выходных данных; его увеличение добавляет детали, но занимает больше времени.

ss_guidance_strengthнеобязательно

Типnumber

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

0 – 10

ss_guidance_rescaleнеобязательно

Типnumber

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

0 – 1

ss_guidance_interval_startнеобязательно

Типnumber

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

0 – 1

ss_guidance_interval_endнеобязательно

Типnumber

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

0 – 1

ss_sampling_stepsнеобязательно

Типinteger

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

1 – 50

ss_rescale_tнеобязательно

Типnumber

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

1 – 6

shape_slat_guidance_strengthнеобязательно

Типnumber

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

0 – 10

shape_slat_guidance_rescaleнеобязательно

Типnumber

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

0 – 1

shape_slat_guidance_interval_startнеобязательно

Типnumber

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

0 – 1

shape_slat_guidance_interval_endнеобязательно

Типnumber

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

0 – 1

shape_slat_sampling_stepsнеобязательно

Типinteger

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

1 – 50

shape_slat_rescale_tнеобязательно

Типnumber

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

1 – 6

tex_slat_guidance_strengthнеобязательно

Типnumber

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

0 – 10

tex_slat_guidance_rescaleнеобязательно

Типnumber

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

0 – 1

tex_slat_guidance_interval_startнеобязательно

Типnumber

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

0 – 1

tex_slat_guidance_interval_endнеобязательно

Типnumber

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

0 – 1

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

texture_sizeнеобязательно

Типenum

По умолчанию2048

102420484096

remeshнеобязательно

Типboolean

По умолчаниюtrue

Перестроение топологии, создающее более чистые треугольники сетки и обычно улучшающее пригодность для последующего использования, например анимации или 3D-печати, за счёт более медленной обработки.

remesh_bandнеобязательно

Типnumber

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

0 – 4

remesh_projectнеобязательно

Типnumber

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

0 – 1

uv_unwrap_angle_threshold_degнеобязательно

Типnumber

По умолчанию90

0 – 180

uv_unwrap_refine_iterationsнеобязательно

Типinteger

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

0 – 10

Количество локальных проходов уточнения для вычисления UV-карт.

uv_unwrap_global_iterationsнеобязательно

Типinteger

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

1 – 10

Баланс UV-карт можно улучшить, увеличив количество глобальных проходов кластеризации для их вычисления.

uv_unwrap_smooth_strengthнеобязательно

Типnumber

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

0 – 10

image_urlобязательно image

Типurl · image

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

обязательно Каноническое имя, также принимается

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

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    }
  },
  "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}3D-модель, сгенерированная в формате GLB.

Другие модели: Изображение в 3D

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

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

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

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

О Trellis 2

Параметры

Результат

Другие варианты Trellis 2

Trellis 2 · Retexture Варианты: 2

Другие модели: Изображение в 3D

Trellis Варианты: 2

Trellis · Multi Варианты: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Варианты: 6