Creative Lab 方塊小人 API

透過兩個階段，將一張照片轉換為方塊風格的收藏款 3D 小人（minifigure）。原型任務會根據照片產生一張概念圖，構建任務則將該圖像轉換為帶材質的 3D 模型，並以原型任務的 ID 作為 input_task_id。

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

POST/openapi/creative-lab/brick-figure/v1/prototype

建立 Brick Figure prototype 任務

根據一張照片生成一張方塊風格的概念圖。要建構 3D 模型，請將此任務的 ID 作為 input_task_id 傳遞給 build endpoint。有關任務欄位的說明，請參閱 The Brick Figure prototype task object。

Request

POST

/openapi/creative-lab/brick-figure/v1/prototype

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

參數

Name
image_url
Type
string
必選
Description
要轉換為方塊小人的照片，可以是公開可存取的 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
是否從原型圖片中移除背景。true 會回傳一張透明的 RGBA PNG，這樣你就可以將主體放到任意背景上。建構過程也會使用去除背景後的圖片作為起點。如果 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/brick-figure/v1/build

建立方塊小人構建任務

根據一個已成功的原型任務生成帶貼圖的 3D 小人模型。有關其欄位資訊，請參閱 The Brick Figure build task object。

Request

POST

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

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/brick-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"
}

參數

Name
input_task_id
Type
string
必選
Description
要構建的原型任務的 ID。它必須是你的帳戶透過 POST /openapi/creative-lab/brick-figure/v1/prototype 建立的任務，且狀態為 SUCCEEDED。
如果該 ID 不是你透過 API 建立的 Brick Figure 原型任務之一，將回傳 404，這也包括在 web app 中建立的原型。
Name
name
Type
string
Description
任務的名稱，最多 100 個字元。它會在任務的 name 欄位中回傳。名稱過長會回傳 400。

回傳值

result 欄位保存新建構任務的 ID。取得任務或串流取得任務，直到 status 變為 SUCCEEDED。然後從 model_urls.glb 下載帶貼圖的 GLB。如果需要 OBJ，則從 model_urls.obj 下載 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 建立的任何 Brick Figure 原型任務都不相符。在 web app 中建立的原型也會回傳 404。請傳送來自原型建立回應的 result ID。
Name
429 - Too Many Requests
Description
達到了以下限制之一：
- 你傳送的請求數超過了速率限制所允許的數量。請等待幾秒鐘後重試。參閱 Rate limits。
- 你排隊或正在執行的任務太多。請等待部分任務完成後重試。
- 在不限量方案下且沒有剩餘積分時，你達到了無需積分即可執行的任務數量上限。請等待某個任務完成，或增加積分。

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

獲取方塊小人任務

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

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

Request

GET

/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578

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

# Build
curl https://api.meshy.ai/openapi/creative-lab/brick-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-brick-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-brick-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=***"
    }
  ]
}

參數

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

回傳值

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

失敗模式

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

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

刪除 Brick Figure 任務

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

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

Request

DELETE

/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/brick-figure/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -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 對應的 Brick Figure 任務，或者該任務所處的階段與路徑不符。請檢查 ID，並使用 /prototype 或 /build 來符合該任務。

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

流式取得 Brick Figure 任務

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

Request

GET

/openapi/creative-lab/brick-figure/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream

curl -N https://api.meshy.ai/openapi/creative-lab/brick-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-brick-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=***"
    }
  ]
}

參數

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

回傳

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

如果IP 過濾功能阻擋了任務結果的回傳，該串流會在相應位置發送一則 error 事件，其中 status_code 與 get 請求本應回傳的值一致。

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

取得 Brick Figure 任務清單

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

Request

GET

/openapi/creative-lab/brick-figure/v1/prototype

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

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/brick-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-brick-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
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 任務物件組成的陣列，具體取決於路徑中指定的階段。

Brick Figure prototype 任務物件

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

Properties

Example Brick Figure Prototype Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-brick-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。不要依賴其格式。
Name
type
Type
string
Description
任務類型，始終為 creative-lab-brick-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。任務成功後，該陣列中會有一個 URL；在此之前為空陣列。

方塊小人構建任務物件

構建任務會根據一個成功的原型任務生成帶貼圖的 3D 小人模型。其 model_urls、thumbnail_url 和 texture_urls 欄位的格式與影象生成 3D 任務物件中的相同。

屬性

Example Brick Figure Build Task Object

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-brick-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=***"
    }
  ]
}

Name
id
Type
string
Description
任務 ID。不要依賴其格式。
Name
type
Type
string
Description
任務類型，始終為 creative-lab-brick-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
對於方塊小人構建任務，始終為 ""。
Name
negative_prompt
Type
string
Description
與 prompt 一樣，對於方塊小人構建任務始終為 ""。
Name
texture_prompt
Type
string
Description
與 prompt 一樣，對於方塊小人構建任務始終為 ""。
Name
texture_image_url
Type
string
Description
與 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。