Trellis 2

Интеграциялау

Модель идентификаторы trellis-2

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/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.ru/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/kk/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/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/kk/developers/models/trellis-2.md

POST https://api.doitong.ru/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" болса, ол "succeeded" болғанша GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 арқылы күйін тексеріңіз; файлдар outputs[].url ішінде болады. Дәл іске қосу бағасын алдын ала алу үшін POST https://api.doitong.ru/v1/quote/trellis-2 сұрауын сол денемен жіберіңіз.

Осы сұрау: 0,30 $ 300 API кредиті · ≈ 31,64 ₽ Осы бетте іске қосу

API кілтін алу

Microsoft Кескіннен 3D-ге #image-to-3d

Бір кескінді құрылымы, пішіні, текстурасы және UV параметрлері реттелетін текстураланған GLB 3D торға айналдырады

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

Файлды тастаңыз немесе

3D түрлендіруге арналған бастапқы кескінге сілтейтін URL.

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

1-кезеңдегі (сирек құрылым) классификаторсыз бағыттау аралығының бастапқы шегі, шуды азайту үлесімен берілген. Төмен мәндер бағыттауды ертерек бастайды; бағыттау тек interval_start пен interval_end аралығында қолданылады, қалған уақытта өңдеу бағыттаусыз жүреді.

ss_guidance_interval_end әдепкі 1

1-кезеңдегі (сирек құрылым) бағыттауды тоқтату шегі: ss_guidance_interval_start мәнінен кем емес мән таңдаңыз. Мән классификаторсыз бағыттау тоқтаған сәтте шуды азайтудың қандай үлесіне жеткенін көрсетеді.

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

2-кезеңде пішінді нақтылау үшін классификаторсыз бағыттауды іске қосу нүктесі. Шуды азайту барысының үлесімен беріліп, interval_start мәнін орнатады; бағыттау тек interval_start және interval_end шектейтін аралықта жұмыс істейді.

shape_slat_guidance_interval_end әдепкі 1

2-кезеңдегі (пішінді нақтылау) бағыттауды тоқтату шегі: shape_slat_guidance_interval_start мәнінен кем емес мән таңдаңыз. Мән классификаторсыз бағыттау тоқтаған сәтте шуды азайтудың қандай үлесіне жеткенін көрсетеді.

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

3-кезеңде текстура генерациясы үшін классификаторсыз бағыттауды іске қосу нүктесі. Шуды азайту барысының үлесімен беріліп, interval_start мәнін орнатады; бағыттау тек interval_start және interval_end шектейтін аралықта жұмыс істейді.

tex_slat_guidance_interval_end әдепкі 0.9

3-кезеңдегі (текстура) бағыттауды тоқтату шегі: tex_slat_guidance_interval_start мәнінен кем емес мән таңдаңыз. Мән классификаторсыз бағыттау тоқтаған сәтте шуды азайтудың қандай үлесіне жеткенін көрсетеді.

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

Қайталанымды кездейсоқ генерация үшін қолданылатын 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/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.ru/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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. Осы браузерде есте сақтау API кілтін алу

Trellis 2 туралы

Бір кескіннен (`image_url`) 3D нысан жасап, GLB файлін қайтарады. `resolution` — 512, 1024 немесе 1536, ал `texture_size` — 1024, 2048 немесе 4096. Үш кезеңнің (құрылым, пішін, текстура) әрқайсысында жеке бағыттау және сэмплинг қадамдарын басқару элементтері бар. `decimation_target` тор төбелерінің санын белгілейді (5,000–2,000,000), сондай-ақ қайта торлау және UV ашу параметрлері қолжетімді.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама

seedміндетті емес

Түріinteger | null

Қайталанымды кездейсоқ генерация үшін қолданылатын seed.

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_unwrap_smooth_strengthміндетті емес

Түріnumber

Әдепкі1

0 – 10

image_urlміндетті image

Түріurl · image

3D түрлендіруге арналған бастапқы кескінге сілтейтін URL.

міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.

Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.

Шығыс өрістері

model_glb: object {url, content_type, file_name, file_size}GLB пішімінде жасалған 3D модель.

Қосымша модельдер: Кескіннен 3D-ге

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/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