크기 조정 API

크기 조정 API를 사용하면 기존 3D 모델을 실제 세계 치수로 크기를 조정할 수 있습니다. 정확한 높이, 가장 긴 변 제약 조건을 지정하거나 AI가 적절한 크기를 자동으로 추정하도록 할 수 있습니다.

POST/openapi/v1/resize

크기 조정 작업 삭제

이 엔드포인트는 크기 조정 작업과 관련된 모든 모델 및 데이터를 영구적으로 삭제합니다. 이 작업은 되돌릴 수 없습니다.

경로 매개변수

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/resize/:id

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/resize/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/resize

크기 조정 작업 목록 조회

이 엔드포인트를 사용하면 크기 조정 작업 목록을 조회할 수 있습니다.

매개변수

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/resize

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "resize",
    "model_urls": {
      "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
    },
    "progress": 100,
    "status": "SUCCEEDED",
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "task_error": null,
    "consumed_credits": 1
  }
]

GET/openapi/v1/resize/:id/stream

크기 조정 작업 스트리밍

이 엔드포인트는 Server-Sent Events(SSE)를 사용하여 크기 조정 작업의 실시간 업데이트를 스트리밍합니다.

매개변수

Name
id
Type
path
Description
스트리밍할 크기 조정 작업의 고유 식별자입니다.

반환값

크기 조정 작업 객체의 스트림을 Server-Sent Events로 반환합니다.

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

Request

GET

/openapi/v1/resize/:id/stream

curl -N https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Message event examples illustrate task progress.
event: message
data: {
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "resize",
  "model_urls": {
    "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": null,
  "consumed_credits": 1
}

The Resize Task Object

Resize Task 객체는 크기 조정 작업을 나타냅니다.

Properties

id · string

작업의 고유 식별자입니다.

type · string

작업의 유형입니다. 값은 resize입니다.

model_urls · object

크기가 조정된 모델 파일의 다운로드 가능한 URL입니다. input_task_id를 사용하는 경우 출력은 항상 GLB입니다. model_url을 사용하는 경우 .glb, .obj, .fbx 또는 .stl 입력은 해당 형식을 유지하며, .gltf 입력이나 Data URI는 GLB를 생성합니다.

progress · integer

작업의 progress입니다 (0-100).

status · string

작업의 상태입니다. 가능한 값: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

preceding_tasks · integer

선행 작업의 수입니다. status가 PENDING일 때만 의미가 있습니다.

created_at · timestamp

작업이 생성된 시점의 타임스탬프이며, 밀리초 단위입니다.

started_at · timestamp

작업이 시작된 시점의 타임스탬프이며, 밀리초 단위입니다. 시작되지 않은 경우 0입니다.

finished_at · timestamp

작업이 완료된 시점의 타임스탬프이며, 밀리초 단위입니다. 완료되지 않은 경우 0입니다.

task_error · object

작업이 실패한 경우의 오류 객체입니다. 자세한 내용은 Errors를 참조하세요.

consumed_credits · integer

이 작업으로 소비된 크레딧 수입니다 (크기 조정 작업당 1 크레딧). FAILED 작업의 경우 0을 반환합니다.

크기 조정 API

크기 조정 작업 생성

파라미터

반환 값

실패 모드

Request

Response

크기 조정 작업 조회

매개변수

반환값

Request

Response

크기 조정 작업 삭제

경로 매개변수

작업 상태

반환값

Request

Response

크기 조정 작업 목록 조회

매개변수

반환 값

Request

Response

크기 조정 작업 스트리밍

매개변수

반환값

Request

Response Stream

The Resize Task Object

Properties