Creative Lab — 냉장고 자석 API

사진을 맞춤형 냉장고 자석으로 바꾸세요 — 냉장고에 맞는 크기의 평평한 자석 뒷면이 있는 둥근 직사각형 컬러화 깊이 릴리프를 두 단계로 만듭니다. 프로토타입은 입력 사진에서 컬러화된 콘셉트 이미지를 생성한 다음, 빌드는 해당 콘셉트 이미지를 릴리프 3D 모델로 변환합니다. 두 단계는 input_task_id를 통해 연결됩니다.

POST /openapi/creative-lab/fridge-magnet/v1/prototype
POST /openapi/creative-lab/fridge-magnet/v1/build

POST/openapi/creative-lab/fridge-magnet/v1/prototype

냉장고 자석 프로토타입 작업 생성

원본 사진에서 단일 컬러 콘셉트 이미지를 생성합니다. 반환된 작업 ID는 build 엔드포인트에 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에 도달할 때까지 작업 가져오기 엔드포인트를 폴링하거나 stream을 구독한 다음, 해당 ID를 build 엔드포인트에 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/fridge-magnet/v1/prototype

# Stage 1: generate a colorized fridge magnet concept image
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/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": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9"
}

Prototype example

Start with a source photo, then generate the prototype image used by the fridge magnet build stage.

Source landscape photo used as the Creative Lab Fridge Magnet input — Prototype input

Creative Lab Fridge Magnet prototype output generated from the source photo — Prototype output

POST/openapi/creative-lab/fridge-magnet/v1/build

냉장고 자석 빌드 작업 생성

성공한 프로토타입 작업에서 최종 3D 출력 가능한 냉장고 자석을 생성합니다. 빌드는 프로토타입의 컬러링된 콘셉트 이미지에 깊이 맵 릴리프 파이프라인을 실행하고, 요청한 형식으로 단일 메시 아티팩트를 제공합니다. 응답 형태는 냉장고 자석 빌드 작업 객체를 참조하세요.

파라미터

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

`options`

릴리프 지오메트리를 위한 선택적 조정 파라미터입니다. 모든 필드에는 합리적인 기본값이 있습니다 — 재정의하려는 항목만 보내세요.

Name
badge_shape
Type
string
기본값 rounded-rect
Description
냉장고 자석의 외곽 실루엣입니다. 사용 가능한 값:
- circle
- rounded-rect (기본값)
- hexagon
- shield
- star
Name
size_mm
Type
number
기본값 60
Description
냉장고 자석의 경계 정사각형 변 길이(밀리미터)입니다. 범위: (0, 400].
Name
relief_height_mm
Type
number
기본값 3.3
Description
베이스 위 최대 릴리프 높이(밀리미터)입니다. 범위: [0, 20].
Name
relief_offset_mm
Type
number
기본값 0
Description
익스트루전 전에 릴리프에 적용되는 수직 오프셋(밀리미터)입니다. 범위: [0, 20].
Name
base_thickness_mm
Type
number
기본값 2.0
Description
릴리프 뒤의 평평한 베이스 플레이트 두께(밀리미터)입니다. 냉장고 자석 기본값은 더 두툼한 2 mm 베이스입니다 — 릴리프가 약하게 느껴지지 않으면서 자석이 냉장고에 붙을 충분한 두께를 제공합니다. 범위: [0, 20].
Name
has_closed_back
Type
boolean
기본값 true
Description
냉장고 자석 뒷면(자석을 붙이는 면)을 닫힌 표면으로 밀봉할지 여부입니다. 열린 셸로 만들려면 false로 설정하세요.
Name
relief_curve
Type
string
기본값 linear
Description
깊이 맵 값을 릴리프 높이에 매핑하는 전송 곡선입니다. 사용 가능한 값:
- linear (기본값)
- gamma
- s-curve
Name
curve_param
Type
number
기본값 1.0
Description
전송 곡선의 형태 파라미터입니다(relief_curve가 gamma일 때만 의미가 있음). 범위: (0, 10].
Name
invert_depth
Type
boolean
기본값 false
Description
깊이 맵 해석을 반전하여 더 어두운 영역이 더 높은 릴리프가 되도록 합니다.
Name
smoothing
Type
number
기본값 0.24
Description
릴리프 추출 전에 깊이 맵에 적용되는 스무딩 강도입니다. 범위: [0, 10].
Name
relief_scale
Type
number
기본값 1.0
Description
relief_height_mm 위에 적용되는 수직 스케일 배율입니다. 범위: (0, 10].
Name
depth_threshold
Type
number
기본값 0.1
Description
깊이 맵 값에 대한 로우패스 임계값입니다. 이보다 낮은 모든 값은 0으로 클램프됩니다. 범위: [0, 1].
Name
remove_background
Type
boolean
기본값 true
Description
릴리프 처리 전에 프로토타입의 콘셉트 이미지 배경을 자동으로 제거합니다.
Name
export_resolution
Type
integer
기본값 512
Description
내보내기에 사용되는 메시 해상도입니다. 범위: [64, 2048].

`output`

선택적 와이어 형식 선택기입니다. 기본값은 glb입니다.

Name
format
Type
string
기본값 glb
Description
빌드에서 반환되는 아티팩트 번들입니다. 사용 가능한 값:
- glb (기본값) — model_urls.glb 아래에 단일 model.glb를 반환합니다.
- obj — model.obj + model.mtl + texture.png를 zip으로 묶고 model_urls.obj 아래에 번들을 반환합니다.
- zip — 생성기가 내보내는 모든 아티팩트를 zip으로 묶고 model_urls.bundle_zip 아래에 번들을 반환합니다.

반환값

응답의 result 속성에는 새로 생성된 냉장고 자석 빌드 작업의 작업 id가 포함됩니다. 작업이 SUCCEEDED에 도달할 때까지 작업 가져오기 엔드포인트를 폴링하거나 스트림을 구독한 다음, model_urls의 단일 항목에서 아티팩트를 다운로드하세요.

실패 모드

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

Request

POST

/openapi/creative-lab/fridge-magnet/v1/build

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "options": {
      "badge_shape": "rounded-rect",
      "size_mm": 60,
      "relief_height_mm": 3.3
    },
    "output": {
      "format": "glb"
    }
  }'

Response

{
  "result": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0"
}

Build example

The build task turns the selected prototype image into a 3D-printable fridge magnet model.

Creative Lab 냉장고 자석 빌드 모델 미리보기 — Build model preview

GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

냉장고 자석 작업 조회

유효한 작업 id로 prototype 또는 build 작업을 조회합니다. URL 경로는 작업의 단계와 일치해야 합니다. build 작업을 /prototype/:id를 통해 가져오면 404가 반환되며, 그 반대도 마찬가지입니다.

응답 형태는 냉장고 자석 Prototype 작업 객체 및 냉장고 자석 Build 작업 객체를 참조하세요.

매개변수

Name
id
Type
path
Description
조회할 냉장고 자석 작업의 고유 식별자입니다.

반환값

응답에는 냉장고 자석 작업 객체가 포함됩니다. 형태는 요청된 단계에 따라 달라집니다.

Request

GET

/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9

# Prototype
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}

DELETE/openapi/creative-lab/fridge-magnet/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/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).

GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id/stream

냉장고 자석 작업 스트리밍

Server-Sent Events(SSE)를 통해 냉장고 자석 작업의 실시간 업데이트를 스트리밍합니다. URL 경로는 작업의 단계와 일치해야 합니다. 즉, /prototype/:buildId/stream에서 스트림을 열면 status_code: 404가 포함된 단일 event: error 페이로드를 내보내고 스트림을 닫습니다.

매개변수

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

반환값

냉장고 자석 프로토타입 또는 냉장고 자석 빌드 작업 객체의 스트림을 Server-Sent Events로 반환합니다. PENDING 또는 IN_PROGRESS 작업의 경우, 응답 스트림에는 필요한 progress 및 status 필드만 포함됩니다.

Request

GET

/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream

curl -N https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/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.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}

GET/openapi/creative-lab/fridge-magnet/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/fridge-magnet/v1/prototype

# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response (List Prototype Tasks)

[
  {
    "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "type": "creative-lab-fridge-magnet-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729543210000,
    "started_at": 1729543215000,
    "finished_at": 1729543242000,
    "expires_at": 1729802442000,
    "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-fridge-magnet-prototype입니다.
Name
name
Type
string
Description
작업이 생성될 때 제공된 작업 이름입니다. 이름이 제공되지 않은 경우 빈 문자열입니다.
Name
status
Type
string
Description
작업의 상태입니다. 가능한 값은 PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED 중 하나입니다.
Name
progress
Type
integer
Description
작업의 progress입니다. 작업이 아직 시작되지 않은 경우 이 속성은 0입니다. 작업이 성공하면 이 값은 100이 됩니다.
Name
created_at
Type
timestamp
Description
작업이 생성된 시점의 타임스탬프(밀리초)입니다.
타임스탬프는 1970년 1월 1일 UTC 이후 경과한 밀리초 수를 나타내며, RFC 3339 표준을 따릅니다. 예를 들어, 2023년 9월 1일 금요일 오후 12:00:00 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 Fridge Magnet Prototype Task Object

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

냉장고 자석 빌드 작업 객체

냉장고 자석 빌드 작업 객체는 Meshy가 SUCCEEDED 상태의 프로토타입 작업에서 최종 3D 냉장고 자석 메시를 생성하기 위해 추적하는 작업 단위입니다. 빌드는 프로토타입의 콘셉트 이미지에 깊이 맵 릴리프 파이프라인을 실행하고 호출자가 요청한 형식으로 단일 메시 산출물을 게시합니다.

속성

Name
id
Type
string
Description
작업의 고유 식별자입니다.
Name
type
Type
string
Description
작업의 유형입니다. 값은 creative-lab-fridge-magnet-build입니다.
Name
name
Type
string
Description
작업이 생성될 때 제공된 작업 이름입니다. 이름이 제공되지 않은 경우 빈 문자열입니다.
Name
status
Type
string
Description
작업의 상태입니다. 가능한 값은 PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED 중 하나입니다.
Name
progress
Type
integer
Description
작업의 progress입니다. 작업이 아직 시작되지 않은 경우 이 속성은 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
model_urls
Type
object
Description
생성된 아티팩트의 다운로드 가능한 URL이며, 아티팩트 이름을 키로 사용합니다. 항상 정확히 하나의 항목을 포함하며, 빌드 요청의 output.format을 통해 요청된 형식입니다. 키는 요청된 형식과 일치합니다.
- Name
  glb
  Type
  string
  Description
  GLB 파일의 다운로드 가능한 URL입니다. output.format이 glb(기본값)인 경우 존재합니다.
- Name
  obj
  Type
  string
  Description
  model.obj, model.mtl, texture.png가 포함된 zip 번들의 다운로드 가능한 URL입니다. output.format이 obj인 경우 존재합니다.
- Name
  bundle_zip
  Type
  string
  Description
  생성기가 내보내는 모든 아티팩트의 zip 번들에 대한 다운로드 가능한 URL입니다. output.format이 zip인 경우 존재합니다.

Example Fridge Magnet Build Task Object

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}