Hunyuan3D 2.0 API

Hunyuan3D 2.0 – Tencent компаниясының кеңейтілген кең ауқымды 3D генеративті AI жүйесі. Диффузияға негізделген архитектураларды қолдана отырып, ол мәтіндік сипаттамаларды немесе кескіндерді екі сатылы конвейер арқылы егжей-тегжейлі 3D активтеріне - жоғары сапалы текстуралармен байытылған торларға айналдырады. пішінді генерациялау және текстураның синтезі.

Негізгі мүмкіндіктер (ол не істейді)

• Екі кезеңді ұрпақ: ажыратады геометрия (жалаңаш тор) бастап текстураның синтезі (УК карталары / PBR текстуралары), бақылау мен сапаны жақсарту.
• Кескінді шартты және мәтіндік шартты режимдер: қабылдайды бір немесе көп көріністі суреттер Және / немесе мәтіндік шақырулар пішін мен текстураны бағыттау.
• Жоғары ажыратымдылықтағы текстуралар: үлкен текстуралық шығыстарды (2K–6K+ жұмыс үрдістері үшін конфигурациялар) және SR/жақсарту қадамдарын қолдайды. Түйінді сөздер: текстураның ажыратымдылығы, супер ажыратымдылық, пісіру.

---

Техникалық Толығырақ

• Пішін генераторы (Hunyuan3D-DiT): геометрияны (нұсқаға байланысты сегіздік/сегіздік немесе торлы көріністер) жасауға үйретілген диффузиялық-трансформатор стилінің модулі, геометрияны кондициялау кескінімен немесе мәтіндік шақырумен туралау үшін оңтайландырылған.
• Текстура синтезаторы (Hunyuan3D-Paint / PBR синтезаторы): УК-карталанған текстуралық атластарды жасайтын екінші модель физикалық негізделген көрсету шығарылымдар (альбедо, кедір-бұдырлық, металл карталар), сондықтан жасалған активтер рендерерлер мен ойын қозғалтқыштарында бірден пайдалануға болады.
• Декодтау және ажыратымдылық: кейінгі нұсқалар геометриялық ажыратымдылықты (мысалы, жоғары сегіздік/торлы ажыратымдылық) және текстура өлшемдерін (жалпы қауымдастық параметрлері экспорттау үшін бірнеше мың текстураға дейін шығарады) арттырады.
• Масштабтау және үлгі өлшемдері: v2.5 есебі геометрия дәлдігі мен текстураның дәлдігін жақсарту үшін 2.0-ден 2.5-ке дейін айтарлықтай үлкейтуді (параметрлер санау және деректер жиынының шкаласы) көрсетеді.
• Hunyuan3D-2.5 жаңартулары: ТОР (10B параметрлері максимум) айқынырақ, таза геометрия үшін; PBR текстуралық құбыры жақсартылған көп көрініс консистенциясы; 4K класындағы текстуралар қауымдастық жазбаларында көрсетілген.

Есептеу және VRAM: анықтамалық репо жазбалары ~6 ГБ VRAM пішінді қалыптастыру үшін және ~ 16 ГБ толық пішін+текстуралық қорытынды үшін (әдеттегі жұмыс үстелі GPU).

Стандартты өнімділік (v2.0 және басқалармен салыстырғанда)

Нәтижелер геометриялық егжей-тегжейлер мен текстуралық реализмдегі айтарлықтай артықшылықты растайды.

Cases пайдалану

• Енгізу режимдері: Мәтінді 3D-ге, Кескінді-3D-ге, Көп көріністі енгізу (қосымша нұсқаларда).
• Шығару: Ажыратымдылығы жоғары тор + жоғары сапалы текстуралар (кейінгі нұсқаларда PBR).

Ойын прототипін жасау және активтер құбырлары: жылдам концепция → текстуралы торды айналдыру; реквизиттер/кейіпкерлер үшін суретшінің қайталану уақытын қысқартады. Түйінді сөздер: прототиптеу, ойын активтері.

AR/VR / виртуалды өндіріс: PBR текстуралары + қозғалтқышпен үйлесімді экспорт интерактивті көріністерге және алдын ала визуализацияға жылдам интеграциялауға мүмкіндік береді. Түйінді сөздер: AR/VR, PBR, қозғалтқышқа дайын.

Архитектура және өнімді визуализациялау: эскиздерден немесе көңіл-күй кескіндерінен стильдендірілген немесе шынайы 3D прототиптері. Түйінді сөздер: визуализация, жылдам қайталау.

Білім беру/шығармашылық құрал: 3D тұжырымдамаларын үйретудің және жасаушыларға нақтылау үшін негізгі торларды жасауға мүмкіндік берудің қол жетімді әдісі. Түйінді сөздер: т?рбиелеу, шы?армашылы? (Қауымдастық мысалдары мен оқулықтар.)

---

Шектеулер мен қиындықтар

• Тор тығыздығы: Жоғары үшбұрыштар саны (~600к дейін) өндірістік құбырлар үшін ретопологияны қажет етеді.
• Текстура мәліметтері: Кіріс ажыратымдылығы төмен болғанда, ұсақ бөлшектер (мысалы, маталар) бұлыңғыр болуы мүмкін.
• Аймақтық шектеулер: ЕО/GDPR пайдалануды шектеуге қатысты; сәйкес нұсқалар жасалуда.
• Тігістер мен жарықтандырудың сәйкессіздігі: текстуралық пісіру жасай алады тігістер немесе жарықтандыру артефактілері, әсіресе бір кескінді енгізулермен; көп көріністі енгізулер және SR/inpainting азайтады, бірақ бұл мәселелерді жоймайды.
• Шұғыл/кондициялау сезімталдығы:** басқа генеративті модельдер сияқты, жедел фразалық және енгізу жақтауы нәтижелерге айтарлықтай әсер етеді; шеткі жағдайлар мен жұқа геометриялық шектеулер қайталанатын нақтылауды қажет етуі мүмкін.

Қалай қоңырау шалуға болады Hunyuan3D CometAPI ұсынған API

Hunyuan3D-2 CometAPI ішіндегі API бағасы, ресми бағадан 20% жеңілдік:

Қажетті қадамдар

• Жүйеге кіріңіз cometapi.com. Егер сіз әлі біздің пайдаланушы болмасаңыз, алдымен тіркеліңіз
• Интерфейстің кіру тіркелгі деректерінің API кілтін алыңыз. Жеке орталықтағы API токеніндегі «Токенді қосу» түймесін басыңыз, таңбалауыш кілтін алыңыз: sk-xxxxx және жіберіңіз.
• Осы сайттың URL мекенжайын алыңыз: https://api.cometapi.com/

Пайдалану әдісі

1. “Hunyuan3D-2” API сұрауын жіберуге және сұраудың негізгі бөлігін орнатуға арналған соңғы нүкте. Сұрау әдісі мен сұрау мәтіні біздің веб-сайт API құжатынан алынған. Біздің веб-сайт сізге ыңғайлы болу үшін Apifox сынағын да ұсынады.
2. Ауыстыру тіркелгіңізден нақты CometAPI кілтімен.
3. Мазмұн өрісіне сұрағыңызды немесе сұрауыңызды енгізіңіз — үлгі осыған жауап береді.
4. . Жасалған жауапты алу үшін API жауабын өңдеңіз.

CometAPI үздіксіз тасымалдау үшін толық үйлесімді REST API қамтамасыз етеді. Негізгі мәліметтер  API құжаты:

• Соңғы нүкте: https://api.cometapi.com/v1/images/generations
• Үлгі параметрі: Hunyuan3D-2
• Түпнұсқалық растама: Bearer YOUR_CometAPI_API_KEY
• Мазмұн түрі: application/json .

curl --location 
--request POST 'https://api.cometapi.com/v1/images/generations' \ 
--header 'Authorization: Bearer {{api-key}}' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{ "model": "Hunyuan3D-2", "prompt": "A cute baby sea otter", "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png" }'