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

Trellis 2 · Retexture

אינטעגרירן

מאָדעל־id trellis-2/retexture
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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.24⁩ 240 API־קרעדיטן · ≈ ⁨₽ 25.31⁩ לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Microsoft בילד צו 3D #image-to-3d

רעטעקסטורירט אַן עקזיסטירנדיקן אומטעקסטורירטן 3D־מעש לויט אַ רעפֿערענץ־בילד, מיט GLB ווי רעזולטאַט

Microsoft · 3D

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

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

בויען אַ בעטן

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

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

URL פֿון רעפֿערענץ־בילד גענוצט פֿאַר טעקסטוריזאַציע.

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

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

•פארלאנגט

קוואַל־URL פֿאַר רעטעקסטוריזאַציע פֿון אַן אומגעוועבט 3D־מעש אין GLB, OBJ, PLY אָדער STL־פֿאָרמאַט.

פֿאָרגעשריטן texture_size · 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 · seed
texture_size סטאַנדאַרט 2048

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

סטאַנדאַרט 1

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

סטאַנדאַרט 0

פֿאַרגרעסערט די באַשטעטיקונג צו באַהאַנדלען ראַשיקע טעקסטורן אָדער קאָליר־באַנדירונג: עס רעדוצירט אַרטעפֿאַקטן פֿון שטאַרקע גיידאַנס בעת דער טעקסטור־סטאַגע.

סטאַנדאַרט 0.6

אַקטיווירונג־פּונקט פֿון קלאַסיפיקאַטאָר־פֿרײַער אָנפֿירונג פֿאַר געוועב־גענערירונג. אויסגעדריקט ווי אַ בראָכצאָל פֿון דע־נויזינג־פֿאָרשריט, שטעלט עס interval_start; אָנפֿירונג אַרבעט נאָר אינעם פֿענצטער צווישן interval_start און interval_end.

סטאַנדאַרט 0.9

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

סטאַנדאַרט 12

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

סטאַנדאַרט 3

שטעלט די שאַרפֿקייט פֿון טעקסטור־דעטאַל דורך דעם ראַש־סקעדזשול פֿאַר טעקסטור־גענערירונג; דאָס פֿאַרגרעסערן גיט שאַרפֿערע דעטאַלן.

סיד גענוצט פֿאַר רעפּראָדוצירבאַרער טראַפֿישער גענערירונג.

POST /run/trellis-2/retexture?wait=20 פּרײַז → ⁨$ 0.24⁩
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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 · Retexture

ווענדט אַ נײַע טעקסטור אויף דעם מעש בײַ `mesh_url` (GLB, OBJ, PLY אָדער STL) לויט אַ רעפֿערענץ־`image_url`. `resolution` איז 512 אָדער 1024, און `texture_size` איז 1024, 2048 אָדער 4096. טעקסטור־סטאַגע־גיידאַנס און סאַמפּלינג־קאָנטראָלן זענען בנימצא. געאָמעטריע ווערט נישט ווידערגענערירט.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
URL פֿון רעפֿערענץ־בילד גענוצט פֿאַר טעקסטוריזאַציע.
mesh_urlפארלאנגט
טיפּstring
קוואַל־URL פֿאַר רעטעקסטוריזאַציע פֿון אַן אומגעוועבט 3D־מעש אין GLB, OBJ, PLY אָדער STL־פֿאָרמאַט.
seedאָפּציאָנעל
טיפּinteger | null
סיד גענוצט פֿאַר רעפּראָדוצירבאַרער טראַפֿישער גענערירונג.
resolutionאָפּציאָנעל
טיפּenum
סטאַנדאַרט1024
5121024
געוועב־דעטאַל און פּראַסעסינג־גיכקייט ווענדן זיך אין דער אינערלעכער גענערירונג־רעזאָלוציע: איר פֿאַרגרעסערונג גיט פֿײַנערע דעטאַלן אָבער נעמט מער צײַט.
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
אַקטיווירונג־פּונקט פֿון קלאַסיפיקאַטאָר־פֿרײַער אָנפֿירונג פֿאַר געוועב־גענערירונג. אויסגעדריקט ווי אַ בראָכצאָל פֿון דע־נויזינג־פֿאָרשריט, שטעלט עס interval_start; אָנפֿירונג אַרבעט נאָר אינעם פֿענצטער צווישן interval_start און interval_end.
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
שטעלט די שאַרפֿקייט פֿון טעקסטור־דעטאַל דורך דעם ראַש־סקעדזשול פֿאַר טעקסטור־גענערירונג; דאָס פֿאַרגרעסערן גיט שאַרפֿערע דעטאַלן.
texture_sizeאָפּציאָנעל
טיפּenum
סטאַנדאַרט2048
102420484096
מעש־טעקסטור־רעזאָלוציע פֿאַר באַקינג. פֿײַנערע אויבערפֿלאַך־דעטאַלן ברענגען גרעסערע פֿײַלן ווען די רעזאָלוציע ווערט פֿאַרגרעסערט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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־חודש) אָדער 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/yi/developers/models/trellis-2/retexture.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt