Retexture API

Retexture API는 Meshy의 AI 리텍스처 기능을 여러분의 애플리케이션에 통합할 수 있도록 해주는 기능입니다. 이 섹션에서는 이 API를 시작하는 데 필요한 모든 정보를 확인할 수 있습니다.

POST/openapi/v1/retexture

Retexture 작업 생성

이 엔드포인트를 사용하면 새로운 Retexture 작업을 생성할 수 있습니다. Retexture 작업 객체에 포함된 속성을 확인하려면 The Retexture Task Object를 참조하세요.

작업은 백그라운드에서 실행됩니다. 일반적으로 소요되는 시간은 Processing Times를 참조하세요.

파라미터

input_task_id 또는 model_url 중 하나만 필수입니다. 둘 다 제공된 경우, input_task_id가 우선합니다.

Name
input_task_id
Type
string
필수
Description
리텍스처를 원하는, 완료된 이미지로 3D 또는 텍스트로 3D 작업의 ID입니다. 이 작업은 다음 중 하나여야 합니다: 텍스트로 3D Preview, 텍스트로 3D Refine, 이미지로 3D 또는 리메시. 또한 상태가 SUCCEEDED여야 합니다.

Name
model_url
Type
string
필수
Description
Meshy가 텍스처를 적용할 3D 모델을 제공합니다. 지원 형식: .glb, .gltf, .obj, .fbx, .stl.
최대 파일 크기: http 또는 https URL의 경우 400MB, data: URI의 경우 100MB.
100MB를 초과하는 GLB, glTF, FBX 또는 OBJ 파일은 최대 10,000,000개의 면을 가질 수 있습니다. 면은 삼각형으로 계산됩니다. 사각형은 2개로 계산되며, 두 번 이상 그려진 메시는 복사본당 한 번씩 계산됩니다. 100MB를 초과하는 FBX 파일은 바이너리 FBX 7.1 이상이어야 하며, GLB 또는 glTF 파일은 Draco 압축을 사용하지 않아야 합니다.
모델을 제공하는 방법은 두 가지입니다:
- 공개적으로 접근 가능한 URL: 공용 인터넷에서 접근 가능한 URL입니다.
- Data URI: 모델의 base64로 인코딩된 data URI입니다. MIME type application/octet-stream을 사용하세요. 예: data:application/octet-stream;base64,<your base64-encoded model data>.

스타일 입력 중 정확히 하나가 필수입니다: text_style_prompt, image_style_url, 또는 multiview_image_urls. multiview_image_urls는 다른 두 가지와 함께 사용할 수 없습니다. text_style_prompt와 image_style_url이 모두 제공된 경우, image_style_url이 우선합니다.

Name
text_style_prompt
Type
string
필수
Description
텍스트를 사용하여 원하는 객체의 텍스처 스타일을 설명하세요. 최대 800자.

Name
image_style_url
Type
string
필수
Description
텍스처링 과정을 안내할 2D 이미지를 제공하세요. 현재 .jpg, .jpeg, .png, .webp 형식을 지원합니다.
최대 파일 크기: 20MB.
이미지를 제공하는 방법은 두 가지입니다:
- 공개적으로 접근 가능한 URL: 공용 인터넷에서 접근 가능한 URL
- Data URI: 이미지의 base64로 인코딩된 data URI입니다. data URI 예시: data:image/jpeg;base64,<your base64-encoded image data>
원본 asset과 업로드된 이미지 간에 지오메트리 차이가 상당할 경우 이미지 텍스처링이 최적으로 작동하지 않을 수 있습니다.

Name
multiview_image_urls
Type
string[]
필수
Description
텍스처링을 안내하기 위해 동일한 객체를 서로 다른 시점에서 보여주는 1개에서 4개의 이미지를 제공하세요. 첫 번째 이미지는 주 시점(정면)이며, 나머지 시점(왼쪽, 뒤, 오른쪽)의 순서는 상관없습니다.
각 요소는 image_style_url과 동일한 형식(공개적으로 접근 가능한 URL 또는 base64 data URI, .jpg/.jpeg/.png/.webp)을 허용합니다.
최대 파일 크기: 이미지당 20MB.
명시적인 ai_model: "meshy-7"이 필요합니다.

Name
ai_model
Type
string
기본값 latest
Description
리텍스처링에 사용할 AI 모델의 ID입니다. 사용 가능한 값: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).
Name
enable_original_uv
Type
boolean
기본값 false
Description
새로운 UV 레이아웃을 생성하는 대신 모델의 기존 UV 레이아웃을 유지합니다.
- Meshy가 생성한 모델(input_task_id를 통하거나, Meshy의 출력물을 가리키는 model_url)을 리텍스처링하는 경우, 최적화된 UV 레이아웃을 재사용하려면 이 값을 true로 설정하세요.
- 업로드한 타사 모델을 리텍스처링하는 경우, 유지하고 싶은 양호한 UV가 이미 있다면 true로 설정하고, 그렇지 않으면 Meshy가 새 UV를 언래핑하도록 false로 두세요(적절한 UV 매핑이 없는 모델에 적합).
Name
enable_pbr
Type
boolean
기본값 false
Description
기본 색상 외에 PBR 맵(metallic, roughness, normal)을 생성합니다. ai_model이 meshy-6인 경우 emission 맵도 포함되지만, texture_resolution: 8k인 경우는 제외됩니다. meshy-6-lite, meshy-7, latest는 emission 맵을 생성하지 않습니다.
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여야 합니다. 8k에서는 emission 맵이 생성되지 않습니다.
Name
hd_texture
Type
boolean
⚠ 사용 중단
기본값 false
Description
대신 texture_resolution을 사용하세요 — texture_resolution: "4k"와 동일합니다. 둘 다 설정된 경우 texture_resolution이 우선합니다.
Name
remove_lighting
Type
boolean
기본값 true
Description
기본 색상 텍스처에서 하이라이트와 그림자를 제거하여, 커스텀 조명 설정에서 더 잘 작동하는 더 깔끔한 결과물을 생성합니다.
ai_model이 meshy-6이고 texture_resolution이 2k 또는 4k일 때만 적용됩니다. meshy-7 또는 latest, 그리고 8k에서는 이 값이 허용되지만 무시됩니다. meshy-6-lite에서는 어떤 값을 보내더라도 400이 반환됩니다.
Name
target_formats
Type
string[]
Description
출력에 포함할 3D 파일 형식을 지정합니다. 요청된 형식만 생성되어 반환되므로 작업 완료 시간을 단축할 수 있습니다. 생략하면 지원되는 모든 형식이 포함됩니다.
사용 가능한 값: glb, obj, fbx, stl, usdz, 3mf
생략하면 3mf를 제외한 모든 형식이 생성됩니다. 3mf는 명시적으로 지정된 경우에만 포함됩니다.
Name
alpha_thumbnail
Type
boolean
기본값 false
Description
true로 설정하면, 작업은 미리보기의 투명 배경(RGBA) 버전을 추가로 렌더링하여 GET 응답에서 alpha_thumbnail_url로 반환합니다. 기존 thumbnail_url 필드는 변경되지 않습니다.

반환 값

응답의 result 속성에는 새로 생성된 Retexture 작업의 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"이 필요합니다.
- 모델을 사용할 수 없음: ai_model: "meshy-7"과 ai_model: "meshy-6-lite"는 단계적으로 배포되고 있으며 귀하의 계정에서는 아직 활성화되지 않았을 수 있습니다.
- 잘못된 입력 작업: input_task_id는 지원되는 모델의 성공한 작업을 참조해야 합니다.
- 잘못된 모델 형식: model_url이 지원되지 않는 확장자를 가진 파일을 가리킵니다.
- 도달할 수 없는 URL: model_url, image_style_url 또는 multiview_image_urls 요소를 다운로드할 수 없습니다.
- 모델 파일이 너무 큼: model_url 파일이 400MB(http 또는 https URL) 또는 100MB(data: URI)를 초과합니다.
- 면이 너무 많음: model_url 파일이 100MB를 초과하며 10,000,000개가 넘는 면을 가지고 있습니다. 면 수를 줄인 후 파일을 다시 보내세요.
- 100MB를 초과하는 ASCII FBX: model_url 파일이 100MB를 초과하는 ASCII FBX입니다. 바이너리 FBX 또는 GLB로 보내세요.
- 읽을 수 없는 모델 파일: model_url 파일이 100MB를 초과하며 헤더를 읽을 수 없습니다. 예를 들어 Draco로 압축된 GLB 또는 glTF, 또는 7.1보다 오래된 바이너리 FBX인 경우입니다.
- 모델 헤더가 너무 복잡함: model_url 파일이 100MB를 초과하며 헤더에 확인해야 할 메시, 노드 또는 레코드가 너무 많습니다. 파일 내 객체 수를 줄인 후 다시 보내세요.
- 이미지가 너무 큼: image_style_url 이미지 또는 multiview_image_urls 요소가 20MB를 초과합니다.
Name
401 - Unauthorized
Description
인증에 실패했습니다. API 키를 확인해 주세요.
Name
402 - Payment Required
Description
이 작업을 수행하기 위한 크레딧이 부족합니다.
Name
429 - Too Many Requests
Description
속도 제한을 초과했습니다.

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

GET/openapi/v1/retexture/:id

리텍스처 작업 조회

이 엔드포인트를 사용하면 유효한 작업 id가 주어졌을 때 리텍스처 작업을 조회할 수 있습니다. 리텍스처 작업 객체에 포함된 속성을 확인하려면 The Retexture Task Object를 참고하세요.

매개변수

Name
id
Type
path
Description
조회할 리텍스처 작업의 고유 식별자입니다.

반환값

응답에는 리텍스처 작업 객체가 포함됩니다. 자세한 내용은 The Retexture Task Object 섹션을 확인하세요.

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
}

DELETE/openapi/v1/retexture/:id

리텍스처 작업 삭제

이 엔드포인트는 리텍스처 작업을 연관된 모든 모델 및 데이터와 함께 영구적으로 삭제합니다. 이 작업은 되돌릴 수 없습니다.

경로 매개변수

Name
id
Type
path
Description
삭제할 리텍스처 작업의 ID입니다.

작업 상태

여전히 PENDING 상태인 작업은 삭제되며, 생성 시 소모된 크레딧이 환불됩니다.

이미 IN_PROGRESS 상태인 작업은 삭제할 수 없습니다: 요청은 409 Conflict로 거부되며 작업은 계속 실행됩니다. 워커가 이미 시작한 작업의 크레딧은 환불되지 않으므로, 실행 도중 삭제하면 크레딧과 결과물을 모두 잃게 됩니다. SUCCEEDED, FAILED 또는 CANCELED 상태가 될 때까지 기다린 후 삭제하세요.

종료 상태(SUCCEEDED, FAILED 또는 CANCELED)에 있는 작업은 환불 없이 삭제됩니다.

반환값

성공 시 200 OK를 반환하며, 작업이 IN_PROGRESS인 경우 409 Conflict를 반환합니다.

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 is left 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."
}

GET/openapi/v1/retexture

리텍스처 작업 목록 조회

이 엔드포인트를 사용하면 리텍스처 작업 목록을 조회할 수 있습니다.

파라미터

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: 생성 시간 기준 내림차순 정렬.

반환 값

리텍스처 작업 객체의 페이지네이션된 목록을 반환합니다.

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

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

리텍스처 작업 스트리밍

이 엔드포인트는 Server-Sent Events(SSE)를 사용하여 리텍스처 작업에 대한 실시간 업데이트를 스트리밍합니다.

매개변수

Name
id
Type
path
Description
스트리밍할 리텍스처 작업의 고유 식별자입니다.

반환값

리텍스처 작업 객체의 스트림을 Server-Sent Events로 반환합니다.

PENDING 또는 IN_PROGRESS 상태의 작업의 경우, 응답 스트림에는 필요한 progress 및 status 필드만 포함됩니다.

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.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
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
}

리텍스처 태스크 객체

리텍스처 태스크 객체는 Meshy가 텍스트 또는 이미지 입력으로부터 3D 텍스처를 생성하는 데 사용하는 작업 단위입니다. 이 모델은 다음과 같은 속성을 가집니다:

속성

Name
id
Type
string
Description
태스크의 고유 식별자입니다. 구현 세부 사항으로서 태스크 id에 k-sortable UUID를 사용하고 있지만, id의 형식에 대해서는 어떠한 가정도 하지 않아야 합니다.
Name
type
Type
string
Description
리텍스처 태스크의 유형입니다. 값은 retexture입니다.
Name
model_urls
Type
object
Description
Meshy가 생성한 텍스처가 적용된 3D 모델 파일을 다운로드할 수 있는 URL입니다.
- Name
  glb
  Type
  string
  Description
  GLB 파일을 다운로드할 수 있는 URL입니다.
- Name
  fbx
  Type
  string
  Description
  FBX 파일을 다운로드할 수 있는 URL입니다.
- Name
  obj
  Type
  string
  Description
  OBJ 파일을 다운로드할 수 있는 URL입니다.
- Name
  usdz
  Type
  string
  Description
  USDZ 파일을 다운로드할 수 있는 URL입니다.
- Name
  mtl
  Type
  string
  Description
  MTL 파일을 다운로드할 수 있는 URL이며, 텍스처가 있는 경우 OBJ 내보내기와 함께 반환됩니다.
- Name
  stl
  Type
  string
  Description
  STL 파일을 다운로드할 수 있는 URL입니다.
- Name
  3mf
  Type
  string
  Description
  3MF 파일을 다운로드할 수 있는 URL입니다. 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
thumbnail_url의 투명 배경(RGBA) 버전을 다운로드할 수 있는 URL입니다. 태스크가 alpha_thumbnail: true로 생성되고 투명 미리보기가 성공적으로 렌더링된 경우에만 제공되며, 그렇지 않으면 이 필드는 생략됩니다.
Name
progress
Type
integer
Description
태스크의 progress입니다. 태스크가 아직 시작되지 않은 경우 이 속성은 0입니다. 태스크가 성공하면 100이 됩니다.
Name
started_at
Type
timestamp
Description
태스크가 시작된 시점의 타임스탬프이며, 밀리초 단위입니다. 태스크가 아직 시작되지 않은 경우 이 속성은 0입니다.
타임스탬프는 RFC 3339 표준을 따라 1970년 1월 1일 UTC로부터 경과한 밀리초 수를 나타냅니다. 예를 들어, 2023년 9월 1일 금요일 오후 12시 00분 00초 GMT는 1693569600000으로 표현됩니다. 이는 Meshy API의 모든 타임스탬프에 적용됩니다.
Name
created_at
Type
timestamp
Description
태스크가 생성된 시점의 타임스탬프이며, 밀리초 단위입니다.
Name
expires_at
Type
timestamp
Description
태스크 결과가 만료되는 시점의 타임스탬프이며, 밀리초 단위입니다.
Name
finished_at
Type
timestamp
Description
태스크가 완료된 시점의 타임스탬프이며, 밀리초 단위입니다. 태스크가 아직 완료되지 않은 경우 이 속성은 0입니다.
Name
status
Type
string
Description
태스크의 상태입니다. 가능한 값은 PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED 중 하나입니다.
Name
texture_urls
Type
array
Description
태스크에서 생성된 텍스처 URL 객체의 배열입니다. 일반적으로 이 배열에는 하나의 텍스처 URL 객체만 포함됩니다. 각 텍스처 URL은 다음과 같은 속성을 가집니다:
- Name
  base_color
  Type
  string
  Description
  베이스 컬러 맵 이미지를 다운로드할 수 있는 URL입니다.
- Name
  metallic
  Type
  string
  Description
  메탈릭 맵 이미지를 다운로드할 수 있는 URL입니다.
  태스크가 enable_pbr: false로 생성된 경우 이 속성은 생략됩니다.
- Name
  normal
  Type
  string
  Description
  노멀 맵 이미지를 다운로드할 수 있는 URL입니다.
  태스크가 enable_pbr: false로 생성된 경우 이 속성은 생략됩니다.
- Name
  roughness
  Type
  string
  Description
  러프니스 맵 이미지를 다운로드할 수 있는 URL입니다.
  태스크가 enable_pbr: false로 생성된 경우 이 속성은 생략됩니다.
- Name
  emission
  Type
  string
  Description
  이미션 맵 이미지를 다운로드할 수 있는 URL입니다.
  태스크가 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
실패한 태스크에 대한 오류 세부 정보입니다. task_error 객체의 전체 참조는 오류를 참고하세요.
Name
consumed_credits
Type
integer
Description
이 태스크에서 소비된 크레딧 수입니다. 태스크 상태가 PENDING, IN_PROGRESS, 또는 SUCCEEDED일 때 제공됩니다. FAILED 태스크의 경우 0을 반환합니다(실패 시 크레딧은 환불됩니다).

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
}