Мазмұнға өту

Meshy 6 · Image to 3D

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

Модель идентификаторы meshy/v6/image-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/v6/image-to-3d?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"

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

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

Meshy 6: қайта торлау, PBR карталары, қосымша адамтәрізді ригтеу және анимациясы бар кескіннен 3D

Meshy · 3D

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

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

Сұрау жасау

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

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

3D жасауға арналған бастапқы кескінді URL немесе base64 деректер URI арқылы беріңіз; .jpg, .jpeg, .png, AVIF немесе HEIF қолданыңыз. AVIF және HEIF кірістері автоматты түрде түрлендіріледі.

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

Текстура генерациясын бағыттайтын мәтіндік нұсқаулар.

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

Текстура генерациясын бағыттайтын 2D анықтамалық кескін.

model_type әдепкі standard

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

topology әдепкі triangle

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

symmetry_mode әдепкі auto

Модель генерациясы симметрияны On арқылы мәжбүрлей ме, Off арқылы алып тастай ма, әлде 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` санына сәйкес келеді.

POST /run/meshy/v6/image-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/v6/image-to-3d?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"

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

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

Meshy 6 · Image to 3D туралы

Бір кескіннен (`image_url`) 3D модель жасайды. `model_type` standard, lowpoly немесе smart-topology мәндерін, топология triangle немесе quad мәндерін таңдайды, ал `target_polycount` 100-ден 300000-ға дейін. Опцияларға текстуралау, PBR карталары, симметрия, A немесе T позасы және анимация пресетімен адамтәрізді ригтеу кіреді. Шығыста GLB және FBX файлдары бар.

Параметрлер

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

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
3D жасауға арналған бастапқы кескінді URL немесе base64 деректер URI арқылы беріңіз; .jpg, .jpeg, .png, AVIF немесе HEIF қолданыңыз. AVIF және HEIF кірістері автоматты түрде түрлендіріледі.
model_typeміндетті емес
Түріenum
Әдепкіstandard
standardlowpolysmart-topology
3D mesh режимі: таза полигондарға оңтайландырылған low-poly нәтиже үшін 'lowpoly' таңдаңыз; бұл режимде Meshy topology, target_polycount және should_remesh параметрлерін елемейді. Қалыпты жоғары детализацияланған нәтиже үшін 'standard', ал басынан бастап бөлек жасалған таза бөліктерді алу үшін 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 — таңдалады.
symmetry_modeміндетті емес
Түріenum
Әдепкіauto
offautoon
Модель генерациясы симметрияны On арқылы мәжбүрлей ме, Off арқылы алып тастай ма, әлде Auto арқылы автоматты түрде анықтай ма — таңдаңыз.
should_remeshміндетті емес
Түріboolean
Әдепкіtrue
Қайта mesh жасау кезеңін қосады немесе өшіреді.
should_textureміндетті емес
Түріboolean
Әдепкіtrue
Текстура генерациясын қосады немесе өшіреді.
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 сұраңыз.
texture_promptміндетті емес
Түріstring | null
≤ 600 таңба
Текстура генерациясын бағыттайтын мәтіндік нұсқаулар.
texture_image_urlміндетті емес
Түріurl · image
Текстура генерациясын бағыттайтын 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 мәні кіріс қауіпсіздігін тексеруді өңдеудің міндетті шарты етеді.
міндетті Канондық атау, бұл да қабылданады

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

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v6/image-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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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,
    "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}Meshy API құрылымына сәйкес массивтегі текстура файлдарының нысандары.
seed
integer | nullБар болса, генерация seed-і.
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/v6/image-to-3d.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt