Creative Lab — API Figura Vinyl

Tukar foto sumber kepada figura 3D koleksi kepala besar dalam dua peringkat: prototaip menjana imej konsep bergaya daripada foto input anda, kemudian pembinaan menukar imej konsep itu kepada model 3D bertekstur. Kedua-dua peringkat dihubungkan melalui input_task_id.

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

Cipta Tugas Prototip Figura Vinyl

Hasilkan satu imej konsep gaya figura vinyl daripada foto sumber. ID tugas yang dikembalikan adalah apa yang anda serahkan sebagai input_task_id kepada endpoint bina. Rujuk kepada Objek Tugas Prototip Figura Vinyl untuk bentuk respons.

Parameter

  • Name
    image_url
    Type
    string
    Diperlukan
    Description

    Foto sumber untuk Meshy gayakan sebagai figura vinyl berkepala besar. Kami kini menyokong format .jpg, .jpeg, .png, dan .webp.

    Terdapat dua cara untuk menyediakan imej:

    • URL yang boleh diakses secara umum: URL yang boleh diakses dari internet awam.
    • Data URI: Data URI yang dikodkan base64 bagi imej. Contoh Data URI: data:image/jpeg;base64,<your base64-encoded image data>.
  • Name
    name
    Type
    string
    Description

    Nama tugas pilihan untuk tujuan paparan. Maksimum 100 aksara.

  • Name
    remove_background
    Type
    boolean
    lalai false
    Description

    Apabila ditetapkan kepada true, imej prototip dikembalikan sebagai PNG RGBA telus dengan latar belakang dibuang, jadi anda boleh menggabungkan subjek ke mana-mana latar belakang.

Mengembalikan

Properti result dalam respons mengandungi ID tugas id bagi tugas prototip figura vinyl yang baru dicipta. Poll endpoint Dapatkan Tugas atau langgan stream sehingga tugas mencapai SUCCEEDED, kemudian serahkan ID tersebut kepada endpoint bina sebagai input_task_id.

Mod Kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat diterima. Punca biasa:

    • Parameter hilang: image_url diperlukan.
    • Format imej tidak sah: image_url yang disediakan bukan format yang disokong (.jpg, .jpeg, .png, .webp).
    • Dimensi imej di luar julat: Imej terlalu kecil, melebihi saiz fail maksimum, atau melebihi jumlah piksel maksimum.
    • URL tidak dapat dicapai: image_url tidak dapat dimuat turun (404 atau timeout).
    • Data URI tidak sah: Rentetan base64 tidak sah.
    • Kandungan ditandakan: Imej input ditandakan oleh moderation NSFW atau harta intelek.
  • 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.

Permintaan

POST
/openapi/creative-lab/vinyl-figure/v1/prototype
# Stage 1: generate a vinyl-figure-style concept image
curl https://api.meshy.ai/openapi/creative-lab/vinyl-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>"
  }'

Respons

{
  "result": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
}
Contoh prototip
Mulakan dengan foto sumber, kemudian hasilkan imej prototip yang digunakan oleh peringkat bina.
Foto sumber digunakan sebagai input Creative Lab Vinyl Figure
Input prototip
Imej prototip figura vinyl berkepala besar yang dihasilkan daripada foto sumber
Output prototip
POST/openapi/creative-lab/vinyl-figure/v1/build

Cipta Tugas Bina Figura Vinyl

Hasilkan figura vinyl 3D bertekstur akhir daripada tugas prototaip yang berjaya. Pembinaan ini menjalankan saluran paip imej-ke-3D yang sama seperti Imej ke 3D, jadi format objek respons dan senarai URL output sepadan dengan tepat. Rujuk kepada Objek Tugas Bina Figura Vinyl untuk bentuk respons.

Parameter

  • Name
    input_task_id
    Type
    string
    Diperlukan
    Description

    ID tugas bagi tugas prototaip yang dicipta melalui endpoint OpenAPI yang sama ini. Prototaip mesti telah dicipta dengan kunci API yang sama, mesti telah mencapai SUCCEEDED, dan mesti telah menghasilkan tepat satu imej calon.

    Tugas prototaip yang dicipta melalui aplikasi web tidak diterima — endpoint bina hanya menerima tugas prototaip yang dihasilkan oleh POST /openapi/creative-lab/vinyl-figure/v1/prototype dan menolak mana-mana sumber lain dengan 404.

  • Name
    name
    Type
    string
    Description

    Nama tugas pilihan untuk tujuan paparan. Maksimum 100 aksara.

Mengembalikan

Properti result dalam respons mengandungi id tugas bagi tugas bina figura vinyl yang baru dicipta. Pantau endpoint Dapatkan Tugas atau langgan aliran sehingga tugas mencapai SUCCEEDED, kemudian muat turun GLB bertekstur dari model_urls.glb (atau pasangan OBJ + MTL dari model_urls.obj dan model_urls.mtl jika saluran paip hiliran anda lebih suka OBJ).

Mod Kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat diterima. Punca biasa:

    • Parameter hilang: input_task_id diperlukan.
    • UUID tidak sah: input_task_id bukan UUID yang sah.
    • Induk tidak berjaya: Tugas prototaip yang dirujuk belum mencapai SUCCEEDED.
    • Tiada calon: Tugas prototaip berjaya tetapi tidak menghasilkan imej calon.
  • Name
    401 - Unauthorized
    Description

    Pengesahan gagal. Sila periksa kunci API anda.

  • Name
    402 - Payment Required
    Description

    Kredit tidak mencukupi untuk melaksanakan tugas ini.

  • Name
    404 - Not Found
    Description

    Tugas prototaip yang dirujuk tidak wujud, milik pengguna lain, atau dicipta melalui aplikasi web (hanya tugas prototaip mod-API yang berantai ke bina).

  • Name
    429 - Too Many Requests
    Description

    Anda telah melebihi had kadar anda.

Permintaan

POST
/openapi/creative-lab/vinyl-figure/v1/build
# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
  }'

Respons

{
  "result": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef"
}
GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

Dapatkan Tugasan Figura Vinyl

Dapatkan tugasan prototaip atau binaan dengan memberikan id tugasan yang sah. Laluan URL mesti sepadan dengan peringkat tugasan — tugasan binaan yang diambil melalui /prototype/:id akan mengembalikan 404, dan sebaliknya.

Rujuk kepada Objek Tugasan Prototaip Figura Vinyl dan Objek Tugasan Binaan Figura Vinyl untuk bentuk respons.

Parameter

  • Name
    id
    Type
    path
    Description

    Pengenal pasti unik untuk tugasan figura vinyl yang hendak didapatkan.

Pulangan

Respons mengandungi objek tugasan figura vinyl. Bentuknya bergantung pada peringkat yang diminta.

Permintaan

GET
/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de
# Prototype
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Respons Prototaip

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Respons Binaan

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "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/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}
DELETE/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

Padam Tugas Figura Vinyl

Batalkan tugas figura vinyl. Jika tugas masih PENDING, kredit yang digunakan semasa ciptaan akan dikembalikan. Tugas yang sudah IN_PROGRESS dibatalkan tanpa pengembalian (pekerja mungkin sudah menggunakan sumber). Tugas yang telah mencapai keadaan terminal (SUCCEEDED, FAILED, CANCELED) tidak boleh dibatalkan.

Laluan URL mesti sepadan dengan tahap tugas — DELETE pada /prototype/:buildId mengembalikan 404.

Parameter Laluan

  • Name
    id
    Type
    path
    Description

    Pengenal pasti unik untuk tugas figura vinyl yang hendak dibatalkan.

Pulangan

Mengembalikan 204 No Content pada kejayaan dengan badan kosong.

Mod Kegagalan

  • Name
    400 - Bad Request
    Description

    Tugas sudah berada dalam keadaan terminal dan tidak boleh dibatalkan.

  • Name
    404 - Not Found
    Description

    Tugas tidak wujud, milik pengguna lain, atau tahapnya tidak sepadan dengan laluan URL.

Permintaan

DELETE
/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de
curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Respons

// Returns 204 No Content on success (empty body).
GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id/stream

Strim Tugas Figura Vinyl

Strim kemas kini masa nyata untuk tugas figura vinyl melalui Server-Sent Events (SSE). Laluan URL mesti sepadan dengan peringkat tugas — membuka strim di /prototype/:buildId/stream akan mengeluarkan satu event: error payload dengan status_code: 404 dan menutup strim.

Parameter

  • Name
    id
    Type
    path
    Description

    Pengenal unik untuk tugas figura vinyl yang ingin distrim.

Pulangan

Mengembalikan strim objek tugas Vinyl Figure Prototype atau Vinyl Figure Build sebagai Server-Sent Events. Untuk tugas PENDING atau IN_PROGRESS, strim respons hanya akan menyertakan medan progress dan status yang diperlukan.

Permintaan

GET
/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream
curl -N https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Strim Respons

// 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.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}
GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)

Senarai Tugas Figura Vinyl

Dapatkan senarai berpenomboran halaman bagi tugas figura vinyl anda untuk satu peringkat. Laluan URL memilih peringkat — /prototype mengembalikan tugas prototaip; /build mengembalikan tugas binaan. Tugas dari peringkat lain tidak termasuk dalam mana-mana respons.

Parameter Laluan

  • Name
    stage
    Type
    path
    Diperlukan
    Description

    Sama ada prototype atau build. Koleksi hanya mengembalikan tugas yang peringkatnya sepadan dengan URL — mendapatkan /prototype tidak pernah mengembalikan tugas binaan dan sebaliknya.

Parameter Pertanyaan

  • Name
    page_num
    Type
    integer
    lalai 1
    Description

    Nombor halaman untuk penomboran halaman.

  • Name
    page_size
    Type
    integer
    lalai 10
    Description

    Had saiz halaman. Maksimum yang dibenarkan ialah 50 item.

  • Name
    sort_by
    Type
    string
    lalai -created_at
    Description

    Medan untuk disusun. Nilai yang tersedia:

    • +created_at: Susun mengikut masa penciptaan dalam susunan menaik.
    • -created_at: Susun mengikut masa penciptaan dalam susunan menurun.

Mengembalikan

Mengembalikan senarai berpenomboran halaman bagi objek tugas per peringkat — sama ada objek tugas prototaip figura vinyl apabila menyenaraikan /prototype atau objek tugas binaan figura vinyl apabila menyenaraikan /build.

Permintaan

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

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

Respons (Senarai Tugas Prototaip)

[
  {
    "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
    "type": "creative-lab-vinyl-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1752969600000,
    "started_at": 1752969604000,
    "finished_at": 1752969630000,
    "expires_at": 1753228830000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

Objek Tugas Prototip Figura Vinyl

Objek Tugas Prototip Figura Vinyl adalah unit kerja yang Meshy jejak untuk menjana imej konsep gaya figura vinyl daripada foto sumber. Hasil daripada peringkat ini dihubungkan ke peringkat binaan melalui input_task_id.

Sifat

  • Name
    id
    Type
    string
    Description

    Pengenal unik untuk tugas. Walaupun kami menggunakan UUID yang boleh diurutkan k untuk id tugas sebagai butiran pelaksanaan, anda tidak seharusnya membuat sebarang andaian tentang format id.

  • Name
    type
    Type
    string
    Description

    Jenis tugas. Nilainya adalah creative-lab-vinyl-figure-prototype.

  • Name
    name
    Type
    string
    Description

    Nama tugas yang diberikan semasa tugas dicipta. Rentetan kosong jika tiada nama diberikan.

  • Name
    status
    Type
    string
    Description

    Status tugas. Nilai yang mungkin adalah salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Kemajuan tugas. Jika tugas belum dimulakan, sifat ini akan menjadi 0. Setelah tugas berjaya, ini akan menjadi 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Cap masa apabila tugas dicipta, dalam milisaat.

    Cap masa mewakili bilangan milisaat yang berlalu sejak 1 Januari 1970 UTC, mengikut piawaian RFC 3339. Sebagai contoh, Jumaat, 1 September 2023 12:00:00 PM GMT diwakili sebagai 1693569600000. Ini terpakai kepada semua cap masa dalam Meshy API.

  • Name
    started_at
    Type
    timestamp
    Description

    Cap masa apabila tugas dimulakan, dalam milisaat. Jika tugas belum dimulakan, sifat ini akan menjadi 0.

  • Name
    finished_at
    Type
    timestamp
    Description

    Cap masa apabila tugas selesai, dalam milisaat. Jika tugas belum selesai, sifat ini akan menjadi 0.

  • Name
    expires_at
    Type
    timestamp
    Description

    Cap masa apabila hasil tugas tamat tempoh, dalam milisaat.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Bilangan tugas terdahulu.

    Nilai medan ini bermakna hanya jika status tugas adalah PENDING.

  • Name
    task_error
    Type
    object
    Description

    Butiran ralat untuk tugas yang gagal. Lihat Ralat 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 untuk tugas FAILED (kredit dikembalikan semula apabila gagal).

  • Name
    image_urls
    Type
    array of strings
    Description

    URL yang boleh dimuat turun untuk calon imej konsep yang dijana oleh tugas prototip ini. Pada masa ini, API sentiasa mengembalikan tepat satu calon; medan ini adalah tatasusunan supaya semakan masa depan boleh menampilkan pelbagai calon tanpa perubahan yang memecahkan.

Contoh Objek Tugas Prototip Figura Vinyl

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Objek Tugasan Bina Figura Vinyl

Objek Tugasan Bina Figura Vinyl adalah unit kerja yang Meshy jejak untuk menjana figura vinyl 3D bertekstur daripada tugasan prototaip yang berjaya. Ia menjalankan saluran paip imej-ke-3D yang sama digunakan oleh Imej ke 3D, jadi medan output mencerminkan objek tugasan endpoint tersebut.

Sifat

  • Name
    id
    Type
    string
    Description

    Pengenal pasti unik untuk tugasan.

  • Name
    type
    Type
    string
    Description

    Jenis tugasan. Nilainya adalah creative-lab-vinyl-figure-build.

  • Name
    name
    Type
    string
    Description

    Nama tugasan yang diberikan semasa tugasan dicipta. Rentetan kosong jika tiada nama diberikan.

  • Name
    status
    Type
    string
    Description

    Status tugasan. Nilai yang mungkin adalah salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Kemajuan tugasan. Jika tugasan belum dimulakan, sifat ini akan menjadi 0. Setelah tugasan berjaya, ini akan menjadi 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Cap masa apabila tugasan dicipta, dalam milisaat.

  • Name
    started_at
    Type
    timestamp
    Description

    Cap masa apabila tugasan dimulakan, dalam milisaat.

  • Name
    finished_at
    Type
    timestamp
    Description

    Cap masa apabila tugasan selesai, dalam milisaat.

  • Name
    expires_at
    Type
    timestamp
    Description

    Cap masa apabila hasil tugasan tamat tempoh, dalam milisaat.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Bilangan tugasan terdahulu. Bermakna hanya apabila status adalah PENDING.

  • Name
    task_error
    Type
    object
    Description

    Butiran ralat untuk tugasan yang gagal. Lihat Ralat untuk rujukan penuh objek task_error.

  • Name
    consumed_credits
    Type
    integer
    Description

    Bilangan kredit yang digunakan oleh tugasan ini. Mengembalikan 0 untuk tugasan FAILED (kredit dikembalikan jika gagal).

  • Name
    prompt
    Type
    string
    Description

    Sentiasa kosong untuk bina figura vinyl. Hadir untuk keserasian rentas-endpoint dengan bentuk V2ImageTo3DTaskResponse yang dikongsi digunakan oleh Imej ke 3D.

  • Name
    negative_prompt
    Type
    string
    Description

    Sentiasa kosong untuk bina figura vinyl. Hadir untuk keserasian rentas-endpoint.

  • Name
    texture_prompt
    Type
    string
    Description

    Sentiasa kosong untuk bina figura vinyl. Hadir untuk keserasian rentas-endpoint.

  • Name
    texture_image_url
    Type
    string
    Description

    Sentiasa kosong untuk bina figura vinyl. Hadir untuk keserasian rentas-endpoint.

  • Name
    model_urls
    Type
    object
    Description

    URL boleh dimuat turun untuk model 3D yang dijana. Bina figura vinyl mengeluarkan GLB bertekstur serta pasangan OBJ + MTL untuk saluran paip yang lebih suka Wavefront OBJ. Bentuk medan sepadan dengan objek model_urls Imej ke 3D supaya penambahan format masa depan boleh dimasukkan tanpa perubahan yang memecahkan.

    • Name
      glb
      Type
      string
      Description

      URL boleh dimuat turun untuk fail GLB bertekstur.

    • Name
      obj
      Type
      string
      Description

      URL boleh dimuat turun untuk fail Wavefront OBJ (geometri + UV).

    • Name
      mtl
      Type
      string
      Description

      URL boleh dimuat turun untuk fail bahan MTL teman OBJ. Pasangkan dengan obj dan entri dari texture_urls[0].base_color.

  • Name
    thumbnail_url
    Type
    string
    Description

    URL boleh dimuat turun untuk imej kecil fail model.

  • Name
    texture_urls
    Type
    array
    Description

    Satu array objek URL tekstur yang dijana oleh tugasan ini. Pada masa ini mengandungi satu objek dengan peta warna asas.

    • Name
      base_color
      Type
      string
      Description

      URL boleh dimuat turun untuk imej peta warna asas.

Contoh Objek Tugasan Bina Figura Vinyl

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "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/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}