Мазмұнға өту

Trellis 2 · Retexture

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

Модель идентификаторы 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрау: 0,24 $ 240 API кредиті Осы бетте іске қосу

API кілтін алу
Microsoft Кескіннен 3D-ге #image-to-3d

Бар текстурасыз 3D торға референс кескінге сәйкес жаңа текстура қолданады, GLB шығарады

Microsoft · 3D

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

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

Сұрау жасау

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

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

Текстуралау үшін қолданылатын үлгі кескіннің URL мекенжайы.

resolution әдепкі 1024

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

•міндетті

Қайта текстуралауға арналған, GLB, OBJ, PLY немесе STL пішіміндегі текстурасыз бастапқы 3D тордың URL мекенжайы.

Қосымша 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

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

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

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

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Trellis 2 · Retexture туралы

Референс `image_url` негізінде `mesh_url` мекенжайындағы торға (GLB, OBJ, PLY немесе STL) жаңа текстура қолданады. `resolution` 512 немесе 1024, ал `texture_size` 1024, 2048 немесе 4096 мәндерінің бірі. Текстура кезеңіне арналған бағыттау және сэмплинг басқарулары қолжетімді. Геометрия қайта генерацияланбайды.

Параметрлер

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

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
Текстуралау үшін қолданылатын үлгі кескіннің URL мекенжайы.
mesh_urlміндетті
Түріstring
Қайта текстуралауға арналған, GLB, OBJ, PLY немесе STL пішіміндегі текстурасыз бастапқы 3D тордың URL мекенжайы.
seedміндетті емес
Түріinteger | null
Қайталанымды кездейсоқ генерация үшін қолданылатын seed.
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 мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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.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}GLB пішімінде жасалған 3D модель.

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

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