Retexture API

Генеруйте нові текстури для існуючої 3D-моделі на основі текстового prompt або референсних зображень. Модель може походити з іншої задачі Meshy або з файлу моделі.

POST/openapi/v1/retexture

Створення задачі Ретекстурування

Створює задачу Ретекстурування. Задача виконується у фоновому режимі. Про типову тривалість виконання задачі див. Час обробки.

Request

POST

/openapi/v1/retexture

# Retexture with text prompt
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "enable_original_uv": true,
    "enable_pbr": true
  }'

# Retexture with image style and PBR
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "image_style_url": "<your publicly accessible image url or base64-encoded data URI>",
    "ai_model": "latest",
    "enable_pbr": true,
    "enable_original_uv": true
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

Параметри

Name
input_task_id
Type
string
Обов'язковий
Description
Обов'язковий, якщо ви не надсилаєте model_url. ID задачі, яка створила 3D-модель для текстурування, наприклад задачі Текст у 3D, Зображення у 3D, Ремеш або Ретекстурування. Задача має бути створена вами через API та мати статус SUCCEEDED. Meshy текстурує GLB цієї задачі.

Name
model_url
Type
string
Обов'язковий
Description
Обов'язковий, якщо ви не надсилаєте input_task_id. Модель для текстурування у вигляді публічного URL або data URI. Якщо надіслано обидва, Meshy використовує input_task_id.
Модель має бути файлом GLB, glTF, OBJ, FBX або STL розміром щонайбільше 400 МБ з http- або https-URL, або 100 МБ у вигляді data URI. Для data URI використовуйте MIME type application/octet-stream, наприклад data:application/octet-stream;base64,<your base64-encoded model data>.
Файл понад 100 МБ також має відповідати цим правилам:
- Файл GLB, glTF, FBX або OBJ може мати щонайбільше 10 000 000 граней. Meshy рахує грані як трикутники, тому чотирикутник рахується як 2, а сітка, намальована кілька разів, рахується один раз за кожну копію.
- Файл FBX має бути бінарним FBX версії 7.1 або новішим.
- Файл GLB або glTF не повинен використовувати стиснення Draco.

Надішліть одне з цих трьох введень стилю.

Name
text_style_prompt
Type
string
Обов'язковий
Description
Обов'язковий, якщо ви не надсилаєте image_style_url або multiview_image_urls. Текст, що описує бажану текстуру, до 800 символів. Довший текст поверне 400.

Name
image_style_url
Type
string
Обов'язковий
Description
Обов'язковий, якщо ви не надсилаєте text_style_prompt або multiview_image_urls. 2D-зображення, стилю якого відповідатиме текстура, у вигляді публічного URL або data URI (data:image/jpeg;base64,<your base64-encoded image data>). Якщо надіслано і text_style_prompt, і image_style_url, Meshy використовує image_style_url.
Зображення має бути файлом .jpg, .jpeg, .png або .webp розміром щонайбільше 20 МБ.
Текстура може не дуже добре підходити, якщо об'єкт на зображенні має дуже іншу форму, ніж модель.

Name
multiview_image_urls
Type
string[]
Обов'язковий
Description
Обов'язковий, якщо ви не надсилаєте text_style_prompt або image_style_url. Від одного до чотирьох зображень одного й того ж об'єкта з різних ракурсів. Перше зображення — головний (фронтальний) вигляд. Порядок інших ракурсів (лівий, задній, правий) не має значення. Порожній масив або більше чотирьох зображень поверне 400.
Кожне зображення відповідає тим самим правилам формату та розміру, що й image_style_url, щонайбільше 20 МБ на зображення. Ви не можете поєднувати multiview_image_urls з text_style_prompt або image_style_url.
multiview_image_urls потребує явного "ai_model": "meshy-7". Будь-яка інша ai_model, включно зі значенням за замовчуванням latest, поверне 400.

Name
ai_model
Type
string
за замовчуванням latest
Description
AI-модель, яка генерує текстуру.
Доступні значення:
- meshy-6-lite
- meshy-6
- meshy-7
- latest: Meshy 7
Name
enable_original_uv
Type
boolean
за замовчуванням false
Description
Чи зберігати UV-розкладку моделі замість генерації нової.
- Для моделі, згенерованої Meshy, з input_task_id або model_url, що вказує на результат Meshy, використовуйте true, щоб повторно використати її оптимізовану UV-розкладку.
- Для моделі, завантаженої вами з іншого джерела, використовуйте true, щоб зберегти вже хороші UV. Залиште false, щоб дозволити Meshy згенерувати нові UV, що підходить для моделі без належного UV-мапінгу.
Name
enable_pbr
Type
boolean
за замовчуванням false
Description
Чи також генерувати PBR-карти (металевість, шорсткість та нормалі) разом з базовим кольором. З meshy-6 Meshy також генерує карту випромінювання, окрім texture_resolution рівня 8k. meshy-6-lite, meshy-7 та latest не генерують карту випромінювання.
Name
texture_resolution
Type
string
за замовчуванням 2k
Description
Розмір текстури базового кольору. Вища роздільна здатність захоплює більше деталей поверхні.
Доступні значення:
- 2k: 2048 × 2048 пікселів
- 4k: 4096 × 4096 пікселів
- 8k: 8192 × 8192 пікселів
4k та 8k потребують ai_model зі значенням meshy-6, meshy-7 або latest. З meshy-6-lite вони повертають 400. При 8k Meshy не генерує карту випромінювання.
Name
hd_texture
Type
boolean
⚠ застарілий
за замовчуванням false
Description
Замість цього використовуйте texture_resolution. true еквівалентно texture_resolution: "4k". Якщо надіслано обидва, Meshy використовує texture_resolution.
Name
remove_lighting
Type
boolean
за замовчуванням true
Description
Чи видаляти відблиски та тіні з текстури базового кольору. Результат краще працює при власному освітленні.
Meshy застосовує це лише з meshy-6, при texture_resolution рівня 2k або 4k. З meshy-7 чи latest, або при 8k, Meshy приймає цей параметр, але ігнорує його. З meshy-6-lite надсилання будь-якого значення поверне 400.
Name
target_formats
Type
string[]
Description
Файлові формати для генерації. Meshy генерує лише перелічені вами формати, що може скоротити час виконання задачі. Якщо параметр не вказано, Meshy генерує всі формати, крім 3mf.
Доступні значення:
- glb
- obj
- fbx
- stl
- usdz
- 3mf
Name
alpha_thumbnail
Type
boolean
за замовчуванням false
Description
Чи також рендерити попередній перегляд із прозорим фоном (RGBA), що повертається в alpha_thumbnail_url при отриманні задачі. thumbnail_url не змінюється.

Результат

Поле result відповіді містить ID нової задачі Ретекстурування.

Режими відмови

Name
400 - Bad Request
Description
Запит не може бути виконаний. Повідомлення про помилку вказує, яку саме проблему виявлено. Наприклад:
- Відсутній параметр: не надіслано ні model_url, ні input_task_id.
- Відсутній стиль: не надіслано жодного з text_style_prompt, image_style_url та multiview_image_urls.
- Конфліктні введення стилю: multiview_image_urls надіслано разом з text_style_prompt або image_style_url.
- Непідтримувана модель для мультивиду: multiview_image_urls надіслано без явного "ai_model": "meshy-7".
- Недійсна вхідна задача: input_task_id не є успішною задачею підтримуваного типу.
- Недійсний формат моделі: файл model_url має непідтримуване розширення.
- Недоступний URL: Meshy не може завантажити файл model_url, зображення image_style_url або зображення з multiview_image_urls.
- Файл моделі завеликий: файл model_url перевищує 400 МБ з http- або https-URL, або 100 МБ у вигляді data URI.
- Забагато граней: файл model_url перевищує 100 МБ і має понад 10 000 000 граней. Зменшіть кількість граней і надішліть файл знову.
- ASCII FBX понад 100 МБ: файл model_url є ASCII FBX понад 100 МБ. Надішліть його як бінарний FBX або GLB.
- Нечитабельний файл моделі: файл model_url перевищує 100 МБ, і Meshy не може прочитати його заголовок. Наприклад, це GLB або glTF, стиснутий Draco, або бінарний FBX старіший за 7.1.
- Заголовок моделі занадто складний: файл model_url перевищує 100 МБ, і його заголовок містить забагато сіток, вузлів або записів для перевірки. Зменшіть кількість об'єктів у файлі та надішліть його знову.
- Зображення завелике: зображення image_style_url або зображення з multiview_image_urls перевищує 20 МБ.
Виправте запит і надішліть його знову. Див. Помилки.
Name
401 - Unauthorized
Description
API-ключ відсутній або недійсний. Перевірте заголовок Authorization.
Name
402 - Payment Required
Description
Наприклад:
- Недостатньо кредитів: на рахунку недостатньо кредитів для цієї задачі, або рахунок досяг ліміту кредитів. Перевірте баланс кредитів і повторіть спробу.
- Безкоштовний план: для створення задачі потрібен платний план. Оновіть свій план у налаштуваннях підписки, а потім повторіть спробу.
Name
403 - Forbidden
Description
input_task_id — це модель барельєфа, яку ця кінцева точка не може ретекстурувати. Повідомлення: This model type does not support this operation. Надішліть іншу модель.
Name
404 - Not Found
Description
input_task_id не відповідає жодній з ваших задач. Перевірте ID задачі та надішліть запит знову.
Name
429 - Too Many Requests
Description
Перевищено обмеження частоти запитів. Зачекайте, а потім повторіть спробу. Див. Обмеження частоти.

GET/openapi/v1/retexture/:id

Отримати задачу Ретекстурування

Повертає задачу Ретекстурування за її ID.

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "texture_image_url": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

Параметри

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

Повертає

Об'єкт задачі Ретекстурування.

DELETE/openapi/v1/retexture/:id

Видалення завдання Ретекстурування

Остаточно видаляє завдання Ретекстурування, включно з його моделями та даними. Скасувати видалення неможливо.

Request

DELETE

/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

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

Name
id
Type
path
Description
ID завдання, яке потрібно видалити.

Статус завдання

Видалення завдання зі статусом PENDING повертає кредити, витрачені під час його створення.

Завдання зі статусом IN_PROGRESS видалити неможливо. Запит поверне 409 Conflict, а завдання продовжить виконуватися. Meshy не повертає кредити за завдання, яке вже розпочалося, тож видалення такого завдання коштувало б вам і кредитів, і результату. Зачекайте, доки воно не перейде у статус SUCCEEDED, FAILED або CANCELED, а потім видаліть його.

Видалення завдання з фінальним статусом (SUCCEEDED, FAILED або CANCELED) не повертає витрачені на нього кредити.

Повертає

200 OK, коли завдання видалено, або 409 Conflict, коли завдання має статус IN_PROGRESS.

GET/openapi/v1/retexture

Список завдань Ретекстурування

Повертає список ваших завдань Ретекстурування.

Request

GET

/openapi/v1/retexture

curl https://api.meshy.ai/openapi/v1/retexture?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "retexture",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "expires_at": 1692771679037,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
        "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
        "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
        "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 10
  }
]

Параметри

Name
page_num
Type
integer
за замовчуванням 1
Description
Номер сторінки, яку потрібно повернути.
Name
page_size
Type
integer
за замовчуванням 10
Description
Кількість завдань на сторінці, до 100.
Name
sort_by
Type
string
Description
Порядок сортування.
Доступні значення:
- +created_at: спочатку найстаріші
- -created_at: спочатку найновіші

Повертає

Розбитий на сторінки список об'єктів завдань Ретекстурування.

GET/openapi/v1/retexture/:id/stream

Потокова передача завдання Ретекстурування

Передає оновлення завдання Ретекстурування у вигляді Server-Sent Events (SSE).

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

Параметри

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

Повертає

Потік об'єктів завдання Ретекстурування у вигляді Server-Sent Events.

Кожна подія містить повний об'єкт завдання, у тому ж форматі, що повертає кінцева точка Get. Поки завдання має статус PENDING або IN_PROGRESS, його поля результату ще не мають значень.

Об'єкт завдання Retexture

Об'єкт завдання Retexture описує одне ретекстурування 3D-моделі. Він містить статус, прогрес, а також файли моделі та текстур, коли завдання завершується успішно.

Властивості

Example Retexture Task Model

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
  },
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "image_style_url": "https://assets.meshy.ai/***/image/example_image.jpg?Expires=***",
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

Name
id
Type
string
Description
ID завдання. Розглядайте його як непрозорий рядок і не покладайтеся на його формат.
Name
type
Type
string
Description
Тип завдання, завжди retexture.
Name
model_urls
Type
object
Description
URL-адреси для завантаження текстурованої 3D-моделі, по одній на кожен формат файлу.
- Name
  glb
  Type
  string
  Description
  Файл GLB.
- Name
  fbx
  Type
  string
  Description
  Файл FBX.
- Name
  obj
  Type
  string
  Description
  Файл OBJ.
- Name
  usdz
  Type
  string
  Description
  Файл USDZ.
- Name
  mtl
  Type
  string
  Description
  Файл MTL. Meshy повертає його разом із файлом OBJ, коли модель має текстури.
- Name
  stl
  Type
  string
  Description
  Файл STL.
- Name
  3mf
  Type
  string
  Description
  Файл 3MF. Присутній лише тоді, коли target_formats включає 3mf.
Name
text_style_prompt
Type
string
Description
Текстовий prompt, з яким ви створили завдання.
Name
image_style_url
Type
string
Description
Зображення стилю, з яким ви створили завдання.
Name
multiview_image_urls
Type
string[]
Description
URL-адреси для завантаження мультивидових референс-зображень, з якими ви створили завдання. Присутнє лише тоді, коли ви створили завдання з multiview_image_urls.
Name
thumbnail_url
Type
string
Description
URL-адреса для завантаження мініатюри моделі.
Name
alpha_thumbnail_url
Type
string
Description
URL-адреса для завантаження версії thumbnail_url з прозорим фоном (RGBA). Присутнє лише тоді, коли ви створили завдання з alpha_thumbnail: true і Meshy відрендерив прозорий попередній перегляд.
Name
progress
Type
integer
Description
Наскільки виконано завдання, у відсотках. Значення 0, доки завдання не почнеться, і 100, коли воно завершиться успішно.
Name
started_at
Type
timestamp
Description
Час початку завдання, у мілісекундах Unix. Значення 0, доки завдання не почнеться.
Name
created_at
Type
timestamp
Description
Час створення завдання, у мілісекундах Unix.
Name
expires_at
Type
timestamp
Description
Час, коли закінчується термін дії результатів завдання, у мілісекундах Unix.
Name
finished_at
Type
timestamp
Description
Час завершення завдання, у мілісекундах Unix. Значення 0, доки завдання не завершиться.
Name
status
Type
string
Description
Статус завдання, один із PENDING, IN_PROGRESS, SUCCEEDED, FAILED або CANCELED.
Name
texture_urls
Type
array
Description
URL-адреси для завантаження згенерованих текстур у вигляді масиву об'єктів. Масив зазвичай містить один об'єкт. Кожен об'єкт має такі поля:
- Name
  base_color
  Type
  string
  Description
  URL-адреса для завантаження карти базового кольору.
- Name
  metallic
  Type
  string
  Description
  URL-адреса для завантаження карти металевості. Meshy не включає це поле, коли ви створюєте завдання з enable_pbr: false.
- Name
  normal
  Type
  string
  Description
  URL-адреса для завантаження карти нормалей. Meshy не включає це поле, коли ви створюєте завдання з enable_pbr: false.
- Name
  roughness
  Type
  string
  Description
  URL-адреса для завантаження карти шорсткості. Meshy не включає це поле, коли ви створюєте завдання з enable_pbr: false.
- Name
  emission
  Type
  string
  Description
  URL-адреса для завантаження карти випромінювання. Meshy не включає це поле, коли ви створюєте завдання з будь-яким із наступного:
  
  enable_pbr: false
  
  ai_model зі значенням meshy-6-lite, meshy-7 або latest
  
  texture_resolution: 8k
Name
preceding_tasks
Type
integer
Description
Кількість завдань попереду цього в черзі. Присутнє лише поки завдання має статус PENDING.
Name
task_error
Type
object
Description
Деталі помилки, коли завдання завершується невдало. Див. Помилки.
Name
consumed_credits
Type
integer
Description
Кількість кредитів, використаних завданням. Присутнє, коли статус дорівнює PENDING, IN_PROGRESS або SUCCEEDED. Значення 0 для завдання зі статусом FAILED, оскільки Meshy повертає кредити, коли завдання завершується невдало.