Мазмұнға өту

Meshy V7 Text to 3D

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

Модель идентификаторы meshy/v7/text-to-3d
# 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/meshy/v7/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

Мысалдағыдай файлдар: 1,20 $ 1 200 API кредиті · ≈ 129,10 ₽ файлдарыңыз іске қосу алдында өлшенеді Осы бетте іске қосу

API кілтін алу
Meshy Мәтіннен 3D-ге #stylized#transform

Meshy 7 арқылы мәтіннен 3D: preview немесе full режимі, 2k геометрия, PBR, ригтеу және анимация опциялары

Meshy · 3D

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

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

Сұрау жасау

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

•міндетті 88 / 600

3D модель ретінде ұсынылатын нысанның сипаттамасы, 600 таңбамен шектелген.

mode әдепкі full

Генерация режимі: 'preview' текстурасыз геометрияны, ал 'full' preview және refine нәтижелерін біріктіріп, текстураланған модельді шығарады.

geometry_resolution

Mesh геометриясының ажыратымдылығы; қолдау көрсетілетін Meshy-7 мәндері — standard және 2k.

Қосымша texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_safety_checker · ultra_mode
0 / 600

'full' режимінде қосымша мәтіндік нұсқаумен текстуралауды бағыттайды; басқа режимдер оны қолданбайды.

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

Тек 'full' режимінде қолданылатын текстура генерациясының 2D анықтамалық кескіні.

model_type әдепкі standard

3D mesh режимі: таза полигондарға оңтайландырылған low-poly нәтиже үшін 'lowpoly' таңдаңыз; бұл режимде Meshy topology, target_polycount және should_remesh параметрлерін елемейді. Қалыпты жоғары детализацияланған нәтиже үшін 'standard', ал геометрияның (preview) қадамында Meshy-T2 қолданып, басынан бастап бөлек жасалған таза бөліктерді алу үшін 'smart-topology' таңдаңыз.

topology әдепкі triangle

Геометриялық детализацияға арналған Triangle және бет тегістігіне арналған Quad арасындағы модель топологиясын таңдау.

symmetry_mode әдепкі auto

Модель генерациясы кезінде қолданылатын симметрия параметрі.

pose_mode әдепкі

Генерацияланған модельдің позасын көрсетпеу үшін жолды бос қалдырыңыз, не 'a-pose' арқылы A-pose, 't-pose' арқылы T-pose сұраңыз.

әдепкі 30000

Полигондар санының мақсаты; model_type 'smart-topology' болғанда 15,000 мәнімен шектеледі. Бұл режимде мақсат көрсетілмесе, Meshy-дің төменірек әдепкі мәні — 4,000 — таңдалады.

әдепкі 1.7

enable_rigging true болғанда кейіпкердің метрмен өлшенетін болжамды биіктігін беріңіз; әйтпесе бұл мән әсер етпейді.

әдепкі 92

Meshy кітапханасындағы анимация пресетінің ID мәні; қолжетімді әрекеттер https://docs.meshy.ai/en/api/animation-library мекенжайында берілген. Тексеру мен қолдану enable_animation мәні true болғанда ғана орындалады: [0, 696] аралығынан тыс мәндер 422 қатесімен қабылданбайды, ал "Idle" мәні `0` санына сәйкес келеді.

Бұрынғы нәтижені әдетте қайталау үшін осы seed-ті өзгермеген нұсқаумен бірге қайта пайдаланыңыз.

POST /run/meshy/v7/text-to-3d?wait=20 бағасы → 1,20 $
# 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/meshy/v7/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

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

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

Meshy V7 Text to 3D туралы

600 таңбаға дейінгі `prompt` арқылы 3D модель жасайды, `enable_prompt_expansion` қосымша қолжетімді. `mode` текстурасыз геометрияны немесе текстураланған модельді қайтарады. `model_type` арқылы standard, lowpoly немесе smart-topology таңдап, `target_polycount` мәнін 100-ден 300000-ға дейін орнатыңыз және standard не 2k `geometry_resolution` таңдаңыз. Адамтәрізді кейіпкерлерге ригтеу мен анимация пресеттерін қосуға болады.

Параметрлер

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
promptміндетті
Түріstring
≤ 600 таңба
3D модель ретінде ұсынылатын нысанның сипаттамасы, 600 таңбамен шектелген.
modeміндетті емес
Түріenum
Әдепкіfull
previewfull
Генерация режимі: 'preview' текстурасыз геометрияны, ал 'full' preview және refine нәтижелерін біріктіріп, текстураланған модельді шығарады.
seedміндетті емес
Түріinteger | null
Бұрынғы нәтижені әдетте қайталау үшін осы seed-ті өзгермеген нұсқаумен бірге қайта пайдаланыңыз.
model_typeміндетті емес
Түріenum
Әдепкіstandard
standardlowpolysmart-topology
3D mesh режимі: таза полигондарға оңтайландырылған low-poly нәтиже үшін 'lowpoly' таңдаңыз; бұл режимде Meshy topology, target_polycount және should_remesh параметрлерін елемейді. Қалыпты жоғары детализацияланған нәтиже үшін 'standard', ал геометрияның (preview) қадамында Meshy-T2 қолданып, басынан бастап бөлек жасалған таза бөліктерді алу үшін 'smart-topology' таңдаңыз.
topologyміндетті емес
Түріenum
Әдепкіtriangle
quadtriangle
Геометриялық детализацияға арналған Triangle және бет тегістігіне арналған Quad арасындағы модель топологиясын таңдау.
target_polycountміндетті емес
Түріinteger
Әдепкі30000
100 – 300 000
Полигондар санының мақсаты; model_type 'smart-topology' болғанда 15,000 мәнімен шектеледі. Бұл режимде мақсат көрсетілмесе, Meshy-дің төменірек әдепкі мәні — 4,000 — таңдалады.
should_remeshміндетті емес
Түріboolean
Әдепкіtrue
false мәнін орнатып, қайта mesh жасауды өткізіп, бастапқы үшбұрышты mesh алыңыз; әйтпесе remesh кезеңін қосыңыз.
symmetry_modeміндетті емес
Түріenum
Әдепкіauto
offautoon
Модель генерациясы кезінде қолданылатын симметрия параметрі.
enable_pbrміндетті емес
Түріboolean
Әдепкіfalse
Негізгі түспен қатар metallic, roughness және normal PBR карталарының генерациясын басқарады.
is_a_t_poseміндетті емес
Түріboolean
Әдепкіfalse
true мәні арқылы іске қосылатын T-pose генерация ауыстырып-қосқышы; pose_mode пайдасына ескірген.
pose_modeміндетті емес
Түріenum
Әдепкі
a-poset-pose
Генерацияланған модельдің позасын көрсетпеу үшін жолды бос қалдырыңыз, не 'a-pose' арқылы A-pose, 't-pose' арқылы T-pose сұраңыз.
enable_prompt_expansionміндетті емес
Түріboolean
Әдепкіfalse
Үлкен тіл моделіне нұсқауды мәліметтермен толықтыруға рұқсат береді. Бұл кеңейту нұсқаудың мағынасын өзгертпейді.
texture_promptміндетті емес
Түріstring | null
≤ 600 таңба
'full' режимінде қосымша мәтіндік нұсқаумен текстуралауды бағыттайды; басқа режимдер оны қолданбайды.
texture_image_urlміндетті емес
Түріurl · image
Тек 'full' режимінде қолданылатын текстура генерациясының 2D анықтамалық кескіні.
enable_riggingміндетті емес
Түріboolean
Әдепкіfalse
Автоматты гуманоидты риггинг, аяқ-қолдары анық ажыратылатын гуманоидты модельдер үшін ең тиімді. Оны қосу генерацияланған модельге риггинг жасап, жүру мен жүгіруге арналған негізгі анимацияларды береді.
rigging_height_metersміндетті емес
Түріnumber
Әдепкі1.7
> 0
enable_rigging true болғанда кейіпкердің метрмен өлшенетін болжамды биіктігін беріңіз; әйтпесе бұл мән әсер етпейді.
enable_animationміндетті емес
Түріboolean
Әдепкіfalse
Ригтелген модельге алдын ала орнатылған анимация беріле ме; бұл үшін enable_rigging true болуы керек.
animation_action_idміндетті емес
Түріinteger
Әдепкі92
Meshy кітапханасындағы анимация пресетінің ID мәні; қолжетімді әрекеттер https://docs.meshy.ai/en/api/animation-library мекенжайында берілген. Тексеру мен қолдану enable_animation мәні true болғанда ғана орындалады: [0, 696] аралығынан тыс мәндер 422 қатесімен қабылданбайды, ал "Idle" мәні `0` санына сәйкес келеді.
enable_safety_checkerміндетті емес
Түріboolean
Әдепкіtrue
Алдын ала өңдеу қауіпсіздігін тексеру ауыстырып-қосқышы: true мәні кіріс қауіпсіздігін тексеруді өңдеудің міндетті шарты етеді.
geometry_resolutionміндетті емес
Түріenum
standard2k
Mesh геометриясының ажыратымдылығы; қолдау көрсетілетін Meshy-7 мәндері — standard және 2k.
ultra_modeміндетті емес
Түріboolean
Әдепкіfalse
geometry_resolution параметрімен алмастырылған ескірген параметр; екеуі де берілсе, geometry_resolution басым болады; geometry_resolution='2k' пайдаланыңыз.
міндетті

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/text-to-3d",
  "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": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "animation_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
    },
    "animation_fbx": {
      "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
    },
    "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
    },
    "thumbnail": {
      "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
    },
    "model_urls": {
      "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
      },
      "fbx": {
        "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
      },
      "obj": {
        "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
      },
      "usdz": {
        "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
      },
      "blend": {
        "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
      },
      "stl": {
        "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
      }
    },
    "texture_urls": [
      {
        "base_color": {
          "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
        },
        "metallic": {
          "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
        },
        "normal": {
          "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
        },
        "roughness": {
          "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,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "rigged_character_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
    },
    "rigged_character_fbx": {
      "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
    },
    "basic_animations": {
      "walking_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
      },
      "walking_fbx": {
        "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
      },
      "walking_armature_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
      },
      "running_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
      },
      "running_fbx": {
        "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
      },
      "running_armature_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
      }
    },
    "rig_task_id": "string"
  },
  "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-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
animation_glb
object {url, content_type, file_name, file_size} | null3D модельді GLB ретінде қамтитын анимация нәтижесі; enable_animation true болмаса, жауапта бұл нәтиже болмайды.
animation_fbx
object {url, content_type, file_name, file_size} | null3D модельді FBX ретінде қамтитын анимация нәтижесі; enable_animation true болмаса, жауапта бұл нәтиже болмайды.
model_glb
object {url, content_type, file_name, file_size}Генерацияланған 3D нысаны бар GLB файлы.
thumbnail
object {url, content_type, file_name, file_size} | nullГенерацияланған модельдің алдын ала қарауын көрсететін нобай.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Әртүрлі пішімдердегі 3D модельге сілтемелер.
texture_urls
array of object {base_color, metallic, normal, roughness}Нысандар массиві ретінде ұсынылған текстура файлдары.
seed
integer | nullГенерация кезінде пайдаланылатын seed мәні.
prompt
stringГенерация үшін берілген мәтіндік нұсқау.
actual_prompt
string | nullНұсқауды кеңейту қосылғанда генерацияға нақты қолданылған нұсқау мәтіні.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullGLB кейіпкер файлы ретінде берілетін риггинг нәтижесі; enable_rigging true болмаса, жауапта болмайды.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullFBX кейіпкер файлы ретінде берілетін риггинг нәтижесі; enable_rigging true болмаса, жауапта болмайды.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullНегізгі жүру және жүгіру анимациялары, тек enable_rigging true болғанда қосылады.
rig_task_id
string | nullРиггинг тапсырмасының идентификаторы; тек enable_rigging true болғанда қосылады.

Қосымша модельдер: Мәтіннен 3D-ге

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