lowpoly akan dihentikan pada 30 Okt 2026. Tukar model sebelum tarikh-tarikh ini untuk mengelakkan ralat permintaan. Lihat semua penamatan

API Figura Creative Lab

Tukarkan foto kepada patung koleksi 3D bergaya chibi dalam dua peringkat. Tugas prototaip menjana imej konsep daripada foto tersebut. Tugas binaan menukar imej tersebut kepada model 3D bertekstur, dan menggunakan ID tugas prototaip sebagai input_task_id.

  • POST /openapi/creative-lab/figure/v1/prototype
  • POST /openapi/creative-lab/figure/v1/build
POST/openapi/creative-lab/figure/v1/prototype

Cipta tugas prototaip Figure

Menjana satu imej konsep bergaya chibi daripada sekeping foto. Untuk membina model 3D, hantar ID tugas ini ke build endpoint sebagai input_task_id. Untuk medan-medan tugas ini, lihat The Figure prototype task object.

Request

POST
/openapi/creative-lab/figure/v1/prototype
# Stage 1: generate a chibi-style concept image
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/prototype \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<your publicly accessible image url or base64-encoded data URI>"
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}
Prototype example
Start with a source portrait, then generate the prototype image used by the build stage.
Source portrait used as the Creative Lab Figure input
Prototype input
Chibi-style figurine prototype image generated from the source photo
Prototype output

Parameter

  • Name
    image_url
    Type
    string
    Diperlukan
    Description

    Foto yang hendak ditukar menjadi figura chibi, sama ada sebagai URL awam atau data URI (data:image/jpeg;base64,<your base64-encoded image data>).

    Imej mestilah fail JPG, JPEG, PNG, atau WebP bersaiz tidak melebihi 20 MB.

  • Name
    name
    Type
    string
    Description

    Nama untuk tugas, sehingga 100 aksara. Nama ini akan dikembalikan dalam medan name tugas tersebut. Nama yang lebih panjang akan mengembalikan 400.

  • Name
    remove_background
    Type
    boolean
    lalai false
    Description

    Sama ada untuk membuang latar belakang daripada imej prototaip. true mengembalikan PNG RGBA lutsinar, supaya anda boleh meletakkan subjek pada sebarang latar belakang. Proses pembinaan juga bermula daripada imej tanpa latar belakangnya. Jika Meshy tidak dapat membuang latar belakang, ia akan mengembalikan imej dengan latar belakangnya, dan tugas tersebut tetap berjaya.

Nilai pulangan

Medan result menyimpan ID tugas prototaip yang baharu. Dapatkan tugas tersebut atau strim tugas tersebut sehingga status menjadi SUCCEEDED. Kemudian hantar ID tersebut ke build endpoint sebagai input_task_id.

Mod kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat dijalankan. Contohnya:

    • image_url tiada.
    • Imej bukan fail JPG, JPEG, PNG, atau WebP.
    • Imej terlalu kecil, melebihi 20 MB, atau melebihi bilangan piksel maksimum.
    • Meshy tidak dapat memuat turun imej, contohnya kerana URL mengembalikan 404 atau tamat masa.
    • Data URI bukan base64 yang sah.
    • Imej ditandakan sebagai NSFW.

    Mesej ralat menyatakan masalah yang ditemui. Betulkan permintaan, kemudian hantar semula.

  • Name
    401 - Unauthorized
    Description

    Kunci API tiada atau tidak sah. Semak header Authorization.

  • Name
    402 - Payment Required
    Description

    Salah satu daripada perkara berikut berlaku:

    • Akaun tidak mempunyai kredit yang mencukupi.
    • Kunci API, ruang kerja, atau ahli telah mencapai had kreditnya.
    • Akaun berada pada pelan percuma.

    Semak kredit dan pelan anda, kemudian cuba semula.

  • Name
    403 - Forbidden
    Description

    Pasukan anda telah menghidupkan IP Filtering, dan Meshy telah menandakan imej tersebut kerana harta intelek pihak ketiga. Hantar imej yang anda mempunyai hak untuk menggunakannya.

  • Name
    429 - Too Many Requests
    Description

    Salah satu had berikut telah dicapai:

    • Anda menghantar lebih banyak permintaan daripada yang dibenarkan oleh had kadar anda. Tunggu beberapa saat, kemudian cuba semula. Lihat Rate limits.
    • Terlalu banyak tugas anda sedang beratur atau berjalan. Tunggu sehingga sebahagiannya selesai, kemudian cuba semula.
    • Pada pelan tanpa had tanpa baki kredit, anda telah mencapai bilangan tugas yang boleh berjalan tanpa kredit. Tunggu sehingga satu tugas selesai, atau tambah kredit.
  • Name
    500 - Internal Server Error
    Description

    Meshy mengalami ralat pelayan, contohnya kerana ia tidak dapat menjalankan semakan harta intelek pada imej tersebut. Meshy tidak mencipta tugas tersebut, dan memulangkan semula sebarang kredit yang telah dicaj. Cuba semula permintaan tersebut.

POST/openapi/creative-lab/figure/v1/build

Cipta tugas pembinaan Figure

Menjana figura 3D bertekstur daripada tugas prototaip yang berjaya. Untuk medannya, lihat Objek tugas pembinaan Figure.

Request

POST
/openapi/creative-lab/figure/v1/build
# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

Response

{
  "result": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb"
}
Contoh pembinaan
Tugas pembinaan menukar imej prototaip yang dipilih menjadi model 3D bertekstur yang boleh dimuat turun.
Pratonton model pembinaan Figure Creative Lab
Pratonton model pembinaan

Parameter

  • Name
    input_task_id
    Type
    string
    Diperlukan
    Description

    ID tugas prototaip yang hendak dibina. Ia mestilah tugas yang dicipta oleh akaun anda menggunakan POST /openapi/creative-lab/figure/v1/prototype, dengan status SUCCEEDED.

    Satu ID yang bukan salah satu tugas prototaip Figure anda daripada API akan memulangkan 404, termasuk prototaip yang dibuat dalam aplikasi web.

  • Name
    name
    Type
    string
    Description

    Nama untuk tugas tersebut, sehingga 100 aksara. Ia dipulangkan dalam medan name tugas tersebut. Nama yang lebih panjang akan memulangkan 400.

Pulangan

Medan result menyimpan ID tugas pembinaan baharu. Dapatkan tugas atau strimkan ia sehingga status menjadi SUCCEEDED. Kemudian muat turun GLB bertekstur daripada model_urls.glb. Untuk OBJ pula, muat turun model_urls.obj bersama fail bahannya daripada model_urls.mtl.

Mod kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat dijalankan. Contohnya:

    • input_task_id tiada atau bukan ID tugas yang sah.
    • Status tugas prototaip bukan SUCCEEDED. Jika ia masih berjalan, tunggu dan cuba lagi. Jika ia gagal atau dibatalkan, cipta tugas prototaip baharu.
    • Tugas prototaip berjaya tetapi tiada imej. Cipta tugas prototaip baharu.

    Mesej ralat menyatakan masalah yang ditemui.

  • Name
    401 - Unauthorized
    Description

    Kunci API tiada atau tidak sah. Semak pengepala Authorization.

  • Name
    402 - Payment Required
    Description

    Salah satu daripada berikut berlaku:

    • Akaun tidak mempunyai kredit yang mencukupi.
    • Kunci API, ruang kerja, atau ahli telah mencapai had kreditnya.
    • Akaun berada pada pelan percuma.

    Semak kredit dan pelan anda, kemudian cuba lagi.

  • Name
    404 - Not Found
    Description

    input_task_id tidak sepadan dengan mana-mana tugas prototaip Figure yang dicipta oleh akaun anda menggunakan API. Prototaip yang dibuat dalam aplikasi web juga akan memulangkan 404. Hantar ID result daripada respons cipta prototaip.

  • Name
    429 - Too Many Requests
    Description

    Salah satu had berikut telah dicapai:

    • Anda menghantar lebih banyak permintaan daripada yang dibenarkan oleh had kadar anda. Tunggu beberapa saat, kemudian cuba lagi. Lihat Had kadar.
    • Terlalu banyak tugas anda sedang dalam baris gilir atau sedang berjalan. Tunggu sehingga sebahagiannya selesai, kemudian cuba lagi.
    • Pada pelan tanpa had tanpa kredit yang berbaki, anda telah mencapai bilangan tugas yang boleh berjalan tanpa kredit. Tunggu sehingga satu tugas selesai, atau tambah kredit.
GET/openapi/creative-lab/figure/v1/(prototype|build)/:id

Dapatkan tugas Figure

Mengembalikan tugas prototype atau build. Laluan (path) mesti sepadan dengan peringkat tugas tersebut. Tugas build yang diminta melalui /prototype/:id akan mengembalikan 404, dan begitu juga tugas prototype yang diminta melalui /build/:id.

Untuk medan-medannya, lihat Objek tugas prototype Figure dan Objek tugas build Figure.

Request

GET
/openapi/creative-lab/figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578
# Prototype
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ],
  "remove_lighting": true
}

Parameter

  • Name
    id
    Type
    path
    Description

    ID tugas daripada respons create.

Pulangan

Objek tugas prototype atau objek tugas build, yang sepadan dengan peringkat dalam laluan (path).

Mod kegagalan

  • Name
    400 - Bad Request
    Description

    id bukan ID tugas yang sah. Hantar ID result daripada respons create.

  • Name
    403 - Forbidden
    Description

    Pasukan anda telah menghidupkan IP Filtering, dan Meshy telah menandakan imej tugas tersebut kerana hak harta intelek pihak ketiga. Pasukan pada pelan Enterprise tidak mendapat ralat ini. Cipta tugas prototype daripada imej yang anda mempunyai hak untuk digunakan.

  • Name
    404 - Not Found
    Description

    Tiada tugas Figure dengan ID ini yang dimiliki oleh akaun anda, atau peringkat tugas tersebut tidak sepadan dengan laluan (path). Semak ID tersebut, dan gunakan /prototype atau /build yang sepadan dengan tugas tersebut.

  • Name
    500 - Internal Server Error
    Description

    Meshy tidak dapat menjalankan semakan harta intelek. Cuba semula permintaan tersebut.

DELETE/openapi/creative-lab/figure/v1/(prototype|build)/:id

Padam tugas Figure

Membatalkan tugas Figure. Membatalkan tugas PENDING akan memulangkan semula kreditnya. Tugas IN_PROGRESS dibatalkan tanpa bayaran balik, kerana pekerja sudah memulakannya. Tugas yang mempunyai status akhir (SUCCEEDED, FAILED, atau CANCELED) tidak boleh dibatalkan.

Laluan tersebut mesti sepadan dengan peringkat tugas. Sebagai contoh, DELETE pada /prototype/:id dengan ID tugas build akan mengembalikan 404.

Request

DELETE
/openapi/creative-lab/figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578
curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).

Parameter laluan

  • Name
    id
    Type
    path
    Description

    ID tugas yang hendak dibatalkan.

Pulangan

204 No Content dengan badan kosong.

Mod kegagalan

  • Name
    400 - Bad Request
    Description

    Salah satu daripada berikut berlaku:

    • id bukan ID tugas yang sah. Hantar ID result daripada respons penciptaan.
    • Tugas tersebut sudah mempunyai status akhir (SUCCEEDED, FAILED, atau CANCELED), jadi ia tidak boleh dibatalkan.
  • Name
    404 - Not Found
    Description

    Tiada tugas Figure dengan ID ini yang dimiliki oleh akaun anda, atau peringkat tugas tidak sepadan dengan laluan. Semak ID, dan gunakan /prototype atau /build untuk memadankan tugas tersebut.

GET/openapi/creative-lab/figure/v1/(prototype|build)/:id/stream

Alirkan tugas Figure

Mengalirkan kemas kini tugas Figure sebagai Server-Sent Events (SSE). Laluan tersebut mesti sepadan dengan peringkat tugas. Jika tidak, contohnya ID tugas build pada /prototype/:id/stream, strim tersebut menghantar satu peristiwa error dengan status_code: 404 dan kemudian ditutup.

Request

GET
/openapi/creative-lab/figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream
curl -N https://api.meshy.ai/openapi/creative-lab/figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example (wrong stage or task not found)
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// Every frame is the full task object; fields not yet populated are null / empty.
// The following PENDING frame is shortened to the fields that change.
event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ],
  "remove_lighting": true
}

Parameter

  • Name
    id
    Type
    path
    Description

    ID tugas daripada respons create.

Returns

Strim objek tugas prototype atau build. Setiap peristiwa mengandungi objek tugas yang lengkap, sebagaimana yang dikembalikan oleh Get a Figure task. Semasa tugas berstatus PENDING atau IN_PROGRESS, medan outputnya masih kosong (null, [], atau {}), dan finished_at adalah null.

Jika IP Filtering menyekat hasil tugas tersebut, strim akan menghantar satu peristiwa error sebagai gantinya, dengan status_code yang sama seperti yang akan dikembalikan oleh permintaan get.

GET/openapi/creative-lab/figure/v1/(prototype|build)

Senaraikan tugas Figure

Mengembalikan tugas Figure anda bagi satu peringkat, satu halaman pada satu masa. Laluan tersebut memilih peringkat. /prototype hanya mengembalikan tugas prototype, dan /build hanya mengembalikan tugas build.

Request

GET
/openapi/creative-lab/figure/v1/prototype
# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/figure/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response (List Prototype Tasks)

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "creative-lab-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729123456000,
    "started_at": 1729123460000,
    "finished_at": 1729123486000,
    "expires_at": 1729382686000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

Parameter laluan

  • Name
    stage
    Type
    path
    Diperlukan
    Description

    Peringkat yang hendak disenaraikan, prototype atau build.

Parameter pertanyaan

  • Name
    page_num
    Type
    integer
    lalai 1
    Description

    Halaman yang hendak dikembalikan, dari 1 hingga 255. 0 mengembalikan halaman pertama. Nilai di luar julat 0 hingga 255 akan mengembalikan 400.

  • Name
    page_size
    Type
    integer
    lalai 10
    Description

    Bilangan tugas setiap halaman, sehingga 100. Nilai dari 101 hingga 255 akan mengembalikan 100 tugas, dan 0 menggunakan nilai lalai. Nilai di luar julat 0 hingga 255 akan mengembalikan 400.

  • Name
    sort_by
    Type
    string
    lalai -created_at
    Description

    Susunan pengisihan.

    Nilai yang tersedia:

    • -created_at: terbaharu dahulu
    • +created_at: terlama dahulu

Pulangan

Satu array objek tugas prototype atau objek tugas build, mengikut peringkat yang dinyatakan dalam laluan.

Objek tugas prototaip Figure

Tugas prototaip menjana imej konsep gaya chibi daripada sebuah foto. Untuk menukar imej tersebut menjadi model 3D, hantar ID tugas itu kepada endpoint build sebagai input_task_id.

Sifat

Example Figure Prototype Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}
  • Name
    id
    Type
    string
    Description

    ID tugas. Jangan bergantung pada formatnya.

  • Name
    type
    Type
    string
    Description

    Jenis tugas, sentiasa creative-lab-figure-prototype.

  • Name
    name
    Type
    string
    Description

    name yang anda hantar semasa mencipta tugas, atau "" jika anda tidak menghantarnya.

  • Name
    status
    Type
    string
    Description

    Status tugas tersebut.

    Nilai yang tersedia:

    • PENDING: menunggu dalam giliran
    • IN_PROGRESS: sedang menjana hasil
    • SUCCEEDED: muktamad, dengan hasil
    • FAILED: muktamad, dengan sebab dalam task_error
    • CANCELED: muktamad, tanpa hasil
  • Name
    progress
    Type
    integer
    Description

    Peratusan kerja yang selesai, dari 0 hingga 100. Nilainya 0 sehingga tugas bermula dan 100 apabila berjaya.

  • Name
    created_at
    Type
    timestamp
    Description

    Masa tugas dicipta, dalam milisaat Unix.

  • Name
    started_at
    Type
    timestamp
    Description

    Masa seorang pekerja memulakan tugas, dalam milisaat Unix. null sehingga itu.

  • Name
    finished_at
    Type
    timestamp
    Description

    Masa tugas mencapai status muktamad, dalam milisaat Unix. null sehingga itu.

  • Name
    expires_at
    Type
    timestamp
    Description

    Masa hasil tugas itu luput, dalam milisaat Unix. Ia adalah 3 hari selepas finished_at, atau 3 hari selepas created_at sehingga tugas itu selesai. Bagi akaun Enterprise, yang menyimpan hasil API secara berterusan, ia adalah lebih kurang 100 tahun kemudian. Lihat Pengekalan aset.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Kedudukan tugas dalam giliran semasa ia PENDING. 1 bermaksud ia akan bermula seterusnya. 0 selepas tugas keluar daripada giliran, dan sentiasa 0 dalam hasil senarai.

  • Name
    task_error
    Type
    object
    Description

    Sebab tugas itu gagal. null kecuali status adalah FAILED. Lihat Ralat.

  • Name
    consumed_credits
    Type
    integer
    Description

    Bilangan kredit yang dikenakan untuk tugas tersebut, selepas sebarang bayaran balik. Permintaan yang mengembalikan ralat tidak dikenakan caj. Tugas yang gagal adalah 0, kerana Meshy membayar baliknya. Membatalkan hanya membayar balik tugas semasa ia PENDING. Jika Meshy tidak dapat membaca caj tersebut, respons get atau stream akan meninggalkan medan tersebut, dan permintaan senarai akan mengembalikan 500. Dalam kes itu, cuba semula permintaan tersebut.

  • Name
    image_urls
    Type
    array of strings
    Description

    URL muat turun untuk imej konsep. Array mempunyai satu URL selepas tugas berjaya, dan kosong sehingga itu.

Objek tugas pembinaan Figure

Tugas pembinaan menghasilkan figura 3D bertekstur daripada tugas prototaip yang berjaya. Medan model_urls, thumbnail_url, dan texture_urls mempunyai format yang sama seperti dalam objek tugas Imej ke 3D.

Ciri-ciri

Example Figure Build Task Object

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/texture_0.png?Expires=***"
    }
  ],
  "remove_lighting": true
}
  • Name
    id
    Type
    string
    Description

    ID tugas. Jangan bergantung pada formatnya.

  • Name
    type
    Type
    string
    Description

    Jenis tugas, sentiasa creative-lab-figure-build.

  • Name
    name
    Type
    string
    Description

    name yang anda hantar semasa mencipta tugas, atau "" jika anda tidak menghantarnya.

  • Name
    status
    Type
    string
    Description

    Status tugas.

    Nilai yang tersedia:

    • PENDING: menunggu dalam baris gilir
    • IN_PROGRESS: menjana hasil
    • SUCCEEDED: muktamad, dengan hasil
    • FAILED: muktamad, dengan sebab dalam task_error
    • CANCELED: muktamad, tanpa hasil
  • Name
    progress
    Type
    integer
    Description

    Peratusan kerja yang telah selesai, dari 0 hingga 100. Nilainya 0 sehingga tugas bermula dan 100 apabila ia berjaya.

  • Name
    created_at
    Type
    timestamp
    Description

    Masa tugas dicipta, dalam milisaat Unix.

  • Name
    started_at
    Type
    timestamp
    Description

    Masa seorang pekerja memulakan tugas, dalam milisaat Unix. null sehingga itu.

  • Name
    finished_at
    Type
    timestamp
    Description

    Masa tugas mencapai status muktamad, dalam milisaat Unix. null sehingga itu.

  • Name
    expires_at
    Type
    timestamp
    Description

    Masa hasil tugas tamat tempoh, dalam milisaat Unix. Ia adalah 3 hari selepas finished_at, atau 3 hari selepas created_at sehingga tugas selesai. Untuk akaun Enterprise, yang menyimpan hasil API tanpa had masa, ia adalah lebih kurang 100 tahun kemudian. Lihat Pengekalan aset.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Kedudukan tugas dalam baris gilir semasa ia PENDING. 1 bermaksud ia bermula seterusnya. 0 selepas tugas keluar daripada baris gilir, dan sentiasa 0 dalam hasil senarai.

  • Name
    task_error
    Type
    object
    Description

    Sebab tugas gagal. null kecuali status adalah FAILED. Lihat Ralat.

  • Name
    consumed_credits
    Type
    integer
    Description

    Bilangan kredit yang dikenakan untuk tugas, selepas sebarang bayaran balik. Permintaan yang mengembalikan ralat tidak dikenakan bayaran. Tugas yang gagal adalah 0, kerana Meshy membayar baliknya. Membatalkan hanya membayar balik tugas semasa ia PENDING. Jika Meshy tidak dapat membaca caj tersebut, respons get atau stream akan meninggalkan medan tersebut, dan permintaan senarai akan mengembalikan 500. Dalam kes itu, cuba semula permintaan tersebut.

  • Name
    prompt
    Type
    string
    Description

    Sentiasa "" untuk tugas pembinaan Figure.

  • Name
    negative_prompt
    Type
    string
    Description

    Sentiasa "" untuk tugas pembinaan Figure, seperti prompt.

  • Name
    texture_prompt
    Type
    string
    Description

    Sentiasa "" untuk tugas pembinaan Figure, seperti prompt.

  • Name
    texture_image_url
    Type
    string
    Description

    Sentiasa "" untuk tugas pembinaan Figure, seperti prompt.

  • Name
    model_urls
    Type
    object
    Description

    URL muat turun untuk model 3D, sebagai GLB bertekstur dan sebagai fail OBJ dengan fail MTL-nya.

    • Name
      glb
      Type
      string
      Description

      URL muat turun untuk fail GLB bertekstur.

    • Name
      obj
      Type
      string
      Description

      URL muat turun untuk fail OBJ, dengan geometri dan UV.

    • Name
      mtl
      Type
      string
      Description

      URL muat turun untuk fail bahan MTL yang disertakan dengan obj. Gunakannya bersama obj dan tekstur dalam texture_urls[0].base_color.

  • Name
    thumbnail_url
    Type
    string
    Description

    URL muat turun untuk imej pratonton model.

  • Name
    texture_urls
    Type
    array
    Description

    Peta tekstur, sebagai tatasusunan dengan satu objek yang menyimpan peta warna asas.

    • Name
      base_color
      Type
      string
      Description

      URL muat turun untuk peta warna asas.

  • Name
    remove_lighting
    Type
    boolean
    Description

    Sama ada Meshy mengeluarkan sorotan dan bayang-bayang daripada tekstur warna asas.