Retexture API

Retexture API는 Meshy의 AI 리텍스처링 기능을 자체 애플리케이션에 통합할 수 있는 기능을 제공합니다. 이 섹션에서는 이 API를 시작하는 데 필요한 모든 정보를 찾을 수 있습니다.

POST/openapi/v1/retexture

리텍스처 작업 생성

이 엔드포인트는 새로운 리텍스처 작업을 생성할 수 있도록 허용합니다. 리텍스처 작업 객체에 포함된 속성을 보려면 The Retexture Task Object를 참조하세요.

파라미터

input_task_id 또는 model_url 중 하나만 필수입니다. 두 개가 모두 제공되면 input_task_id가 우선합니다.

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

Name
model_url
Type
string
필수
Description
Meshy가 텍스처링할 3D 모델을 제공합니다. 지원되는 형식: .glb, .gltf, .obj, .fbx, .stl.
모델을 제공하는 두 가지 방법이 있습니다:
- 공개적으로 접근 가능한 URL: 인터넷에서 접근 가능한 URL
- Data URI: 모델의 base64-인코딩된 데이터 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
텍스트를 사용하여 객체의 원하는 텍스처 스타일을 설명하세요. 최대 600자.

Name
image_style_url
Type
string
필수
Description
텍스처링 프로세스를 안내할 2D 이미지를 제공합니다. 현재 .jpg, .jpeg, 그리고 .png 형식을 지원합니다.
이미지를 제공하는 두 가지 방법이 있습니다:
- 공개적으로 접근 가능한 URL: 인터넷에서 접근 가능한 URL
- Data URI: 이미지의 base64-인코딩된 데이터 URI. 데이터 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 데이터 URI, .jpg/.jpeg/.png)을 허용합니다.
ai_model: "meshy-7" (또는 latest)가 필요합니다.

Name
ai_model
Type
string
기본값 latest
Description
리텍스처링에 사용할 AI 모델의 ID. 사용 가능한 값: meshy-5, 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로 설정하거나, 적절한 UV 맵핑이 부족한 모델에는 새로운 UV를 펼치도록 false로 두십시오.
Name
enable_pbr
Type
boolean
기본값 false
Description
기본 색상 외에 PBR 맵 (메탈릭, 거칠기, 노멀 맵)을 생성합니다. ai_model이 meshy-6인 경우 방출 맵도 포함되지만 texture_resolution: 8k에서는 제외됩니다. 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가 필요합니다. 8k에서는 방출 맵이 생성되지 않습니다.
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일 때만 지원됩니다.
Name
target_formats
Type
string[]
Description
출력에 포함할 3D 파일 형식을 지정합니다. 요청된 형식만 생성 및 반환되어 작업 완료 시간을 단축할 수 있습니다. 생략되면 모든 지원 형식이 포함됩니다.
사용 가능한 값: glb, obj, fbx, stl, usdz, 3mf
생략되면 3mf를 제외한 모든 형식이 생성됩니다. 3mf는 명시적으로 지정된 경우에만 포함됩니다.
Name
alpha_thumbnail
Type
boolean
기본값 false
Description
true로 설정되면 작업은 투명 배경 (RGBA) 버전의 미리보기를 추가로 렌더링하여 alpha_thumbnail_url로 GET 응답에 반환합니다. 기존의 thumbnail_url 필드는 변경되지 않습니다.

반환값

응답의 result 속성은 새로 생성된 리텍스처 작업의 작업 id를 포함합니다.

실패 모드

Name
400 - 잘못된 요청
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" (또는 latest)가 필요합니다.
- 모델 T 이용 불가능: ai_model: "meshy-7"은 점진적으로 제공되어 아직 귀하의 계정에 활성화되지 않았습니다.
- 잘못된 입력 작업: input_task_id는 지원되는 모델의 성공적인 작업을 참조해야 합니다.
- 잘못된 모델 형식: model_url이 지원되지 않는 확장의 파일로 향하고 있습니다.
- 접근할 수 없는 URL: model_url, image_style_url 또는 multiview_image_urls 요소를 다운로드할 수 없습니다.
Name
401 - 인증 실패
Description
인증에 실패했습니다. API 키를 확인하세요.
Name
402 - 결제 필요
Description
이 작업을 수행할 크레딧이 부족합니다.
Name
429 - 요청이 너무 많습니다
Description
속도 제한을 초과했습니다.

요청

POST

/openapi/v1/retexture

# 텍스트 프롬프트로 리텍스처
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": "붉은 송곳니, 일본식 바틱 스타일과 일본 사무라이 의상의 결합",
    "enable_original_uv": true,
    "enable_pbr": true
  }'

# 이미지 스타일 및 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": "https://cdn.meshy.ai/image/example_image.jpg",
    "ai_model": "latest",
    "enable_pbr": true,
    "enable_original_uv": true
  }'

응답

{
  "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 섹션을 확인하세요.

요청

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

응답

{
  "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": "붉은 송곳니, 일본식 바틱 스타일과 일본 사무라이 의상의 결합",
  "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",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

DELETE/openapi/v1/retexture/:id

리텍스처 작업 삭제

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

경로 파라미터

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

반환값

성공 시 200 OK를 반환합니다.

요청

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

응답

// 성공 시 200 Ok를 반환합니다.

GET/openapi/v1/retexture

리텍스처 작업 목록

이 엔드포인트는 리텍스처 작업 목록을 검색할 수 있도록 허용합니다.

파라미터

Name
page_num
Type
integer
기본값 1
Description
페이지네이션을 위한 페이지 번호.
Name
page_size
Type
integer
기본값 10
Description
페이지 크기 제한. 최대 50개 항목까지 허용됩니다.
Name
sort_by
Type
string
Description
정렬할 필드.
사용 가능한 값:
- +created_at: 생성 시간 기준 오름차순 정렬.
- -created_at: 생성 시간 기준 내림차순 정렬.

반환값

페이지네이션된 The Retexture Task Objects 목록을 반환합니다.

요청

GET

/openapi/v1/retexture

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

응답

[
  {
    "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": "붉은 송곳니, 일본식 바틱 스타일과 일본 사무라이 의상의 결합",
    "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",
        "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.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로 스트리밍되는 The Retexture Task Objects의 스트림을 반환합니다.

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

요청

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

응답 스트림

// 오류 이벤트 예시
event: error
data: {
  "status_code": 404,
  "message": "작업을 찾을 수 없음"
}

// 메시지 이벤트 예시는 작업 진행 상황을 나타냅니다.
// PENDING or IN_PROGRESS 작업의 경우, 응답 스트림에 모든 필드가 포함되지 않습니다.
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/018aclasses='`WRITE`attachment' :  'fw1```(кгст9):",
      "metallic": "https://assets.meshy.ai/***/tasks/018aecamatan>traverseturself://api.meshy.ai/***/tasks/018a(mu****nd```umclare)`work`=`9`ณ",
      "normal": "https://assets.meshy.ai/***/tasks/018aooldtimeline(dead://usalaska****jobs）：onswerportsuensst",
      "roughness": "https://assets.meshy.ai/***/tasks/2Lmersivatedloren✆***le@=g 9-3tionstyь/",
      "emission": "https://assets.meshy.ai/***/tasks/coolpatriotic2019ekok_=class/
//<他のvia***icestC.cumulator}">
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

리텍스처 작업 객체

리텍스처 작업 객체는 Meshy가 텍스트 또는 이미지 입력에서 3D 텍스처를 생성하는 데 사용하는 작업 단위입니다. 모델은 다음 속성을 가지고 있습니다:

속성

Name
id
Type
string
Description
작업의 고유 식별자입니다. 우리는 임의의 UUID를 작업 ID로 사용하지만 구현 세부 사항으로 이 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
  텍스처가 있을 때 OBJ 출력과 함께 반환되는 MTL 파일의 다운로드 가능한 URL.
- Name
  stl
  Type
  string
  Description
  STL 파일의 다운로드 가능한 URL.
- Name
  3mf
  Type
  string
  Description
  3MF 파일의 다운로드 가능한 URL. target_formats를 통해 3mf가 요청되었을 때만 존재합니다.
Name
text_style_prompt
Type
string
Description
텍스처 작업을 생성하는 데 사용된 텍스트 프롬프트입니다.
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
작업의 진행 상황입니다. 작업이 아직 시작되지 않았다면 이 속성은 0입니다. 작업이 완료되면 이 값은 100이 됩니다.
Name
started_at
Type
timestamp
Description
작업이 시작된 시점의 타임스탬프입니다. 밀리세컨드 단위. 작업이 아직 시작되지 않았다면 이 속성은 0입니다.
타임스탬프는 1970년 1월 1일 UTC부터 경과된 밀리세컨드 수를 나타내며, RFC 3339 표준을 따릅니다. 예를 들어, 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-5인 경우 이 속성은 생략됩니다.
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을 반환합니다 (실패 시 크레딧은 환불됩니다).

예시 리텍스처 작업 모델

{
  "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": "붉은 송곳니, 일본식 바틱 스타일과 일본 사무라이 의상의 결합",
  "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",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credentials": 10
}