Мазмұнға өту

TRELLIS.2 LoRA Inference

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

Модель идентификаторы 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 кредиті Осы бетте іске қосу

API кілтін алу

Құрылымға, геометрияға және текстураға арналған теңшелетін LoRA адаптерлерін қолдана алатын Trellis 2 image-to-3D

Microsoft · 3D

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

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

3D модельге түрлендірілетін бастапқы кескіннің URL мекенжайы.

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

Текстураның шуын жою құралы үшін арнайы оқытылған, safetensors пішіміндегі міндетті емес LoRA бақылау нүктесі.

texture_size әдепкі 2048

GLB экспортына бекітілетін текстуралардың ажыратымдылығы.

Сирек құрылымның шуын жою құралы үшін арнайы оқытылған, safetensors пішіміндегі міндетті емес LoRA бақылау нүктесі.

Геометрияның шуын жою құралы үшін арнайы оқытылған, safetensors пішіміндегі міндетті емес LoRA бақылау нүктесі.

әдепкі 7.5

Сирек құрылым генерациясы кезіндегі жіктеуішсіз бағыттау күші.

әдепкі 0.7

Сирек құрылым генерациясы кезіндегі бағыттауды қайта масштабтау. Үлкен мәндер шығысты тұрақтырақ етеді.

әдепкі 0.6

Сирек құрылымды бағыттау басталатын шуды жою барысының үлесі.

әдепкі 1

Сирек құрылымды бағыттаудың тоқтау сәтін көрсету үшін `ss_guidance_interval_start` мәнінен кем емес шуды жою үлесін пайдаланыңыз.

әдепкі 12

Сирек құрылым генерациясы кезіндегі шуды жою қадамдарының саны.

әдепкі 5

Сирек құрылым генерациясы кезіндегі шу кестесінің күрттігі.

әдепкі 7.5

Пішін генерациясы кезіндегі жіктеуішсіз бағыттау күші.

әдепкі 0.5

Пішін генерациясы кезінде бағыттауға қолданылатын қайта масштабтау; геометрияда шу байқалса, мәнді арттырыңыз.

әдепкі 0.6

Пішін кезеңіндегі бағыттау басталатын шуды жою үлесі.

әдепкі 1

Пішін кезеңіндегі бағыттаудың тоқтау нүктесі; shape_slat_guidance_interval_start мәнінен кем емес шуды жою үлесі ретінде беріледі.

әдепкі 12

Пішін генерациясы кезіндегі шуды жою қадамдарының саны.

әдепкі 3

Пішін генерациясы кезіндегі шу кестесінің күрттігі.

әдепкі 1

Текстура генерациясы кезіндегі жіктеуішсіз бағыттау күші.

әдепкі 0

Текстура генерациясы кезінде бағыттауға қолданылатын қайта масштабтау; текстураларда шу байқалса, мәнді арттырыңыз.

әдепкі 0.6

Текстура кезеңіндегі бағыттау басталатын шуды жою үлесі.

әдепкі 0.9

Текстура кезеңіндегі бағыттаудың тоқтау нүктесі; 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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

TRELLIS.2 LoRA Inference туралы

`image_url` арқылы GLB жасайды, қажет болса safetensors LoRA-ларын `sparse_structure_lora_url`, `geometry_lora_url` және `texture_lora_url` көмегімен қолданады. `resolution` 512 немесе 1024 мәніне тең болуы және адаптерлердің оқыту ажыратымдылығына сәйкес келуі керек. Әр кезеңге арналған бағыттау және қадам басқарулары, `decimation_target` және `texture_size` де қолжетімді.

Параметрлер

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

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
3D модельге түрлендірілетін бастапқы кескіннің URL мекенжайы.
sparse_structure_lora_urlміндетті емес
Түріstring | null
Сирек құрылымның шуын жою құралы үшін арнайы оқытылған, safetensors пішіміндегі міндетті емес LoRA бақылау нүктесі.
geometry_lora_urlміндетті емес
Түріstring | null
Геометрияның шуын жою құралы үшін арнайы оқытылған, safetensors пішіміндегі міндетті емес LoRA бақылау нүктесі.
texture_lora_urlміндетті емес
Түріstring | null
Текстураның шуын жою құралы үшін арнайы оқытылған, safetensors пішіміндегі міндетті емес LoRA бақылау нүктесі.
seedміндетті емес
Түріinteger | null
Генерацияны қайталауға мүмкіндік беретін кездейсоқ seed.
resolutionміндетті емес
Түріenum
Әдепкі512
5121024
Генерация ажыратымдылығы; 1024 каскадты өңдеу тізбегін таңдайды. Берілген LoRA адаптерлері оқытылған ажыратымдылықты таңдаңыз; олардың сәйкес келуі міндетті.
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_guidance_interval_start` мәнінен кем емес шуды жою үлесін пайдаланыңыз.
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_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
Текстура генерациясы кезіндегі жіктеуішсіз бағыттау күші.
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_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 мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
model_glb
object {url, content_type, file_name, file_size}Генерацияланған 3D моделі бар GLB файлы.
seed
integerГенерация кезінде қолданылатын seed.
resolution
integerГенерация орындалған ажыратымдылық.
sparse_structure_lora_url
string | nullГенерация кезінде қолданылған сирек құрылымға арналған LoRA бақылау нүктесі, егер қолданылса.
geometry_lora_url
string | nullГенерация кезінде қолданылған геометрияға арналған LoRA бақылау нүктесі, егер қолданылса.
texture_lora_url
string | nullГенерация кезінде қолданылған текстураға арналған LoRA бақылау нүктесі, егер қолданылса.
decimation_target
integerGLB экспортына қолданылған төбелер санының мақсатты мәні.
texture_size
integerGLB экспортына бекітілетін текстуралардың ажыратымдылығы.

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/trellis-2-lora.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt