Retexture API

Ang Retexture API ay isang feature na nagbibigay-daan sa iyo na isama ang mga kakayahan ng Meshy sa AI retexturing sa iyong sariling application. Sa seksyong ito, matutagpuan mo ang lahat ng impormasyon na kailangan mo upang makapagsimula sa API na ito.

POST/openapi/v1/retexture

Create a Retexture Task

Ang endpoint na ito ay nagbibigay-daan sa iyong gumawa ng bagong Retexture task. Tingnan ang The Retexture Task Object para makita kung aling mga property ang kasama sa Retexture task object.

Tumatakbo ang task sa background. Para malaman kung gaano karaming oras karaniwang inaabot nito, tingnan ang Processing Times.

Mga Parameter

Isa lang sa input_task_id o model_url ang kinakailangan. Kung parehong ibinigay, ang input_task_id ang mauuna.

Name
input_task_id
Type
string
Kinakailangan
Description
Ang ID ng nakumpletong Image to 3D o Text to 3D task na nais mong i-retexture. Ang task na ito ay dapat isa sa mga sumusunod: Text to 3D Preview, Text to 3D Refine, Image to 3D, o Remesh. Bukod dito, dapat itong may status na SUCCEEDED.

Name
model_url
Type
string
Kinakailangan
Description
Magbigay ng 3D model para i-texture ng Meshy. Sinusuportahang mga format: .glb, .gltf, .obj, .fbx, .stl.
Maximum na laki ng file: 100 MB.
May dalawang paraan para magbigay ng model:
- Publicly accessible URL: Isang URL na naa-access mula sa pampublikong internet.
- Data URI: Isang base64-encoded data URI ng model. Gamitin ang MIME type na application/octet-stream. Halimbawa: data:application/octet-stream;base64,<your base64-encoded model data>.

Isa lang na style input ang kinakailangan: text_style_prompt, image_style_url, o multiview_image_urls. Ang multiview_image_urls ay hindi maaaring isama kasama ang alinman sa dalawang iba pa; kung parehong ibinigay ang text_style_prompt at image_style_url, ang image_style_url ang mauuna.

Name
text_style_prompt
Type
string
Kinakailangan
Description
Ilarawan gamit ang text ang gusto mong texture style ng object. Maximum na 800 characters.

Name
image_style_url
Type
string
Kinakailangan
Description
Magbigay ng 2d na larawan para gabayan ang proseso ng pag-texture. Kasalukuyan naming sinusuportahan ang mga format na .jpg, .jpeg, .png, at .webp.
Maximum na laki ng file: 20 MB.
May dalawang paraan para magbigay ng larawan:
- Publicly accessible URL: Isang URL na naa-access mula sa pampublikong internet
- Data URI: Isang base64-encoded data URI ng larawan. Halimbawa ng data URI: data:image/jpeg;base64,<your base64-encoded image data>
Maaaring hindi gumana nang optimal ang pag-texture ng larawan kung may malaking pagkakaiba sa heometriya sa pagitan ng orihinal na asset at ng in-upload na larawan.

Name
multiview_image_urls
Type
string[]
Kinakailangan
Description
Magbigay ng 1 hanggang 4 na larawan na nagpapakita ng parehong object mula sa iba't ibang anggulo para gabayan ang pag-texture. Ang unang larawan ang pangunahing (harap) na view; ang pagkakasunod-sunod ng natitirang views (kaliwa, likod, kanan) ay hindi mahalaga.
Ang bawat elemento ay tumatanggap ng parehong mga format gaya ng image_style_url (isang publicly accessible URL o isang base64 data URI, .jpg/.jpeg/.png/.webp).
Maximum na laki ng file: 20 MB bawat larawan.
Kailangan ng tahasang ai_model: "meshy-7".

Name
ai_model
Type
string
default latest
Description
ID ng AI model na gagamitin para sa retexturing. Mga available na value: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).
Name
enable_original_uv
Type
boolean
default false
Description
Panatilihin ang kasalukuyang UV layout ng model sa halip na gumawa ng bago.
- Kung nagre-retexture ka ng model na ginawa ng Meshy (sa pamamagitan ng input_task_id, o isang model_url na tumutukoy sa output ng Meshy), itakda ito sa true para 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 magandang UV na gusto mong panatilihin, o iwanan itong false para hayaang mag-unwrap ang Meshy ng bagong UV (pinakamainam para sa mga model na kulang sa tamang UV mapping).
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-6-lite, meshy-7 at latest ay hindi gumagawa ng emission map.
Name
texture_resolution
Type
string
default 2k
Description
Resolution ng base color texture. Isa sa 2k (2048×2048), 4k (4096×4096), o 8k (8192×8192). Ang mas mataas na resolution ay nagkukuha ng mas maraming detalye sa ibabaw.
Kailangan ng 4k at 8k ang ai_model na meshy-6, meshy-7 o latest. Sa 8k, walang gagawing emission map.
Name
hd_texture
Type
boolean
⚠ lipas na
default false
Description
Gamitin na lang ang texture_resolution — katumbas ito ng texture_resolution: "4k". Kapag parehong itinakda, ang texture_resolution ang mangingibabaw.
Name
remove_lighting
Type
boolean
default true
Description
Inaalis ang mga highlight at anino mula sa base color texture, na nagbubunga ng mas malinis na resulta na mas gumagana nang maayos sa custom na lighting setup.
Sinusuportahan lamang kapag ang ai_model ay meshy-6.
Name
target_formats
Type
string[]
Description
Tinutukoy kung aling mga 3D file format ang isasama sa output. Tanging ang mga hiniling na format lamang ang gagawin at ibabalik, na maaaring magpaikli sa oras ng pagkumpleto ng task. Kapag hindi itinakda, lahat ng sinusuportahang format ang isinasama.
Mga available na value: glb, obj, fbx, stl, usdz, 3mf
Kapag hindi itinakda, lahat ng format maliban sa 3mf ang gagawin. Ang 3mf ay isinasama lamang kapag tahasang itinakda.
Name
alpha_thumbnail
Type
boolean
default false
Description
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 field na thumbnail_url ay hindi nagbabago.

Mga Ibabalik

Ang property na result ng response ay naglalaman ng task id ng bagong ginawang Retexture task.

Mga Mode ng Kabiguan

Name
400 - Bad Request
Description
Hindi katanggap-tanggap ang request. Karaniwang mga dahilan:
- Kulang na parameter: Dapat ibigay ang model_url o input_task_id.
- Kulang na style: Dapat ibigay ang isa sa text_style_prompt, image_style_url o multiview_image_urls.
- Nagkokonplikto na style input: Hindi maaaring isama ang multiview_image_urls kasama ang text_style_prompt o image_style_url.
- Hindi sinusuportahang model para sa multi-view: Kailangan ng multiview_image_urls ng tahasang ai_model: "meshy-7".
- Hindi available ang model: Ang ai_model: "meshy-7" at ai_model: "meshy-6-lite" ay ginagawang available nang unti-unti at maaaring hindi pa naka-enable para sa iyong account.
- Di-wastong input task: Ang input_task_id ay dapat tumukoy sa isang matagumpay na task mula sa isang sinusuportahang model.
- Di-wastong format ng model: Ang model_url ay tumuturo sa isang file na may hindi sinusuportahang extension.
- Hindi naa-access na URL: Ang model_url, image_style_url o isang elemento ng multiview_image_urls ay hindi ma-download.
- Masyadong malaki ang model file: Ang file sa model_url ay lumampas sa 100 MB.
- Masyadong malaki ang larawan: Ang larawan sa image_style_url o isang elemento ng multiview_image_urls ay lumampas sa 20 MB.
Name
401 - Unauthorized
Description
Nabigo ang authentication. Pakisuri ang iyong API key.
Name
402 - Payment Required
Description
Hindi sapat na credits para isagawa ang task na ito.
Name
429 - Too Many Requests
Description
Lumampas ka na sa iyong rate limit.

Request

POST

/openapi/v1/retexture

# Retexture with text prompt
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "enable_original_uv": true,
    "enable_pbr": true
  }'

# Retexture with image style and PBR
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "image_style_url": "https://cdn.meshy.ai/image/example_image.jpg",
    "ai_model": "latest",
    "enable_pbr": true,
    "enable_original_uv": true
  }'

Response

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

GET/openapi/v1/retexture/:id

Kunin ang Isang Retexture Task

Ang endpoint na ito ay nagbibigay-daan sa iyo upang kunin ang isang Retexture task gamit ang balidong task id. Sumangguni sa The Retexture Task Object upang makita kung aling mga property ang kasama sa Retexture task object.

Mga Parameter

Name
id
Type
path
Description
Natatanging identifier para sa Retexture task na kukunin.

Mga Ibinabalik

Ang tugon ay naglalaman ng Retexture task object. Tingnan ang The Retexture Task Object na seksyon para sa mga detalye.

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578

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

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "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=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "texture_image_url": "",
  "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"
    }
  ],
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

DELETE/openapi/v1/retexture/:id

Burahin ang Retexture Task

Ang endpoint na ito ay permanenteng magbubura ng retexture task, kasama na ang lahat ng kaugnay na mga modelo at data. Hindi na maibabalik ang aksyong ito.

Mga Path Parameter

Name
id
Type
path
Description
Ang ID ng retexture task na ibubura.

Status ng Task

Ang task na PENDING pa ay buburahin at ang mga credits na nagamit noong itong ginawa ay irerefund.

Ang task na IN_PROGRESS na ay hindi na maaaring burahin: ang request ay ire-reject na may 409 Conflict at magpapatuloy pa rin ang pagtakbo ng task. Ang mga credits para sa task na nasimulan na ng worker ay hindi na maaaring i-refund, kaya kung burahin ito habang tumatakbo ay mawawala sa iyo ang mga credits at ang resulta. Maghintay hanggang umabot ito sa SUCCEEDED, FAILED o CANCELED, saka mo lang ito burahin.

Ang task na nasa terminal state (SUCCEEDED, FAILED o CANCELED) ay buburahin nang walang refund.

Mga Ibabalik

Ibabalik ang 200 OK kapag matagumpay, o 409 Conflict kapag ang task ay IN_PROGRESS.

Request

DELETE

/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS — the task is left running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

GET/openapi/v1/retexture

List Retexture Tasks

Ang endpoint na ito ay nagbibigay-daan sa iyo na kumuha ng listahan ng mga Retexture task.

Mga Parameter

Name
page_num
Type
integer
default 1
Description
Numero ng page para sa pagination.
Name
page_size
Type
integer
default 10
Description
Limitasyon ng laki ng page. Ang pinakamataas na pinapayagan ay 100 items.
Name
sort_by
Type
string
Description
Field na gagamitin sa pag-sort.
Mga available na value:
- +created_at: Isaayos ayon sa oras ng paggawa nang tumataas (ascending).
- -created_at: Isaayos ayon sa oras ng paggawa nang bumababa (descending).

Ibinabalik

Ibinabalik ang isang pinaged na listahan ng The Retexture Task Objects.

Request

GET

/openapi/v1/retexture

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

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "retexture",
    "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=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "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": 10
  }
]

GET/openapi/v1/retexture/:id/stream

I-stream ang Retexture Task

Ang endpoint na ito ay nag-stream ng real-time updates para sa isang Retexture task gamit ang Server-Sent Events (SSE).

Mga Parameter

Name
id
Type
path
Description
Ang natatanging identifier para sa Retexture task na i-stream.

Ibinabalik

Nagbabalik ng stream ng The Retexture Task Objects bilang Server-Sent Events.

Para sa mga task na PENDING o IN_PROGRESS, ang response stream ay maglalaman lamang ng mga kinakailangang field na progress at status.

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream

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

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "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=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "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": 10
}

Ang Retexture Task Object

Ang Retexture Task object ay isang yunit ng trabaho na ginagamit ng Meshy upang bumuo ng 3D texture mula sa alinman sa mga input na text o image. Ang modelo ay may mga sumusunod na katangian:

Mga Katangian

Name
id
Type
string
Description
Natatanging identifier para sa task. Habang gumagamit kami ng k-sortable UUID para sa mga task id bilang detalye ng implementasyon, hindi ka dapat gumawa ng anumang palagay tungkol sa format ng id.
Name
type
Type
string
Description
Uri ng Retexture task. Ang value ay retexture.
Name
model_urls
Type
object
Description
Downloadable na URL sa textured na 3D model file na binuo ng Meshy.
- 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, na ibinabalik kasama ng mga OBJ export kapag may mga texture.
- Name
  stl
  Type
  string
  Description
  Downloadable na URL sa STL file.
- Name
  3mf
  Type
  string
  Description
  Downloadable na URL sa 3MF file. Naririto lamang kapag hiniling ang 3mf sa pamamagitan ng target_formats.
Name
text_style_prompt
Type
string
Description
Ito ang text prompt na ginamit upang gumawa ng texturing task.
Name
image_style_url
Type
string
Description
Ito ang image input na ginamit upang gumawa ng texturing task.
Name
multiview_image_urls
Type
string[]
Description
Downloadable na mga URL sa mga multi-view reference image na ginamit upang gumawa ng texturing task. Naririto lamang kapag ang task ay ginawa gamit ang multiview_image_urls.
Name
thumbnail_url
Type
string
Description
Downloadable na URL sa thumbnail na larawan ng model file.
Name
alpha_thumbnail_url
Type
string
Description
Downloadable na URL sa isang transparent-background (RGBA) na bersyon ng thumbnail_url. Naririto lamang kapag ang task ay ginawa gamit ang alpha_thumbnail: true at matagumpay na na-render ang transparent na preview; kung hindi, ang field na ito ay hindi isasama.
Name
progress
Type
integer
Description
Progress ng task. Kung hindi pa nasisimulan ang task, ang property na ito ay magiging 0. Kapag nagtagumpay na ang task, ito ay magiging 100.
Name
started_at
Type
timestamp
Description
Timestamp kung kailan sinimulan ang task, sa milliseconds. Kung hindi pa nasisimulan ang task, ang property na ito ay magiging 0.
Ang isang timestamp ay kumakatawan sa bilang ng mga milliseconds na lumipas mula Enero 1, 1970 UTC, ayon sa RFC 3339 na pamantayan. Halimbawa, Biyernes, Setyembre 1, 2023 12:00:00 PM GMT ay kinakatawan bilang 1693569600000. Ito ay naaangkop sa lahat ng timestamp sa Meshy API.
Name
created_at
Type
timestamp
Description
Timestamp kung kailan ginawa ang task, sa milliseconds.
Name
expires_at
Type
timestamp
Description
Timestamp kung kailan mag-e-expire ang resulta ng task, sa milliseconds.
Name
finished_at
Type
timestamp
Description
Timestamp kung kailan natapos ang task, sa milliseconds. Kung hindi pa natatapos ang task, ang property na ito ay magiging 0.
Name
status
Type
string
Description
Status ng task. Ang mga posibleng value ay isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
texture_urls
Type
array
Description
Isang array ng mga texture URL object na binuo mula sa task. Karaniwan, iisang texture URL object lamang ang nilalaman nito. Ang bawat texture URL ay may mga sumusunod na katangian:
- Name
  base_color
  Type
  string
  Description
  Downloadable na URL sa base color map na larawan.
- Name
  metallic
  Type
  string
  Description
  Downloadable na URL sa metallic map na larawan.
  Kung ang task ay ginawa gamit ang enable_pbr: false, ang property na ito ay hindi isasama.
- Name
  normal
  Type
  string
  Description
  Downloadable na URL sa normal map na larawan.
  Kung ang task ay ginawa gamit ang enable_pbr: false, ang property na ito ay hindi isasama.
- Name
  roughness
  Type
  string
  Description
  Downloadable na URL sa roughness map na larawan.
  Kung ang task ay ginawa gamit ang enable_pbr: false, ang property na ito ay hindi isasama.
- Name
  emission
  Type
  string
  Description
  Downloadable na URL sa emission map na larawan.
  Kung ang task ay ginawa gamit ang enable_pbr: false, o meshy-6-lite ang ai_model, ang property na ito ay hindi isasama.
Name
preceding_tasks
Type
integer
Description
Ang bilang ng mga naunang task.
Ang property na ito ay naririto lamang kapag 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 reperensya ng task_error object.
Name
consumed_credits
Type
integer
Description
Ang bilang ng mga credit na nagamit ng task na ito. Naririto kapag ang status ng task ay PENDING, IN_PROGRESS, o SUCCEEDED. Nagbabalik ng 0 para sa mga FAILED na task (ang mga credit ay ire-refund kapag nabigo).

Example Retexture Task Model

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "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=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
  },
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "image_style_url": "https://assets.meshy.ai/***/image/example_image.jpg?Expires=***",
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "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": 10
}