Creative Lab Vinyl Figure API
Biến một bức ảnh thành một tượng sưu tầm 3D dạng vinyl đầu to qua hai giai đoạn. Một tác vụ prototype sẽ tạo ra hình ảnh ý tưởng 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/vinyl-figure/v1/prototypePOST /openapi/creative-lab/vinyl-figure/v1/build
Tạo tác vụ tạo tượng Vinyl Figure prototype
Tạo ra một hình ảnh ý tưởng theo phong cách tượng vinyl 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 vào 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ụ Vinyl Figure prototype.
Request
# 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"
}
Tham số
- Name
- image_url
- Type
- string
- Bắt buộc
- Description
Bức ảnh cần chuyển thành tượng vinyl đầu to, 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>).Ảnh phải là tệp JPG, JPEG, PNG, hoặc WebP có 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ụ. Nếu tên dài hơn sẽ trả về400.
- Name
- remove_background
- Type
- boolean
- mặc định false
- Description
Có xóa phông nền khỏi hình ảnh prototype hay không.
truesẽ trả về một ảnh PNG RGBA trong suốt, giúp bạn đặt chủ thể lên bất kỳ phông nền nào. Quá trình build cũng sẽ bắt đầu từ hình ảnh đã xóa phông nền. Nếu Meshy không thể xóa phông nền, nó sẽ trả về hình ảnh kèm phông nền gốc, 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 theo dõi trực tuyến cho đến khi status là SUCCEEDED. Sau đó truyền ID vào 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ể thực thi. Ví dụ:
- Thiếu
image_url. - Ảnh không phải là tệp JPG, JPEG, PNG, hoặc WebP.
- Ảnh quá nhỏ, vượt quá 20 MB, hoặc vượt quá số pixel tối đa.
- Meshy không thể tải ảnh xuống, ví dụ vì URL trả về
404hoặc hết thời gian chờ. - Data URI không phải base64 hợp lệ.
- Ảnh bị đánh dấu là nội dung nhạy cảm (NSFW).
Thông báo lỗi sẽ cho biết vấn đề nào đã được phát hiện. Sửa yêu cầu rồi gửi lại.
- Thiếu
- Name
401 - Unauthorized- Description
Thiếu khóa API hoặc khóa API không hợp lệ. Kiểm tra header
Authorization.
- Name
402 - Payment Required- Description
Một trong những 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 đến giới hạn tín dụng.
- Tài khoản đang dùng 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 đã đánh dấu hình ảnh này vì 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 những 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. Chờ 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. Chờ một số tác vụ hoàn tất 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. Chờ 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ụ vì không thể thực hiện kiểm tra sở hữu trí tuệ trên hình ảnh. Meshy sẽ không tạo tác vụ, và hoàn lại bất kỳ khoản tín dụng nào đã bị trừ. Hãy thử gửi lại yêu cầu.
Tạo một tác vụ build Vinyl Figure
Tạo ra mô hình vinyl figure 3D có 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 The Vinyl Figure build task object.
Request
# 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"
}
Tham số
- Name
- input_task_id
- Type
- string
- Bắt buộc
- Description
ID của tác vụ prototype cần build. Nó 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/vinyl-figure/v1/prototype, với trạng tháiSUCCEEDED.Một ID không phải là tác vụ prototype Vinyl Figure nào đó của bạn từ API sẽ trả về
404, kể cả một prototype được tạo trong ứng dụng web.
- Name
- name
- Type
- string
- Description
Một tên cho tác vụ, tối đa 100 ký tự. Nó sẽ xuất hiện lại trong trường
namecủa tác vụ. Một 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 GLB có vật liệu xuống từ model_urls.glb. Để lấy OBJ thay thế, tải model_urls.obj xuống 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
Yêu cầu không thể chạy. 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 chờ và 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 những 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 dùng 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 Vinyl 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 đến:
- 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 chờ vài giây, sau đó thử lại. Xem Rate limits.
- Có quá nhiều tác vụ của bạn đang xếp hàng hoặc đang chạy. Hãy chờ một số tác vụ hoàn thành, sau đó thử lại.
- Trên một 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 chờ một tác vụ hoàn thành, hoặc nạp thêm tín dụng.
Lấy tác vụ Vinyl Figure
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 qua /prototype/:id sẽ trả về 404, và một tác vụ prototype được yêu cầu qua /build/:id cũng vậy.
Để biết các trường, xem Đối tượng tác vụ prototype Vinyl Figure và Đối tượng tác vụ build Vinyl Figure.
Request
# 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=***"
}
]
}
Tham số
- Name
- id
- Type
- path
- Description
ID của tác vụ từ phản hồi tạo.
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 đã đánh dấu hình ảnh của tác vụ vì vi phạm sở hữu trí tuệ của bên thứ ba. Các nhóm trên gói Enterprise sẽ không gặp lỗi này. Hãy tạo tác vụ prototype từ hình ảnh mà bạn có quyền sử dụng.
- Name
404 - Not Found- Description
Không có tác vụ Vinyl Figure 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 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ụ Vinyl Figure
Hủy một tác vụ Vinyl Figure. 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 sẽ bị hủy mà không được hoàn tiền, 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ụ, 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/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
-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 trống.
Các chế độ lỗi
- Name
400 - Bad Request- Description
Một trong những 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), nên không thể bị hủy.
- Name
404 - Not Found- Description
Không có tác vụ Vinyl Figure 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 ID, và sử dụng
/prototypehoặc/buildđể khớp với tác vụ.
Luồng tác vụ Vinyl Figure
Truyền các cập nhật của tác vụ Vinyl 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 được dùng ở /prototype/:id/stream, luồng sẽ gửi một sự kiện error duy nhất với status_code: 404 rồi đóng lại.
Request
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=***"
}
]
}
Tham số
- Name
- id
- Type
- path
- Description
ID của tác vụ từ phản hồi tạo.
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ư những gì Lấy thông tin tác vụ Vinyl Figure 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 duy nhất thay thế, với status_code mà một yêu cầu get sẽ trả về.
Liệt kê tác vụ Vinyl Figure
Trả về các tác vụ Vinyl 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, còn /build chỉ trả về các tác vụ build.
Request
# 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=***"
]
}
]
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. Giá trị0sẽ trả về trang đầu tiên. Giá trị nằm ngoài khoảng0đến255sẽ trả về lỗi400.
- 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ẽ dùng giá trị mặc định. Giá trị nằm ngoài khoảng0đến255sẽ trả về lỗi400.
- 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 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ụ prototype Vinyl Figure
Một tác vụ prototype tạo ra một hình ảnh concept theo phong cách vinyl figure từ một bức ảnh. Để biến hình ảnh này thành mô hình 3D, hãy truyền ID của tác vụ vào build endpoint dưới dạng input_task_id.
Thuộc tính
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 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-vinyl-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: trạng thái cuối, kèm kết quảFAILED: trạng thái cuối, với lý do trongtask_errorCANCELED: trạng thái cuối, 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à là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 Unix milliseconds.
- Name
- started_at
- Type
- timestamp
- Description
Thời điểm một worker bắt đầu tác vụ, tính bằng Unix milliseconds. 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 Unix milliseconds. 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 Unix milliseconds. 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 thành. Đối với các tài khoản Enterprise, 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 tác vụ đang ở trạng thái
PENDING.1nghĩa là tác vụ sẽ bắt đầu tiếp theo. 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. 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 hoàn tiền (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 lại tín dụng. Việc hủy chỉ hoàn 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 concept. 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ụ xây dựng Tượng Vinyl
Một tác vụ xây dựng tạo ra một tượng vinyl 3D có texture từ một tác vụ nguyên mẫu đã 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 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 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-vinyl-figure-build.
- 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: cuối cùng, có kết quảFAILED: cuối cùng, kèm lý do trongtask_errorCANCELED: 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ị này là0cho đến khi tác vụ bắt đầu và100khi nó 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. Đó 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 các tài khoản Doanh nghiệp, vốn giữ kết quả API vô thời hạn, thời điểm đó 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ị tính phí 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ị tính phí. Một tác vụ thất bại sẽ là
0, vì Meshy sẽ hoàn trả tín dụng đó. Việc hủy chỉ hoàn trả một tác vụ khi nó đ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
- prompt
- Type
- string
- Description
Luôn là
""đối với tác vụ xây dựng Tượng Vinyl.
- Name
- negative_prompt
- Type
- string
- Description
Luôn là
""đối với tác vụ xây dựng Tượng Vinyl, giống nhưprompt.
- Name
- texture_prompt
- Type
- string
- Description
Luôn là
""đối với tác vụ xây dựng Tượng Vinyl, giống nhưprompt.
- Name
- texture_image_url
- Type
- string
- Description
Luôn là
""đối với tác vụ xây dựng Tượng Vinyl, 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ưới dạng tệp OBJ kèm theo 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, với 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. Sử 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 hình ả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ột mảng chứa một đối tượng lưu giữ bản đồ màu nền.
- Name
base_color- Type
- string
- Description
URL tải xuống cho bản đồ màu nền.