Creative Lab Vinyl Figure API

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

Генерирует одно концептуальное изображение в стиле vinyl-figure из фотографии. Чтобы построить 3D-модель, передайте ID этой задачи в эндпоинт сборки как 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
Фотография, которая будет преобразована в фигурку vinyl-figure с большой головой, в виде публичного URL или data URI (data:image/jpeg;base64,<your base64-encoded image data>).
Изображение должно быть файлом JPG, JPEG, PNG или WebP размером не более 20 МБ.
Name
name
Type
string
Description
Название задачи, до 100 символов. Оно возвращается в поле name задачи. Более длинное название приводит к ошибке 400.
Name
remove_background
Type
boolean
по умолчанию false
Description
Удалять ли фон с изображения прототипа. true возвращает прозрачный PNG в формате RGBA, чтобы вы могли разместить объект на любом фоне. Сборка также начинается с изображения без фона. Если 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/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, который не является 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

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

Передаёт обновления задачи 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 задачи в эндпоинт сборки как 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, пока задача не завершена. Для корпоративных аккаунтов, которые хранят результаты API бессрочно, это примерно через 100 лет. См. Хранение ресурсов.
Name
preceding_tasks
Type
integer
Description
Позиция задачи в очереди, пока она находится в статусе PENDING. 1 означает, что она начнётся следующей. 0 после того, как задача покидает очередь, и всегда 0 в результатах списка.
Name
task_error
Type
object
Description
Причина сбоя задачи. null, если status не равен FAILED. См. Ошибки.
Name
consumed_credits
Type
integer
Description
Количество кредитов, списанных за задачу, после учёта любого возврата. Запрос, возвращающий ошибку, не оплачивается. Для неудавшейся задачи значение равно 0, так как Meshy возвращает средства. Отмена возвращает средства за задачу только пока она находится в статусе PENDING. Если Meshy не может определить сумму списания, поле отсутствует в ответе get или stream, а запрос списка возвращает 500. В этом случае повторите запрос.
Name
image_urls
Type
array of strings
Description
Ссылки для скачивания концептуального изображения. Массив содержит одну ссылку после успешного завершения задачи, и пуст до этого момента.

Объект задачи сборки фигурки 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-адрес для скачивания карты базового цвета.