API tượng Creative Lab
Biến một bức ảnh thành một tượng 3D sưu tầm theo phong cách chibi qua hai giai đoạn. Một tác vụ prototype sẽ tạo ra một hình ảnh khái niệm từ bức ảnh. Một tác vụ build sẽ biến hình ảnh đó thành một mô hình 3D có texture, và lấy ID của tác vụ prototype làm input_task_id.
POST /openapi/creative-lab/figure/v1/prototypePOST /openapi/creative-lab/figure/v1/build
Tạo tác vụ prototype Figure
Tạo một hình ảnh concept phong cách chibi từ một bức ảnh. Để xây dựng mô hình 3D, hãy truyền ID của tác vụ này tới build endpoint dưới dạng input_task_id. Để biết các trường của tác vụ, xem Đối tượng tác vụ prototype Figure.
Request
# 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"
}
Tham số
- Name
- image_url
- Type
- string
- Bắt buộc
- Description
Bức ảnh để chuyển thành tượng chibi, dưới dạng URL công khai hoặc data URI (
data:image/jpeg;base64,<dữ liệu ảnh được mã hóa base64 của bạn>).Hình ảnh phải là tệp JPG, JPEG, PNG hoặc WebP dung lượng tối đa 20 MB.
- Name
- name
- Type
- string
- Description
Tên cho tác vụ, tối đa 100 ký tự. Tên này sẽ được trả về trong trường
namecủa tác vụ. Tên dài hơn sẽ trả về lỗi400.
- Name
- remove_background
- Type
- boolean
- mặc định false
- Description
Có xóa nền khỏi hình ảnh prototype hay không.
truesẽ trả về một ảnh PNG RGBA trong suốt, nhờ đó bạn có thể đặt chủ thể lên bất kỳ nền nào. Quá trình build cũng sẽ bắt đầu từ hình ảnh không có nền. Nếu Meshy không thể xóa nền, nó sẽ trả về hình ảnh kèm nền, và tác vụ vẫn thành công.
Giá trị trả về
Trường result chứa ID của tác vụ prototype mới. Lấy tác vụ hoặc stream tác vụ cho đến khi status là SUCCEEDED. Sau đó truyền ID này tới build endpoint dưới dạng input_task_id.
Các chế độ lỗi
- Name
400 - Bad Request- Description
Yêu cầu không thể chạy. Ví dụ:
- Thiếu
image_url. - Hình ảnh không phải là tệp JPG, JPEG, PNG hoặc WebP.
- Hình ảnh quá nhỏ, vượt quá 20 MB, hoặc vượt quá số lượng pixel tối đa.
- Meshy không thể tải hình ảnh xuống, ví dụ do URL trả về
404hoặc hết thời gian chờ. - Data URI không phải là base64 hợp lệ.
- Hình ảnh bị gắn cờ là NSFW.
Thông báo lỗi cho biết vấn đề nào đã được phát hiện. Hãy sửa yêu cầu rồi gửi lại.
- Thiếu
- Name
401 - Unauthorized- Description
Khóa API bị thiếu hoặc không hợp lệ. Kiểm tra header
Authorization.
- Name
402 - Payment Required- Description
Một trong các trường hợp sau xảy ra:
- Tài khoản không có đủ tín dụng.
- Khóa API, không gian làm việc, hoặc thành viên đã đạt giới hạn tín dụng.
- Tài khoản đang ở gói miễn phí.
Kiểm tra tín dụng và gói của bạn, sau đó thử lại.
- Name
403 - Forbidden- Description
Nhóm của bạn đã bật IP Filtering, và Meshy đã gắn cờ hình ảnh này do vi phạm sở hữu trí tuệ của bên thứ ba. Hãy gửi một hình ảnh mà bạn có quyền sử dụng.
- Name
429 - Too Many Requests- Description
Một trong các giới hạn sau đã đạt tới:
- Bạn đã gửi nhiều yêu cầu hơn mức giới hạn tốc độ cho phép. Hãy đợi vài giây rồi thử lại. Xem Giới hạn tốc độ.
- Có quá nhiều tác vụ của bạn đang xếp hàng hoặc đang chạy. Hãy đợi một số tác vụ hoàn tất rồi thử lại.
- Ở gói không giới hạn nhưng không còn tín dụng, bạn đã đạt đến số lượng tác vụ có thể chạy mà không cần tín dụng. Hãy đợi một tác vụ hoàn tất, hoặc nạp thêm tín dụng.
- Name
500 - Internal Server Error- Description
Meshy gặp lỗi máy chủ, ví dụ do không thể chạy kiểm tra sở hữu trí tuệ trên hình ảnh. Meshy không tạo tác vụ, và hoàn lại bất kỳ khoản tín dụng nào đã tính phí. Hãy thử lại yêu cầu.
Tạo một tác vụ build Figure
Tạo ra mô hình tượng 3D đã được áp vật liệu từ một tác vụ prototype đã thành công. Để biết các trường của nó, xem Đối tượng tác vụ build Figure.
Request
# 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"
}
Tham số
- Name
- input_task_id
- Type
- string
- Bắt buộc
- Description
ID của tác vụ prototype cần build. Đây phải là một tác vụ do tài khoản của bạn tạo bằng
POST /openapi/creative-lab/figure/v1/prototype, với trạng tháiSUCCEEDED.Một ID không phải là tác vụ prototype Figure của bạn từ API sẽ trả về
404, kể cả khi đó là một prototype được tạo trong ứng dụng web.
- Name
- name
- Type
- string
- Description
Tên cho tác vụ, tối đa 100 ký tự. Nó sẽ xuất hiện trong trường
namecủa tác vụ. Tên dài hơn sẽ trả về400.
Giá trị trả về
Trường result chứa ID của tác vụ build mới. Lấy tác vụ hoặc stream nó cho đến khi status là SUCCEEDED. Sau đó tải xuống GLB đã áp vật liệu từ model_urls.glb. Để thay thế bằng OBJ, hãy tải xuống model_urls.obj cùng với tệp vật liệu của nó từ model_urls.mtl.
Các chế độ lỗi
- Name
400 - Bad Request- Description
Không thể thực hiện yêu cầu. Ví dụ:
input_task_idbị thiếu hoặc không phải là một ID tác vụ hợp lệ.- Trạng thái của tác vụ prototype không phải là
SUCCEEDED. Nếu nó vẫn đang chạy, hãy đợi rồi thử lại. Nếu nó thất bại hoặc bị hủy, hãy tạo một tác vụ prototype mới. - Tác vụ prototype thành công nhưng không có hình ảnh. Hãy tạo một tác vụ prototype mới.
Thông báo lỗi sẽ cho biết vấn đề nào đã được phát hiện.
- Name
401 - Unauthorized- Description
Khóa API bị thiếu hoặc không hợp lệ. Kiểm tra tiêu đề
Authorization.
- Name
402 - Payment Required- Description
Một trong các trường hợp sau áp dụng:
- Tài khoản không có đủ tín dụng.
- Khóa API, không gian làm việc hoặc thành viên đã đạt đến giới hạn tín dụng.
- Tài khoản đang ở gói miễn phí.
Hãy kiểm tra tín dụng và gói của bạn, sau đó thử lại.
- Name
404 - Not Found- Description
input_task_idkhông khớp với bất kỳ tác vụ prototype Figure nào mà tài khoản của bạn đã tạo bằng API. Một prototype được tạo trong ứng dụng web cũng sẽ trả về404. Hãy gửi IDresulttừ một phản hồi tạo prototype.
- Name
429 - Too Many Requests- Description
Một trong các giới hạn sau đã đạt tới:
- Bạn đã gửi nhiều yêu cầu hơn mức giới hạn tốc độ cho phép. Hãy đợi vài giây rồi thử lại. Xem Giới hạn tốc độ.
- Có quá nhiều tác vụ của bạn đang xếp hàng hoặc đang chạy. Hãy đợi một số tác vụ hoàn thành rồi thử lại.
- Trên gói không giới hạn nhưng không còn tín dụng, bạn đã đạt đến số lượng tác vụ có thể chạy mà không cần tín dụng. Hãy đợi một tác vụ hoàn thành, hoặc nạp thêm tín dụng.
Lấy tác vụ tượng
Trả về một tác vụ prototype hoặc build. Đường dẫn phải khớp với giai đoạn của tác vụ. Một tác vụ build được yêu cầu thông qua /prototype/:id sẽ trả về 404, và một tác vụ prototype được yêu cầu thông qua /build/:id cũng vậy.
Để biết các trường, xem Đối tượng tác vụ prototype tượng và Đối tượng tác vụ build tượng.
Request
# 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
}
Tham số
- Name
- id
- Type
- path
- Description
ID tác vụ từ phản hồi tạo.
Giá trị trả về
Đối tượng tác vụ prototype hoặc đối tượng tác vụ build, tương ứng với giai đoạn trong đường dẫn.
Các chế độ lỗi
- Name
400 - Bad Request- Description
idkhông phải là một ID tác vụ hợp lệ. Hãy gửi IDresulttừ phản hồi tạo.
- Name
403 - Forbidden- Description
Nhóm của bạn đã bật IP Filtering, và Meshy đã gắn cờ hình ảnh của tác vụ vì sở hữu trí tuệ của bên thứ ba. Các nhóm thuộc gói Enterprise sẽ không gặp lỗi này. Hãy tạo tác vụ prototype từ một hình ảnh mà bạn có quyền sử dụng.
- Name
404 - Not Found- Description
Không có tác vụ Tượng nào với ID này thuộc tài khoản của bạn, hoặc giai đoạn của tác vụ không khớp với đường dẫn. Hãy kiểm tra ID, và sử dụng
/prototypehoặc/buildđể khớp với tác vụ.
- Name
500 - Internal Server Error- Description
Meshy không thể chạy kiểm tra sở hữu trí tuệ. Hãy thử lại yêu cầu.
Xóa một tác vụ tượng
Hủy một tác vụ tượng. Hủy một tác vụ PENDING sẽ hoàn lại tín dụng của tác vụ đó. Một tác vụ IN_PROGRESS bị hủy mà không được hoàn tín dụng, vì một worker đã bắt đầu xử lý nó. Một tác vụ có trạng thái cuối cùng (SUCCEEDED, FAILED, hoặc CANCELED) không thể bị hủy.
Đường dẫn phải khớp với giai đoạn của tác vụ. Ví dụ, gọi DELETE trên /prototype/:id với ID của một tác vụ build sẽ trả về 404.
Request
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).
Tham số đường dẫn
- Name
- id
- Type
- path
- Description
ID của tác vụ cần hủy.
Giá trị trả về
204 No Content với nội dung rỗng.
Các chế độ lỗi
- Name
400 - Bad Request- Description
Một trong các trường hợp sau áp dụng:
idkhông phải là một ID tác vụ hợp lệ. Hãy gửi IDresulttừ phản hồi tạo tác vụ.- Tác vụ đã có trạng thái cuối cùng (
SUCCEEDED,FAILED, hoặcCANCELED), vì vậy không thể hủy được.
- Name
404 - Not Found- Description
Không có tác vụ tượng nào với ID này thuộc về tài khoản của bạn, hoặc giai đoạn của tác vụ không khớp với đường dẫn. Hãy kiểm tra lại ID, và sử dụng
/prototypehoặc/buildđể khớp với tác vụ.
Stream a Figure task
Phát trực tuyến các cập nhật của một tác vụ Figure dưới dạng Server-Sent Events (SSE). Đường dẫn phải khớp với giai đoạn của tác vụ. Nếu không khớp, ví dụ như ID của một tác vụ build tại /prototype/:id/stream, luồng sẽ gửi một sự kiện error với status_code: 404 rồi đóng lại.
Request
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
}
Tham số
- Name
- id
- Type
- path
- Description
ID của tác vụ từ phản hồi tạo tác vụ.
Giá trị trả về
Một luồng các đối tượng tác vụ prototype hoặc build. Mỗi sự kiện chứa toàn bộ đối tượng tác vụ, giống như Get a Figure task trả về. Trong khi tác vụ đang ở trạng thái PENDING hoặc IN_PROGRESS, các trường đầu ra của nó vẫn còn trống (null, [], hoặc {}), và finished_at là null.
Nếu IP Filtering chặn kết quả của tác vụ, luồng sẽ gửi một sự kiện error thay thế, với status_code mà một yêu cầu get sẽ trả về.
Liệt kê các tác vụ Figure
Trả về các tác vụ Figure của bạn thuộc một giai đoạn, mỗi lần một trang. Đường dẫn sẽ chọn giai đoạn. /prototype chỉ trả về các tác vụ prototype, và /build chỉ trả về các tác vụ build.
Request
# 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=***"
]
}
]
Tham số đường dẫn
- Name
- stage
- Type
- path
- Bắt buộc
- Description
Giai đoạn cần liệt kê,
prototypehoặcbuild.
Tham số truy vấn
- Name
- page_num
- Type
- integer
- mặc định 1
- Description
Trang cần trả về, từ
1đến255.0sẽ trả về trang đầu tiên. Giá trị ngoài khoảng0đến255sẽ trả về400.
- Name
- page_size
- Type
- integer
- mặc định 10
- Description
Số lượng tác vụ trên mỗi trang, tối đa
100. Giá trị từ101đến255sẽ trả về 100 tác vụ, và0sẽ sử dụng giá trị mặc định. Giá trị ngoài khoảng0đến255sẽ trả về400.
- Name
- sort_by
- Type
- string
- mặc định -created_at
- Description
Thứ tự sắp xếp.
Các giá trị khả dụng:
-created_at: mới nhất trước+created_at: cũ nhất trước
Giá trị trả về
Một mảng gồm các đối tượng tác vụ prototype hoặc đối tượng tác vụ build, tương ứng với giai đoạn trong đường dẫn.
Đối tượng tác vụ nguyên mẫu Figure
Một tác vụ nguyên mẫu tạo ra một hình ảnh ý tưởng theo phong cách chibi từ một bức ảnh. Để biến hình ảnh đó thành mô hình 3D, hãy truyền ID của tác vụ cho endpoint tạo bản dựng dưới dạng input_task_id.
Thuộc tính
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 của tác vụ. Đừng dựa vào định dạng của nó.
- Name
- type
- Type
- string
- Description
Loại tác vụ, luôn là
creative-lab-figure-prototype.
- Name
- name
- Type
- string
- Description
namebạn đã gửi khi tạo tác vụ, hoặc""nếu bạn không gửi.
- Name
- status
- Type
- string
- Description
Trạng thái của tác vụ.
Các giá trị khả dụng:
PENDING: đang chờ trong hàng đợiIN_PROGRESS: đang tạo kết quảSUCCEEDED: đã hoàn tất, có kết quảFAILED: đã hoàn tất, kèm lý do trongtask_errorCANCELED: đã hoàn tất, không có kết quả
- Name
- progress
- Type
- integer
- Description
Phần trăm công việc đã hoàn thành, từ
0đến100. Giá trị này là0cho đến khi tác vụ bắt đầu và100khi tác vụ thành công.
- Name
- created_at
- Type
- timestamp
- Description
Thời điểm tác vụ được tạo, tính bằng mili giây Unix.
- Name
- started_at
- Type
- timestamp
- Description
Thời điểm một worker bắt đầu thực hiện tác vụ, tính bằng mili giây Unix. Giá trị là
nullcho đến lúc đó.
- Name
- finished_at
- Type
- timestamp
- Description
Thời điểm tác vụ đạt trạng thái cuối cùng, tính bằng mili giây Unix. Giá trị là
nullcho đến lúc đó.
- Name
- expires_at
- Type
- timestamp
- Description
Thời điểm kết quả của tác vụ hết hạn, tính bằng mili giây Unix. Giá trị này là 3 ngày sau
finished_at, hoặc 3 ngày saucreated_atcho đến khi tác vụ hoàn tất. Đối với tài khoản Enterprise, vốn lưu giữ kết quả API vô thời hạn, giá trị này là khoảng 100 năm sau. Xem Lưu giữ tài nguyên.
- Name
- preceding_tasks
- Type
- integer
- Description
Vị trí của tác vụ trong hàng đợi khi tác vụ đang ở trạng thái
PENDING.1nghĩa là tác vụ sẽ bắt đầu tiếp theo. Giá trị là0sau khi tác vụ rời khỏi hàng đợi, và luôn là0trong kết quả danh sách.
- Name
- task_error
- Type
- object
- Description
Lý do tác vụ thất bại. Giá trị là
nulltrừ khistatuslàFAILED. Xem Lỗi.
- Name
- consumed_credits
- Type
- integer
- Description
Số tín dụng bị tính phí cho tác vụ, sau khi trừ đi khoản hoàn trả (nếu có). Một yêu cầu trả về lỗi sẽ không bị tính phí. Một tác vụ thất bại có giá trị
0, vì Meshy sẽ hoàn trả tín dụng cho tác vụ đó. Việc hủy chỉ hoàn trả tín dụng cho tác vụ khi tác vụ đó đang ở trạng tháiPENDING. Nếu Meshy không thể đọc được khoản phí, phản hồi get hoặc stream sẽ bỏ qua trường này, và một yêu cầu danh sách sẽ trả về500. Trong trường hợp đó, hãy thử lại yêu cầu.
- Name
- image_urls
- Type
- array of strings
- Description
URL tải xuống cho hình ảnh ý tưởng. Mảng này có một URL sau khi tác vụ thành công, và rỗng cho đến lúc đó.
Đối tượng tác vụ build Figure
Một tác vụ build tạo ra một tượng 3D có texture từ một tác vụ prototype đã thành công. Các trường model_urls, thumbnail_url và texture_urls của nó có cùng định dạng như trong đối tượng tác vụ Ảnh sang 3D.
Thuộc tính
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 của tác vụ. Đừng phụ thuộc vào định dạng của nó.
- Name
- type
- Type
- string
- Description
Loại tác vụ, luôn là
creative-lab-figure-build.
- Name
- name
- Type
- string
- Description
namemà bạn đã gửi khi tạo tác vụ, hoặc""nếu bạn không gửi.
- Name
- status
- Type
- string
- Description
Trạng thái của tác vụ.
Các giá trị khả dụng:
PENDING: đang chờ trong hàng đợiIN_PROGRESS: đang tạo kết quảSUCCEEDED: trạng thái cuối cùng, có kết quảFAILED: trạng thái cuối cùng, kèm lý do trongtask_errorCANCELED: trạng thái cuối cùng, không có kết quả
- Name
- progress
- Type
- integer
- Description
Phần trăm công việc đã hoàn thành, từ
0đến100. Giá trị là0cho đến khi tác vụ bắt đầu và100khi tác vụ thành công.
- Name
- created_at
- Type
- timestamp
- Description
Thời điểm tác vụ được tạo, tính bằng mili-giây Unix.
- Name
- started_at
- Type
- timestamp
- Description
Thời điểm một worker bắt đầu tác vụ, tính bằng mili-giây Unix.
nullcho đến lúc đó.
- Name
- finished_at
- Type
- timestamp
- Description
Thời điểm tác vụ đạt trạng thái cuối cùng, tính bằng mili-giây Unix.
nullcho đến lúc đó.
- Name
- expires_at
- Type
- timestamp
- Description
Thời điểm kết quả của tác vụ hết hạn, tính bằng mili-giây Unix. Giá trị này là 3 ngày sau
finished_at, hoặc 3 ngày saucreated_atcho đến khi tác vụ hoàn tất. Đối với tài khoản Doanh nghiệp, vốn giữ kết quả API vô thời hạn, giá trị này là khoảng 100 năm sau. Xem Lưu giữ tài nguyên.
- Name
- preceding_tasks
- Type
- integer
- Description
Vị trí của tác vụ trong hàng đợi khi nó đang ở trạng thái
PENDING.1nghĩa là nó sẽ bắt đầu tiếp theo.0sau khi tác vụ rời khỏi hàng đợi, và luôn là0trong kết quả danh sách.
- Name
- task_error
- Type
- object
- Description
Lý do tác vụ thất bại.
nulltrừ khistatuslàFAILED. Xem Lỗi.
- Name
- consumed_credits
- Type
- integer
- Description
Số tín dụng bị trừ cho tác vụ, sau khi hoàn trả (nếu có). Một yêu cầu trả về lỗi sẽ không bị trừ tín dụng. Một tác vụ thất bại có giá trị
0, vì Meshy sẽ hoàn trả tín dụng. Việc hủy chỉ hoàn trả tín dụng cho tác vụ khi nó đang ở trạng tháiPENDING. Nếu Meshy không đọc được khoản trừ tín dụng, phản hồi get hoặc stream sẽ bỏ qua trường này, và yêu cầu danh sách sẽ trả về500. Trong trường hợp đó, hãy thử lại yêu cầu.
- Name
- prompt
- Type
- string
- Description
Luôn là
""đối với tác vụ build Figure.
- Name
- negative_prompt
- Type
- string
- Description
Luôn là
""đối với tác vụ build Figure, giống nhưprompt.
- Name
- texture_prompt
- Type
- string
- Description
Luôn là
""đối với tác vụ build Figure, giống nhưprompt.
- Name
- texture_image_url
- Type
- string
- Description
Luôn là
""đối với tác vụ build Figure, giống nhưprompt.
- Name
- model_urls
- Type
- object
- Description
URL tải xuống cho mô hình 3D, dưới dạng GLB có texture và dạng tệp OBJ kèm tệp MTL của nó.
- Name
glb- Type
- string
- Description
URL tải xuống cho tệp GLB có texture.
- Name
obj- Type
- string
- Description
URL tải xuống cho tệp OBJ, gồm hình học và UV.
- Name
mtl- Type
- string
- Description
URL tải xuống cho tệp vật liệu MTL đi kèm với
obj. Hãy dùng nó cùng vớiobjvà texture trongtexture_urls[0].base_color.
- Name
- thumbnail_url
- Type
- string
- Description
URL tải xuống cho ảnh xem trước của mô hình.
- Name
- texture_urls
- Type
- array
- Description
Các bản đồ texture, dưới dạng mảng chứa một đối tượng lưu bản đồ màu nền (base color).
- Name
base_color- Type
- string
- Description
URL tải xuống cho bản đồ màu nền (base color).
- Name
- remove_lighting
- Type
- boolean
- Description
Liệu Meshy có loại bỏ điểm sáng (highlight) và bóng đổ khỏi texture màu nền hay không.