文字生成 3D API

文字生成 3D API 是一項功能，可讓你將 Meshy 的文字生成 3D 能力整合到你自己的應用程式中。在本節中，你將找到開始使用此 API 所需的所有資訊。

文字生成 3D 採用兩步驟工作流程。首先，建立一個預覽任務（mode: "preview"）產生不含貼圖的 3D 網格，以便評估模型形狀。接著，將已完成的預覽任務 ID 傳入精細化任務（mode: "refine"）來為網格加入貼圖。兩個步驟使用同一個介面。

POST/openapi/v2/text-to-3d

建立文字生成 3D 預覽任務

此介面用於建立文字生成 3D 預覽任務，根據文字提示生成不含貼圖的 3D 網格（僅幾何體）。這是兩步驟工作流程的第一步。預覽任務成功後，使用傳回的任務 ID 建立精修任務來新增貼圖。完整回應結構請參考文字生成 3D 任務物件。

參數

Name
mode
Type
string
必选
Description
建立預覽任務時，此欄位應設定為 "preview"。
Name
prompt
Type
string
必选
Description
描述 3D 模型是什麼類型的物體。最多 600 個字元。
Name
model_type
Type
string
默认值 standard
Description
指定 3D 網格生成的類型。
可選值：
- standard：一般高細節 3D 網格生成。
- lowpoly：生成最佳化後多邊形更精簡的低面數網格。
選擇 lowpoly 時，ai_model、topology、target_polycount、should_remesh 將被忽略。
Name
ai_model
Type
string
默认值 latest
Description
所用模型的 ID。可選值：meshy-5、meshy-6、latest（Meshy 6）。
Name
should_remesh
Type
boolean
默认值 false (meshy-6), true (others)
Description
控制是否啟用重拓撲階段。設定為 false 時，API 會直接傳回最高精度的三角網格。

仅当 should_remesh = true

Name
topology
Type
string
默认值 triangle
Description
指定生成模型的拓撲結構。
可選值：
- quad：生成以四邊形為主的網格
- triangle：生成簡化的三角網格
Name
target_polycount
Type
integer
默认值 30,000
Description
指定生成模型的目標面數。實際面數可能會因幾何複雜度而有所偏差。
有效取值範圍會依使用者等級而有所不同：
- 100 到 300,000（含）
Name
decimation_mode
Type
integer
Description
透過設定面數等級啟用自適應減面。設定後，target_polycount 將被忽略。
可選值：
- 1：自適應——超高面數。
- 2：自適應——高面數。
- 3：自適應——中等面數。
- 4：自適應——低面數。

Name
symmetry_mode
Type
string
⚠ 已弃用
默认值 auto
Description
已棄用。此參數不再影響輸出。
symmetry_mode 欄位控制模型生成過程中的對稱性行為。
可選值：
- off：關閉對稱
- auto：根據輸入幾何自動判斷並套用對稱
- on：強制對稱生成
Name
pose_mode
Type
string
默认值 ""
Description
指定生成模型的姿態模式。
可選值：
- a-pose：生成 A Pose 的模型。
- t-pose：生成 T Pose 的模型。
- ""（空字串）：不套用特定姿態。
Name
is_a_t_pose
Type
boolean
⚠ 已弃用
默认值 false
Description
請使用 pose_mode 取代。是否生成 A/T 姿態的模型。
Name
art_style
Type
string
⚠ 已弃用
默认值 realistic
Description
Meshy-6 不支援此參數。使用 Meshy-6 時會忽略 art_style，某些組合可能導致錯誤。可用值：realistic、sculpture。
使用 Sculpture 風格時，enable_pbr 應設定為 false，因為 Sculpture 風格會生成自己的 PBR 貼圖。
Name
moderation
Type
boolean
默认值 false
Description
設定為 true 時，輸入內容將自動進行潛在有害內容檢查。如果偵測到有害內容，任務將不會進入生成階段。
prompt 中的文字將會被檢查。
Name
target_formats
Type
string[]
Description
指定輸出中包含的 3D 檔案格式。只會生成並傳回所請求的格式，可縮短任務完成時間。省略時，將包含所有支援的格式。
可選值：glb、obj、fbx、stl、usdz、3mf
未指定時，除 3mf 外的所有格式均會生成。3mf 僅在明確指定時才會包含。
Name
alpha_thumbnail
Type
boolean
默认值 false
Description
設定為 true 時，任務會額外算繪一張透明背景（RGBA）的預覽圖，並在 GET 回應的 alpha_thumbnail_url 欄位中傳回。既有的 thumbnail_url 欄位保持不變。
Name
auto_size
Type
boolean
默认值 false
Description
設定為 true 時，服務會使用 AI 視覺自動估算物體的真實高度，並據此調整模型大小。除非明確設定了 origin_at，否則原點將預設為 bottom。

仅当 auto_size = true

Name
origin_at
Type
string
默认值 bottom
Description
auto_size 啟用時的原點位置。
可選值：bottom、center。

傳回值

回應的 result 欄位包含新建立的文字生成 3D 任務的 id。

失敗模式

Name
400 - Bad Request
Description
請求無效。常見原因：
- 缺少參數：未提供必要參數（如 prompt、mode）。
- 參數無效：art_style 不在允許的取值範圍內。
- 提示詞過長：prompt 超出字元數限制。
Name
401 - Unauthorized
Description
驗證失敗。請檢查您的 API 金鑰。
Name
402 - Payment Required
Description
點數不足，無法執行此任務。
Name
429 - Too Many Requests
Description
您已超出請求頻率限制。

请求

POST

/openapi/v2/text-to-3d

# 仅使用必需参数的简单预览
curl https://api.meshy.ai/openapi/v2/text-to-3d \
  -H 'Authorization: Bearer ${YOUR_API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "preview",
  "prompt": "a monster mask"
}'

# 启用重建网格和 A-pose 的预览
curl https://api.meshy.ai/openapi/v2/text-to-3d \
  -H 'Authorization: Bearer ${YOUR_API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "preview",
  "prompt": "a futuristic robot warrior",
  "should_remesh": true,
  "target_polycount": 100000,
  "pose_mode": "a-pose",
  "target_formats": ["glb"]
}'

响应

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

POST/openapi/v2/text-to-3d

建立文字生成 3D 精細化任務

此 API 用於建立文字生成 3D 精細化任務，為已完成的預覽網格加入貼圖。你需要提供來自已成功預覽任務的 preview_task_id。這是兩步驟工作流程的第二步。

參數

Name
mode
Type
string
必选
Description
建立精細化任務時，此欄位應設為 "refine"。
Name
preview_task_id
Type
string
必选
Description
對應的預覽任務 id。
指定的預覽任務狀態必須為 SUCCEEDED。
Name
enable_pbr
Type
boolean
默认值 false
Description
生成 PBR 貼圖（金屬度、粗糙度、法線）以及基礎色貼圖。當 ai_model 為 meshy-6 或 latest 時，還會額外生成自發光貼圖。
Name
hd_texture
Type
boolean
默认值 false
Description
以 4K（4096×4096）解析度生成基礎色貼圖，以取得更高細節。
僅在 ai_model 為 meshy-6 或 latest 時支援。PBR 貼圖一律以 2K 解析度生成。
Name
texture_prompt
Type
string
Description
提供額外的文字提示以引導貼圖流程。最多 600 個字元。
Name
texture_image_url
Type
string
Description
提供 2D 圖片以引導貼圖流程。目前支援 .jpg、.jpeg 和 .png 格式。
提供圖片有兩種方式：
- 可公開存取的 URL：可從公開網路存取的圖片連結
- Data URI：圖片的 base64 編碼 Data URI。例如：data:image/jpeg;base64;<your base64-encoded image data>
如果原始資產與上傳圖片在幾何形狀上有較大差異，圖片貼圖效果可能不佳。texture_image_url 和 texture_prompt 只能擇一使用。如果兩者都提供，則預設使用 texture_prompt 進行貼圖。
Name
ai_model
Type
string
默认值 latest
Description
用於最佳化的模型 ID。可選值：meshy-5、meshy-6、latest（Meshy 6）。
Name
moderation
Type
boolean
默认值 false
Description
當設為 true 時，輸入內容將自動進行潛在有害內容篩檢。如果偵測到有害內容，任務將不會進入生成階段。
texture_prompt 中的文字和 texture_image_url 中的圖片都會被篩檢。
Name
remove_lighting
Type
boolean
默认值 true
Description
移除基礎色貼圖中的高光和陰影，生成更乾淨的效果，在自訂光照設定下表現更佳。
僅當 ai_model 為 meshy-6 或 latest 時支援。
Name
target_formats
Type
string[]
Description
指定輸出中包含的 3D 檔案格式。只會生成並傳回所要求的格式，可減少任務完成時間。省略時，將包含所有支援的格式。
可選值：glb、obj、fbx、stl、usdz、3mf
未指定時，除 3mf 外的所有格式都會生成。3mf 僅在明確指定時才會包含。
Name
alpha_thumbnail
Type
boolean
默认值 false
Description
當設為 true 時，任務會額外渲染一張透明背景（RGBA）的預覽圖，並在 GET 回應的 alpha_thumbnail_url 欄位中傳回。原有 thumbnail_url 欄位保持不變。
Name
auto_size
Type
boolean
默认值 false
Description
當設為 true 時，服務會使用 AI 視覺自動估算物體的真實高度，並相應調整模型大小。除非明確設定了 origin_at，否則原點將預設為 bottom。

仅当 auto_size = true

Name
origin_at
Type
string
默认值 bottom
Description
啟用 auto_size 時的原點位置。
可選值：bottom、center。

傳回值

回應的 result 欄位包含新建立的文字生成 3D 任務的 id。

失敗模式

Name
400 - Bad Request
Description
請求不合法。常見原因：
- 任務 ID 無效：preview_task_id 無效或不存在。
- 任務尚未就緒：預覽任務尚未成功完成。
- 模型不相符：預覽任務的 AI 模型與請求的精細化模型不相容。
Name
401 - Unauthorized
Description
驗證失敗。請檢查您的 API 金鑰。
Name
402 - Payment Required
Description
點數不足，無法執行此任務。
Name
404 - Not Found
Description
找不到 preview_task_id 指定的預覽任務。
Name
429 - Too Many Requests
Description
您已超出請求頻率限制。

请求

POST

/openapi/v2/text-to-3d

# 基本精细化任务
curl https://api.meshy.ai/openapi/v2/text-to-3d \
  -H 'Authorization: Bearer ${YOUR_API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "refine",
  "preview_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "enable_pbr": true
}'

# 启用自动尺寸和 GLB 格式的精细化
curl https://api.meshy.ai/openapi/v2/text-to-3d \
  -H 'Authorization: Bearer ${YOUR_API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "refine",
  "preview_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "target_formats": ["glb"],
  "auto_size": true
}'

响应

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

GET/openapi/v2/text-to-3d/:id

取得文字生成 3D 任務

此 API 可讓你透過有效的任務 id 取得文字生成 3D 任務。請參考文字生成 3D 任務物件查看任務物件包含的屬性。

此 API 同時適用於預覽和精細化任務。

參數

Name
id
Type
path
Description
要取得的文字生成 3D 任務的唯一識別碼。

回傳值

回應包含文字生成 3D 任務物件。詳情請查看文字生成 3D 任務物件部分。

範例

模式	範例模型
預覽
精細化

请求

GET

/openapi/v2/text-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v2/text-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

响应

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "text-to-3d-preview",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "prompt": "a monster mask",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 20
}

DELETE/openapi/v2/text-to-3d/:id

刪除文字轉 3D 任務

此端點可永久刪除文字轉 3D 任務，包括所有關聯的模型和資料。此操作無法復原。

路徑參數

Name
id
Type
path
Description
要刪除的文字轉 3D 任務的 ID。

回傳值

成功則回傳 200 OK。

请求

DELETE

/openapi/v2/text-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v2/text-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

响应

// 成功则返回 200 Ok。

GET/openapi/v2/text-to-3d

取得文字生成 3D 任務清單

此介面用於取得文字生成 3D 任務清單。

參數

Name
page_num
Type
integer
默认值 1
Description
分頁頁碼。
Name
page_size
Type
integer
默认值 10
Description
分頁大小限制。最多允許 50 筆。
Name
sort_by
Type
string
Description
排序欄位。
可選值：
- +created_at：依建立時間升冪排序。
- -created_at：依建立時間降冪排序。

回傳值

回傳文字生成 3D 任務物件的分頁清單。

请求

GET

/openapi/v2/text-to-3d

curl https://api.meshy.ai/openapi/v2/text-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

响应

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "text-to-3d-preview",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
      "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "prompt": "a monster mask",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 20
  }
]

GET/openapi/v2/text-to-3d/:id/stream

串流取得文字生成 3D 任務

此 API 透過 Server-Sent Events (SSE) 即時串流回傳文字生成 3D 任務的進度更新。

參數

Name
id
Type
path
Description
要串流取得的文字生成 3D 任務唯一識別碼。

回傳值

回傳文字生成 3D 任務物件的 SSE 即時串流。

對於 PENDING 或 IN_PROGRESS 狀態的任務，回應串流僅包含必要的 progress 和 status 欄位。

请求

GET

/openapi/v2/text-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v2/text-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

响应流

// 错误事件示例
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// 消息事件示例，展示任务进度。
// 对于 PENDING 或 IN_PROGRESS 状态的任务，响应流不会包含所有字段。
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: {
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "text-to-3d-preview",
"progress": 100,
"status": "SUCCEEDED",
"created_at": 1692771650657,
"started_at": 1692771667037,
"finished_at": 1692771669037,
"model_urls": {
  "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***"
},
"texture_urls": [
  {
    "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
    "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
    "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
    "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
    "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
  }
],
"preceding_tasks": 0,
"task_error": {

  "message": ""

},

"consumed_credits": 20
}

文字生成 3D 任務物件

文字生成 3D 任務物件是 Meshy 用於追蹤從文字輸入生成 3D 模型的工作單元。文字生成 3D API 分為兩個階段：preview（預覽）和 refine（精細化）。預覽階段用於生成僅有網格的 3D 模型，精細化階段則基於預覽結果生成帶有貼圖的 3D 模型。

該物件包含以下屬性：

屬性

Name
id
Type
string
Description
任務的唯一識別碼。雖然我們採用 k-sortable UUID 作為任務 id 的實作細節，但你不應對 id 格式做任何假設。
Name
type
Type
string
Description
文字生成 3D 任務的類型。傳回值為 text-to-3d-preview（預覽階段任務）或 text-to-3d-refine（精細化階段任務）。
Name
model_urls
Type
object
Description
Meshy 生成的帶貼圖 3D 模型檔案可下載連結。如果某種格式未生成，則不會傳回該屬性。
- Name
  glb
  Type
  string
  Description
  GLB 檔案的可下載連結。
- Name
  fbx
  Type
  string
  Description
  FBX 檔案的可下載連結。
- Name
  usdz
  Type
  string
  Description
  USDZ 檔案的可下載連結。
- Name
  obj
  Type
  string
  Description
  OBJ 檔案的可下載連結。
- Name
  mtl
  Type
  string
  Description
  MTL 檔案的可下載連結。
- Name
  stl
  Type
  string
  Description
  STL 檔案的可下載連結。
- Name
  3mf
  Type
  string
  Description
  3MF 檔案的可下載連結。僅在透過 target_formats 請求 3mf 時傳回。
Name
prompt
Type
string
Description
建立任務時使用的原始 prompt。
Name
negative_prompt
Type
string
⚠ 已弃用
Description
為相容性保留，對生成模型無實際影響。
Name
art_style
Type
string
⚠ 已弃用
Description
建立預覽任務時使用的原始 art_style。Meshy-6 不再支援。
Name
texture_richness
Type
string
⚠ 已弃用
Description
為相容性保留，對生成模型無實際影響。
Name
texture_prompt
Type
string
Description
精細化階段用於引導貼圖流程的額外文字提示。
Name
texture_image_url
Type
string
Description
用於引導貼圖流程的圖片下載連結。
Name
thumbnail_url
Type
string
Description
模型檔案縮圖的可下載連結。
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url 的透明背景（RGBA）版本可下載 URL。僅當建立任務時設定了 alpha_thumbnail: true 且成功算繪出透明預覽圖時才會傳回，否則會省略該欄位。
Name
video_url
Type
string
⚠ 已弃用
Description
預覽影片的可下載連結。將在後續版本移除。
Name
progress
Type
integer
Description
任務進度。如果任務尚未開始，該值為 0。任務成功後為 100。
Name
started_at
Type
timestamp
Description
任務開始時間的時間戳（毫秒）。如果任務尚未開始，該值為 0。
時間戳表示自 1970 年 1 月 1 日 UTC 起經過的毫秒數，遵循 RFC 3339 標準。例如，2023 年 9 月 1 日 12:00:00 GMT 表示為 1693569600000。Meshy API 中所有時間戳均採用此標準。
Name
created_at
Type
timestamp
Description
任務建立時間的時間戳（毫秒）。
Name
finished_at
Type
timestamp
Description
任務完成時間的時間戳（毫秒）。如果任務尚未完成，該值為 0。
Name
status
Type
string
Description
任務狀態。可能值為 PENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELED。
Name
texture_urls
Type
array
Description
任務生成的貼圖 URL 物件陣列。通常只包含一個貼圖 URL 物件。每個貼圖 URL 包含以下屬性：
- Name
  base_color
  Type
  string
  Description
  基礎色貼圖的可下載連結。
- Name
  metallic
  Type
  string
  Description
  金屬度貼圖的可下載連結。
  如果建立任務時 enable_pbr: false，則不會傳回該屬性。
- Name
  normal
  Type
  string
  Description
  法線貼圖的可下載連結。
  如果建立任務時 enable_pbr: false，則不會傳回該屬性。
- Name
  roughness
  Type
  string
  Description
  粗糙度貼圖的可下載連結。
  如果建立任務時 enable_pbr: false，則不會傳回該屬性。
- Name
  emission
  Type
  string
  Description
  自發光貼圖的可下載連結。
  如果建立任務時 enable_pbr: false，或 ai_model 為 meshy-5，則不會傳回該屬性。
Name
preceding_tasks
Type
integer
Description
前置任務數量。
僅當任務狀態為 PENDING 時，該欄位才有意義。
Name
task_error
Type
object
Description
失敗任務的錯誤詳細資訊。完整 task_error 物件參考請查看錯誤處理。
Name
consumed_credits
Type
integer
Description
該任務消耗的積分數。當任務狀態為 PENDING、IN_PROGRESS 或 SUCCEEDED 時傳回。對於 FAILED 任務傳回 0（失敗時積分會被退還）。

文本生成3D任务对象示例

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "text-to-3d-preview",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "prompt": "a monster mask",
  "texture_prompt": "green slimy skin with scales and warts",
  "texture_image_url": "",
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "progress": 100,
  "seed": 1234,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 20
}