Мазмұнға өту

Meshy V7 Multi Image to 3D

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

Модель идентификаторы meshy/v7/multi-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/v7/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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-ге #stylized#transform

Полигон және топология басқару элементтерімен бір нысанның 1-ден 4 көрінісінен бір 3D модель жасайды

Meshy · 3D

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

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

Сұрау жасау

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

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

3D жасауға арналған кескіндер жиыны: .jpg, .jpeg, .png, сондай-ақ автоматты түрлендірілетін AVIF/HEIF қабылданады. Бір нысанды әртүрлі бұрыштан көрсететін 1–4 көрініс беріңіз; алғашқы 4-тен кейінгі элементтер қолданылмайды.

geometry_resolution

Геометрияның ажыратымдылығы; бірнеше кескіннен генерациялау үшін 4k қолжетімсіз.

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

should_texture true болуын талап ететін мәтіндік нұсқау түріндегі текстуралау нұсқаулығы.

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

should_texture true болуын талап ететін 2D кескін түріндегі текстуралау нұсқаулығы.

topology әдепкі triangle

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

symmetry_mode әдепкі auto

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

pose_mode әдепкі

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

әдепкі 30000

Шығыс моделіне қажетті полигондар саны.

әдепкі 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/v7/multi-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/v7/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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 V7 Multi Image to 3D туралы

`image_urls` арқылы әртүрлі бұрыштан түсірілген нысанның бірден төртке дейінгі суретінен бір нысанды қайта құрады. `topology` мәнін quad немесе triangle етіп, `target_polycount` мәнін 100-ден 300000-ға дейін орнатыңыз және standard немесе 2k `geometry_resolution` таңдаңыз. `should_texture` арқылы текстуралау қосымша орындалады; PBR карталары, поза режимі, ригтеу және анимация қолжетімді. Шығыста GLB және басқа форматтар бар.

Параметрлер

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

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlsміндетті images
Түріurl[] · image
3D жасауға арналған кескіндер жиыны: .jpg, .jpeg, .png, сондай-ақ автоматты түрлендірілетін AVIF/HEIF қабылданады. Бір нысанды әртүрлі бұрыштан көрсететін 1–4 көрініс беріңіз; алғашқы 4-тен кейінгі элементтер қолданылмайды.
topologyміндетті емес
Түріenum
Әдепкіtriangle
quadtriangle
Геометриялық детализацияға арналған Triangle және бет тегістігіне арналған Quad арасындағы модель топологиясын таңдау.
target_polycountміндетті емес
Түріinteger
Әдепкі30000
100 – 300 000
Шығыс моделіне қажетті полигондар саны.
symmetry_modeміндетті емес
Түріenum
Әдепкіauto
offautoon
Модель генерациясы кезінде қолданылатын симметрия параметрі.
should_remeshміндетті емес
Түріboolean
Әдепкіtrue
Remesh кезеңін іске қосу керек пе. false мәні үшбұрышты mesh жасайды; содан кейін topology және target_polycount еленбейді.
should_textureміндетті емес
Түріboolean
Әдепкіtrue
Текстура генерациясын қосады немесе өшіреді.
enable_pbrміндетті емес
Түріboolean
Әдепкіfalse
Тек should_texture true болғанда қолжетімді қосымша PBR шығыс ауыстырып-қосқышы; негізгі түспен қатар metallic, roughness және normal карталарын қосады.
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 таңба
should_texture true болуын талап ететін мәтіндік нұсқау түріндегі текстуралау нұсқаулығы.
texture_image_urlміндетті емес
Түріurl · image
should_texture true болуын талап ететін 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
Геометрияның ажыратымдылығы; бірнеше кескіннен генерациялау үшін 4k қолжетімсіз.
міндетті Канондық атау, бұл да қабылданады

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

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/multi-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_urls": [
      "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}Нысандар массиві ретінде ұсынылған текстура файлдары.
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/v7/multi-image-to-3d.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt