Figure API для Creative Lab

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

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

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

Створення завдання прототипу Figure

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

Request

POST

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

# 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"
}

Приклад прототипу

Почніть із вихідного портрету, а потім згенеруйте зображення прототипу, яке використовується на етапі побудови.

Вихідний портрет, використаний як вхідні дані для Creative Lab Figure — Вхідні дані прототипу

Зображення прототипу фігурки у стилі «чиби», згенероване з вихідного фото — Результат прототипу

Параметри

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 до кінцевої точки побудови як 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/figure/v1/build

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

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

Request

POST

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

# 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"
}

Build example

Завдання побудови перетворює обране зображення прототипу на текстуровану 3D-модель, доступну для завантаження.

Creative Lab Figure build model preview — Build model preview

Параметри

Name
input_task_id
Type
string
Обов'язковий
Description
ID завдання прототипування, яке потрібно побудувати. Це має бути завдання, створене вашим акаунтом через POST /openapi/creative-lab/figure/v1/prototype, зі статусом SUCCEEDED.
ID, який не належить до жодного з ваших завдань прототипування 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 не відповідає жодному завданню прототипування Figure, створеному вашим акаунтом через API. Прототип, створений у веб-застосунку, також повертає 404. Надішліть ID result з відповіді на створення прототипу.
Name
429 - Too Many Requests
Description
Було досягнуто одне з наступних обмежень:
- Ви надіслали більше запитів, ніж дозволяє ваше обмеження частоти. Зачекайте кілька секунд, а потім повторіть спробу. Див. Обмеження частоти.
- Забагато ваших завдань перебувають у черзі або виконуються. Зачекайте, доки деякі з них завершаться, а потім повторіть спробу.
- На безлімітному плані без залишку кредитів ви досягли кількості завдань, які можуть виконуватися без кредитів. Зачекайте завершення завдання або поповніть кредити.

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

Отримати завдання фігурки

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

Щодо полів дивіться Об'єкт завдання прототипу фігурки та Об'єкт завдання збірки фігурки.

Request

GET

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

# 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
}

Параметри

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
Завдання фігурки з цим ID не належить вашому акаунту, або стадія завдання не відповідає шляху. Перевірте ID та використайте /prototype або /build відповідно до завдання.
Name
500 - Internal Server Error
Description
Meshy не вдалося виконати перевірку інтелектуальної власності. Повторіть запит.

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

Видалення завдання Figure

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

Шлях має відповідати етапу завдання. Наприклад, DELETE для /prototype/:id з ID завдання етапу build поверне 404.

Request

DELETE

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

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).

Параметри шляху

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
Жодне завдання Figure з таким ID не належить вашому акаунту, або етап завдання не відповідає шляху. Перевірте ID та використовуйте /prototype або /build відповідно до завдання.

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

Потокова передача завдання Figure

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

Request

GET

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

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
}

Параметри

Name
id
Type
path
Description
ID завдання з відповіді на створення.

Повертає

Потік об'єктів завдання prototype або build. Кожна подія містить повний об'єкт завдання, у тому вигляді, в якому його повертає Отримати завдання Figure. Поки завдання має статус PENDING або IN_PROGRESS, його вихідні поля все ще порожні (null, [] або {}), а finished_at дорівнює null.

Якщо IP Filtering блокує результат завдання, потік натомість надсилає одну подію error з status_code, яку повернув би звичайний запит на отримання.

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

Список завдань Figure

Повертає ваші завдання Figure для одного етапу, по одній сторінці за раз. Шлях визначає етап. /prototype повертає лише завдання прототипування, а /build повертає лише завдання побудови.

Request

GET

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

# 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=***"
    ]
  }
]

Параметри шляху

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: спочатку найстаріші

Повертає

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

Об'єкт завдання прототипу Figure

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

Властивості

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 завдання. Не покладайтеся на його формат.
Name
type
Type
string
Description
Тип завдання, завжди creative-lab-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 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 завдання. Не покладайтеся на його формат.
Name
type
Type
string
Description
Тип завдання, завжди creative-lab-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, доки завдання не завершиться. Для корпоративних акаунтів, які зберігають результати 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-запит або потік це поле відсутнє, а запит списку повертає 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-адреса для завантаження карти базового кольору.
Name
remove_lighting
Type
boolean
Description
Чи видалив Meshy відблиски та тіні з текстури базового кольору.