Creative Lab Q 版手辦 API

透過兩個階段，將一張照片轉換為大頭公仔收藏款 3D Q 版手辦。prototype 任務會根據照片生成一張概念圖像。build 任務會將該圖像轉換為帶材質的 3D 模型，並將 prototype 任務的 ID 作為 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

建立 Vinyl Figure prototype 任務

根據一張照片產生一張 vinyl-figure 風格的概念圖。若要建構 3D 模型，請將此任務的 ID 作為 input_task_id 傳遞給 build endpoint。有關該任務欄位的說明，請參閱 Vinyl Figure prototype 任務物件。

Request

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>"
  }'

Response

{
  "result": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
}

Prototype example

Start with a source photo, then generate the prototype image used by the build stage.

Source photo used as the Creative Lab Vinyl Figure input — Prototype input

Big-head vinyl figure prototype image generated from the source photo — Prototype output

參數

Name
image_url
Type
string
必選
Description
要轉換為大頭 vinyl figure 的照片，可以是公開可存取的 URL，也可以是 data URI（data:image/jpeg;base64,<your base64-encoded image data>）。
圖片必須是 JPG、JPEG、PNG 或 WebP 檔案，且不超過 20 MB。
Name
name
Type
string
Description
任務的名稱，最多 100 個字元。該名稱會在任務的 name 欄位中回傳。名稱過長會回傳 400。
Name
remove_background
Type
boolean
預設值 false
Description
是否從 prototype 圖像中移除背景。true 會回傳透明的 RGBA PNG，這樣你就能將主體放到任意背景上。build 階段也會以去除背景後的圖像作為起點。如果 Meshy 無法移除背景，它會回傳帶有背景的圖像，任務仍然會成功。

回傳值

result 欄位保存新 prototype 任務的 ID。取得任務或串流取得任務，直到 status 變為 SUCCEEDED。然後將該 ID 作為 input_task_id 傳遞給 build endpoint。

失敗情況

Name
400 - Bad Request
Description
請求無法執行。例如：
- 缺少 image_url。
- 圖片不是 JPG、JPEG、PNG 或 WebP 檔案。
- 圖片過小、超過 20 MB，或超過最大像素數限制。
- Meshy 無法下載該圖片，例如 URL 回傳 404 或逾時。
- data URI 不是有效的 base64 編碼。
- 該圖片被標記為 NSFW。
錯誤訊息會說明具體發現的問題。修正請求後重新傳送。
Name
401 - Unauthorized
Description
API 金鑰缺失或無效。請檢查 Authorization 請求標頭。
Name
402 - Payment Required
Description
以下情況之一適用：
- 帳戶的積分不足。
- API 金鑰、工作區或成員已達到其積分限額。
- 帳戶使用的是免費方案。
請檢查你的積分和方案，然後重試。
Name
403 - Forbidden
Description
你的團隊開啟了 IP Filtering，Meshy 將該圖片標記為涉及第三方智慧財產權。請傳送你擁有使用權的圖片。
Name
429 - Too Many Requests
Description
達到了以下某個限制：
- 你傳送的請求超出了速率限制所允許的數量。請等待幾秒鐘後重試。參見 Rate limits。
- 你排隊或正在執行的任務過多。請等待部分任務完成後重試。
- 在沒有積分的無限量方案下，已達到可在無積分情況下執行的任務數量上限。請等待某個任務完成，或增加積分。
Name
500 - Internal Server Error
Description
Meshy 遇到了伺服器錯誤，例如無法對圖片執行智慧財產權檢查。Meshy 不會建立該任務，並會退還已扣除的任何積分。請重試該請求。

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

創建一個 Vinyl Figure 構建任務

根據一個成功的原型任務生成帶貼圖的 3D vinyl figure。有關其欄位，請參閱 Vinyl Figure 構建任務物件。

Request

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"
  }'

Response

{
  "result": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef"
}

參數

Name
input_task_id
Type
string
必選
Description
要構建的原型任務的 ID。它必須是你的帳戶使用 POST /openapi/creative-lab/vinyl-figure/v1/prototype 創建的任務，且其狀態為 SUCCEEDED。
如果該 ID 不是來自 API 的 Vinyl Figure 原型任務之一，將返回 404，這也包括在 web 應用中創建的原型。
Name
name
Type
string
Description
任務的名稱，最多 100 個字元。它會在任務的 name 欄位中返回。超長的名稱會返回 400。

返回值

result 欄位保存新構建任務的 ID。取得該任務或對其進行串流取得，直到 status 為 SUCCEEDED。然後從 model_urls.glb 下載帶貼圖的 GLB。若需要 OBJ，則從 model_urls.obj 下載，並從 model_urls.mtl 下載其 material 檔案。

失敗模式

Name
400 - Bad Request
Description
請求無法執行。例如：
- input_task_id 缺失或不是有效的任務 ID。
- 原型任務的狀態不是 SUCCEEDED。如果它仍在執行中，請等待後重試。如果它失敗或被取消，請創建一個新的原型任務。
- 原型任務成功了，但沒有圖片。請創建一個新的原型任務。
錯誤訊息會說明發現了哪種問題。
Name
401 - Unauthorized
Description
API 金鑰缺失或無效。請檢查 Authorization 請求標頭。
Name
402 - Payment Required
Description
以下情況之一適用：
- 帳戶沒有足夠的積分。
- 該 API 金鑰、工作區或成員已達到其積分限額。
- 該帳戶處於免費方案。
請檢查你的積分和方案，然後重試。
Name
404 - Not Found
Description
input_task_id 與你的帳戶透過 API 創建的任何 Vinyl Figure 原型任務都不匹配。在 web 應用中創建的原型也會返回 404。請傳送來自原型創建回應中的 result ID。
Name
429 - Too Many Requests
Description
達到了以下限制之一：
- 你傳送的請求超過了速率限制允許的數量。請等待幾秒鐘後重試。參見速率限制。
- 你排隊或正在執行的任務過多。請等待部分任務完成後重試。
- 在無限方案下且積分已用完的情況下，你已達到了無需積分即可執行的任務數量上限。請等待某個任務完成，或增加積分。

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

取得 Vinyl Figure 任務

回傳一個 prototype 或 build 任務。路徑必須與任務所處的階段相符。透過 /prototype/:id 請求一個 build 任務會回傳 404，透過 /build/:id 請求一個 prototype 任務同樣會回傳 404。

關於欄位說明，請參閱 Vinyl Figure prototype 任務物件和 Vinyl Figure build 任務物件。

Request

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

Prototype Response

{
  "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=***"
  ]
}

Build Response

{
  "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=***"
    }
  ]
}

參數

Name
id
Type
path
Description
建立回應中回傳的任務 ID。

回傳值

與路徑所示階段相符的 prototype 任務物件或 build 任務物件。

失敗模式

Name
400 - Bad Request
Description
id 不是有效的任務 ID。請使用建立回應中回傳的 result ID。
Name
403 - Forbidden
Description
你的團隊已開啟 IP Filtering，且 Meshy 將該任務的圖片標記為涉及第三方智慧財產權。使用 Enterprise 方案的團隊不會收到此錯誤。請使用你擁有使用權的圖片來建立 prototype 任務。
Name
404 - Not Found
Description
你的帳戶下沒有此 ID 對應的 Vinyl Figure 任務，或該任務所處的階段與路徑不符。請檢查 ID，並使用 /prototype 或 /build 來對應該任務。
Name
500 - Internal Server Error
Description
Meshy 無法執行智慧財產權檢查。請重試請求。

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

刪除 Vinyl Figure 任務

取消一個 Vinyl Figure 任務。取消 PENDING 任務會退還其積分。IN_PROGRESS 任務被取消時不會退款，因為已有工作程序開始處理該任務。處於最終狀態（SUCCEEDED、FAILED 或 CANCELED）的任務無法取消。

路徑必須與任務所處的階段相符。例如，使用建構任務的 ID 對 /prototype/:id 執行 DELETE 操作會回傳 404。

Request

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

Response

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

路徑參數

Name
id
Type
path
Description
要取消的任務的 ID。

回傳值

204 No Content，回應內容為空。

失敗情況

Name
400 - Bad Request
Description
以下情況之一適用：
- id 不是有效的任務 ID。請傳送建立回應中的 result ID。
- 該任務已處於最終狀態（SUCCEEDED、FAILED 或 CANCELED），因此無法取消。
Name
404 - Not Found
Description
你的帳戶下沒有此 ID 對應的 Vinyl Figure 任務，或該任務所處的階段與路徑不符。請檢查 ID，並使用 /prototype 或 /build 來符合該任務。

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

以串流方式取得 Vinyl Figure 任務

以伺服器傳送事件（SSE）的形式串流傳輸 Vinyl Figure 任務的更新。路徑必須與任務所處的階段相符。如果不相符，例如將一個 build 任務的 ID 用於 /prototype/:id/stream，串流會傳送一個 status_code: 404 的 error 事件，然後關閉連線。

Request

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

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": "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=***"
    }
  ]
}

參數

Name
id
Type
path
Description
建立回應中回傳的任務 ID。

回傳值

一個 prototype 或 build 任務物件的串流。每個事件都攜帶完整的任務物件，與取得 Vinyl Figure 任務回傳的內容一致。當任務處於 PENDING 或 IN_PROGRESS 狀態時，其輸出欄位仍為空（null、[] 或 {}），finished_at 為 null。

如果IP 過濾功能攔截了任務的結果，串流會在該位置傳送一個 error 事件，其中的 status_code 與直接發出 get 請求時會回傳的狀態碼相同。

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

列出 Vinyl Figure 任務

返回你某個階段的 Vinyl Figure 任務，一次返回一頁。路徑決定了階段：/prototype 僅返回 prototype 任務，/build 僅返回 build 任務。

Request

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

Response (List Prototype Tasks)

[
  {
    "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=***"
    ]
  }
]

路徑參數

Name
stage
Type
path
必選
Description
要列出的階段，prototype 或 build。

查詢參數

Name
page_num
Type
integer
預設值 1
Description
要返回的頁碼，範圍為 1 到 255。0 返回第一頁。超出 0 到 255 範圍的值將返回 400。
Name
page_size
Type
integer
預設值 10
Description
每頁任務數量，最多 100。101 到 255 之間的值將返回 100 個任務，0 則使用預設值。超出 0 到 255 範圍的值將返回 400。
Name
sort_by
Type
string
預設值 -created_at
Description
排序方式。
可用值：
- -created_at：最新的排在前面
- +created_at：最舊的排在前面

返回值

一個陣列，包含與路徑中階段相符的 prototype 任務物件或build 任務物件。

The Vinyl Figure prototype task object

prototype 任務會根據照片生成 vinyl-figure 風格的概念圖。若要將圖像轉換為 3D 模型，請將該任務的 ID 作為 input_task_id 傳遞給build endpoint。

屬性

Example Vinyl Figure Prototype Task Object

{
  "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=***"
  ]
}

Name
id
Type
string
Description
任務 ID。請勿依賴其格式。
Name
type
Type
string
Description
任務類型，始終為 creative-lab-vinyl-figure-prototype。
Name
name
Type
string
Description
你在建立任務時傳送的 name，若未傳送則為 ""。
Name
status
Type
string
Description
任務的狀態。
可用值：
- PENDING：在佇列中等待
- IN_PROGRESS：正在生成結果
- SUCCEEDED：最終狀態，附帶結果
- FAILED：最終狀態，失敗原因在 task_error 中
- CANCELED：最終狀態，沒有結果
Name
progress
Type
integer
Description
已完成工作的百分比，範圍從 0 到 100。在任務開始之前為 0，成功後為 100。
Name
created_at
Type
timestamp
Description
任務建立的時間，以 Unix 毫秒表示。
Name
started_at
Type
timestamp
Description
工作處理程序開始處理任務的時間，以 Unix 毫秒表示。在此之前為 null。
Name
finished_at
Type
timestamp
Description
任務達到最終狀態的時間，以 Unix 毫秒表示。在此之前為 null。
Name
expires_at
Type
timestamp
Description
任務結果過期的時間，以 Unix 毫秒表示。該時間為 finished_at 之後 3 天，或在任務完成之前為 created_at 之後 3 天。對於會無限期保留 API 結果的企業版帳戶，該時間約為之後 100 年。參見資產保留期。
Name
preceding_tasks
Type
integer
Description
任務處於 PENDING 狀態時在佇列中的位置。1 表示它將是下一個開始的任務。任務離開佇列後為 0，在清單結果中始終為 0。
Name
task_error
Type
object
Description
任務失敗的原因。除非 status 為 FAILED，否則為 null。參見錯誤。
Name
consumed_credits
Type
integer
Description
該任務在退款之後所扣除的積分數量。回傳錯誤的請求不會被扣費。失敗的任務為 0，因為 Meshy 會對其進行退款。只有在任務處於 PENDING 狀態時取消才會退款。如果 Meshy 無法讀取扣費資訊，get 或 stream 回應中將不包含該欄位，而 list 請求會回傳 500。這種情況下，請重試該請求。
Name
image_urls
Type
array of strings
Description
概念圖的下載連結。任務成功後，該陣列中會有一個 URL，在此之前為空陣列。

Vinyl Figure 建置任務物件

建置任務會根據成功的原型任務產生帶貼圖的 3D vinyl figure。其 model_urls、thumbnail_url 和 texture_urls 欄位的格式與影象生成 3D 任務物件中的相同。

屬性

Example Vinyl Figure Build Task Object

{
  "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=***"
    }
  ]
}

Name
id
Type
string
Description
任務 ID。請勿依賴其格式。
Name
type
Type
string
Description
任務類型，始終為 creative-lab-vinyl-figure-build。
Name
name
Type
string
Description
你在建立任務時傳送的 name，如果未傳送，則為 ""。
Name
status
Type
string
Description
任務的狀態。
可用值：
- PENDING：在佇列中等待
- IN_PROGRESS：正在產生結果
- SUCCEEDED：最終狀態，附帶結果
- FAILED：最終狀態，原因見 task_error
- CANCELED：最終狀態，無結果
Name
progress
Type
integer
Description
已完成工作的百分比，範圍從 0 到 100。任務開始前為 0，成功後為 100。
Name
created_at
Type
timestamp
Description
任務建立的時間，以 Unix 毫秒表示。
Name
started_at
Type
timestamp
Description
工作程式開始處理該任務的時間，以 Unix 毫秒表示。在此之前為 null。
Name
finished_at
Type
timestamp
Description
任務到達最終狀態的時間，以 Unix 毫秒表示。在此之前為 null。
Name
expires_at
Type
timestamp
Description
任務結果過期的時間，以 Unix 毫秒表示。它是 finished_at 之後的 3 天，或者在任務完成之前是 created_at 之後的 3 天。對於會無限期保留 API 結果的企業版帳戶，這個時間約為 100 年之後。請參閱資產保留期。
Name
preceding_tasks
Type
integer
Description
任務處於 PENDING 狀態時在佇列中的位置。1 表示它將是下一個開始的任務。任務離開佇列後為 0，在列表結果中始終為 0。
Name
task_error
Type
object
Description
任務失敗的原因。除非 status 為 FAILED，否則為 null。請參閱錯誤。
Name
consumed_credits
Type
integer
Description
扣除任何退款後，該任務實際扣取的積分數量。回傳錯誤的請求不會被扣費。失敗的任務為 0，因為 Meshy 會對其進行退款。取消任務僅在其處於 PENDING 狀態時才會退款。如果 Meshy 無法讀取扣費資訊，get 或 stream 回應會省略該欄位，而 list 請求會回傳 500。在這種情況下，請重試該請求。
Name
prompt
Type
string
Description
對於 Vinyl Figure 建置任務，始終為 ""。
Name
negative_prompt
Type
string
Description
對於 Vinyl Figure 建置任務，與 prompt 一樣，始終為 ""。
Name
texture_prompt
Type
string
Description
對於 Vinyl Figure 建置任務，與 prompt 一樣，始終為 ""。
Name
texture_image_url
Type
string
Description
對於 Vinyl Figure 建置任務，與 prompt 一樣，始終為 ""。
Name
model_urls
Type
object
Description
3D 模型的下載 URL，分別為帶貼圖的 GLB 檔案，以及附帶 MTL 檔案的 OBJ 檔案。
- Name
  glb
  Type
  string
  Description
  帶貼圖的 GLB 檔案的下載 URL。
- Name
  obj
  Type
  string
  Description
  OBJ 檔案的下載 URL，包含幾何體和 UV。
- Name
  mtl
  Type
  string
  Description
  與 obj 搭配使用的 MTL 材質檔案的下載 URL。請將其與 obj 以及 texture_urls[0].base_color 中的紋理 / 貼圖一起使用。
Name
thumbnail_url
Type
string
Description
模型預覽圖片的下載 URL。
Name
texture_urls
Type
array
Description
貼圖集合，是一個包含單一物件的陣列，該物件保存基礎顏色貼圖。
- Name
  base_color
  Type
  string
  Description
  基礎顏色貼圖的下載 URL。