שפּרינגען צו אינהאַלט

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

דער דאָזיקער ריקוועסט: ⁨$ 0.25⁩ 250 API־קרעדיטן · ≈ ⁨₽ 26.64⁩ לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Microsoft בילד צו 3D

Trellis 2 בילד־צו־3D וואָס קען צולייגן אייגענע LoRA־אַדאַפּטערס פֿאַר סטרוקטור, געאָמעטריע און טעקסטור

Microsoft · 3D

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

•פארלאנגט image_url
לייגט אַרײַן אַ טעקע, אָדער

URL פֿון דעם מקור־בילד פֿאַר פֿאַרוואַנדלונג אין אַ 3D־מאָדעל.

resolution סטאַנדאַרט 512

גענערירונג־רעזאָלוציע, וווּ 1024 אויסקלײַבט דעם cascade־פּייפּליין. קלײַב די רעזאָלוציע מיט וועלכער די צוגעשטעלטע 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

אָפּציאָנאַלער LoRA־טשעקפּוינט אין safetensors־פֿאָרמאַט, ספּעציפֿיש אויסגעלערנט פֿאַרן געוועב־דע־נויזער.

texture_size סטאַנדאַרט 2048

רעזאָלוציע פֿון די געוועבן אַרײַנגעבאַקט אין דער GLB־עקספּאָרט.

אָפּציאָנאַלער LoRA־טשעקפּוינט אין safetensors־פֿאָרמאַט, ספּעציפֿיש אויסגעלערנט פֿאַרן דע־נויזער פֿון דער שפּאַרלעכער סטרוקטור.

אָפּציאָנאַלער LoRA־טשעקפּוינט אין safetensors־פֿאָרמאַט, ספּעציפֿיש אויסגעלערנט פֿאַרן געאָמעטריע־דע־נויזער.

סטאַנדאַרט 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־עקספּאָרט.

צופֿעליקער סיד וואָס מאכט די גענערירונג רעפּראָדוצירבאַר.

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן TRELLIS.2 LoRA Inference

שאַפֿט אַ GLB פֿון `image_url`, אָפּציאָנעל מיט safetensors LoRAs דורך `sparse_structure_lora_url`, `geometry_lora_url` און `texture_lora_url`. `resolution` איז 512 אָדער 1024 און מוזן שטימען מיט דער טרעניר־רעזאָלוציע פֿון די אַדאַפּטערס. עס גיט אויך פּער־סטאַגע קאָנטראָלן פֿאַר גיידאַנס און שריט, `decimation_target` און `texture_size`.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
URL פֿון דעם מקור־בילד פֿאַר פֿאַרוואַנדלונג אין אַ 3D־מאָדעל.
sparse_structure_lora_urlאָפּציאָנעל
טיפּstring | null
אָפּציאָנאַלער LoRA־טשעקפּוינט אין safetensors־פֿאָרמאַט, ספּעציפֿיש אויסגעלערנט פֿאַרן דע־נויזער פֿון דער שפּאַרלעכער סטרוקטור.
geometry_lora_urlאָפּציאָנעל
טיפּstring | null
אָפּציאָנאַלער LoRA־טשעקפּוינט אין safetensors־פֿאָרמאַט, ספּעציפֿיש אויסגעלערנט פֿאַרן געאָמעטריע־דע־נויזער.
texture_lora_urlאָפּציאָנעל
טיפּstring | null
אָפּציאָנאַלער LoRA־טשעקפּוינט אין safetensors־פֿאָרמאַט, ספּעציפֿיש אויסגעלערנט פֿאַרן געוועב־דע־נויזער.
seedאָפּציאָנעל
טיפּinteger | null
צופֿעליקער סיד וואָס מאכט די גענערירונג רעפּראָדוצירבאַר.
resolutionאָפּציאָנעל
טיפּenum
סטאַנדאַרט512
5121024
גענערירונג־רעזאָלוציע, וווּ 1024 אויסקלײַבט דעם cascade־פּייפּליין. קלײַב די רעזאָלוציע מיט וועלכער די צוגעשטעלטע 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, אַ 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
model_glb
object {url, content_type, file_name, file_size}GLB־פֿײַל מיטן גענערירטן 3D־מאָדעל.
seed
integerסיד געווענדט בעת גענערירונג.
resolution
integerרעזאָלוציע מיט וועלכער די גענערירונג איז דורכגעפֿירט געוואָרן.
sparse_structure_lora_url
string | nullLoRA־טשעקפּוינט פֿון דער שפּאַרלעכער סטרוקטור, גענוצט בעת גענערירונג, אויב איינער איז געווענדט געוואָרן.
geometry_lora_url
string | nullגעאָמעטריע־LoRA־טשעקפּוינט, גענוצט בעת גענערירונג, אויב איינער איז געווענדט געוואָרן.
texture_lora_url
string | nullגעוועב־LoRA־טשעקפּוינט, גענוצט בעת גענערירונג, אויב איינער איז געווענדט געוואָרן.
decimation_target
integerווערטעקס־צאָל־ציל געווענדט צו דער GLB־עקספּאָרט.
texture_size
integerרעזאָלוציע פֿון די געוועבן אַרײַנגעבאַקט אין דער GLB־עקספּאָרט.

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/trellis-2-lora.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt