Creative Lab — 비닐 피규어 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

비닐 피규어 프로토타입 작업 생성

원본 사진에서 비닐 피규어 스타일의 컨셉 이미지를 생성합니다. 반환된 작업 ID는 input_task_id로 빌드 엔드포인트에 전달합니다. 응답 형식에 대해서는 비닐 피규어 프로토타입 작업 객체를 참조하십시오.

파라미터

Name
image_url
Type
string
필수
Description
Meshy가 큰 머리 비닐 피규어 스타일로 꾸미기 위한 원본 사진입니다. 현재 .jpg, .jpeg, .png, .webp 형식을 지원합니다.
이미지를 제공하는 두 가지 방법이 있습니다:
- 공개 접근 가능 URL: 공용 인터넷에서 접근 가능한 URL.
- Data URI: 이미지의 base64로 인코딩된 Data URI. Data URI의 예: data:image/jpeg;base64,<your base64-encoded image data>.
Name
name
Type
string
Description
표시 목적으로 사용될 선택적 작업 이름입니다. 최대 100자까지 가능합니다.

반환 값

응답의 result 속성에는 새로 생성된 비닐 피규어 프로토타입 작업의 작업 id가 포함됩니다. 작업이 SUCCEEDED에 도달할 때까지 작업 가져오기 엔드포인트를 폴링하거나 스트림에 가입한 후 해당 ID를 input_task_id로 빌드 엔드포인트에 전달합니다.

실패 모드

Name
400 - Bad Request
Description
요청이 수용될 수 없습니다. 일반적인 원인은 다음과 같습니다:
- 파라미터 누락: image_url은 필수입니다.
- 잘못된 이미지 형식: 제공된 image_url이 지원되지 않는 형식입니다 (.jpg, .jpeg, .png, .webp).
- 이미지 크기 범위를 초과: 이미지가 너무 작거나 최대 파일 크기를 초과하거나 최대 픽셀 수를 초과합니다.
- 접속 불가한 URL: image_url이 다운로드할 수 없습니다 (404 또는 timeout).
- 잘못된 Data URI: base64 문자열이 잘못되었습니다.
- 콘텐츠 플래그됨: 입력 이미지가 NSFW나 지적 재산권 moderation에 의해 플래그되었습니다.
Name
401 - Unauthorized
Description
인증이 실패했습니다. API 키를 확인하십시오.
Name
402 - Payment Required
Description
이 작업을 수행할 충분한 크레딧이 없습니다.
Name
429 - Too Many Requests
Description
속도 제한을 초과했습니다.

Request

POST

/openapi/creative-lab/vinyl-figure/v1/prototype

# 단계 1: 비닐 피규어 스타일의 컨셉 이미지 생성
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 portrait, 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

POST/openapi/creative-lab/vinyl-figure/v1/build

비닐 피규어 빌드 작업 생성

완료된 프로토타입 작업에서 최종 3D 텍스처 비닐 피규어를 생성합니다. 빌드는 이미지로 3D와 동일한 이미지-to-3D 파이프라인을 실행하므로 응답 객체 형식과 출력 URL 목록이 정확히 일치합니다. 응답 형식에 대해서는 비닐 피규어 빌드 작업 객체를 참고하세요.

파라미터

Name
input_task_id
Type
string
필수
Description
이 OpenAPI 엔드포인트를 통해 생성된 프로토타입 작업의 작업 ID입니다. 프로토타입은 동일한 API 키로 생성되어야 하며, SUCCEEDED 상태에 도달해야 하고, 정확히 하나의 후보 이미지를 생성해야 합니다.
웹앱을 통해 생성된 프로토타입 작업은 수락되지 않습니다 — 빌드 엔드포인트는 POST /openapi/creative-lab/vinyl-figure/v1/prototype로 생성된 프로토타입 작업만 수락하며, 다른 소스는 404로 거부합니다.
Name
name
Type
string
Description
디스플레이 용도의 선택적 작업 이름입니다. 최대 100자.

반환 값

응답의 result 속성에는 새로 생성된 비닐 피규어 빌드 작업의 id가 포함됩니다. 작업이 SUCCEEDED 상태에 도달할 때까지 작업 가져오기 엔드포인트를 폴 또는 스트림에 구독하세요. 그런 다음, model_urls.glb에서 텍스처가 적용된 GLB를 다운로드하세요 (또는 다운스트림 파이프라인에서 OBJ를 선호할 경우 model_urls.obj 및 model_urls.mtl에서 OBJ + MTL 쌍을 다운로드하세요).

실패 모드

Name
400 - Bad Request
Description
요청이 승인되지 않았습니다. 일반적인 원인:
- 누락된 파라미터: input_task_id가 필요합니다.
- 유효하지 않은 UUID: input_task_id가 유효한 UUID가 아닙니다.
- 부모가 성공하지 않음: 참조된 프로토타입 작업이 아직 SUCCEEDED 상태에 도달하지 않았습니다.
- 후보 없음: 프로토타입 작업이 성공했지만 후보 이미지를 생성하지 않았습니다.
Name
401 - Unauthorized
Description
인증에 실패했습니다. API 키를 확인하세요.
Name
402 - Payment Required
Description
이 작업을 수행하기에 충분한 크레딧이 없습니다.
Name
404 - Not Found
Description
참조된 프로토타입 작업이 존재하지 않거나, 다른 사용자에게 속해 있거나, 웹앱을 통해 생성되었습니다 (엔드포인트 모드에서만 생성된 프로토타입 작업이 빌드로 연결됩니다).
Name
429 - Too Many Requests
Description
속도 제한을 초과했습니다.

Request

POST

/openapi/creative-lab/vinyl-figure/v1/build

# 단계 2: 완료된 프로토타입 작업에서 체인 빌드
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"
}

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

비닐 피규어 작업 검색

유효한 작업 id가 주어지면 프로토타입 또는 빌드 작업을 검색합니다. URL 경로는 작업의 단계와 일치해야 하며, /prototype/:id를 통해 가져온 빌드 작업은 404를 반환하고, 그 반대의 경우도 마찬가지입니다.

응답 형식에 대해서는 비닐 피규어 프로토타입 작업 개체 및 비닐 피규어 빌드 작업 개체를 참고하세요.

매개변수

Name
id
Type
path
Description
검색할 비닐 피규어 작업의 고유 식별자입니다.

반환값

응답에는 비닐 피규어 작업 개체가 포함됩니다. 요청된 단계에 따라 형식이 달라집니다.

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=***"
    }
  ]
}

DELETE/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

피규어 작업 삭제

피규어 작업을 취소합니다. 작업이 아직 PENDING 상태인 경우, 생성 시 소모된 크레딧이 환불됩니다. 이미 IN_PROGRESS 상태인 작업은 환불 없이 취소됩니다 (작업자가 이미 리소스를 소모하고 있을 수 있음). 이미 최종 상태 (SUCCEEDED, FAILED, CANCELED)에 도달한 작업은 취소할 수 없습니다.

URL 경로는 작업의 단계와 일치해야 합니다 — /prototype/:buildId에 대한 DELETE는 404를 반환합니다.

경로 매개변수

Name
id
Type
path
Description
취소할 피규어 작업의 고유 식별자입니다.

반환 값

성공 시 빈 본문과 함께 204 No Content를 반환합니다.

실패 모드

Name
400 - Bad Request
Description
작업이 이미 최종 상태에 있으며 취소할 수 없습니다.
Name
404 - Not Found
Description
작업이 존재하지 않거나, 다른 사용자에게 속하거나, 작업의 단계가 URL 경로와 일치하지 않습니다.

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

// 성공 시 204 No Content를 반환합니다 (빈 본문).

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id/stream

비닐 피규어 작업 스트림

비닐 피규어 작업에 대한 실시간 업데이트를 Server-Sent Events(SSE)로 스트림합니다. URL 경로는 작업의 단계와 일치해야 하며, /prototype/:buildId/stream 스트림을 시작하면 하나의 event: error 페이로드가 status_code: 404로 전송되고 스트림이 종료됩니다.

매개 변수

Name
id
Type
path
Description
스트림할 비닐 피규어 작업의 고유 식별자입니다.

반환 값

반환 값은 Server-Sent Events로 비닐 피규어 프로토타입 또는 비닐 피규어 빌드 작업 객체로 스트림됩니다. PENDING 또는 IN_PROGRESS 작업의 경우, 응답 스트림은 필요한 progress 및 status 필드만 포함합니다.

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

// 오류 이벤트 예시 (잘못된 단계 또는 작업을 찾을 수 없음)
event: error
data: {
  "status_code": 404,
  "message": "작업을 찾을 수 없습니다"
}

// 메시지 이벤트 예시들은 작업 진행 상황을 보여줍니다.
// PENDING 또는 IN_PROGRESS 작업의 경우, 응답 스트림은 모든 필드를 포함하지 않습니다.
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=***"
    }
  ]
}

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)

비닐 피규어 작업 목록

단일 단계에 대한 비닐 피규어 작업의 페이지네이션 목록을 검색합니다. URL 경로는 단계를 선택합니다 — /prototype은 프로토타입 작업을 반환하고; /build는 빌드 작업을 반환합니다. 다른 단계의 작업은 어떤 응답에도 포함되지 않습니다.

경로 매개변수

Name
stage
Type
path
필수
Description
prototype 또는 build. 컬렉션은 URL과 단계가 일치하는 작업만 반환합니다 — /prototype을 가져오면 빌드 작업은 절대 반환되지 않으며 그 반대도 마찬가지입니다.

쿼리 매개변수

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

반환 값

각 단계 작업 객체의 페이지네이션 목록을 반환합니다 — /prototype을 나열할 때는 비닐 피규어 프로토타입 작업 객체를, /build를 나열할 때는 비닐 피규어 빌드 작업 객체를 반환합니다.

Request

GET

/openapi/creative-lab/vinyl-figure/v1/prototype

# 프로토타입 작업 목록
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# 빌드 작업 목록
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=***"
    ]
  }
]

비닐 피규어 프로토타입 작업 오브젝트

비닐 피규어 프로토타입 작업 오브젝트는 Meshy가 소스 사진으로부터 비닐 피규어 스타일의 컨셉 이미지를 생성하기 위해 추적하는 작업 단위입니다. 이 단계의 출력은 input_task_id를 통해 빌드 단계와 연결됩니다.

속성

Name
id
Type
string
Description
작업의 고유 식별자입니다. 작업 ID에 대해 k-sortable UUID를 구현 세부사항으로 사용하지만, ID의 형식에 대한 가정을 해서는 안 됩니다.
Name
type
Type
string
Description
작업의 유형입니다. 값은 creative-lab-vinyl-figure-prototype입니다.
Name
name
Type
string
Description
작업이 생성될 때 제공된 작업 이름입니다. 이름이 제공되지 않은 경우 빈 문자열이 됩니다.
Name
status
Type
string
Description
작업의 상태입니다. 가능한 값은 PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED 중 하나입니다.
Name
progress
Type
integer
Description
작업의 진행 상황입니다. 작업이 아직 시작되지 않은 경우, 이 속성은 0입니다. 작업이 성공하면, 이 값은 100이 됩니다.
Name
created_at
Type
timestamp
Description
작업이 생성된 시간의 타임스탬프입니다. 밀리초로 표현됩니다.
타임스탬프는 1970년 1월 1일 UTC 이후 경과된 밀리초 수를 나타내며 RFC 3339 표준을 따릅니다. 예를 들어, 2023년 9월 1일 금요일 12:00:00 PM GMT는 1693569600000로 표현됩니다. 이는 Meshy API의 모든 타임스탬프에 적용됩니다.
Name
started_at
Type
timestamp
Description
작업이 시작된 시간의 타임스탬프입니다. 밀리초로 표현됩니다. 작업이 아직 시작되지 않은 경우, 이 속성은 0입니다.
Name
finished_at
Type
timestamp
Description
작업이 완료된 시간의 타임스탬프입니다. 밀리초로 표현됩니다. 작업이 아직 완료되지 않은 경우, 이 속성은 0입니다.
Name
expires_at
Type
timestamp
Description
작업 결과가 만료되는 시간의 타임스탬프입니다. 밀리초로 표현됩니다.
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을 반환합니다 (실패 시 크레딧이 환불됩니다).
Name
image_urls
Type
array of strings
Description
이 프로토타입 작업이 생성한 개념 이미지 후보에 대한 다운로드 가능한 URL들입니다. 현재 API는 항상 하나의 후보만 반환합니다; 이 필드는 향후 수정 시 여러 후보를 묶음 처리할 수 있도록 배열입니다.

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=***"
  ]
}

비닐 피규어 빌드 작업 객체

비닐 피규어 빌드 작업 객체는 Meshy가 추적하여 SUCCEEDED된 프로토타입 작업으로부터 텍스처가 있는 3D 비닐 피규어를 생성하는 작업 단위입니다. 이 작업은 이미지로 3D와 동일한 이미지-3D 파이프라인을 실행하므로, 출력 필드는 해당 엔드포인트의 작업 객체를 반영합니다.

Properties

Name
id
Type
string
Description
작업의 고유 식별자.
Name
type
Type
string
Description
작업의 유형. 값은 creative-lab-vinyl-figure-build 입니다.
Name
name
Type
string
Description
작업이 생성될 때 제공된 작업 이름. 이름이 제공되지 않은 경우 빈 문자열.
Name
status
Type
string
Description
작업의 상태. 가능한 값은 PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED 중 하나입니다.
Name
progress
Type
integer
Description
작업의 진행 상황. 작업이 아직 시작되지 않은 경우 이 속성은 0입니다. 작업이 성공하면 100이 됩니다.
Name
created_at
Type
timestamp
Description
작업이 생성된 시간의 타임스탬프, 밀리초 단위.
Name
started_at
Type
timestamp
Description
작업이 시작된 시간의 타임스탬프, 밀리초 단위.
Name
finished_at
Type
timestamp
Description
작업이 완료된 시간의 타임스탬프, 밀리초 단위.
Name
expires_at
Type
timestamp
Description
작업 결과가 만료되는 시간의 타임스탬프, 밀리초 단위.
Name
preceding_tasks
Type
integer
Description
이전 작업의 개수. 상태가 PENDING일 때만 유의미합니다.
Name
task_error
Type
object
Description
실패한 작업에 대한 오류 세부 정보. 전체 task_error 객체 참조는 오류를 참조하십시오.
Name
consumed_credits
Type
integer
Description
이 작업에 소비된 크레딧의 수. FAILED 작업의 경우 0을 반환합니다 (실패 시 크레딧이 환불됨).
Name
prompt
Type
string
Description
비닐 피규어 빌드에서는 항상 비어 있습니다. 공통 V2ImageTo3DTaskResponse 형태와의 엔드포인트 간 호환성을 위해 존재합니다. 이미지로 3D를 참조하십시오.
Name
negative_prompt
Type
string
Description
비닐 피규어 빌드에서는 항상 비어 있습니다. 엔드포인트 간 호환성을 위해 존재합니다.
Name
texture_prompt
Type
string
Description
비닐 피규어 빌드에서는 항상 비어 있습니다. 엔드포인트 간 호환성을 위해 존재합니다.
Name
texture_image_url
Type
string
Description
비닐 피규어 빌드에서는 항상 비어 있습니다. 엔드포인트 간 호환성을 위해 존재합니다.
Name
model_urls
Type
object
Description
생성된 3D 모델의 다운로드 가능한 URL들입니다. 비닐 피규어 빌드는 텍스처가 적용된 GLB와 Wavefront OBJ를 선호하는 파이프라인을 위한 OBJ + MTL 쌍을 내보냅니다. 필드 모양은 이미지로 3D model_urls 객체와 일치하여 향후 포맷 추가 시 중단되지 않도록 합니다.
- Name
  glb
  Type
  string
  Description
  텍스처가 적용된 GLB 파일의 다운로드 가능한 URL입니다.
- Name
  obj
  Type
  string
  Description
  Wavefront OBJ 파일 (지오메트리 + UV)의 다운로드 가능한 URL입니다.
- Name
  mtl
  Type
  string
  Description
  OBJ 동반 MTL 머티리얼 파일의 다운로드 가능한 URL입니다. obj와 texture_urls[0].base_color의 항목과 함께 사용하십시오.
Name
thumbnail_url
Type
string
Description
모델 파일의 썸네일 이미지의 다운로드 가능한 URL입니다.
Name
texture_urls
Type
array
Description
이 작업에서 생성된 텍스처 URL 객체의 배열입니다. 현재 기본 색상 맵을 가진 단일 객체가 포함되어 있습니다.
- Name
  base_color
  Type
  string
  Description
  기본 색상 맵 이미지의 다운로드 가능한 URL입니다.

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=***"
    }
  ]
}