API вінілових фігурок Creative Lab

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

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

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

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

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

Request

POST

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

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

Prototype example

Start with a source photo, then generate the prototype image used by the build stage.

Source photo used as the Creative Lab Vinyl Figure input — Prototype input

Big-head vinyl figure prototype image generated from the source photo — Prototype output

Параметри

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 в endpoint побудови як 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/vinyl-figure/v1/build

Створення завдання збірки Vinyl Figure

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

Request

POST

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

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

Параметри

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

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

Отримати завдання Vinyl Figure

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

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

Request

GET

/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de

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

Параметри

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

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

Видалити завдання Vinyl Figure

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

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

Request

DELETE

/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de

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

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

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

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

Stream a Vinyl Figure task

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

Request

GET

/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream

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

Параметри

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

Повертає

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

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

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

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

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

Request

GET

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

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

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

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 задачі до кінцевої точки build як input_task_id.

Властивості

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 задачі. Не покладайтеся на його формат.
Name
type
Type
string
Description
Тип задачі, завжди creative-lab-vinyl-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 після успішного завершення задачі, а до того — порожній.

Об'єкт завдання збірки Vinyl Figure

Завдання збірки генерує текстуровану 3D вініл-фігурку (vinyl figure) з успішно виконаного завдання прототипу. Поля model_urls, thumbnail_url та texture_urls мають той самий формат, що й у об'єкті завдання Зображення у 3D.

Властивості

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 завдання. Не покладайтеся на його формат.
Name
type
Type
string
Description
Тип завдання, завжди creative-lab-vinyl-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 не може прочитати суму списання, у відповіді на запит отримання або потокову передачу це поле відсутнє, а запит списку повертає 500. У такому разі повторіть запит.
Name
prompt
Type
string
Description
Завжди "" для завдання збірки Vinyl Figure.
Name
negative_prompt
Type
string
Description
Завжди "" для завдання збірки Vinyl Figure, як і prompt.
Name
texture_prompt
Type
string
Description
Завжди "" для завдання збірки Vinyl Figure, як і prompt.
Name
texture_image_url
Type
string
Description
Завжди "" для завдання збірки Vinyl Figure, як і 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-адреса для завантаження карти базового кольору.