Multi-Image to 3D API

Ang Multi-Image to 3D API ay isang tampok na nagpapahintulot sa iyo na isama ang mga kakayahan ng Meshy na i-convert ang Multi-Image to 3D sa iyong sariling aplikasyon. Sa seksyon na ito, matutunan mo ang lahat ng impormasyon na kailangan mo upang makapagsimula sa API na ito.

POST/openapi/v1/multi-image-to-3d

Gumawa ng Multi-Image to 3D Task

Ang endpoint na ito ay nagpapahintulot sa iyo na gumawa ng bagong Multi-Image to 3D task. Suriin ang The Multi-Image to 3D Task Object para makita kung anong mga property ang kasama sa Multi-Image to 3D task object.

Mga Parameter

Tanging isa lang sa input_task_id o image_urls ang kailangan. Kung parehong ibinigay, input_task_id ang may prayoridad.

Name
input_task_id
Type
string
Kinakailangan
Description
Ang ID ng isang natapos na image-generation task na ang output (1-4 na larawan) ay dapat gamitin bilang input. Ang task na ito ay dapat isa sa sumusunod na mga task: Text to Image, Image to Image, Text to Image Multi-View, o Image to Image Multi-View. Dagdag pa, dapat itong ginawa sa pamamagitan ng API at may status na SUCCEEDED.

Name
image_urls
Type
array
Kinakailangan
Description
Magbigay ng 1 hanggang 4 na larawan na gagamitin ng Meshy sa paglikha ng modelo. Sinusuportahan namin ang .jpg, .jpeg, at .png na mga format. Ang lahat ng mga larawan ay dapat magpakita ng parehong bagay mula sa iba't ibang anggulo para sa pinakamahusay na resulta.
May dalawang paraan upang magbigay ng bawat larawan:
- Publicly accessible URL: Isang URL na naa-access mula sa publiko sa internet.
- Data URI: Isang base64-encoded data URI ng larawan. Halimbawa ng isang data URI: data:image/jpeg;base64,<your base64-encoded image data>.
Para sa meshy-7 (o latest), ang unang larawan ay ginagamit bilang pangunahing (harap na) view. Ang pagkakasunod-sunod ng natitirang mga larawan ay hindi mahalaga.

Name
ai_model
Type
string
default latest
Description
ID ng modelong gagamitin. Mga magagamit na halaga: meshy-5, meshy-6, meshy-7, latest (Meshy 7).
Name
should_texture
Type
boolean
default true
Description
Tinutukoy kung ang mga texture ay gagawin. Ang pagtatakda nito sa false ay laktawan ang texture phase, na nagbibigay ng mesh na walang textures.

Naaangkop lamang kapag should_texture = true

Name
enable_pbr
Type
boolean
default false
Description
Gumawa ng PBR Maps (metallic, roughness, normal) bilang karagdagan sa base color. Kasama rin ang emission map kapag ang ai_model ay meshy-6, maliban sa texture_resolution: 8k. Ang meshy-7 at latest ay hindi naglalabas ng emission map.
Name
texture_resolution
Type
string
default 2k
Description
Base color texture resolution. Isa sa 2k (2048×2048), 4k (4096×4096), o 8k (8192×8192). Ang mataas na resolusyon ay nakukuha ang higit na detalye sa ibabaw.
4k at 8k ay nangangailangan ng ai_model na meshy-6, meshy-7 o latest. Sa 8k, walang nagagawa na emission map.
Name
hd_texture
Type
boolean
⚠ lipas na
default false
Description
Gamitin ang texture_resolution sa halip — katumbas ng texture_resolution: "4k". Kapag parehong naitakda, ang texture_resolution ang may prayoridad.
Name
texture_prompt
Type
string
Description
Magbigay ng text prompt upang i-guide ang proseso ng texturing. Maximum na 600 na karakter.
Name
texture_image_url
Type
string
Description
Magbigay ng 2D na larawan upang i-guide ang proseso ng texturing. Sinusuportahan namin ang .jpg, .jpeg, at .png na mga format.
May dalawang paraan upang magbigay ng larawan:
- Publicly accessible URL: Isang URL na naa-access mula sa publiko sa internet
- Data URI: Isang base64-encoded data URI ng larawan. Halimbawa ng isang data URI: data:image/jpeg;base64,<your base64-encoded image data>
Ang image texturing ay maaaring hindi gumana ng optimal kung mayroong mga malalaking pagkakaiba sa heometriya sa pagitan ng orihinal na asset at ang in-upload na larawan. Tanging isa sa texture_image_url o texture_prompt ang maaaring gamitin upang i-guideline ang proseso ng texturing. Kung parehong mga parameter ay ibinigay, ang texture_prompt ang gagamitin sa pag-texture ng modelo sa default.

Name
should_remesh
Type
boolean
default false (meshy-6), true (others)
Description
Kinokontrol kung papaganahin ang remesh phase. Para sa pinakamataas na kalidad na modelo, inirerekomenda namin itakda ang should_remesh na false.

Naaangkop lamang kapag should_remesh = true

Name
topology
Type
string
default triangle
Description
Tukuyin ang topology ng ginawa na modelo.
Magagamit na mga halaga:
- quad: Gumawa ng quad-dominant na mesh.
- triangle: Gumawa ng decimated triangle mesh.
Name
target_polycount
Type
integer
default 30,000
Description
Tukuyin ang target na bilang ng polygons sa ginawa na modelo. Ang aktwal na bilang ng polygons ay maaaring lumihis mula sa target depende sa pagiging kumplikado ng heometriya.
Ang tamang hanay ng halaga ay nag-iiba depende sa user tier:
- 100 hanggang 300,000 (kasama)
Name
decimation_mode
Type
integer
Description
Paganahin ang adaptive decimation sa pamamagitan ng pagtatakda ng polycount level. Kapag itinakda, ang target_polycount ay hindi isasaalang-alang.
Magagamit na mga halaga:
- 1: Adaptive — ultra polycount.
- 2: Adaptive — high polycount.
- 3: Adaptive — medium polycount.
- 4: Adaptive — low polycount.
Name
save_pre_remeshed_model
Type
boolean
default false
Description
Kapag itinakda sa true, iniimbak din ng Meshy ang isang dagdag na GLB file bago makumpleto ang remesh phase.

Name
symmetry_mode
Type
string
⚠ lipas na
default auto
Description
Deprecated. Ang parameter na ito ay hindi na nag-aapekto sa output.
Ang field na symmetry_mode ay kumokontrol sa simetriya na paggalaw habang ang proseso ng pagbuo ng modelo.
Ang tamang mga halaga ay:
- off: Hindi pinapagana ang simetriya.
- auto: Awtomatikong tinutukoy at nag-aangkop ng simetriya base sa input na heometriya.
- on: Ine-enforce ang simetriya habang gumagawa.
Name
pose_mode
Type
string
default ""
Description
Tukuyin ang pose mode para sa ginawa na modelo.
Magagamit na mga halaga:
- a-pose: Gumawa ng modelo sa A pose.
- t-pose: Gumawa ng modelo sa T pose.
- "" (walang laman na string): Walang tiyak na pose na inilapat.
Name
is_a_t_pose
Type
boolean
⚠ lipas na
default false
Description
Gamitin ang pose_mode sa halip. Kung gagawa ng modelo sa A/T pose.
Name
image_enhancement
Type
boolean
default true
Description
Ine-optimize ang mga input na larawan para sa mas magandang resulta. Itakda sa false para mapanatili ang eksaktong hitsura ng mga input na larawan nang walang anumang pagproseso ng estilo.
Sinusuportahan lamang kapag ang ai_model ay meshy-6, meshy-7 o latest.
Name
remove_lighting
Type
boolean
default true
Description
Tinatanggal ang mga highlight at anino mula sa base color texture, na gumagawa ng mas malinis na resulta na mas mahusay na nag-aangkop sa mga custom na lighting setups.
Sinusuportahan lamang kapag ang ai_model ay meshy-6, meshy-7 o latest.
Name
moderation
Type
boolean
default false
Description
Kapag itinakda sa true, ang input na nilalaman ay awtomatikong sisiyasatin para sa potensyal na mapanganib na nilalaman. Kung natukoy ang mapanganib na nilalaman, ang task ay hindi magpapatuloy sa paggawa.
Ang bawat larawan mula sa image_urls at ang teksto mula sa texture_prompt ay susuriin.
Name
target_formats
Type
string[]
Description
Tinutukoy kung aling mga 3D file format ang isasama sa output. Tanging ang mga hiling na format ang gagawin at ibabalik, na maaaring mabawasan ang oras ng pagkumpleto ng task.
Magagamit na mga halaga: glb, obj, fbx, stl, usdz, 3mf
Kapag hindi kasama, ang lahat ng format maliban sa 3mf ay nagagawa. Ang 3mf ay kasama lamang kapag tahasang itinakda.
Name
auto_size
Type
boolean
default false
Description
Kapag itinakda sa true, ginagamit ng serbisyo ang AI vision upang awtomatikong tantyahin ang totoong-laking taas ng bagay at i-resize ang modelo nang naaayon. Ang pinagmulan ay magdedepault sa bottom maliban kung ang origin_at ay tahasang itinakda.
Name
alpha_thumbnail
Type
boolean
default false
Description
Kapag itinakda sa true, ang task ay karagdagang nagre-render ng transparent-background (RGBA) na bersyon ng preview at ibinalik ito bilang alpha_thumbnail_url sa GET response. Ang umiiral na field na thumbnail_url ay hindi nagbabago.
Name
multi_view_thumbnails
Type
boolean
default false
Description
Kapag itinakda sa true, ang task ay karagdagang nagre-render ng apat na cardinal-view thumbnails (harap, kanan, likod, kaliwa) at ibinalik ang mga ito sa ilalim ng thumbnail_urls sa GET response. Ang umiiral na field na thumbnail_url ay hindi nagbabago at patuloy na tumutukoy sa harap na view, kaya ang mga umiiral na kliyente ay hindi naaapektuhan.
Nagdadagdag ng humigit-kumulang 3 segundo sa task latency.

Naaangkop lamang kapag auto_size = true

Name
origin_at
Type
string
default bottom
Description
Posisyon ng pinagmulan kapag pinagana ang auto_size. Magagamit na mga halaga: bottom, center.

Binalik

Ang result property ng tugon ay naglalaman ng task id ng bagong likha na Multi-Image to 3D task.

Mga Mode ng Pagkabigo

Name
400 - Bad Request
Description
Ang kahilingan ay hindi katanggap-tanggap. Mga karaniwang sanhi:
- Kulang ang parameter: Kailangan magbigay ng alinman sa image_urls o input_task_id.
- Invalid na input task: Ang input_task_id ay dapat tumutukoy sa isang SUCCEEDED Text to Image, Image to Image, o multi-view variant na task.
- Maling bilang ng larawan: Ang image_urls ay dapat maglaman ng pagitan ng 1 at 4 na mga larawan.
- Di-suportadong format ng larawan: Ang isa o higit pang larawan sa image_urls ay hindi suportadong mga format.
- Hindi ma-access na URL: Ang isa o higit pang image_urls ay hindi na-download.
Name
401 - Unauthorized
Description
Nabigo ang authentication. Paki-tsek ang iyong API key.
Name
402 - Payment Required
Description
Hindi sapat ang mga credit upang gawin ang task na ito.
Name
429 - Too Many Requests
Description
Lumampas ka na sa iyong rate limit.

Request

POST

/openapi/v1/multi-image-to-3d

# Simpleng kahilingan
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<iyong pwedeng akses na URL ng larawan o base64-encoded data URI>",
      "<iyong pangalawang pwedeng akses na URL ng larawan o base64-encoded data URI>"
    ]
  }'

# May PBR texturing at GLB format
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<iyong pwedeng akses na URL ng larawan o base64-encoded data URI>",
      "<iyong pangalawang pwedeng akses na URL ng larawan o base64-encoded data URI>"
    ],
    "should_texture": true,
    "enable_pbr": true,
    "target_formats": ["glb"]
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

GET/openapi/v1/multi-image-to-3d/:id

Kumuha ng Multi-Image to 3D Task

Ang endpoint na ito ay nagpapahintulot sa iyo na makuha ang isang Multi-Image to 3D task gamit ang isang valid na task id. Suriin ang The Multi-Image to 3D Task Object para makita kung anong mga property ang kasama sa Multi-Image to 3D task object.

Mga Parameter

Name
id
Type
path
Description
Natatanging tagatukoy para sa Multi-Image to 3D task na kukunin.

Binalik

Ang tugon ay naglalaman ng Multi-Image to 3D task object. Tsekahin ang seksyon ng The Multi-Image to 3D Task Object para sa mga detalye.

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

DELETE/openapi/v1/multi-image-to-3d/:id

Tanggalin ang Multi-Image to 3D Task

Ang endpoint na ito ay permanenteng tinatanggal ang isang Multi-Image to 3D task, kasama ang lahat ng kaugnay na mga modelo at data. Ang aksyon na ito ay hindi na maibabalik.

Mga Path Parameter

Name
id
Type
path
Description
Ang ID ng Multi-Image to 3D task na tatanggalin.

Binalik

Nagbalik ng 200 OK sa tagumpay.

Request

DELETE

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Nagbabalik ng 200 OK sa tagumpay.

GET/openapi/v1/multi-image-to-3d

Listahan ng Multi-Image to 3D Tasks

Ang endpoint na ito ay nagpapahintulot sa iyo na makuha ang listahan ng Multi-Image to 3D tasks.

Mga Parameter

Mga Opsyonal na katangian

Name
page_num
Type
integer
Description
Numero ng pahina para sa pagination. Nagsisimula at default sa 1.
Name
page_size
Type
integer
Description
Limitasyon ng laki ng pahina. Default sa 10 item. Ang maximum na pinapayagan ay 50 item.
Name
sort_by
Type
string
Description
Field na iaayos. Magagamit na halaga:
- +created_at: Ayusin batay sa oras ng paglikha sa pataas na pagkakasunud-sunod.
- -created_at: Ayusin batay sa oras ng paglikha sa pababang pagkakasunud-sunod.

Binalik

Nagbabalik ng isang naka-paginate na listahan ng The Multi-Image to 3D Task Objects.

Request

GET

/openapi/v1/multi-image-to-3d

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "multi-image-to-3d",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
      "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "thumbnail_urls": {
      "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
      "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
      "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
      "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
    },
    "texture_prompt": "",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "expires_at": 1692771679037,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
        "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
        "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
        "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
        "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 30
  }
]

GET/openapi/v1/multi-image-to-3d/:id/stream

I-stream ang Multi-Image to 3D Task

Ang endpoint na ito ay nag-i-stream ng real-time na mga update para sa isang Multi-Image to 3D task gamit ang Server-Sent Events (SSE).

Mga Parameter

Name
id
Type
path
Description
Natatanging tagatukoy para sa Multi-Image to 3D task na i-stream.

Binalik

Ang tugon ay nagbabalik ng stream ng The Multi-Image to 3D Task Objects bilang Server-Sent Events.

Para sa mga PENDING o IN_PROGRESS na mga task, ang stream ng tugon ay parehong magkakaroon ng kinakailangang progress at status fields.

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Halimbawa ng error na event
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Ang mga halimbawa ng message event ay naglalarawan ng progreso ng task.
// Para sa mga PENDING o IN_PROGRESS na mga task, ang stream ng tugon ay hindi maglalaman ng lahat ng fields.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
  "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
  "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
  "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
  "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
  "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
  "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
  "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
  "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
  "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
  "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

Ang Multi-Image to 3D Task Object

Ang Multi-Image to 3D Task object ay isang work unit na tinutunton ng Meshy upang makabuo ng 3D na modelo mula sa maramihang mga larawan (sa pagitan ng 1 hanggang 4 kabilang). Ang mga larawan ay dapat ng parehong bagay, mas mabuti mula sa iba't ibang mga view o anggulo. Ang object ay may mga sumusunod na property:

Mga Property

Name
id
Type
string
Description
Natatanging tagatukoy para sa task. Habang gumagamit kami ng k-sortable na UUID para sa mga task id bilang implementasyon na detalye, hindi ka dapat gumawa ng anumang mga paghaka tungkol sa format ng id.
Name
type
Type
string
Description
Uri ng Multi-Image to 3D task. Ang halaga ay multi-image-to-3d.
Name
model_urls
Type
object
Description
Downloadable na URL ng textured 3D model file na nabuo ng Meshy. Ang property para sa isang format ay hindi isasama kung ang format ay hindi nagagawa sa halip na magpabalik ng isang blangkong string.
- Name
  glb
  Type
  string
  Description
  Downloadable na URL sa GLB file.
- Name
  fbx
  Type
  string
  Description
  Downloadable na URL sa FBX file.
- Name
  obj
  Type
  string
  Description
  Downloadable na URL sa OBJ file.
- Name
  usdz
  Type
  string
  Description
  Downloadable na URL sa USDZ file.
- Name
  mtl
  Type
  string
  Description
  Downloadable na URL sa MTL file, ibinabalik kasabay ng mga OBJ exports kapag mayroong mga texture.
- Name
  stl
  Type
  string
  Description
  Downloadable na URL sa STL file.
- Name
  3mf
  Type
  string
  Description
  Downloadable na URL sa 3MF file. Tanging nandito lamang kapag ang 3mf ay hiniling sa pamamagitan ng target_formats.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  Downloadable na URL sa orihinal na GLB output bago ang remeshing.
  Available lamang kapag ang task ay ginawa kasama ang parehong should_remesh: true at save_pre_remeshed_model: true.
Name
thumbnail_url
Type
string
Description
Downloadable na URL sa thumbnail image ng model file. Katumbas ng thumbnail_urls.front kapag mayroon, pinanatili para sa backward compatibility.
Name
alpha_thumbnail_url
Type
string
Description
Downloadable na URL sa transparent-background (RGBA) na bersyon ng thumbnail_url. Tanging nandoon lamang kapag ang task ay nilikha na may alpha_thumbnail: true at ang transparent preview ay matagumpay na na-render; kung hindi, ang field na ito ay hindi isinama.
Name
thumbnail_urls
Type
object
Description
Downloadable na mga URL para sa apat na cardinal-view na thumbnails ng nabuo na 3D model. Bawat halaga ay isang signed URL sa isang 512×512 PNG na na-render na may parehong mga materyales at ilaw tulad ng thumbnail_url. Kapaki-pakinabang para sa pag-preview ng modelo mula sa maraming anggulo sa mga batch pipelines nang hindi na-download ang GLB.
Tanging nandoon kapag ang task ay nilikha na may multi_view_thumbnails: true at nakarating sa SUCCEEDED. Ang mga lumang task at mga task na nilikha nang walang opt-in ay hindi maglalaman ng field na ito.
- Name
  front
  Type
  string
  Description
  Harap na view, 0° na pag-ikot sa paligid ng vertical na axis (tumutugma sa thumbnail_url).
- Name
  right
  Type
  string
  Description
  Right view, 90° na pag-ikot.
- Name
  back
  Type
  string
  Description
  Likod na view, 180° na pag-ikot.
- Name
  left
  Type
  string
  Description
  Kaliwang view, 270° na pag-ikot.
Name
texture_prompt
Type
string
Description
Ang text prompt na ginamit upang i-guide ang proseso ng texturing.
Name
progress
Type
integer
Description
Progreso ng task. Kung ang task ay hindi pa nagsimula, ang property na ito ay magiging 0. Sa sandaling ang task ay tagumpay, ito ay magiging 100.
Name
started_at
Type
timestamp
Description
Timestamp ng oras kung kailan nagsimula ang task, sa milliseconds. Kung ang task ay hindi pa nagsisimula, ang property na ito ay magiging 0.
Ang timestamp ay kumakatawan sa bilang ng milliseconds simula noong January 1, 1970 UTC, ayon sa RFC 3339 standard. Halimbawa, ang Biyernes, September 1, 2023 12:00:00 PM GMT ay kinakatawan bilang 1693569600000. Ito ay angkop sa lahat ng mga timestamps sa Meshy API.
Name
created_at
Type
timestamp
Description
Timestamp ng oras kung kailan nilikha ang task, sa milliseconds.
Name
expires_at
Type
timestamp
Description
Timestamp ng oras kung kailan mag-eexpire ang resulta ng task, sa milliseconds.
Name
finished_at
Type
timestamp
Description
Timestamp ng oras kung kailan natapos ang task, sa milliseconds. Kung ang task ay hindi pa natapos, ang property na ito ay magiging 0.
Name
status
Type
string
Description
Status ng task. Posibleng mga halaga ay isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
texture_urls
Type
array
Description
Isang array ng texture URL objects na nabuo mula sa task. Normal na ito ay naglalaman lamang ng isa na texture URL object. Bawat texture URL ay mayroong sumusunod na mga property:
- Name
  base_color
  Type
  string
  Description
  Downloadable na URL sa base color map na imahe.
- Name
  metallic
  Type
  string
  Description
  Downloadable na URL sa metallic map na imahe.
  Kung ang task ay nilikha na may enable_pbr: false, ang property na ito ay hindi isasama.
- Name
  normal
  Type
  string
  Description
  Downloadable na URL sa normal map na imahe.
  Kung ang task ay nilikha na may enable_pbr: false, ang property na ito ay hindi isasama.
- Name
  roughness
  Type
  string
  Description
  Downloadable na URL sa roughness map na imahe.
  Kung ang task ay nilikha na may enable_pbr: false, ang property na ito ay hindi isasama.
- Name
  emission
  Type
  string
  Description
  Downloadable na URL sa emission map na imahe.
  Kung ang task ay nilikha na may enable_pbr: false, o ai_model ay meshy-5, ang property na ito ay hindi isasama.
Name
preceding_tasks
Type
integer
Description
Ang bilang ng mga naunang task.
Ang halaga ng field na ito ay makabuluhan lamang kung ang status ng task ay PENDING.
Name
task_error
Type
object
Description
Mga detalye ng error para sa mga nabigong task. Tingnan ang Errors para sa buong reference ng task_error object.
Name
consumed_credits
Type
integer
Description
Ang bilang ng mga credits na nagamit sa task na ito. Kasama kapag ang status ng task ay PENDING, IN_PROGRESS, o SUCCEEDED. Nagbabalik ng 0 para sa mga FAILED na task (mga credits ay nirerefund sa pagkabigo).

Example Multi-Image to 3D Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30,
}