Creative Lab Brick Figure API

Перетворіть фотографію на колекційну 3D-мініфігурку у стилі з цеглинок у два етапи. Завдання прототипу генерує концептуальне зображення з фотографії. Завдання побудови перетворює це зображення на текстуровану 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

Генерує одне концептуальне зображення у цегляному стилі з фотографії. Щоб побудувати 3D-модель, передайте ID цього завдання до кінцевої точки build як input_task_id. Поля завдання описані в розділі Об'єкт завдання прототипу Brick Figure.

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,<ваші base64-закодовані дані зображення>).
Зображення має бути файлом JPG, JPEG, PNG або WebP розміром не більше 20 МБ.
Name
name
Type
string
Description
Назва завдання, до 100 символів. Вона повертається в полі name завдання. Довша назва поверне 400.
Name
remove_background
Type
boolean
за замовчуванням false
Description
Чи слід видаляти фон із зображення прототипу. true повертає прозорий RGBA PNG, щоб ви могли розмістити об'єкт на будь-якому фоні. Побудова також починається із зображення без фону. Якщо Meshy не може видалити фон, повертається зображення з фоном, а завдання все одно виконується успішно.

Результат

Поле result містить ID нового завдання прототипу. Отримайте завдання або транслюйте його, доки status не стане SUCCEEDED. Потім передайте ID до кінцевої точки build як input_task_id.

Режими збою

Name
400 - Bad Request
Description
Запит не може бути виконаний. Наприклад:
- Відсутній image_url.
- Зображення не є файлом JPG, JPEG, PNG або WebP.
- Зображення занадто мале, перевищує 20 МБ або перевищує максимальну кількість пікселів.
- 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
Досягнуто одного з таких лімітів:
- Ви надіслали більше запитів, ніж дозволяє ваше обмеження частоти. Зачекайте кілька секунд, а потім повторіть спробу. Див. Обмеження частоти.
- Забагато ваших завдань перебуває в черзі або виконується. Зачекайте, доки деякі з них завершаться, а потім повторіть спробу.
- На необмеженому плані без залишку кредитів ви досягли кількості завдань, які можуть виконуватися без кредитів. Зачекайте завершення завдання або додайте кредити.
Name
500 - Internal Server Error
Description
Meshy зіткнувся з помилкою сервера, наприклад через неможливість виконати перевірку зображення на інтелектуальну власність. Meshy не створює завдання та повертає будь-які списані кредити. Повторіть запит.

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

Створення задачі на побудову фігурки з цеглинок

Генерує текстуровану 3D-мініфігурку на основі успішно виконаної задачі прототипу. Опис полів наведено в розділі Об'єкт задачі на побудову фігурки з цеглинок.

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 не належить до жодної з ваших задач-прототипів Brick Figure, створених через API, повертається 404, включно з прототипом, створеним у веб-застосунку.
Name
name
Type
string
Description
Назва задачі, до 100 символів. Повертається в полі name задачі. Довша назва призводить до 400.

Результат

Поле result містить ID нової задачі на побудову. Отримайте задачу або відстежуйте її в потоковому режимі, доки status не стане SUCCEEDED. Потім завантажте текстурований GLB з model_urls.glb. Якщо потрібен OBJ, завантажте model_urls.obj разом із файлом матеріалу з model_urls.mtl.

Режими помилок

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 не відповідає жодній задачі-прототипу Brick Figure, створеній вашим акаунтом через API. Прототип, створений у веб-застосунку, також повертає 404. Надішліть ID result з відповіді на створення прототипу.
Name
429 - Too Many Requests
Description
Досягнуто одного з таких лімітів:
- Ви надіслали більше запитів, ніж дозволяє ваше обмеження частоти. Зачекайте кілька секунд, потім повторіть спробу. Див. Обмеження частоти.
- Забагато ваших задач перебуває в черзі або виконується. Зачекайте, доки деякі з них завершаться, потім повторіть спробу.
- На безлімітному тарифному плані без залишку кредитів ви досягли кількості задач, які можуть виконуватися без кредитів. Зачекайте завершення задачі або поповніть кредити.

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

Отримати задачу Brick Figure

Повертає задачу прототипу або побудови. Шлях має відповідати стадії задачі. Задача побудови, запитана через /prototype/:id, повертає 404, так само як і задача прототипу, запитана через /build/:id.

Щодо полів, див. Об'єкт задачі прототипу Brick Figure та Об'єкт задачі побудови Brick Figure.

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 задачі з відповіді на створення.

Повертає

Об'єкт задачі прототипу або об'єкт задачі побудови, що відповідає стадії, вказаній у шляху.

Режими збою

Name
400 - Bad Request
Description
id не є дійсним ID задачі. Надішліть ID result з відповіді на створення.
Name
403 - Forbidden
Description
У вашій команді ввімкнено IP Filtering, і Meshy позначив зображення задачі як таке, що містить інтелектуальну власність третьої сторони. Команди на плані Enterprise не отримують цю помилку. Створіть задачу прототипу із зображення, на використання якого ви маєте права.
Name
404 - Not Found
Description
Жодна задача Brick Figure з цим ID не належить вашому акаунту, або стадія задачі не відповідає шляху. Перевірте ID та використовуйте /prototype або /build відповідно до задачі.
Name
500 - Internal Server Error
Description
Meshy не вдалося виконати перевірку на інтелектуальну власність. Повторіть запит.

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

Видалити завдання фігурки з цеглинок

Скасовує завдання фігурки з цеглинок. Скасування завдання зі статусом PENDING повертає його кредити. Завдання зі статусом IN_PROGRESS скасовується без повернення коштів, оскільки воркер уже почав його виконання. Завдання з фінальним статусом (SUCCEEDED, FAILED або CANCELED) не можна скасувати.

Шлях має відповідати етапу завдання. Наприклад, DELETE на /prototype/:id з ID завдання етапу build поверне 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 завдання. Надішліть ID result з відповіді на створення.
- Завдання вже має фінальний статус (SUCCEEDED, FAILED або CANCELED), тому його не можна скасувати.
Name
404 - Not Found
Description
Жодне завдання фігурки з цеглинок з цим ID не належить вашому акаунту, або етап завдання не відповідає шляху. Перевірте ID та використовуйте /prototype або /build відповідно до завдання.

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

Трансляція задачі Brick Figure у реальному часі

Транслює оновлення задачі Brick Figure у вигляді Server-Sent Events (SSE). Шлях має відповідати етапу задачі. Якщо ні, наприклад, ID задачі build за шляхом /prototype/:id/stream, потік надсилає одну подію error зі status_code: 404 і закривається.

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 Filtering блокує результат задачі, потік натомість надсилає одну подію error зі status_code, який повернув би запит get.

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

Список завдань фігурки з цеглинок

Повертає ваші завдання фігурки з цеглинок одного етапу, по одній сторінці за раз. Шлях визначає етап. /prototype повертає лише завдання прототипу, а /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: спочатку найстаріші

Повертає

Масив об'єктів завдання прототипу або об'єктів завдання збірки, що відповідають етапу, вказаному у шляху.

Об'єкт завдання прототипу фігурки з цеглинок

Завдання прототипу генерує концептуальне зображення у стилі цеглинок на основі фото. Щоб перетворити зображення на 3D-модель, передайте ID завдання до кінцевої точки побудови як input_task_id.

Властивості

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. Це через 3 дні після finished_at, або через 3 дні після created_at, доки завдання не завершиться. Для облікових записів Enterprise, які зберігають результати API безстроково, це приблизно через 100 років. Див. Зберігання ресурсів.
Name
preceding_tasks
Type
integer
Description
Позиція завдання в черзі, поки воно має статус PENDING. 1 означає, що воно виконається наступним. 0 після того, як завдання покинуло чергу, і завжди 0 у результатах списку.
Name
task_error
Type
object
Description
Причина, через яку завдання не виконалося. null, якщо status не дорівнює FAILED. Див. Помилки.
Name
consumed_credits
Type
integer
Description
Кількість кредитів, списаних за завдання, після будь-якого повернення коштів. Запит, що повертає помилку, не оплачується. Для невдалого завдання це 0, оскільки Meshy повертає кошти. Скасування повертає кошти за завдання лише, поки воно має статус PENDING. Якщо Meshy не може прочитати списання, у відповіді на запит отримання або потокову передачу це поле відсутнє, а запит списку повертає 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. Це 3 дні після finished_at, або 3 дні після created_at, доки завдання не завершиться. Для облікових записів Enterprise, які зберігають результати API необмежено, це приблизно на 100 років пізніше. Див. Зберігання ресурсів.
Name
preceding_tasks
Type
integer
Description
Позиція завдання в черзі, поки воно має статус PENDING. 1 означає, що воно виконається наступним. 0 після того, як завдання покидає чергу, і завжди 0 у результатах списку.
Name
task_error
Type
object
Description
Причина, чому завдання не вдалося виконати. null, якщо status не дорівнює FAILED. Див. Помилки.
Name
consumed_credits
Type
integer
Description
Кількість кредитів, нарахованих за завдання, після будь-якого повернення коштів. Запит, що повертає помилку, не тарифікується. Для невдалого завдання — 0, оскільки Meshy повертає кредити. Скасування повертає кредити за завдання лише доки воно має статус PENDING. Якщо Meshy не може прочитати нарахування, у відповіді get або stream це поле буде відсутнє, а запит списку поверне 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
URL-адреси для завантаження 3D-моделі у вигляді текстурованого GLB та у вигляді файлу OBJ з відповідним файлом MTL.
- Name
  glb
  Type
  string
  Description
  URL-адреса для завантаження текстурованого файлу GLB.
- Name
  obj
  Type
  string
  Description
  URL-адреса для завантаження файлу OBJ, з геометрією та UV-розгорткою.
- Name
  mtl
  Type
  string
  Description
  URL-адреса для завантаження файлу матеріалу MTL, що супроводжує obj. Використовуйте його разом з 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-адреса для завантаження мапи базового кольору.