lowpoly dihentikan pada 30 Okt 2026. Ganti model sebelum tanggal-tanggal ini agar permintaan tidak error. Lihat semua penghentian

API figur Creative Lab

Ubah foto menjadi figur koleksi 3D bergaya chibi dalam dua tahap. Tugas prototype menghasilkan gambar konsep dari foto tersebut. Tugas build mengubah gambar tersebut menjadi model 3D bertekstur, dan menggunakan ID tugas prototype 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

Buat tugas prototipe Figure

Menghasilkan satu gambar konsep bergaya chibi dari sebuah foto. Untuk membangun model 3D, kirimkan ID tugas ini ke endpoint build sebagai input_task_id. Untuk melihat field-field tugas ini, lihat Objek tugas prototipe Figure.

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"
}
Contoh prototipe
Mulai dengan sebuah potret sumber, lalu hasilkan gambar prototipe yang digunakan oleh tahap build.
Potret sumber yang digunakan sebagai input Creative Lab Figure
Input prototipe
Gambar prototipe figur bergaya chibi yang dihasilkan dari foto sumber
Output prototipe

Parameter

  • Name
    image_url
    Type
    string
    Wajib
    Description

    Foto yang akan diubah menjadi figur chibi, berupa URL publik atau data URI (data:image/jpeg;base64,<data gambar Anda yang dienkode base64>).

    Gambar harus berupa file JPG, JPEG, PNG, atau WebP dengan ukuran maksimum 20 MB.

  • Name
    name
    Type
    string
    Description

    Nama untuk tugas tersebut, hingga 100 karakter. Nama ini dikembalikan pada field name tugas. Nama yang lebih panjang akan mengembalikan 400.

  • Name
    remove_background
    Type
    boolean
    default false
    Description

    Menentukan apakah latar belakang dihapus dari gambar prototipe. true mengembalikan PNG RGBA transparan, sehingga Anda dapat menempatkan subjek pada latar belakang apa pun. Proses build juga dimulai dari gambar tanpa latar belakangnya. Jika Meshy tidak dapat menghapus latar belakang, Meshy akan mengembalikan gambar beserta latar belakangnya, dan tugas tetap berhasil.

Hasil yang Dikembalikan

Field result menyimpan ID dari tugas prototipe baru. Ambil tugas atau streaming tugas tersebut hingga status menjadi SUCCEEDED. Kemudian kirimkan ID tersebut ke endpoint build sebagai input_task_id.

Mode kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat dijalankan. Misalnya:

    • image_url tidak ada.
    • Gambar bukan file JPG, JPEG, PNG, atau WebP.
    • Gambar terlalu kecil, lebih dari 20 MB, atau melebihi jumlah piksel maksimum.
    • Meshy tidak dapat mengunduh gambar, misalnya karena URL mengembalikan 404 atau habis waktu (timeout).
    • Data URI bukan base64 yang valid.
    • Gambar ditandai sebagai NSFW.

    Pesan error menunjukkan masalah apa yang ditemukan. Perbaiki permintaan, lalu kirim ulang.

  • Name
    401 - Unauthorized
    Description

    Kunci API tidak ada atau tidak valid. Periksa header Authorization.

  • Name
    402 - Payment Required
    Description

    Salah satu dari hal berikut berlaku:

    • Akun tidak memiliki cukup kredit.
    • Kunci API, ruang kerja, atau anggota telah mencapai batas kreditnya.
    • Akun menggunakan paket gratis.

    Periksa kredit dan paket Anda, lalu coba lagi.

  • Name
    403 - Forbidden
    Description

    Tim Anda mengaktifkan IP Filtering, dan Meshy menandai gambar tersebut terkait kekayaan intelektual pihak ketiga. Kirimkan gambar yang hak penggunaannya Anda miliki.

  • Name
    429 - Too Many Requests
    Description

    Salah satu batas berikut telah tercapai:

    • Anda mengirim lebih banyak permintaan daripada yang diizinkan oleh batas laju Anda. Tunggu beberapa detik, lalu coba lagi. Lihat Batas laju.
    • Terlalu banyak tugas Anda yang sedang antre atau berjalan. Tunggu hingga beberapa selesai, lalu coba lagi.
    • Pada paket tak terbatas tanpa sisa kredit, Anda telah mencapai jumlah tugas yang dapat berjalan tanpa kredit. Tunggu hingga suatu tugas selesai, atau tambahkan kredit.
  • Name
    500 - Internal Server Error
    Description

    Meshy mengalami error server, misalnya karena tidak dapat menjalankan pemeriksaan kekayaan intelektual pada gambar. Meshy tidak membuat tugas tersebut, dan mengembalikan kredit apa pun yang telah dikenakan. Coba kirim ulang permintaan.

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

Buat tugas build Figure

Menghasilkan figur 3D bertekstur dari tugas prototipe yang berhasil. Untuk kolomnya, lihat Objek tugas build 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 build
Tugas build mengubah gambar prototipe yang dipilih menjadi model 3D bertekstur yang dapat diunduh.
Pratinjau model build Creative Lab Figure
Pratinjau model build

Parameter

  • Name
    input_task_id
    Type
    string
    Wajib
    Description

    ID dari tugas prototipe yang akan di-build. ID ini harus berupa tugas yang dibuat akun Anda dengan POST /openapi/creative-lab/figure/v1/prototype, dengan status SUCCEEDED.

    ID yang bukan salah satu dari tugas prototipe Figure Anda dari API akan mengembalikan 404, termasuk prototipe yang dibuat di aplikasi web.

  • Name
    name
    Type
    string
    Description

    Nama untuk tugas tersebut, hingga 100 karakter. Nama ini akan muncul kembali di kolom name tugas. Nama yang lebih panjang akan mengembalikan 400.

Returns

Kolom result menyimpan ID dari tugas build baru. Ambil tugasnya atau streaming tugasnya hingga status menjadi SUCCEEDED. Kemudian unduh GLB bertekstur dari model_urls.glb. Untuk OBJ, unduh model_urls.obj beserta file material-nya dari model_urls.mtl.

Mode kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat dijalankan. Misalnya:

    • input_task_id tidak ada atau bukan ID tugas yang valid.
    • Status tugas prototipe bukan SUCCEEDED. Jika masih berjalan, tunggu lalu coba lagi. Jika gagal atau dibatalkan, buat tugas prototipe baru.
    • Tugas prototipe berhasil tetapi tidak memiliki gambar. Buat tugas prototipe baru.

    Pesan kesalahan akan menyebutkan masalah apa yang ditemukan.

  • Name
    401 - Unauthorized
    Description

    Kunci API tidak ada atau tidak valid. Periksa header Authorization.

  • Name
    402 - Payment Required
    Description

    Salah satu dari hal berikut berlaku:

    • Akun tidak memiliki cukup kredit.
    • Kunci API, ruang kerja, atau anggota telah mencapai batas kredit.
    • Akun berada pada paket gratis.

    Periksa kredit dan paket Anda, lalu coba lagi.

  • Name
    404 - Not Found
    Description

    input_task_id tidak cocok dengan tugas prototipe Figure manapun yang dibuat akun Anda melalui API. Prototipe yang dibuat di aplikasi web juga akan mengembalikan 404. Kirim ID result dari respons pembuatan prototipe.

  • Name
    429 - Too Many Requests
    Description

    Salah satu batas berikut telah tercapai:

    • Anda mengirim lebih banyak permintaan daripada yang diizinkan oleh batas laju Anda. Tunggu beberapa detik, lalu coba lagi. Lihat Batas laju.
    • Terlalu banyak tugas Anda yang sedang antre atau berjalan. Tunggu hingga beberapa selesai, lalu coba lagi.
    • Pada paket tak terbatas tanpa sisa kredit, Anda telah mencapai jumlah tugas yang dapat berjalan tanpa kredit. Tunggu hingga satu tugas selesai, atau tambahkan kredit.
GET/openapi/creative-lab/figure/v1/(prototype|build)/:id

Mengambil task Figure

Mengembalikan task prototype atau build. Path harus sesuai dengan stage task tersebut. Task build yang diminta melalui /prototype/:id akan mengembalikan 404, begitu juga task prototype yang diminta melalui /build/:id.

Untuk field-fieldnya, lihat Objek task Figure prototype dan Objek task Figure build.

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 task dari respons pembuatan.

Returns

Objek task prototype atau objek task build, sesuai dengan stage pada path.

Mode kegagalan

  • Name
    400 - Bad Request
    Description

    id bukan ID task yang valid. Kirim ID result dari respons pembuatan.

  • Name
    403 - Forbidden
    Description

    Tim Anda mengaktifkan IP Filtering, dan Meshy menandai gambar task tersebut karena kekayaan intelektual pihak ketiga. Tim dengan paket Enterprise tidak mendapatkan error ini. Buat task prototype dari gambar yang hak penggunaannya Anda miliki.

  • Name
    404 - Not Found
    Description

    Tidak ada task Figure dengan ID ini yang dimiliki oleh akun Anda, atau stage task tidak cocok dengan path. Periksa ID-nya, dan gunakan /prototype atau /build yang sesuai dengan task.

  • Name
    500 - Internal Server Error
    Description

    Meshy tidak dapat menjalankan pemeriksaan kekayaan intelektual. Coba lagi permintaan tersebut.

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

Hapus task Figure

Membatalkan task Figure. Membatalkan task PENDING akan mengembalikan kreditnya. Task IN_PROGRESS dibatalkan tanpa pengembalian dana, karena worker sudah mulai mengerjakannya. Task dengan status akhir (SUCCEEDED, FAILED, atau CANCELED) tidak dapat dibatalkan.

Path harus sesuai dengan tahap task tersebut. Misalnya, DELETE pada /prototype/:id dengan ID task 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 path

  • Name
    id
    Type
    path
    Description

    ID dari task yang akan dibatalkan.

Hasil

204 No Content dengan body kosong.

Mode kegagalan

  • Name
    400 - Bad Request
    Description

    Salah satu dari hal berikut berlaku:

    • id bukan ID task yang valid. Kirim ID result dari respons create.
    • Task sudah memiliki status akhir (SUCCEEDED, FAILED, atau CANCELED), sehingga tidak dapat dibatalkan.
  • Name
    404 - Not Found
    Description

    Tidak ada task Figure dengan ID ini yang dimiliki akun Anda, atau tahap task tidak cocok dengan path. Periksa ID, dan gunakan /prototype atau /build yang sesuai dengan task tersebut.

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

Stream a Figure task

Melakukan streaming pembaruan task Figure sebagai Server-Sent Events (SSE). Path harus sesuai dengan tahap task tersebut. Jika tidak sesuai, misalnya ID task build digunakan di /prototype/:id/stream, stream akan mengirimkan satu event error dengan status_code: 404 lalu 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 task dari respons pembuatan.

Returns

Sebuah stream objek task prototype atau build. Setiap event berisi objek task lengkap, seperti yang dikembalikan oleh Get a Figure task. Selama task masih berstatus PENDING atau IN_PROGRESS, kolom output-nya masih kosong (null, [], atau {}), dan finished_at bernilai null.

Jika IP Filtering memblokir hasil task, stream akan mengirimkan satu event error sebagai penggantinya, dengan status_code yang sama seperti yang akan dikembalikan oleh permintaan get.

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

Daftar tugas Figure

Mengembalikan tugas Figure Anda untuk satu tahap, satu halaman dalam satu waktu. Path menentukan tahapnya. /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 path

  • Name
    stage
    Type
    path
    Wajib
    Description

    Tahap yang akan didaftar, prototype atau build.

Parameter kueri

  • Name
    page_num
    Type
    integer
    default 1
    Description

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

  • Name
    page_size
    Type
    integer
    default 10
    Description

    Jumlah tugas per halaman, hingga 100. Nilai dari 101 hingga 255 akan mengembalikan 100 tugas, dan 0 menggunakan nilai default. Nilai di luar 0 hingga 255 akan mengembalikan 400.

  • Name
    sort_by
    Type
    string
    default -created_at
    Description

    Urutan pengurutan.

    Nilai yang tersedia:

    • -created_at: terbaru lebih dulu
    • +created_at: terlama lebih dulu

Hasil

Sebuah array berisi objek tugas prototype atau objek tugas build, sesuai dengan tahap pada path.

Objek tugas prototipe Figure

Tugas prototipe menghasilkan gambar konsep bergaya chibi dari sebuah foto. Untuk mengubah gambar tersebut menjadi model 3D, kirim ID tugas ke endpoint build sebagai input_task_id.

Properti

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, selalu creative-lab-figure-prototype.

  • Name
    name
    Type
    string
    Description

    name yang Anda kirim saat membuat tugas, atau "" jika Anda tidak mengirimkannya.

  • Name
    status
    Type
    string
    Description

    Status tugas.

    Nilai yang tersedia:

    • PENDING: menunggu dalam antrean
    • IN_PROGRESS: menghasilkan hasil
    • SUCCEEDED: final, dengan hasil
    • FAILED: final, dengan alasan di task_error
    • CANCELED: final, tanpa hasil
  • Name
    progress
    Type
    integer
    Description

    Persentase pekerjaan yang selesai, dari 0 hingga 100. Nilainya 0 sampai tugas dimulai dan 100 ketika berhasil.

  • Name
    created_at
    Type
    timestamp
    Description

    Waktu tugas dibuat, dalam milidetik Unix.

  • Name
    started_at
    Type
    timestamp
    Description

    Waktu sebuah worker memulai tugas, dalam milidetik Unix. null sampai saat itu.

  • Name
    finished_at
    Type
    timestamp
    Description

    Waktu tugas mencapai status final, dalam milidetik Unix. null sampai saat itu.

  • Name
    expires_at
    Type
    timestamp
    Description

    Waktu hasil tugas kedaluwarsa, dalam milidetik Unix. Nilainya 3 hari setelah finished_at, atau 3 hari setelah created_at sampai tugas selesai. Untuk akun Enterprise, yang menyimpan hasil API tanpa batas waktu, nilainya sekitar 100 tahun kemudian. Lihat Retensi Aset.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Posisi tugas dalam antrean selagi berstatus PENDING. 1 berarti tugas ini berikutnya yang dimulai. 0 setelah tugas keluar dari antrean, dan selalu 0 pada hasil daftar.

  • Name
    task_error
    Type
    object
    Description

    Alasan tugas gagal. null kecuali status adalah FAILED. Lihat Kesalahan.

  • Name
    consumed_credits
    Type
    integer
    Description

    Jumlah kredit yang dikenakan untuk tugas, setelah dikurangi pengembalian dana. Permintaan yang mengembalikan kesalahan tidak akan dikenakan biaya. Tugas yang gagal bernilai 0, karena Meshy mengembalikan dananya. Membatalkan tugas hanya mengembalikan dana selagi tugas berstatus PENDING. Jika Meshy tidak dapat membaca biaya tersebut, respons get atau stream akan menghilangkan kolom ini, dan permintaan daftar akan mengembalikan 500. Dalam kasus tersebut, coba lagi permintaannya.

  • Name
    image_urls
    Type
    array of strings
    Description

    URL unduhan untuk gambar konsep. Array ini berisi satu URL setelah tugas berhasil, dan kosong sampai saat itu.

Objek tugas build Figure

Tugas build menghasilkan figur 3D bertekstur dari tugas prototype yang berhasil. Field model_urls, thumbnail_url, dan texture_urls miliknya memiliki format yang sama seperti pada objek tugas Gambar ke 3D.

Properti

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, selalu creative-lab-figure-build.

  • Name
    name
    Type
    string
    Description

    name yang Anda kirim saat membuat tugas, atau "" jika Anda tidak mengirimkannya.

  • Name
    status
    Type
    string
    Description

    Status tugas.

    Nilai yang tersedia:

    • PENDING: menunggu dalam antrean
    • IN_PROGRESS: sedang menghasilkan hasil
    • SUCCEEDED: final, dengan hasil
    • FAILED: final, dengan alasan di task_error
    • CANCELED: final, tanpa hasil
  • Name
    progress
    Type
    integer
    Description

    Persentase pekerjaan yang selesai, dari 0 hingga 100. Nilainya 0 sampai tugas dimulai dan 100 saat berhasil.

  • Name
    created_at
    Type
    timestamp
    Description

    Waktu tugas dibuat, dalam milidetik Unix.

  • Name
    started_at
    Type
    timestamp
    Description

    Waktu worker memulai tugas, dalam milidetik Unix. null sampai saat itu.

  • Name
    finished_at
    Type
    timestamp
    Description

    Waktu tugas mencapai status final, dalam milidetik Unix. null sampai saat itu.

  • Name
    expires_at
    Type
    timestamp
    Description

    Waktu hasil tugas kedaluwarsa, dalam milidetik Unix. Nilainya 3 hari setelah finished_at, atau 3 hari setelah created_at sampai tugas selesai. Untuk akun Enterprise, yang menyimpan hasil API tanpa batas waktu, nilainya sekitar 100 tahun kemudian. Lihat Retensi aset.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Posisi tugas dalam antrean selagi berstatus PENDING. 1 berarti tugas berikutnya akan dimulai. 0 setelah tugas meninggalkan antrean, dan selalu 0 dalam hasil daftar.

  • Name
    task_error
    Type
    object
    Description

    Alasan tugas gagal. null kecuali status adalah FAILED. Lihat Kesalahan.

  • Name
    consumed_credits
    Type
    integer
    Description

    Jumlah kredit yang dibebankan untuk tugas, setelah pengembalian dana (jika ada). Permintaan yang menghasilkan kesalahan tidak dikenakan biaya. Tugas yang gagal bernilai 0, karena Meshy mengembalikan kreditnya. Membatalkan tugas hanya mengembalikan kredit selagi tugas masih PENDING. Jika Meshy tidak dapat membaca pembebanan biaya, respons get atau stream akan mengabaikan field ini, dan permintaan daftar akan mengembalikan 500. Dalam kasus ini, coba ulangi permintaan tersebut.

  • Name
    prompt
    Type
    string
    Description

    Selalu "" untuk tugas build Figure.

  • Name
    negative_prompt
    Type
    string
    Description

    Selalu "" untuk tugas build Figure, seperti prompt.

  • Name
    texture_prompt
    Type
    string
    Description

    Selalu "" untuk tugas build Figure, seperti prompt.

  • Name
    texture_image_url
    Type
    string
    Description

    Selalu "" untuk tugas build Figure, seperti prompt.

  • Name
    model_urls
    Type
    object
    Description

    URL unduhan untuk model 3D, sebagai GLB bertekstur dan sebagai file OBJ beserta file MTL-nya.

    • Name
      glb
      Type
      string
      Description

      URL unduhan untuk file GLB bertekstur.

    • Name
      obj
      Type
      string
      Description

      URL unduhan untuk file OBJ, dengan geometri dan UV.

    • Name
      mtl
      Type
      string
      Description

      URL unduhan untuk file material MTL yang menyertai obj. Gunakan bersama obj dan tekstur pada texture_urls[0].base_color.

  • Name
    thumbnail_url
    Type
    string
    Description

    URL unduhan untuk gambar pratinjau model.

  • Name
    texture_urls
    Type
    array
    Description

    Peta tekstur, sebagai sebuah array dengan satu objek yang menyimpan peta warna dasar.

    • Name
      base_color
      Type
      string
      Description

      URL unduhan untuk peta warna dasar.

  • Name
    remove_lighting
    Type
    boolean
    Description

    Apakah Meshy menghapus highlight dan bayangan dari tekstur warna dasar.