API Berbilang Imej ke 3D

API Berbilang Imej ke 3D ialah 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 bermula dengan API ini.

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

Cipta Tugasan Berbilang Imej ke 3D

Endpoint ini membolehkan anda mencipta tugasan Berbilang Imej ke 3D baharu. Rujuk Objek Tugasan Berbilang Imej ke 3D untuk melihat sifat yang disertakan dengan objek tugasan Berbilang Imej ke 3D.

Parameter

Hanya salah satu daripada input_task_id atau image_urls diperlukan. Jika kedua-duanya diberikan, input_task_id mengambil keutamaan.

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

Name
image_urls
Type
array
Diperlukan
Description
Sediakan 1 hingga 4 imej untuk digunakan oleh Meshy dalam penciptaan model. Kami kini menyokong format .jpg, .jpeg, dan .png. Semua imej harus menggambarkan objek yang sama dari sudut berbeza untuk hasil terbaik.
Terdapat dua cara untuk menyediakan setiap 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,<your base64-encoded image data>.

Name
ai_model
Type
string
lalai latest
Description
ID model untuk digunakan. Nilai tersedia: meshy-5, meshy-6, latest (Meshy 6).
Name
should_texture
Type
boolean
lalai true
Description
Menentukan sama ada tekstur dijana. Menetapkannya kepada false akan melangkau fasa tekstur, menyediakan jejaring tanpa tekstur.

Hanya berlaku apabila should_texture = true

Name
enable_pbr
Type
boolean
lalai false
Description
Jana peta PBR (metallic, roughness, normal) sebagai tambahan kepada warna asas. Peta pancaran juga disertakan apabila ai_model ialah meshy-6 atau latest.
Name
hd_texture
Type
boolean
lalai false
Description
Jana tekstur warna asas pada resolusi 4K (4096×4096) untuk perincian yang lebih tinggi.
Hanya disokong apabila ai_model ialah meshy-6 atau latest. Peta PBR sentiasa dijana pada 2K.
Name
texture_prompt
Type
string
Description
Sediakan prompt teks untuk membimbing proses penteksturan. Maksimum 600 aksara.
Name
texture_image_url
Type
string
Description
Sediakan imej 2D untuk membimbing proses penteksturan. Kami kini menyokong format .jpg, .jpeg, dan .png.
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,<your base64-encoded image data>
Penteksturan imej mungkin tidak berfungsi secara optimum jika terdapat perbezaan geometri yang ketara antara asset asal dan imej yang dimuat naik. Hanya salah satu daripada texture_image_url atau texture_prompt boleh digunakan untuk membimbing proses penteksturan. Jika kedua-dua parameter diberikan, maka texture_prompt akan digunakan untuk mentekstur model secara lalai.

Name
should_remesh
Type
boolean
lalai false (meshy-6), true (others)
Description
Mengawal sama ada untuk mendayakan fasa Remesh. Apabila ditetapkan kepada false, API mengembalikan jejaring segi tiga berketepatan tertinggi.

Hanya berlaku apabila should_remesh = true

Name
topology
Type
string
lalai triangle
Description
Tentukan topology model yang dijana.
Nilai tersedia:
- quad: Jana jejaring yang didominasi quad.
- triangle: Jana jejaring segi tiga yang dikurangkan.
Name
target_polycount
Type
integer
lalai 30,000
Description
Tentukan bilangan poligon sasaran dalam model yang dijana. Bilangan poligon sebenar mungkin menyimpang daripada sasaran bergantung pada kerumitan geometri.
Julat nilai sah berbeza bergantung pada peringkat pengguna:
- 100 hingga 300,000 (termasuk)
Name
decimation_mode
Type
integer
Description
Dayakan pengurangan adaptif dengan menetapkan tahap bilangan poligon. Apabila ditetapkan, target_polycount diabaikan.
Nilai 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 (deprecated). Parameter ini tidak lagi mempengaruhi output.
Medan symmetry_mode mengawal tingkah laku simetri semasa proses penjanaan model.
Nilai sah ialah:
- off: Menyahdayakan simetri.
- auto: Menentukan dan menggunakan simetri secara automatik berdasarkan geometri input.
- on: Menguatkuasakan simetri semasa penjanaan.
Name
pose_mode
Type
string
lalai ""
Description
Tentukan pose_mode untuk model yang dijana.
Nilai tersedia:
- a-pose: Jana model dalam pose A.
- t-pose: Jana model dalam pose T.
- "" (rentetan kosong): Tiada pose khusus 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 penampilan tepat imej input tanpa sebarang pemprosesan gaya.
Hanya disokong apabila ai_model ialah meshy-6 atau latest.
Name
remove_lighting
Type
boolean
lalai true
Description
Mengalih keluar sorotan dan bayang-bayang daripada tekstur warna asas, menghasilkan keputusan yang lebih bersih yang berfungsi lebih baik di bawah persediaan pencahayaan tersuai.
Hanya disokong apabila ai_model ialah meshy-6 atau latest.
Name
moderation
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, kandungan input akan disaring secara automatik untuk kandungan yang berpotensi berbahaya. Jika kandungan berbahaya dikesan, tugasan tidak akan diteruskan ke penjanaan.
Setiap imej daripada image_urls dan teks daripada texture_prompt akan disaring.
Name
target_formats
Type
string[]
Description
Menentukan format fail 3D yang perlu disertakan dalam output. Hanya format yang diminta akan dijana dan dikembalikan, yang boleh mengurangkan masa penyelesaian tugasan.
Nilai tersedia: glb, obj, fbx, stl, usdz, 3mf
Apabila ditinggalkan, semua format kecuali 3mf dijana. 3mf hanya disertakan apabila dinyatakan secara eksplisit.
Name
auto_size
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, perkhidmatan menggunakan penglihatan AI untuk menganggar ketinggian dunia sebenar objek secara automatik dan mengubah saiz model sewajarnya. Titik asal akan dilalaikan kepada bottom melainkan origin_at ditetapkan secara eksplisit.
Name
alpha_thumbnail
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, tugasan turut merender versi latar belakang lutsinar (RGBA) bagi pratonton dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Medan thumbnail_url sedia ada tidak berubah.
Name
multi_view_thumbnails
Type
boolean
lalai false
Description
Apabila ditetapkan kepada true, tugasan turut merender empat imej kecil pandangan kardinal (depan, kanan, belakang, kiri) dan mengembalikannya di bawah thumbnail_urls pada respons GET. Medan thumbnail_url sedia ada tidak berubah dan terus menunjuk kepada pandangan depan, jadi klien sedia ada tidak terjejas.
Menambah kira-kira 3 saat kepada kependaman tugasan.

Hanya berlaku apabila auto_size = true

Name
origin_at
Type
string
lalai bottom
Description
Kedudukan titik asal apabila auto_size didayakan. Nilai tersedia: bottom, center.

Pulangan

Sifat result dalam respons mengandungi id tugasan bagi tugasan Berbilang Imej ke 3D yang baru dicipta.

Mode Kegagalan

Name
400 - Bad Request
Description
Permintaan tidak boleh diterima. Punca biasa:
- Parameter hilang: Sama ada image_urls atau input_task_id mesti diberikan.
- Tugasan input tidak sah: input_task_id mesti merujuk kepada tugasan Teks ke Imej, Imej ke Imej, atau varian berbilang pandangan dengan status SUCCEEDED.
- Kiraan imej tidak sah: image_urls mesti mengandungi antara 1 hingga 4 imej.
- Format imej tidak sah: Satu atau lebih imej dalam image_urls bukan format yang disokong.
- URL tidak dapat dicapai: 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 tugasan ini.
Name
429 - Too Many Requests
Description
Anda telah melebihi had kadar anda.

Request

POST

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

# Simple request
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>"
    ]
  }'

# With PBR texturing and GLB format
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 Semula Tugas Berbilang Imej ke 3D

endpoint ini membolehkan anda mendapatkan semula tugas Berbilang Imej ke 3D berdasarkan id tugas yang sah. Rujuk Objek Tugas Berbilang Imej ke 3D untuk melihat sifat yang disertakan dengan objek tugas Berbilang Imej ke 3D.

Parameter

Name
id
Type
path
Description
Pengecam unik untuk tugas Berbilang Imej ke 3D yang ingin didapatkan semula.

Mengembalikan

Respons mengandungi objek tugas Berbilang Imej ke 3D. Semak bahagian Objek Tugas Berbilang Imej ke 3D 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

Padam Tugas Berbilang Imej ke 3D

Endpoint ini memadamkan tugas Berbilang Imej ke 3D secara kekal, 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.

Pulangan

Mengembalikan 200 OK apabila berjaya.

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 on success.

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

Senaraikan Tugasan Berbilang Imej ke 3D

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

Parameter

Atribut pilihan

Name
page_num
Type
integer
Description
Nombor halaman untuk penomboran halaman. Bermula dan lalai kepada 1.
Name
page_size
Type
integer
Description
Had saiz halaman. Lalai kepada 10 item. Maksimum yang dibenarkan ialah 50 item.
Name
sort_by
Type
string
Description
Medan untuk diisih. Nilai yang tersedia:
- +created_at: Isih mengikut masa penciptaan dalam tertib menaik.
- -created_at: Isih mengikut masa penciptaan dalam tertib menurun.

Mengembalikan

Mengembalikan senarai berpenomboran halaman bagi Objek Tugasan 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 menstrim kemas kini masa nyata untuk tugas Berbilang Imej ke 3D menggunakan Server-Sent Events (SSE).

Parameter

Name
id
Type
path
Description
Pengecam unik untuk tugas Berbilang Imej ke 3D yang hendak distrim.

Pulangan

Mengembalikan strim Objek Tugas Berbilang Imej ke 3D sebagai Server-Sent Events.

Untuk tugas PENDING atau IN_PROGRESS, strim respons hanya akan menyertakan medan 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

// 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",
  "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 ialah unit kerja yang Meshy jejaki untuk menjana model 3D daripada berbilang imej (antara 1 hingga 4 termasuk kedua-duanya). Imej tersebut hendaklah daripada objek yang sama, sebaik-baiknya daripada pandangan atau sudut yang berbeza. Objek tersebut mempunyai sifat berikut:

Properties

Name
id
Type
string
Description
Pengecam unik untuk tugasan. Walaupun kami menggunakan UUID boleh diisih-k untuk id tugasan sebagai butiran pelaksanaan, anda tidak patut membuat sebarang andaian tentang format id.
Name
type
Type
string
Description
Jenis tugasan Berbilang Imej ke 3D. Nilainya ialah multi-image-to-3d.
Name
model_urls
Type
object
Description
URL boleh dimuat turun untuk fail model 3D bertekstur yang dijana oleh Meshy. Sifat untuk sesuatu format akan dikecualikan jika format tersebut tidak dijana, dan bukannya mengembalikan rentetan kosong.
- Name
  glb
  Type
  string
  Description
  URL boleh dimuat turun untuk fail GLB.
- Name
  fbx
  Type
  string
  Description
  URL boleh dimuat turun untuk fail FBX.
- Name
  obj
  Type
  string
  Description
  URL boleh dimuat turun untuk fail OBJ.
- Name
  usdz
  Type
  string
  Description
  URL boleh dimuat turun untuk fail USDZ.
- Name
  mtl
  Type
  string
  Description
  URL boleh dimuat turun untuk fail MTL, dikembalikan bersama eksport OBJ apabila tekstur tersedia.
- Name
  stl
  Type
  string
  Description
  URL boleh dimuat turun untuk fail STL.
- Name
  3mf
  Type
  string
  Description
  URL boleh dimuat turun untuk fail 3MF. Hanya tersedia apabila 3mf diminta melalui target_formats.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  URL boleh dimuat turun untuk output GLB asal sebelum remesh.
  Tersedia hanya apabila tugasan dicipta dengan kedua-dua should_remesh: true dan save_pre_remeshed_model: true.
Name
thumbnail_url
Type
string
Description
URL boleh dimuat turun untuk imej kecil fail model. Bersamaan dengan thumbnail_urls.front apabila tersedia, dikekalkan untuk keserasian ke belakang.
Name
alpha_thumbnail_url
Type
string
Description
URL boleh dimuat turun untuk versi berlatar belakang telus (RGBA) bagi thumbnail_url. Hanya tersedia apabila tugasan dicipta dengan alpha_thumbnail: true dan pratonton telus berjaya dirender; jika tidak, medan ini dikecualikan.
Name
thumbnail_urls
Type
object
Description
URL boleh dimuat turun untuk empat imej kecil pandangan arah utama bagi model 3D yang dijana. Setiap nilai ialah URL bertandatangan kepada PNG 512×512 yang dirender dengan bahan dan pencahayaan yang sama seperti thumbnail_url. Berguna untuk mempratonton model dari pelbagai sudut dalam saluran paip kelompok tanpa memuat turun GLB.
Hanya tersedia apabila tugasan dicipta dengan multi_view_thumbnails: true dan telah mencapai SUCCEEDED. Tugasan lama dan tugasan yang dicipta tanpa ikut serta tidak akan memasukkan medan ini.
- Name
  front
  Type
  string
  Description
  Pandangan depan, putaran 0° mengelilingi paksi menegak (sepadan dengan thumbnail_url).
- Name
  right
  Type
  string
  Description
  Pandangan kanan, putaran 90°.
- Name
  back
  Type
  string
  Description
  Pandangan belakang, putaran 180°.
- Name
  left
  Type
  string
  Description
  Pandangan kiri, putaran 270°.
Name
texture_prompt
Type
string
Description
Prompt teks yang digunakan untuk membimbing proses penteksturan.
Name
progress
Type
integer
Description
Progress tugasan. Jika tugasan belum dimulakan, sifat ini akan menjadi 0. Setelah tugasan berjaya, ini akan menjadi 100.
Name
started_at
Type
timestamp
Description
Cap masa bila tugasan dimulakan, dalam milisaat. Jika tugasan belum dimulakan, sifat ini akan menjadi 0.
Cap masa mewakili bilangan milisaat yang telah berlalu sejak 1 Januari 1970 UTC, mengikut 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 bila tugasan dicipta, dalam milisaat.
Name
expires_at
Type
timestamp
Description
Cap masa bila hasil tugasan tamat tempoh, dalam milisaat.
Name
finished_at
Type
timestamp
Description
Cap masa bila tugasan selesai, dalam milisaat. Jika tugasan belum selesai, sifat 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
Tatasusunan objek URL tekstur yang dijana daripada tugasan. Biasanya ini hanya mengandungi satu objek URL tekstur. Setiap URL tekstur mempunyai sifat berikut:
- Name
  base_color
  Type
  string
  Description
  URL boleh dimuat turun untuk imej peta warna asas.
- Name
  metallic
  Type
  string
  Description
  URL boleh dimuat turun untuk imej peta metalik.
  Jika tugasan dicipta dengan enable_pbr: false, sifat ini akan dikecualikan.
- Name
  normal
  Type
  string
  Description
  URL boleh dimuat turun untuk imej peta normal.
  Jika tugasan dicipta dengan enable_pbr: false, sifat ini akan dikecualikan.
- Name
  roughness
  Type
  string
  Description
  URL boleh dimuat turun untuk imej peta kekasaran.
  Jika tugasan dicipta dengan enable_pbr: false, sifat ini akan dikecualikan.
- Name
  emission
  Type
  string
  Description
  URL boleh dimuat turun untuk imej peta pancaran.
  Jika tugasan dicipta dengan enable_pbr: false, atau ai_model ialah meshy-5, sifat ini akan dikecualikan.
Name
preceding_tasks
Type
integer
Description
Bilangan tugasan terdahulu.
Nilai medan ini hanya bermakna jika status tugasan ialah PENDING.
Name
task_error
Type
object
Description
Butiran ralat untuk tugasan yang gagal. Lihat Ralat untuk rujukan objek task_error penuh.
Name
consumed_credits
Type
integer
Description
Bilangan kredit yang digunakan oleh tugasan ini. Tersedia apabila status tugasan ialah PENDING, IN_PROGRESS, atau SUCCEEDED. Mengembalikan 0 untuk tugasan FAILED (kredit dipulangkan semula apabila 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,
}