Retexture API

Retexture API ialah ciri yang membolehkan anda mengintegrasikan keupayaan AI retekstur Meshy ke dalam aplikasi anda sendiri. Dalam bahagian ini, anda akan menemui semua maklumat yang anda perlukan untuk bermula dengan API ini.

POST/openapi/v1/retexture

Cipta Tugas Retekstur

Endpoint ini membolehkan anda mencipta tugas Retekstur baharu. Rujuk Objek Tugas Retekstur untuk melihat sifat-sifat yang disertakan dengan objek tugas Retekstur.

Tugas ini berjalan di latar belakang. Untuk tempoh masa yang biasanya diambil, lihat Masa Pemprosesan.

Parameter

Hanya salah satu daripada input_task_id atau model_url yang diperlukan. Jika kedua-duanya disediakan, input_task_id diutamakan.

Name
input_task_id
Type
string
Diperlukan
Description
ID tugas Imej ke 3D atau Teks ke 3D yang telah selesai yang anda ingin retekstur. Tugas ini mestilah salah satu daripada tugas berikut: Teks ke 3D Preview, Teks ke 3D Refine, Imej ke 3D atau Remesh. Selain itu, ia mesti mempunyai status SUCCEEDED.

Name
model_url
Type
string
Diperlukan
Description
Sediakan model 3D untuk Meshy tekstur. Format yang disokong: .glb, .gltf, .obj, .fbx, .stl.
Saiz fail maksimum: 400 MB untuk URL http atau https, 100 MB untuk data: URI.
Fail GLB, glTF, FBX atau OBJ yang melebihi 100 MB boleh mempunyai paling banyak 10,000,000 muka. Muka dikira sebagai segi tiga: segi empat dikira sebagai 2, dan jejaring yang dilukis lebih daripada sekali dikira sekali bagi setiap salinan. Melebihi 100 MB, fail FBX mesti dalam bentuk binary FBX 7.1 atau lebih baharu, dan fail GLB atau glTF tidak boleh menggunakan pemampatan Draco.
Terdapat dua cara untuk menyediakan model:
- URL yang boleh diakses secara awam: URL yang boleh diakses daripada internet awam.
- Data URI: Data URI model yang dikodkan base64. Gunakan MIME type application/octet-stream. Contoh: data:application/octet-stream;base64,<data model terkod base64 anda>.

Tepat satu input gaya diperlukan: text_style_prompt, image_style_url, atau multiview_image_urls. multiview_image_urls tidak boleh digabungkan dengan mana-mana satu daripada dua yang lain; jika kedua-dua text_style_prompt dan image_style_url disediakan, image_style_url diutamakan.

Name
text_style_prompt
Type
string
Diperlukan
Description
Terangkan gaya tekstur objek yang anda inginkan menggunakan teks. Maksimum 800 aksara.

Name
image_style_url
Type
string
Diperlukan
Description
Sediakan imej 2D untuk membimbing proses tekstur. Kami kini menyokong format .jpg, .jpeg, .png, dan .webp.
Saiz fail maksimum: 20 MB.
Terdapat dua cara untuk menyediakan imej:
- URL yang boleh diakses secara awam: URL yang boleh diakses daripada internet awam
- Data URI: Data URI imej yang dikodkan base64. Contoh data URI: data:image/jpeg;base64,<data imej terkod base64 anda>
Tekstur imej mungkin tidak berfungsi secara optimum jika terdapat perbezaan geometri yang ketara antara aset asal dan imej yang dimuat naik.

Name
multiview_image_urls
Type
string[]
Diperlukan
Description
Sediakan 1 hingga 4 imej yang menunjukkan objek yang sama daripada pandangan yang berbeza untuk membimbing tekstur. Imej pertama ialah pandangan utama (hadapan); susunan pandangan yang selebihnya (kiri, belakang, kanan) tidak penting.
Setiap elemen menerima format yang sama seperti image_style_url (URL yang boleh diakses secara awam atau data URI base64, .jpg/.jpeg/.png/.webp).
Saiz fail maksimum: 20 MB setiap imej.
Memerlukan ai_model: "meshy-7" secara eksplisit.

Name
ai_model
Type
string
lalai latest
Description
ID model AI yang digunakan untuk retekstur. Nilai yang tersedia: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).
Name
enable_original_uv
Type
boolean
lalai false
Description
Kekalkan susun atur UV model yang sedia ada dan bukannya menjana yang baharu.
- Jika anda retekstur model yang dijana oleh Meshy (melalui input_task_id, atau model_url yang menunjuk kepada output Meshy), tetapkan ini kepada true untuk menggunakan semula susun atur UV yang dioptimumkan.
- Jika anda retekstur model pihak ketiga yang anda muat naik, tetapkan true apabila ia sudah mempunyai UV yang baik yang ingin anda kekalkan, atau biarkan false untuk membiarkan Meshy membuka UV baharu (terbaik untuk model yang tidak mempunyai pemetaan UV yang betul).
Name
enable_pbr
Type
boolean
lalai false
Description
Jana peta PBR (metallic, roughness, normal) sebagai tambahan kepada warna asas. Peta emisi turut disertakan apabila ai_model ialah meshy-6, kecuali pada texture_resolution: 8k. meshy-6-lite, meshy-7 dan latest tidak menghasilkan peta emisi.
Name
texture_resolution
Type
string
lalai 2k
Description
Resolusi tekstur warna asas. Salah satu daripada 2k (2048×2048), 4k (4096×4096), atau 8k (8192×8192). Resolusi yang lebih tinggi merakam lebih banyak perincian permukaan.
4k dan 8k memerlukan ai_model meshy-6, meshy-7 atau latest. Pada 8k, tiada peta emisi dihasilkan.
Name
hd_texture
Type
boolean
⚠ lapuk
lalai false
Description
Gunakan texture_resolution sebagai gantinya — setara dengan texture_resolution: "4k". Apabila kedua-duanya ditetapkan, texture_resolution diutamakan.
Name
remove_lighting
Type
boolean
lalai true
Description
Mengalih keluar sorotan dan bayang daripada tekstur warna asas, menghasilkan keputusan yang lebih bersih yang berfungsi dengan lebih baik di bawah persediaan pencahayaan tersuai.
Hanya digunakan apabila ai_model ialah meshy-6 dan texture_resolution ialah 2k atau 4k. Dengan meshy-7 atau latest, dan pada 8k, ia diterima tetapi diabaikan. Dengan meshy-6-lite, menghantarnya dengan sebarang nilai akan mengembalikan 400.
Name
target_formats
Type
string[]
Description
Menentukan format fail 3D yang hendak disertakan dalam output. Hanya format yang diminta akan dijana dan dikembalikan, yang boleh mengurangkan masa penyiapan tugas. Apabila ditinggalkan, semua format yang disokong akan disertakan.
Nilai yang tersedia: glb, obj, fbx, stl, usdz, 3mf
Apabila ditinggalkan, semua format kecuali 3mf dijana. 3mf hanya disertakan apabila dinyatakan secara eksplisit.
Name
alpha_thumbnail
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, tugas ini juga akan merender versi latar belakang telus (RGBA) bagi pratonton dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Medan thumbnail_url yang sedia ada kekal tidak berubah.

Pulangan

Sifat result dalam respons mengandungi id tugas bagi tugas Retekstur yang baharu dicipta.

Mod Kegagalan

Name
400 - Bad Request
Description
Permintaan tidak dapat diterima. Punca biasa:
- Parameter hilang: Sama ada model_url atau input_task_id mesti disediakan.
- Gaya hilang: Salah satu daripada text_style_prompt, image_style_url atau multiview_image_urls mesti disediakan.
- Input gaya bercanggah: multiview_image_urls tidak boleh digabungkan dengan text_style_prompt atau image_style_url.
- Model tidak disokong untuk berbilang pandangan: multiview_image_urls memerlukan ai_model: "meshy-7" secara eksplisit.
- Model tidak tersedia: ai_model: "meshy-7" dan ai_model: "meshy-6-lite" sedang dilancarkan secara berperingkat dan mungkin belum didayakan untuk akaun anda.
- Tugas input tidak sah: input_task_id mesti merujuk kepada tugas yang berjaya daripada model yang disokong.
- Format model tidak sah: model_url menunjuk kepada fail dengan sambungan yang tidak disokong.
- URL tidak boleh dicapai: model_url, image_style_url atau elemen multiview_image_urls tidak dapat dimuat turun.
- Fail model terlalu besar: Fail model_url melebihi 400 MB (URL http atau https) atau 100 MB (data: URI).
- Terlalu banyak muka: Fail model_url melebihi 100 MB dan mempunyai lebih daripada 10,000,000 muka. Kurangkan bilangan muka, kemudian hantar fail itu semula.
- ASCII FBX melebihi 100 MB: Fail model_url ialah ASCII FBX yang melebihi 100 MB. Hantar sebagai binary FBX atau GLB.
- Fail model tidak boleh dibaca: Fail model_url melebihi 100 MB dan headernya tidak dapat dibaca, contohnya GLB atau glTF yang dimampatkan Draco, atau binary FBX yang lebih lama daripada 7.1.
- Header model terlalu kompleks: Fail model_url melebihi 100 MB dan headernya mempunyai terlalu banyak jejaring, nod atau rekod untuk disemak. Kurangkan bilangan objek dalam fail, kemudian hantar semula.
- Imej terlalu besar: Imej image_style_url atau elemen multiview_image_urls melebihi 20 MB.
Name
401 - Unauthorized
Description
Pengesahan gagal. Sila semak kunci API anda.
Name
402 - Payment Required
Description
Kredit tidak mencukupi untuk melaksanakan tugas ini.
Name
429 - Too Many Requests
Description
Anda telah melebihi had kadar anda.

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": "<your publicly accessible image url or base64-encoded data URI>",
    "ai_model": "latest",
    "enable_pbr": true,
    "enable_original_uv": true
  }'

Response

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

GET/openapi/v1/retexture/:id

Dapatkan Tugas Retekstur

Endpoint ini membolehkan anda mendapatkan tugas Retekstur berdasarkan id tugas yang sah. Rujuk The Retexture Task Object untuk melihat sifat-sifat yang disertakan dengan objek tugas Retekstur.

Parameter

Name
id
Type
path
Description
Pengecam unik untuk tugas Retekstur yang hendak didapatkan.

Nilai Dikembalikan

Respons mengandungi objek tugas Retekstur. Semak bahagian The Retexture Task Object untuk maklumat lanjut.

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"
    }
  ],
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

DELETE/openapi/v1/retexture/:id

Padam Tugas Retekstur

Endpoint ini memadam tugas retekstur secara kekal, termasuk semua model dan data yang berkaitan. Tindakan ini tidak boleh diubah semula.

Parameter Laluan

Name
id
Type
path
Description
ID tugas retekstur yang hendak dipadam.

Status Tugas

Tugas yang masih PENDING akan dipadam dan kredit yang digunakan pada masa penciptaan akan dikembalikan.

Tugas yang sudah IN_PROGRESS tidak boleh dipadam: permintaan akan ditolak dengan 409 Conflict dan tugas tersebut akan terus berjalan. Kredit untuk tugas yang pekerja (worker) sudah mula proses tidak boleh dikembalikan, jadi memadamnya semasa ia berjalan akan menyebabkan anda kehilangan kredit dan juga hasilnya. Tunggu sehingga ia mencapai status SUCCEEDED, FAILED atau CANCELED, kemudian padamkannya.

Tugas yang berada dalam keadaan terminal (SUCCEEDED, FAILED atau CANCELED) akan dipadam tanpa bayaran balik.

Pulangan

Mengembalikan 200 OK apabila berjaya, atau 409 Conflict apabila tugas berstatus 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

Senaraikan Tugas Retekstur

Endpoint ini membolehkan anda mendapatkan senarai tugas Retekstur.

Parameter

Name
page_num
Type
integer
lalai 1
Description
Nombor halaman untuk penomboran halaman.
Name
page_size
Type
integer
lalai 10
Description
Had saiz halaman. Maksimum yang dibenarkan ialah 100 item.
Name
sort_by
Type
string
Description
Medan untuk disusun.
Nilai yang tersedia:
- +created_at: Susun mengikut masa penciptaan secara menaik.
- -created_at: Susun mengikut masa penciptaan secara menurun.

Pulangan

Mengembalikan senarai berhalaman bagi 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"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 10
  }
]

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

Strim Tugas Retekstur

endpoint ini menstrim kemas kini masa nyata untuk tugas Retekstur menggunakan Server-Sent Events (SSE).

Parameter

Name
id
Type
path
Description
Pengecam unik untuk tugas Retekstur yang hendak distrim.

Hasil

Mengembalikan strim Objek Tugas Retekstur sebagai Server-Sent Events.

Bagi tugas PENDING atau IN_PROGRESS, strim respons hanya akan menyertakan medan progress dan status yang diperlukan.

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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

The Retexture Task Object

Objek Retexture Task ialah unit kerja yang digunakan oleh Meshy untuk menjana tekstur 3D daripada input teks atau imej. Model ini mempunyai ciri-ciri berikut:

Ciri-ciri

Name
id
Type
string
Description
Pengecam unik untuk tugasan. Walaupun kami menggunakan UUID yang boleh disusun-k (k-sortable) untuk id tugasan sebagai butiran pelaksanaan, anda tidak seharusnya membuat sebarang andaian tentang format id tersebut.
Name
type
Type
string
Description
Jenis tugasan Retexture. Nilainya ialah retexture.
Name
model_urls
Type
object
Description
URL boleh muat turun untuk fail model 3D bertekstur yang dijana oleh Meshy.
- Name
  glb
  Type
  string
  Description
  URL boleh muat turun untuk fail GLB.
- Name
  fbx
  Type
  string
  Description
  URL boleh muat turun untuk fail FBX.
- Name
  obj
  Type
  string
  Description
  URL boleh muat turun untuk fail OBJ.
- Name
  usdz
  Type
  string
  Description
  URL boleh muat turun untuk fail USDZ.
- Name
  mtl
  Type
  string
  Description
  URL boleh muat turun untuk fail MTL, dikembalikan bersama eksport OBJ apabila tekstur wujud.
- Name
  stl
  Type
  string
  Description
  URL boleh muat turun untuk fail STL.
- Name
  3mf
  Type
  string
  Description
  URL boleh muat turun untuk fail 3MF. Hanya wujud apabila 3mf diminta melalui target_formats.
Name
text_style_prompt
Type
string
Description
Ini ialah prompt teks yang digunakan untuk mencipta tugasan tekstur ini.
Name
image_style_url
Type
string
Description
Ini ialah input imej yang digunakan untuk mencipta tugasan tekstur ini.
Name
multiview_image_urls
Type
string[]
Description
URL boleh muat turun untuk imej rujukan Berbilang Pandangan yang digunakan untuk mencipta tugasan tekstur ini. Hanya wujud apabila tugasan dicipta dengan multiview_image_urls.
Name
thumbnail_url
Type
string
Description
URL boleh muat turun untuk imej kecil bagi fail model.
Name
alpha_thumbnail_url
Type
string
Description
URL boleh muat turun untuk versi latar belakang lutsinar (RGBA) bagi thumbnail_url. Hanya wujud apabila tugasan dicipta dengan alpha_thumbnail: true dan pratonton lutsinar berjaya dijana; jika tidak, medan ini akan ditiadakan.
Name
progress
Type
integer
Description
Kemajuan tugasan. Jika tugasan belum bermula, ciri ini akan menjadi 0. Setelah tugasan berjaya, ini akan menjadi 100.
Name
started_at
Type
timestamp
Description
Cap masa bila tugasan bermula, dalam milisaat. Jika tugasan belum bermula, ciri ini akan menjadi 0.
Cap masa mewakili bilangan milisaat yang berlalu sejak 1 Januari 1970 UTC, mengikut piawaian RFC 3339. Sebagai contoh, Jumaat, 1 September 2023 12:00:00 PM GMT diwakili sebagai 1693569600000. Ini terpakai kepada semua cap masa dalam Meshy API.
Name
created_at
Type
timestamp
Description
Cap masa bila tugasan dicipta, dalam milisaat.
Name
expires_at
Type
timestamp
Description
Cap masa bila keputusan tugasan akan luput, dalam milisaat.
Name
finished_at
Type
timestamp
Description
Cap masa bila tugasan selesai, dalam milisaat. Jika tugasan belum selesai, ciri ini akan menjadi 0.
Name
status
Type
string
Description
Status tugasan. Nilai yang mungkin ialah salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
texture_urls
Type
array
Description
Satu tatasusunan objek URL tekstur yang dijana daripada tugasan ini. Biasanya ini hanya mengandungi satu objek URL tekstur. Setiap URL tekstur mempunyai ciri-ciri berikut:
- Name
  base_color
  Type
  string
  Description
  URL boleh muat turun untuk imej peta warna asas (base color).
- Name
  metallic
  Type
  string
  Description
  URL boleh muat turun untuk imej peta logam (metallic).
  Jika tugasan dicipta dengan enable_pbr: false, ciri ini akan ditiadakan.
- Name
  normal
  Type
  string
  Description
  URL boleh muat turun untuk imej peta normal.
  Jika tugasan dicipta dengan enable_pbr: false, ciri ini akan ditiadakan.
- Name
  roughness
  Type
  string
  Description
  URL boleh muat turun untuk imej peta kekasaran (roughness).
  Jika tugasan dicipta dengan enable_pbr: false, ciri ini akan ditiadakan.
- Name
  emission
  Type
  string
  Description
  URL boleh muat turun untuk imej peta pancaran (emission).
  Jika tugasan dicipta dengan enable_pbr: false, dengan ai_model meshy-6-lite, meshy-7 atau latest, atau dengan texture_resolution: 8k, ciri ini akan ditiadakan.
Name
preceding_tasks
Type
integer
Description
Bilangan tugasan terdahulu.
Ciri ini hanya wujud apabila status tugasan ialah PENDING.
Name
task_error
Type
object
Description
Butiran ralat untuk tugasan yang gagal. Lihat Ralat untuk rujukan penuh objek task_error.
Name
consumed_credits
Type
integer
Description
Bilangan kredit yang digunakan oleh tugasan ini. Wujud apabila status tugasan ialah PENDING, IN_PROGRESS, atau SUCCEEDED. Mengembalikan 0 untuk tugasan FAILED (kredit dikembalikan apabila gagal).

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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}