Pāriet uz saturu

Meshy V7 Multi Image to 3D

Integrēt

Modeļa id 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"

Faili, piemēram, paraugā: 1,20 $ 1200 API kredītu · ≈ 129,10 ₽ jūsu faili tiek izmērīti pirms izpildes Izpildīt šajā lapā

Iegūt API atslēgu
Meshy Attēls uz 3D #stylized#transform

Viena 3D modeļa izveide no 1 līdz 4 viena objekta skatiem ar poligonu un topoloģijas vadīklām

Meshy · 3D

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

•obligāts image_urls
Nometiet failu vai

Attēlu kopa 3D izveidei, kas pieņem .jpg, .jpeg, .png, kā arī AVIF/HEIF ar automātisku konvertēšanu. Norādiet 1 līdz 4 skatus, kuros viens objekts redzams no dažādiem leņķiem; ieraksti pēc pirmajiem 4 netiek izmantoti.

geometry_resolution

Ģeometrijas izšķirtspēja; 4k nav pieejams ģenerēšanai no vairākiem attēliem.

Papildu 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

Teksturēšanas norādes, kas iesniegtas kā teksta uzvedne; should_texture jābūt true.

Nometiet failu vai

Teksturēšanas norādes, kas iesniegtas kā 2D attēls; should_texture jābūt true.

topology noklusējums triangle

Modeļa topoloģijas izvēle starp Triangle ģeometriskām detaļām un Quad virsmas gludumam.

symmetry_mode noklusējums auto

Simetrijas iestatījums, ko izmanto modeļa ģenerēšanas laikā.

pose_mode noklusējums

Atstājiet virkni tukšu, lai nenorādītu ģenerētā modeļa pozu, vai pieprasiet A-pozīciju ar 'a-pose' vai T-pozīciju ar 't-pose'.

noklusējums 30000

Vēlamais izvades modeļa daudzstūru skaits.

noklusējums 1.7

Norādiet aptuveno tēla augstumu metros, ja enable_rigging ir true; pretējā gadījumā šai vērtībai nav ietekmes.

noklusējums 92

Meshy bibliotēkas animācijas iepriekš iestatītais ID; pieejamās darbības uzskaitītas vietnē https://docs.meshy.ai/en/api/animation-library. Validācija un lietošana attiecas tikai tad, ja enable_animation ir true: vērtības ārpus [0, 696] tiek noraidītas ar 422, un "Idle" atbilst `0`.

POST /run/meshy/v7/multi-image-to-3d?wait=20 cena → 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"

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Meshy V7 Multi Image to 3D

Rekonstruē vienu objektu no `image_urls`, kas pieņem vienu līdz četrus tā attēlus no dažādiem leņķiem. Iestatiet `topology` uz quad vai triangle un `target_polycount` no 100 līdz 300000, kā arī izvēlieties standard vai 2k `geometry_resolution`. Teksturēšana ir izvēles iespēja ar `should_texture`; pieejamas PBR kartes, pozas režīms, skelets un animācija. Izvade ietver GLB un citus formātus.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
image_urlsobligāts images
Tipsurl[] · image
Attēlu kopa 3D izveidei, kas pieņem .jpg, .jpeg, .png, kā arī AVIF/HEIF ar automātisku konvertēšanu. Norādiet 1 līdz 4 skatus, kuros viens objekts redzams no dažādiem leņķiem; ieraksti pēc pirmajiem 4 netiek izmantoti.
topologyneobligāts
Tipsenum
Noklusējumstriangle
quadtriangle
Modeļa topoloģijas izvēle starp Triangle ģeometriskām detaļām un Quad virsmas gludumam.
target_polycountneobligāts
Tipsinteger
Noklusējums30000
100 – 300 000
Vēlamais izvades modeļa daudzstūru skaits.
symmetry_modeneobligāts
Tipsenum
Noklusējumsauto
offautoon
Simetrijas iestatījums, ko izmanto modeļa ģenerēšanas laikā.
should_remeshneobligāts
Tipsboolean
Noklusējumstrue
Vai palaist atkārtotas tīkla izveides posmu. Iestatot šo uz false, tiek izveidots trijstūru tīkls; topology un target_polycount tiek ignorēti.
should_textureneobligāts
Tipsboolean
Noklusējumstrue
Iespējo vai atspējo tekstūras ģenerēšanu.
enable_pbrneobligāts
Tipsboolean
Noklusējumsfalse
Papildu PBR izvades slēdzis, pieejams tikai tad, ja should_texture iestatīts uz true; līdzās pamatkrāsai pievieno metāliskuma, raupjuma un normāļu kartes.
is_a_t_poseneobligāts
Tipsboolean
Noklusējumsfalse
T-pozīcijas ģenerēšanas slēdzis, ko aktivizē true; novecojis, priekšroka dodama pose_mode.
pose_modeneobligāts
Tipsenum
Noklusējums
a-poset-pose
Atstājiet virkni tukšu, lai nenorādītu ģenerētā modeļa pozu, vai pieprasiet A-pozīciju ar 'a-pose' vai T-pozīciju ar 't-pose'.
texture_promptneobligāts
Tipsstring | null
≤ 600 rakstzīmju
Teksturēšanas norādes, kas iesniegtas kā teksta uzvedne; should_texture jābūt true.
texture_image_urlneobligāts
Tipsurl · image
Teksturēšanas norādes, kas iesniegtas kā 2D attēls; should_texture jābūt true.
enable_riggingneobligāts
Tipsboolean
Noklusējumsfalse
Automātiska humanoīda skeleta izveide, kas visefektīvāk darbojas humanoīdiem modeļiem ar skaidri atšķiramām ekstremitātēm. Iespējojot šo opciju, ģenerētajam modelim tiek izveidots skelets un nodrošinātas pamata iešanas un skriešanas animācijas.
rigging_height_metersneobligāts
Tipsnumber
Noklusējums1.7
> 0
Norādiet aptuveno tēla augstumu metros, ja enable_rigging ir true; pretējā gadījumā šai vērtībai nav ietekmes.
enable_animationneobligāts
Tipsboolean
Noklusējumsfalse
Vai skeletotajam modelim tiek piešķirta iepriekš iestatīta animācija; tam nepieciešams, lai enable_rigging būtu true.
animation_action_idneobligāts
Tipsinteger
Noklusējums92
Meshy bibliotēkas animācijas iepriekš iestatītais ID; pieejamās darbības uzskaitītas vietnē https://docs.meshy.ai/en/api/animation-library. Validācija un lietošana attiecas tikai tad, ja enable_animation ir true: vērtības ārpus [0, 696] tiek noraidītas ar 422, un "Idle" atbilst `0`.
enable_safety_checkerneobligāts
Tipsboolean
Noklusējumstrue
Priekšapstrādes drošības pārbaudes slēdzis: true padara ievades drošības pārbaudi par priekšnoteikumu apstrādei.
geometry_resolutionneobligāts
Tipsenum
standard2k
Ģeometrijas izšķirtspēja; 4k nav pieejams ģenerēšanai no vairākiem attēliem.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
animation_glb
object {url, content_type, file_name, file_size} | nullAnimācijas rezultāts ar 3D modeli GLB formātā; atbilde šo rezultātu neietver, ja vien enable_animation nav true.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimācijas rezultāts ar 3D modeli FBX formātā; atbilde šo rezultātu neietver, ja vien enable_animation nav true.
model_glb
object {url, content_type, file_name, file_size}GLB fails ar ģenerēto 3D objektu.
thumbnail
object {url, content_type, file_name, file_size} | nullSīktēls ar ģenerētā modeļa priekšskatījumu.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Saites uz 3D modeli dažādos formātos.
texture_urls
array of object {base_color, metallic, normal, roughness}Tekstūras faili, kas attēloti kā objektu masīvs.
seed
integer | nullĢenerēšanas sākumstāvoklis, ja pieejams.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullSkeleta izveides rezultāts, kas piegādāts kā GLB tēla fails; atbildē nav iekļauts, ja vien enable_rigging nav true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullSkeleta izveides rezultāts, kas piegādāts kā FBX tēla fails; atbildē nav iekļauts, ja vien enable_rigging nav true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullPamata iešanas un skriešanas animācijas, iekļautas tikai tad, ja enable_rigging ir true.
rig_task_id
string | nullSkeleta izveides uzdevuma identifikators; iekļauts tikai tad, ja enable_rigging ir true.

Vairāk modeļu: Attēls uz 3D

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/meshy/v7/multi-image-to-3d.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt