Retexture API

Ang ID ng kumpletong Image to 3D o Text to 3D task na nais mong i-retexture. Dapat ito ay isa sa mga sumusunod na task: Text to 3D Preview, Text to 3D Refine, Image to 3D o Remesh. Bukod dito, dapat itong may status na SUCCEEDED.

Magbigay ng 3D model para i-texture ni Meshy. Suportadong format: .glb, .gltf, .obj, .fbx, .stl.

Pinakamataas na laki ng file: 400 MB para sa http o https URL, 100 MB para sa data: URI.

Ang isang GLB, glTF, FBX o OBJ file na mahigit 100 MB ay maaaring magkaroon ng hanggang 10,000,000 faces. Binibilang ang faces bilang triangles: ang isang quad ay binibilang bilang 2, at ang isang mesh na iginuhit nang higit sa isang beses ay binibilang isang beses bawat kopya. Lampas sa 100 MB, ang isang FBX file ay dapat binary FBX 7.1 o mas bago, at ang isang GLB o glTF file ay hindi dapat gumagamit ng Draco compression.

May dalawang paraan upang ibigay ang model:

• Publicly accessible URL: Isang URL na naa-access mula sa pampublikong internet.
• Data URI: Isang base64-encoded data URI ng model. Gumamit ng MIME type na application/octet-stream. Halimbawa: data:application/octet-stream;base64,<your base64-encoded model data>.

Ilarawan gamit ang text ang nais mong texture style ng object. Pinakamataas na 800 character.

Magbigay ng 2d na imahe upang gabayan ang proseso ng pag-te-texture. Kasalukuyan naming sinusuportahan ang mga format na .jpg, .jpeg, .png, at .webp.

Pinakamataas na laki ng file: 20 MB.

May dalawang paraan upang ibigay ang imahe:

• Publicly accessible URL: Isang URL na naa-access mula sa pampublikong internet
• Data URI: Isang base64-encoded data URI ng imahe. Halimbawa ng data URI: data:image/jpeg;base64,<your base64-encoded image data>

Magbigay ng 1 hanggang 4 na imahe na nagpapakita ng parehong object mula sa iba't ibang anggulo upang gabayan ang pag-te-texture. Ang unang imahe ay ang pangunahing (harapang) view; hindi mahalaga ang pagkakasunod-sunod ng natitirang mga view (kaliwa, likod, kanan).

Ang bawat elemento ay tumatanggap ng parehong mga format tulad ng image_style_url (isang publicly accessible URL o isang base64 data URI, .jpg/.jpeg/.png/.webp).

Pinakamataas na laki ng file: 20 MB bawat imahe.

ID ng AI model na gagamitin para sa pag-re-retexture. Magagamit na mga value: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).

Panatilihin ang umiiral na UV layout ng model sa halip na gumawa ng bago.

• Kung nagre-retexture ka ng model na nilikha ni Meshy (sa pamamagitan ng input_task_id, o isang model_url na tumuturo sa isang output ng Meshy), itakda ito sa true upang muling gamitin ang na-optimize nitong UV layout.
• Kung nagre-retexture ka ng third-party na model na in-upload mo, itakda sa true kung mayroon na itong magagandang UV na gusto mong panatilihin, o iwanang false upang hayaang mag-unwrap si Meshy ng bagong UV (pinakamainam para sa mga model na walang tamang UV mapping).

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-6-lite, meshy-7 at latest ay hindi gumagawa ng emission map.

Base color texture resolution. Isa sa 2k (2048×2048), 4k (4096×4096), o 8k (8192×8192). Ang mas mataas na resolution ay nakakakuha ng mas maraming detalye sa ibabaw.

Gamitin ang texture_resolution sa halip — katumbas ng texture_resolution: "4k". Kapag parehong itinakda, ang texture_resolution ang mauuna.

Inaalis ang mga highlight at anino mula sa base color texture, na nagbibigay ng mas malinis na resulta na mas mahusay gumana sa custom na lighting setup.

Tinutukoy kung aling mga 3D file format ang isasama sa output. Tanging ang mga hiniling na format lamang ang bubuuin at ibabalik, na maaaring magpababa sa oras ng pagkumpleto ng task. Kapag hindi ito isinama, lahat ng suportadong format ay kasama.

Magagamit na mga value: glb, obj, fbx, stl, usdz, 3mf

Kapag itinakda sa true, ang task ay karagdagang mag-re-render ng bersyon na may transparent na background (RGBA) ng preview at ibabalik ito bilang alpha_thumbnail_url sa GET response. Ang umiiral na thumbnail_url field ay hindi nagbabago.

Hindi katanggap-tanggap ang request. Karaniwang mga dahilan:

• Nawawalang parameter: Dapat ibigay ang alinman sa model_url o input_task_id.
• Nawawalang style: Dapat ibigay ang isa sa text_style_prompt, image_style_url o multiview_image_urls.
• Nagkukumplikto na style input: Hindi maaaring pagsamahin ang multiview_image_urls sa text_style_prompt o image_style_url.
• Hindi suportadong model para sa multi-view: Nangangailangan ang multiview_image_urls ng tahasang ai_model: "meshy-7".
• Hindi magagamit ang model: Ang ai_model: "meshy-7" at ai_model: "meshy-6-lite" ay unti-unting pinapagana at maaaring hindi pa naka-enable para sa iyong account.
• Invalid na input task: Ang input_task_id ay dapat tumutukoy sa isang matagumpay na task mula sa isang suportadong model.
• Invalid na format ng model: Tumuturo ang model_url sa isang file na may hindi suportadong extension.
• Hindi maabot na URL: Hindi ma-download ang model_url, image_style_url o isang elemento ng multiview_image_urls.
• Masyadong malaki ang model file: Lumampas ang model_url file sa 400 MB (http o https URL) o 100 MB (data: URI).
• Masyadong maraming faces: Ang model_url file ay mahigit 100 MB at may higit sa 10,000,000 faces. Bawasan ang bilang ng faces, pagkatapos ay ipadala muli ang file.
• ASCII FBX na mahigit 100 MB: Ang model_url file ay isang ASCII FBX na mahigit 100 MB. Ipadala ito bilang binary FBX o GLB.
• Hindi mabasang model file: Ang model_url file ay mahigit 100 MB at hindi mabasa ang header nito, halimbawa isang Draco-compressed na GLB o glTF, o isang binary FBX na mas luma sa 7.1.
• Masyadong komplikado ang header ng model: Ang model_url file ay mahigit 100 MB at ang header nito ay may masyadong maraming mesh, node, o record na susuriin. Bawasan ang bilang ng mga object sa file, pagkatapos ay ipadala ito muli.
• Masyadong malaki ang imahe: Ang imahe ng image_style_url o isang elemento ng multiview_image_urls ay lumampas sa 20 MB.

Nabigo ang authentication. Pakisuri ang iyong API key.

Hindi sapat na credits upang maisagawa ang task na ito.

Nalagpasan mo ang iyong rate limit.

Natatanging identifier para sa Retexture task na kukunin.

Ang ID ng retexture task na ide-delete.

Numero ng page para sa pagination.

Limitasyon sa laki ng page. Ang pinakamataas na pinapayagan ay 100 na item.

Field na gagamitin para sa pag-sort.

Mga available na value:

• +created_at: Pagsunud-sunurin ayon sa oras ng paggawa sa paraang pataas (ascending).
• -created_at: Pagsunud-sunurin ayon sa oras ng paggawa sa paraang pababa (descending).

Natatanging identifier para sa Retexture task na i-stre-stream.

Ang natatanging identifier para sa task. Bagama't gumagamit kami ng k-sortable UUID para sa task ids bilang implementation detail, hindi mo dapat gawin ang anumang pagpapalagay tungkol sa format ng id.

Uri ng Retexture task. Ang value ay retexture.

Ma-download na URL patungo sa textured 3D model file na binuo ng Meshy.

Ito ang text prompt na ginamit upang likhain ang texturing task.

Ito ang image input na ginamit upang likhain ang texturing task.

Ma-download na mga URL patungo sa multi-view reference images na ginamit upang likhain ang texturing task. Naroroon lamang kapag ang task ay nilikha gamit ang multiview_image_urls.

Ma-download na URL patungo sa thumbnail image ng model file.

Ma-download na URL patungo sa transparent-background (RGBA) na bersyon ng thumbnail_url. Naroroon lamang kapag ang task ay nilikha gamit ang alpha_thumbnail: true at matagumpay na na-render ang transparent preview; kung hindi, aalisin ang field na ito.

Progreso ng task. Kung hindi pa nasisimulan ang task, ang property na ito ay magiging 0. Kapag nagtagumpay na ang task, ito ay magiging 100.

Timestamp kung kailan sinimulan ang task, sa milliseconds. Kung hindi pa nasisimulan ang task, ang property na ito ay magiging 0.

Timestamp kung kailan nilikha ang task, sa milliseconds.

Timestamp kung kailan mag-eexpire ang resulta ng task, sa milliseconds.

Timestamp kung kailan natapos ang task, sa milliseconds. Kung hindi pa tapos ang task, ang property na ito ay magiging 0.

Status ng task. Ang mga posibleng value ay isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Isang array ng texture URL objects na nabuo mula sa task. Karaniwan, isa lamang ang laman nito. Ang bawat texture URL ay may mga sumusunod na properties:

Ang bilang ng mga naunang task.

Mga detalye ng error para sa mga nabigong task. Tingnan ang Errors para sa kumpletong reference ng task_error object.

Ang bilang ng credits na nagamit ng task na ito. Naroroon kapag ang status ng task ay PENDING, IN_PROGRESS, o SUCCEEDED. Nagbabalik ng 0 para sa mga FAILED na task (ang mga credits ay ire-refund kapag nabigo).