Retexture API

Kailangan maliban kung magpadala ka ng model_url. Ang ID ng task na gumawa ng 3D model na te-textureng, halimbawa isang Text to 3D, Image to 3D, Remesh, o Retexture task. Ang task ay dapat isa sa mga nilikha mo gamit ang API at may status na SUCCEEDED. Tine-textureng ni Meshy ang GLB ng task.

Gamit ang meshy-n1, ang model ng task ay maaaring magkaroon ng hanggang 7,999,999 faces lang, binibilang bilang triangles (ang quad ay binibilang bilang 2).

Kailangan maliban kung magpadala ka ng input_task_id. Ang model na te-textureng, bilang isang pampublikong URL o isang data URI. Kung magpapadala ka ng pareho, gagamitin ni Meshy ang input_task_id.

Ang model ay dapat isang GLB, glTF, OBJ, FBX, o STL file na hanggang 400 MB mula sa isang http o https URL, o 100 MB bilang isang data URI. Para sa data URI, gamitin ang MIME type na application/octet-stream, halimbawa data:application/octet-stream;base64,<ang iyong base64-encoded na model data>.

Ang file na higit sa 100 MB ay dapat ding sumunod sa mga patakarang ito:

• Ang GLB, glTF, FBX, o OBJ file ay maaaring magkaroon ng hanggang 10,000,000 faces lang. Binibilang ni Meshy ang faces bilang triangles, kaya ang quad ay binibilang bilang 2, at ang mesh na iginuhit nang higit sa isang beses ay binibilang nang isang beses bawat kopya.
• Ang FBX file ay dapat binary FBX 7.1 o mas bago.
• Ang GLB o glTF file ay hindi dapat gumamit ng Draco compression.

Gamit ang meshy-n1, ang model ay maaaring magkaroon ng hanggang 7,999,999 faces lang, binibilang bilang triangles (ang quad ay binibilang bilang 2), anuman ang laki ng file nito.

Kailangan maliban kung magpadala ka ng image_style_url o multiview_image_urls. Teksto na naglalarawan sa texture na gusto mo, hanggang 800 karakter. Ang mas mahabang teksto ay nagbabalik ng 400. Gamit ang meshy-n1, ang pagpapadala nito nang walang image_style_url ay nagbabalik ng 400.

Kailangan maliban kung magpadala ka ng text_style_prompt o multiview_image_urls. Isang 2D na larawan na sinusunod ng texture ang istilo nito, bilang isang pampublikong URL o isang data URI (data:image/jpeg;base64,<ang iyong base64-encoded na larawan data>). Kung magpapadala ka ng pareho ng text_style_prompt at image_style_url, gagamitin ni Meshy ang image_style_url.

Ang larawan ay dapat isang .jpg, .jpeg, .png, o .webp file na hanggang 20 MB, at hindi bababa sa 32 pixels sa bawat gilid.

Maaaring hindi magkasya nang maayos ang texture kapag ang bagay sa larawan ay may napakaibang hugis mula sa model. Gamit ang meshy-n1, itinuturing ni Meshy ang larawan bilang front view.

Kailangan maliban kung magpadala ka ng text_style_prompt o image_style_url. Isa hanggang apat na larawan ng parehong bagay mula sa iba't ibang anggulo. Ang unang larawan ay ang pangunahin (front) view. Ang pagkakasunod-sunod ng ibang views (left, back, right) ay hindi mahalaga. Ang isang walang laman na array, o higit sa apat na larawan, ay nagbabalik ng 400.

Ang bawat larawan ay sumusunod sa parehong format at patakaran sa laki tulad ng image_style_url, hanggang 20 MB bawat larawan. Hindi mo maaaring pagsamahin ang multiview_image_urls sa text_style_prompt o image_style_url.

Kailangan ng multiview_image_urls ang isang tahasang ai_model na meshy-7 o meshy-n1. Ang alinmang ibang ai_model, kabilang ang default na latest, ay nagbabalik ng 400.

Ang AI model na lumilikha ng texture.

Mga magagamit na value:

• meshy-6-lite
• meshy-6
• meshy-7
• meshy-n1: isang 2K na base color texture mula sa mga reference image lang. Walang text prompt, walang PBR maps, walang 4K o 8K. Hanggang 7,999,999 faces.
• latest: Meshy 7

Kung ipapanatili ang UV layout ng model sa halip na lumikha ng bago.

• Para sa model na nilikha ni Meshy, mula sa input_task_id o isang model_url na tumutukoy sa output ng Meshy, gamitin ang true para muling gamitin ang na-optimize nitong UV layout.
• Para sa model na na-upload mo mula sa ibang lugar, gamitin ang true para panatilihin ang mga UV na maayos na. Iwanang false para hayaang lumikha si Meshy ng bagong UVs, na angkop para sa model na walang tamang UV mapping.

Kung lilikha rin ng PBR maps (metallic, roughness, at normal) kasama ang base color. Gamit ang meshy-6, lumilikha rin si Meshy ng emission map, maliban sa texture_resolution na 8k. Hindi lumilikha ng emission map ang meshy-6-lite, meshy-7, at latest. Gamit ang meshy-n1, ang true ay nagbabalik ng 400.

Ang laki ng base color texture. Ang mas mataas na resolution ay kumukuha ng mas maraming detalye sa ibabaw.

Mga magagamit na value:

• 2k: 2048 × 2048 pixels
• 4k: 4096 × 4096 pixels
• 8k: 8192 × 8192 pixels

Kailangan ng 4k at 8k ang ai_model na meshy-6, meshy-7, o latest. Gamit ang meshy-6-lite o meshy-n1, nagbabalik sila ng 400. Sa 8k, hindi lumilikha si Meshy ng emission map.

Gamitin na lang ang texture_resolution. Ang true ay kapareho ng texture_resolution: "4k". Kung magpapadala ka ng pareho, gagamitin ni Meshy ang texture_resolution.

Kung aalisin ang mga highlight at shadow mula sa base color texture. Mas maayos gumana ang resulta sa ilalim ng sarili mong lighting.

Inilalapat lang ito ni Meshy gamit ang meshy-6, sa texture_resolution na 2k o 4k. Gamit ang meshy-7 o latest, o sa 8k, tinatanggap ito ni Meshy at binabalewala. Gamit ang meshy-6-lite o meshy-n1, ang pagpapadala nito sa anumang value ay nagbabalik ng 400.

Ang mga file format na lilikhain. Lumilikha lang si Meshy ng mga format na nakalista mo, na maaaring magpaikli sa task. Kung iiwanan mong wala, lumilikha si Meshy ng bawat format maliban sa 3mf.

Mga magagamit na value:

• glb
• obj
• fbx
• stl
• usdz
• 3mf

Kung mag-rerender din ng preview na may transparent na background (RGBA), ibinabalik sa alpha_thumbnail_url kapag kinuha mo ang task. Hindi nagbabago ang thumbnail_url.

Hindi matakbo ang request. Sinasabi ng error message kung aling problema ang nahanap nito. Halimbawa:

• Missing parameter: Walang ipinadalang model_url o input_task_id.
• Missing style: Wala sa text_style_prompt, image_style_url, at multiview_image_urls ang ipinadala.
• Conflicting style inputs: Ipinadala ang multiview_image_urls kasama ang text_style_prompt o image_style_url.
• Unsupported model for multi-view: Ipinadala ang multiview_image_urls nang walang tahasang ai_model na meshy-7 o meshy-n1.
• Unsupported option for Meshy N1: Ipinadala ang meshy-n1 kasama ang enable_pbr: true, remove_lighting, isang texture_resolution na 4k o 8k, hd_texture: true nang walang texture_resolution, o text_style_prompt nang walang image_style_url.
• Too many triangles for Meshy N1: Gamit ang meshy-n1, ang 3D model ay may higit sa 7,999,999 triangles. Bawasan ang bilang ng triangle, o gumamit ng ibang ai_model.
• Model too complex for Meshy N1: Gamit ang meshy-n1, ang model_url file ay masyadong kumplikado para mabilang ni Meshy ang mga triangles nito. Bawasan ang bilang ng triangle, pagkatapos ay ipadala muli ang file.
• Triangle count timed out: Gamit ang meshy-n1, masyadong matagal ang pagbilang ng triangles ng model_url file. Subukan muli, o bawasan ang laki ng model.
• Invalid input task: Ang input_task_id ay hindi isang matagumpay na task ng isang supportadong uri.
• Invalid model format: Ang model_url file ay may extension na hindi supportado.
• Unreachable URL: Hindi ma-download ni Meshy ang model_url file, ang image_style_url na larawan, o isang multiview_image_urls na larawan.
• Model file too large: Ang model_url file ay higit sa 400 MB mula sa isang http o https URL, o higit sa 100 MB bilang isang data URI.
• Too many faces: Ang model_url file ay higit sa 100 MB at may higit sa 10,000,000 faces. Bawasan ang bilang ng face, pagkatapos ay ipadala muli ang file.
• ASCII FBX over 100 MB: Ang model_url file ay isang ASCII FBX na higit sa 100 MB. Ipadala ito bilang binary FBX o GLB.
• Unreadable model file: Ang model_url file ay higit sa 100 MB, at hindi mabasa ni Meshy ang header nito. Halimbawa, ito ay isang Draco-compressed GLB o glTF, o isang binary FBX na mas luma sa 7.1.
• Model header too complex: Ang model_url file ay higit sa 100 MB, at ang header nito ay may napakaraming meshes, nodes, o records para suriin. Bawasan ang bilang ng mga object sa file, pagkatapos ay ipadala muli ito.
• Image too large: Ang image_style_url na larawan o isang multiview_image_urls na larawan ay higit sa 20 MB.

Gamit ang meshy-n1, ang model na hindi masuri ni Meshy bago magsimula ang task, tulad ng STL file, ay hindi tatanggihan dito. Kung ito ay may higit sa 7,999,999 triangles, mabibigo ang task, at ibabalik ni Meshy ang mga credits nito.

Ayusin ang request, pagkatapos ay ipadala ito muli. Tingnan ang Errors.

Nawawala o hindi wasto ang API key. Suriin ang Authorization header.

Halimbawa:

• Insufficient credits: Ang account ay walang sapat na credits para sa task na ito, o naabot ng account ang isang credit limit. Suriin ang iyong credit balanse, pagkatapos ay subukan muli.
• Free plan: Ang paglikha ng task ay nangangailangan ng bayad na plano. I-upgrade ang iyong plano sa iyong subscription settings, pagkatapos ay subukan muli.

Isa sa mga ito ang nangyari:

• Hinarang ng content moderation ang prompt o isang input na larawan. Baguhin ang input, pagkatapos ay subukan muli.
• Ang input_task_id ay isang bas-relief model, na hindi mate-textureng ng endpoint na ito. Ang mensahe ay This model type does not support this operation. Magpadala ng ibang model.

Ang input_task_id ay hindi tumutugma sa alinman sa iyong mga task. Suriin ang task ID, pagkatapos ay ipadala muli ang request.

Lumampas ka sa iyong rate limit. Maghintay, pagkatapos ay subukan muli. Tingnan ang Rate limits.

Ang task ID mula sa create response.

Ang ID ng task na ide-delete.

Ang numero ng pahina na ibabalik, hanggang 255. Ang mas malaking halaga ay magbabalik ng 400.

Ang bilang ng mga gawain bawat pahina, hanggang 100.

Ang pagkakasunod-sunod ng pag-uuri.

Mga magagamit na halaga:

• +created_at: pinakaluma muna
• -created_at: pinakabago muna

Ang task ID mula sa create response.

Ang task ID. Ituring itong isang opaque string, at huwag umasa sa format nito.

Ang uri ng task, laging retexture.

Mga download URL para sa na-texture na 3D model, isa para sa bawat file format.

Ang text prompt na ginamit mo noong ginawa ang task.

Ang style image na ginamit mo noong ginawa ang task.

Mga download URL para sa multi-view reference images na ginamit mo noong ginawa ang task. Naroroon lamang kapag ginawa mo ang task gamit ang multiview_image_urls.

Download URL para sa thumbnail image ng model.

Download URL para sa isang bersyon ng thumbnail_url na may transparent na background (RGBA). Naroroon lamang kapag ginawa mo ang task gamit ang alpha_thumbnail: true at na-render ni Meshy ang transparent na preview.

Gaano na katapos ang task, bilang isang porsyento. Ito ay 0 hanggang magsimula ang task at 100 kapag nagtagumpay ito.

Oras na nagsimula ang task, sa Unix milliseconds. Ito ay 0 hanggang magsimula ang task.

Oras na nagawa ang task, sa Unix milliseconds.

Oras na mag-e-expire ang mga resulta ng task, sa Unix milliseconds.

Oras na natapos ang task, sa Unix milliseconds. Ito ay 0 hanggang matapos ang task.

Ang status ng task, isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, o CANCELED.

Mga download URL para sa mga na-generate na texture, bilang isang array ng mga object. Karaniwang isang object lamang ang nakapaloob sa array. Ang bawat object ay may mga sumusunod na field:

Ang bilang ng mga task na nauuna sa queue bago ang task na ito. Naroroon lamang habang PENDING ang task; inaalis ang field kapag 0 ang value.

Ang detalye ng error kapag nabigo ang task. Tingnan ang Errors.

Ang bilang ng credits na ginamit ng task. Naroroon kapag ang status ay PENDING, IN_PROGRESS, o SUCCEEDED. Ito ay 0 para sa isang FAILED na task, dahil ibinabalik ni Meshy ang credits kapag nabigo ang isang task.