API Berbilang Imej ke 3D

API Berbilang Imej ke 3D adalah ciri yang membolehkan anda mengintegrasikan keupayaan Berbilang Imej ke 3D Meshy ke dalam aplikasi anda sendiri. Dalam bahagian ini, anda akan menemui semua maklumat yang anda perlukan untuk memulakan dengan API ini.

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

Buat Tugas Berbilang Imej ke 3D

Endpoint ini membolehkan anda membuat tugas Baharu Berbilang Imej ke 3D. Rujuk kepada Objek Tugas Berbilang Imej ke 3D untuk melihat sifat-sifat yang disertakan dengan objek tugas Berbilang Imej ke 3D.

Parameter

Hanya satu daripada input_task_id atau image_urls adalah diperlukan. Jika kedua-duanya disediakan, input_task_id akan mengambil keutamaan.

Name
input_task_id
Type
string
Diperlukan
Description
ID bagi tugas penjanaan imej yang telah selesai yang outputnya (1-4 imej) perlu digunakan sebagai input. Tugas ini mestilah salah satu daripada tugas berikut: Teks ke Imej, Imej ke Imej, Teks ke Imej Berbilang Pandangan, atau Imej ke Imej Berbilang Pandangan. Selain itu, ia mesti dijalankan melalui API dan mempunyai status SUCCEEDED.

Name
image_urls
Type
array
Diperlukan
Description
Berikan 1 hingga 4 imej untuk digunakan oleh Meshy dalam penciptaan model. Pada masa ini kami menyokong format .jpg, .jpeg, dan .png. Semua imej harus menggambarkan objek yang sama dari sudut yang berbeza untuk hasil terbaik.
Terdapat dua cara untuk menyediakan setiap imej:
- URL boleh diakses secara umum: URL yang boleh diakses dari internet awam.
- Data URI: Base64-encoded data URI bagi imej. Contoh data URI: data:image/jpeg;base64,<your base64-encoded image data>.
Untuk meshy-7 (atau latest), imej pertama digunakan sebagai pandangan utama (hadapan). Urutan imej selebihnya tidak penting.

Name
ai_model
Type
string
lalai latest
Description
ID model yang hendak digunakan. Nilai yang tersedia: meshy-5, meshy-6, meshy-7, latest (Meshy 7).
Name
should_texture
Type
boolean
lalai true
Description
Menentukan jika tekstur dihasilkan. Menetapkannya kepada false melangkau fasa tekstur, menyediakan jejaring tanpa tekstur.

Hanya berlaku apabila should_texture = true

Name
enable_pbr
Type
boolean
lalai false
Description
Menjana Peta PBR (logam, kekasaran, normal) selain warna asas. Peta pelepasan juga disertakan apabila ai_model ialah meshy-6, kecuali pada texture_resolution: 8k. meshy-7 dan latest tidak menghasilkan peta pelepasan.
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 menangkap lebih banyak butiran permukaan.
4k dan 8k memerlukan ai_model meshy-6, meshy-7 atau latest. Pada 8k, tiada peta pelepasan dihasilkan.
Name
hd_texture
Type
boolean
⚠ lapuk
lalai false
Description
Gunakan texture_resolution sebaliknya — bersamaan dengan texture_resolution: "4k". Apabila kedua-duanya ditetapkan, texture_resolution akan diutamakan.
Name
texture_prompt
Type
string
Description
Berikan prompt teks untuk membimbing proses pengecaman tekstur. Maksimum 600 aksara.
Name
texture_image_url
Type
string
Description
Berikan imej 2d untuk membimbing proses pengecaman tekstur. Pada masa ini kami menyokong format .jpg, .jpeg, dan .png.
Terdapat dua cara untuk menyediakan imej:
- URL boleh diakses secara umum: URL yang boleh diakses dari internet awam
- Data URI: Base64-encoded data URI bagi imej. Contoh data URI: data:image/jpeg;base64,<your base64-encoded image data>
Pengecaman tekstur imej mungkin tidak berfungsi secara optimum jika terdapat perbezaan geometri yang ketara antara aset asal dan imej yang dimuat naik. Hanya satu daripada texture_image_url atau texture_prompt yang boleh digunakan untuk membimbing proses pengecaman tekstur. Jika kedua-dua parameter disediakan, maka texture_prompt akan digunakan untuk menyamakan model secara lalai.

Name
should_remesh
Type
boolean
lalai false (meshy-6), true (others)
Description
Mengawal sama ada fasa remesh disediakan. Untuk model berkualiti tinggi, kami mengesyorkan mengatur should_remesh ke false.

Hanya berlaku apabila should_remesh = true

Name
topology
Type
string
lalai triangle
Description
Tentukan topologi model yang dihasilkan.
Nilai yang tersedia:
- quad: Hasilkan jejaring dominan quad.
- triangle: Hasilkan jejaring segi tiga terkurang.
Name
target_polycount
Type
integer
lalai 30,000
Description
Tentukan bilangan poligon sasaran dalam model yang dihasilkan. Jumlah sebenar poligon mungkin berbeza dari sasaran bergantung pada kerumitan geometri.
Julat nilai sah berbeza bergantung pada peringkat pengguna:
- 100 hingga 300,000 (termasuk)
Name
decimation_mode
Type
integer
Description
Aktifkan pengurusan adaptif dengan menetapkan tahap bilangan poligon. Apabila ditetapkan, target_polycount akan diabaikan.
Nilai yang tersedia:
- 1: Adaptif — bilangan poligon ultra.
- 2: Adaptif — bilangan poligon tinggi.
- 3: Adaptif — bilangan poligon sederhana.
- 4: Adaptif — bilangan poligon rendah.
Name
save_pre_remeshed_model
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, Meshy juga menyimpan fail GLB tambahan sebelum fasa remesh selesai.

Name
symmetry_mode
Type
string
⚠ lapuk
lalai auto
Description
Lapuk. Parameter ini tidak lagi mempengaruhi output.
medan symmetry_mode mengawal tingkah laku simetri semasa proses penjanaan model.
Nilai sah adalah:
- off: Menyahaktifkan simetri.
- auto: Menentukan dan menggunakan simetri secara automatik berdasarkan geometri input.
- on: Memaksa simetri semasa penjanaan.
Name
pose_mode
Type
string
lalai ""
Description
Tentukan mod pose untuk model yang dihasilkan.
Nilai yang tersedia:
- a-pose: Menjana model dalam pose A.
- t-pose: Menjana model dalam pose T.
- "" (rentetan kosong): Tiada pose khusus yang digunakan.
Name
is_a_t_pose
Type
boolean
⚠ lapuk
lalai false
Description
Gunakan pose_mode sebaliknya. Sama ada untuk menjana model dalam pose A/T.
Name
image_enhancement
Type
boolean
lalai true
Description
Mengoptimumkan imej input untuk hasil yang lebih baik. Tetapkan kepada false untuk mengekalkan rupa sebenar imej input tanpa sebarang pemprosesan gaya.
Hanya disokong apabila ai_model adalah meshy-6, meshy-7 atau latest.
Name
remove_lighting
Type
boolean
lalai true
Description
Mengeluarkan sorotan dan bayang-bayang dari tekstur warna asas, menghasilkan hasil yang lebih bersih yang berfungsi lebih baik di bawah setup pencahayaan khas.
Hanya disokong apabila ai_model adalah meshy-6, meshy-7 atau latest.
Name
moderation
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, kandungan input akan automatik diperiksa untuk kandungan yang berpotensi berbahaya. Jika kandungan yang berbahaya dikesan, tugas tidak akan diteruskan untuk penjanaan.
Setiap imej dari image_urls dan teks dari texture_prompt akan diperiksa.
Name
target_formats
Type
string[]
Description
Tentukan format fail 3D mana yang ingin disertakan dalam output. Hanya format yang diminta akan dihasilkan dan dipulangkan, yang dapat mengurangkan masa penyiapan tugas.
Nilai yang tersedia: glb, obj, fbx, stl, usdz, 3mf
Apabila diabaikan, semua format kecuali 3mf dihasilkan. 3mf hanya disertakan apabila diminta secara khusus.
Name
auto_size
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, perkhidmatan menggunakan visi AI untuk menganggarkan ketinggian sebenar objek secara automatik dan menyesuaikan saiz model. Titik asal akan ditetapkan ke bottom melainkan origin_at dinyatakan dengan tepat.
Name
alpha_thumbnail
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, tugas juga merender versi latar belakang lut (RGBA) bagi pratayangan dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Medan thumbnail_url sedia ada tetap tidak berubah.
Name
multi_view_thumbnails
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, tugas juga merender empat imej kecil pandangan kardin (hadapan, kanan, belakang, kiri) dan mengembalikannya di bawah thumbnail_urls pada respons GET. Medan thumbnail_url sedia ada tidak berubah dan terus menunjuk kepada pandangan hadapan, jadi klien sedia ada tidak terjejas.
Menambah kira-kira 3 saat kepada latensi tugas.

Hanya berlaku apabila auto_size = true

Name
origin_at
Type
string
lalai bottom
Description
Posisi titik asal apabila auto_size diaktifkan. Nilai yang tersedia: bottom, center.

Returns

Sifat result bagi respons mengandungi id tugas baharu Berbilang Imej ke 3D yang telah dicipta.

Failure Modes

Name
400 - Bad Request
Description
Permintaan tidak dapat diterima. Sebab yang biasa:
- Missing parameter: Sama ada image_urls atau input_task_id mesti disediakan.
- Invalid input task: input_task_id mesti merujuk kepada tugas Teks ke Imej, Imej ke Imej, atau variasi berbilang pandangan yang SUCCEEDED.
- Invalid image count: image_urls mesti mengandungi antara 1 dan 4 imej.
- Invalid image format: Satu atau lebih imej dalam image_urls bukan format yang disokong.
- Unreachable URL: Satu atau lebih image_urls tidak dapat dimuat turun.
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/multi-image-to-3d

# Permintaan ringkas
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": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ]
  }'

# Dengan pengecaman tekstur PBR dan format GLB
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": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or 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

Dapatkan Tugas Berbilang Imej ke 3D

Endpoint ini membolehkan anda mendapatkan tugas Berbilang Imej ke 3D yang diberikan id tugas yang sah. Rujuk kepada Objek Tugas Berbilang Imej ke 3D untuk melihat sifat-sifat yang disertakan dengan objek tugas Berbilang Imej ke 3D.

Parameter

Name
id
Type
path
Description
Pengenalpastian unik bagi tugas Berbilang Imej ke 3D untuk mendapatkan.

Returns

Respons mengandungi objek tugas Berbilang Imej ke 3D. Semak bahagian The Multi-Image to 3D Task Object untuk butiran.

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

Padamkan Tugas Berbilang Imej ke 3D

Endpoint ini memadamkan secara kekal tugas Berbilang Imej ke 3D, termasuk semua model dan data yang berkaitan. Tindakan ini tidak boleh dibatalkan.

Parameter Laluan

Name
id
Type
path
Description
ID tugas Berbilang Imej ke 3D untuk dipadamkan.

Returns

Mengembalikan 200 OK pada kejayaan.

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

// Returns 200 Ok pada kejayaan.

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

Senarai Tugas Berbilang Imej ke 3D

Endpoint ini membolehkan anda mendapatkan senarai tugas Berbilang Imej ke 3D.

Parameter

Atribut Pilihan

Name
page_num
Type
integer
Description
Nombor halaman untuk penomboran halaman. Bermula dan secara lalai pada 1.
Name
page_size
Type
integer
Description
Had saiz halaman. Secara lalai kepada 10 item. Maksimum yang dibenarkan ialah 50 item.
Name
sort_by
Type
string
Description
Medan untuk disenaraikan. Nilai yang tersedia:
- +created_at: Disenaraikan mengikut masa penciptaan secara menaik.
- -created_at: Disenaraikan mengikut masa penciptaan secara menurun.

Returns

Mengembalikan senarai penomboran halaman Objek Tugas Berbilang Imej ke 3D.

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

Strim Tugas Berbilang Imej ke 3D

Endpoint ini menetapkan masa nyata untuk tugas Berbilang Imej ke 3D menggunakan Server-Sent Events (SSE).

Parameter

Name
id
Type
path
Description
Pengenalpastian unik bagi tugas Berbilang Imej ke 3D untuk menstrim.

Returns

Mengembalikan arus The Multi-Image to 3D Task Objects sebagai Server-Sent Events.

Untuk tugas PENDING atau IN_PROGRESS, aliran respons hanya akan menyertakan bidang progress dan status yang diperlukan.

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

// Contoh acara ralat
event: error
data: {
  "status_code": 404,
  "message": "Tugas tidak dijumpai"
}

// Contoh acara mesej menggambarkan kemajuan tugas.
// Untuk tugas PENDING atau IN_PROGRESS, aliran respons tidak akan menyertakan semua medan.
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
}

Objek Tugas Berbilang Imej ke 3D

Objek Tugas Berbilang Imej ke 3D adalah unit kerja yang Meshy kekalkan untuk menjana model 3D daripada pelbagai imej (antara 1 hingga 4 termasuk). Imej mestilah objek yang sama, idealnya dari pandangan atau sudut berbeza. Objek ini mempunyai sifat berikut:

Properties

Name
id
Type
string
Description
Pengenalpastian unik bagi tugas. Sementara kami menggunakan UUID boleh disusun k untuk id tugas sebagai butiran pelaksanaan, anda seharusnya tidak membuat sebarang andaian tentang format id.
Name
type
Type
string
Description
Jenis tugas Berbilang Imej ke 3D. Nilainya ialah multi-image-to-3d.
Name
model_urls
Type
object
Description
URL yang boleh dimuat turun ke fail model 3D bertekstur yang dihasilkan oleh Meshy. Hartanah untuk format akan diabaikan jika format tidak dijana dan bukannya mengembalikan rentetan kosong.
- Name
  glb
  Type
  string
  Description
  URL boleh dimuat turun ke fail GLB.
- Name
  fbx
  Type
  string
  Description
  URL boleh dimuat turun ke fail FBX.
- Name
  obj
  Type
  string
  Description
  URL boleh dimuat turun ke fail OBJ.
- Name
  usdz
  Type
  string
  Description
  URL boleh dimuat turun ke fail USDZ.
- Name
  mtl
  Type
  string
  Description
  URL boleh dimuat turun ke fail MTL, dipulangkan bersama eksport OBJ apabila tekstur ada.
- Name
  stl
  Type
  string
  Description
  URL boleh dimuat turun ke fail STL.
- Name
  3mf
  Type
  string
  Description
  URL boleh dimuat turun ke fail 3MF. Hanya hadir apabila 3mf diminta melalui target_formats.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  URL boleh dimuat turun ke output GLB asal sebelum remeshing.
  Hanya boleh didapati apabila tugas dibuat dengan kedua-dua should_remesh: true dan save_pre_remeshed_model: true.
Name
thumbnail_url
Type
string
Description
URL yang boleh dimuat turun ke imej kecil fail model. Sama dengan thumbnail_urls.front apabila hadir, kekal untuk keserasian ke belakang.
Name
alpha_thumbnail_url
Type
string
Description
URL yang boleh dimuat turun ke versi latar belakang lut (RGBA) bagi thumbnail_url. Hanya hadir apabila tugas dibuat dengan alpha_thumbnail: true dan pratayangan lut berjaya dirender; jika tidak medan ini akan diabaikan.
Name
thumbnail_urls
Type
object
Description
URL yang boleh dimuat turun untuk empat imej kardinal 3D model yang dihasilkan. Setiap nilai ialah URL diberi tanda kepada PNG 512×512 yang direnjerkan dengan bahan dan pencahayaan yang sama dengan thumbnail_url. Berguna untuk pratayangan model dari pelbagai sudut dalam talian tanpa memuat turun GLB.
Hanya hadir apabila tugas telah dibuat dengan multi_view_thumbnails: true dan telah mencapai SUCCEEDED. Tugas-tugas lama dan tugas-tugas yang telah dibuat tanpa terlibat op-in tidak akan termasuk medan ini.
- Name
  front
  Type
  string
  Description
  Pandangan depan, 0° rotasi sekitar paksi menegak (padan dengan thumbnail_url).
- Name
  right
  Type
  string
  Description
  Pandangan kanan, 90° rotasi.
- Name
  back
  Type
  string
  Description
  Pandangan belakang, 180° rotasi.
- Name
  left
  Type
  string
  Description
  Pandangan kiri, 270° rotasi.
Name
texture_prompt
Type
string
Description
Prompt teks yang digunakan untuk membimbing proses pengecaman tekstur.
Name
progress
Type
integer
Description
Kemajuan tugas. Jika tugas belum dimulakan, sifat ini akan menjadi 0. Setelah tugas berjaya, ini akan menjadi 100.
Name
started_at
Type
timestamp
Description
Cap masa ketika tugas dimulakan, dalam milisaat. Jika tugas belum dimulakan, sifat ini akan menjadi 0.
Cap masa mewakili bilangan milisaat berlalu sejak 1 Januari 1970 UTC, mengikuti standard 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 ketika tugas dicipta, dalam milisaat.
Name
expires_at
Type
timestamp
Description
Cap masa ketika keputusan tugas tamat, dalam milisaat.
Name
finished_at
Type
timestamp
Description
Cap masa ketika tugas diselesaikan, dalam milisaat. Jika tugas belum selesai, sifat ini akan menjadi 0.
Name
status
Type
string
Description
Status tugas. Nilai yang mungkin adalah salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
texture_urls
Type
array
Description
Senarai URL tekstur objek yang dihasilkan oleh tugas. Biasanya hanya mengandungi satu objek URL tekstur. Setiap URL tekstur mempunyai sifat berikut:
- Name
  base_color
  Type
  string
  Description
  URL yang boleh dimuat turun ke imej peta warna asas.
- Name
  metallic
  Type
  string
  Description
  URL yang boleh dimuat turun ke imej peta logam.
  Jika tugas dibuat dengan enable_pbr: false, sifat ini akan diabaikan.
- Name
  normal
  Type
  string
  Description
  URL yang boleh dimuat turun ke imej peta normal.
  Jika tugas dibuat dengan enable_pbr: false, sifat ini akan diabaikan.
- Name
  roughness
  Type
  string
  Description
  URL yang boleh dimuat turun ke imej peta kekasaran.
  Jika tugas dibuat dengan enable_pbr: false, sifat ini akan diabaikan.
- Name
  emission
  Type
  string
  Description
  URL yang boleh dimuat turun ke imej peta pelepasan.
  Jika tugas dibuat dengan enable_pbr: false, atau ai_model adalah meshy-5, sifat ini akan diabaikan.
Name
preceding_tasks
Type
integer
Description
Bilangan tugas terdahulu.
Nilai medan ini hanya bermakna jika status tugas adalah PENDING.
Name
task_error
Type
object
Description
Butiran ralat untuk tugas yang gagal. Lihat Errors untuk rujukan penuh objek task_error.
Name
consumed_credits
Type
integer
Description
Bilangan kredit yang digunakan oleh tugas ini. Hadir apabila status tugas adalah PENDING, IN_PROGRESS, atau SUCCEEDED. Mengembalikan 0 bagi tugas FAILED (kredit dipulangkan jika gagal).

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,
}