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 МБ при передаче по URL http или https, либо не более 100 МБ в виде data URI. Для data URI используйте MIME type application/octet-stream, например data:application/octet-stream;base64,<ваши base64-закодированные данные модели>.
Файл размером более 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,<ваши base64-закодированные данные изображения>). Если отправлены оба параметра, 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 МБ при передаче по URL http или https, либо превышает 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

Получить задачу Retexture

Возвращает задачу Retexture по её 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 задачи из ответа на создание.

Возвращает

Объект задачи Retexture.

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-модели. Он содержит статус, progress, а также файлы модели и текстур, когда задача завершается успешно.

Свойства

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
Ссылки для скачивания текстурированной 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
Ссылки для скачивания референсных изображений Мультивид, с которыми вы создали задачу. Присутствует только когда вы создали задачу с multiview_image_urls.
Name
thumbnail_url
Type
string
Description
Ссылка для скачивания миниатюры модели.
Name
alpha_thumbnail_url
Type
string
Description
Ссылка для скачивания версии 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
Ссылки для скачивания сгенерированных текстур, в виде массива объектов. Обычно массив содержит один объект. Каждый объект имеет следующие поля:
- Name
  base_color
  Type
  string
  Description
  Ссылка для скачивания карты базового цвета.
- Name
  metallic
  Type
  string
  Description
  Ссылка для скачивания карты металличности. Meshy не включает это поле, когда вы создаёте задачу с enable_pbr: false.
- Name
  normal
  Type
  string
  Description
  Ссылка для скачивания карты нормалей. Meshy не включает это поле, когда вы создаёте задачу с enable_pbr: false.
- Name
  roughness
  Type
  string
  Description
  Ссылка для скачивания карты шероховатости. Meshy не включает это поле, когда вы создаёте задачу с enable_pbr: false.
- Name
  emission
  Type
  string
  Description
  Ссылка для скачивания карты свечения. 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 возвращает кредиты, когда задача завершается неудачно.