Resize API

Ang Resize API ay nagbibigay-daan sa iyo na i-resize ang mga umiiral na 3D na modelo sa mga totoong sukat. Maaari mong tukuyin ang eksaktong taas, isang pinakamahabang gilid na limitasyon, o hayaan ang AI na awtomatikong tantiyahin ang angkop na laki.

POST/openapi/v1/resize

Gumawa ng Resize Task

Ang endpoint na ito ay lumilikha ng bagong resize task.

Mga Parameter

Isa lamang sa input_task_id o model_url ang kailangan. Kung parehong ibinigay, ang input_task_id ang may prayoridad.

Name
input_task_id
Type
string
Kinakailangan
Description
Ang ID ng isang natapos na Meshy task na ang modelo ay nais mong i-resize. Ang task ay dapat may status na SUCCEEDED. Ang output format ay magiging GLB.

Name
model_url
Type
string
Kinakailangan
Description
Isang pampublikong accessible na URL o data URI na tumuturo sa isang 3D model file. Mga suportadong format: .glb, .gltf, .obj, .fbx, .stl. Para sa Data URIs, gamitin ang MIME type: application/octet-stream. Ang output format ay mapapanatili ang orihinal na format ng input model.

Eksaktong isang resize mode ang kailangan: resize_height, resize_longest_side, o auto_size. Ang tatlong parameter na ito ay hindi maaaring pagsamahin.

Name
resize_height
Type
number
Description
I-resize ang modelo sa isang tiyak na taas na sinusukat sa metro.

Name
resize_longest_side
Type
number
Description
I-resize ang modelo upang ang pinakamahabang bahagi nito ay tumugma sa halagang ito, sinusukat sa metro. Ang aspect ratio ay mapapanatili.

Name
auto_size
Type
boolean
Description
Kapag nakatakda sa true, ang serbisyo ay gumagamit ng AI vision upang awtomatikong tantiyahin ang totoong taas ng bagay at i-resize ang modelo nang naaayon. Ang origin ay magiging default sa bottom maliban kung ang origin_at ay tahasang itinakda.

Name
origin_at
Type
string
default bottom
Description
Posisyon ng origin pagkatapos ng pag-resize.
Mga magagamit na halaga: bottom, center.

Mga Ibinabalik

Ang result na property ng tugon ay naglalaman ng id ng bagong likhang resize task.

Mga Mode ng Pagkabigo

400 - Bad Request

Ang kahilingan ay hindi katanggap-tanggap. Karaniwang mga sanhi:

Nawawalang parameter: Dapat ibigay ang alinman sa model_url o input_task_id.
Nawawalang resize mode: Dapat tukuyin ang isa sa resize_height, resize_longest_side, o auto_size.
Mutually exclusive parameters: Hindi maaaring pagsamahin ang resize_height, resize_longest_side, at auto_size.
Invalid input task: Ang input_task_id ay dapat tumukoy sa isang matagumpay na task.
Invalid model format: Ang model_url ay tumuturo sa isang file na may hindi suportadong extension.
Unreachable URL: Ang model_url ay hindi ma-download.

401 - Unauthorized

Nabigo ang authentication. Pakisuri ang iyong API key.

402 - Payment Required

Kulang ang credits para isagawa ang task na ito.

429 - Too Many Requests

Naabot mo na ang iyong rate limit.

Request

POST

/openapi/v1/resize

# Simple: resize to a specific height
curl https://api.meshy.ai/openapi/v1/resize \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "resize_height": 1.8
  }'

# Advanced: resize longest side with custom origin
curl https://api.meshy.ai/openapi/v1/resize \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.glb",
    "resize_longest_side": 2.0,
    "origin_at": "center"
  }'

Response

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

GET/openapi/v1/resize/:id

Kunin ang isang Resize Task

Ang endpoint na ito ay kumukuha ng isang resize task gamit ang ID nito.

Mga Parameter

Name
id
Type
path
Description
Ang ID ng resize task na kukunin.

Mga Ibinabalik

Ang Resize Task object.

Request

GET

/openapi/v1/resize/:id

curl https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-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
}

DELETE/openapi/v1/resize/:id

Burahin ang isang Resize Task

Ang endpoint na ito ay permanenteng bubura ng isang resize task, kasama ang lahat ng kaugnay na modelo at data. Ang aksyong ito ay hindi na mababawi.

Mga Parameter ng Path

Name
id
Type
path
Description
Ang ID ng resize task na buburahin.

Mga Ibinabalik

Nagbabalik ng 200 OK kapag matagumpay.

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

// Returns 200 Ok on success.

GET/openapi/v1/resize

Listahan ng mga Resize Task

Ang endpoint na ito ay nagbibigay-daan sa iyo na makuha ang listahan ng mga resize task.

Mga Parameter

Name
page_num
Type
integer
default 1
Description
Numero ng pahina para sa pagination.

Name
page_size
Type
integer
default 10
Description
Limitasyon sa laki ng pahina. Ang pinakamataas na pinapayagan ay 50 item.

Name
sort_by
Type
string
Description
Field na gagamitin para sa pag-aayos. Mga magagamit na halaga:
- +created_at: Ayusin ayon sa oras ng paglikha sa pataas na pagkakasunod-sunod.
- -created_at: Ayusin ayon sa oras ng paglikha sa pababang pagkakasunod-sunod.

Mga Ibinabalik

Nagbabalik ng isang listahan na may pagination ng The Resize Task Objects.

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

I-stream ang isang Resize Task

Ang endpoint na ito ay nag-i-stream ng mga real-time na update para sa isang resize task gamit ang Server-Sent Events (SSE).

Mga Parameter

Name
id
Type
path
Description
Natatanging identifier para sa resize task na i-stream.

Mga Ibinabalik

Nagbabalik ng stream ng The Resize Task Objects bilang Server-Sent Events.

Para sa mga PENDING o IN_PROGRESS na mga task, ang response stream ay maglalaman lamang ng kinakailangang mga field na progress at 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
}

Ang Resize Task Object

Ang Resize Task object ay kumakatawan sa isang resize na trabaho.

Mga Katangian

id · string

Natatanging pagkakakilanlan para sa gawain.

type · string

Uri ng gawain. Ang halaga ay resize.

model_urls · object

Downloadable URL para sa resized na model file. Kapag gumagamit ng input_task_id, ang output ay laging GLB. Kapag gumagamit ng model_url, ang output ay pinapanatili ang orihinal na format.

progress · integer

Pag-unlad ng gawain (0-100).

status · string

Katayuan ng gawain. Mga posibleng halaga: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

preceding_tasks · integer

Ang bilang ng mga naunang gawain. Makabuluhan lamang kapag ang status ay PENDING.

created_at · timestamp

Timestamp kung kailan nilikha ang gawain, sa milliseconds.

started_at · timestamp

Timestamp kung kailan sinimulan ang gawain, sa milliseconds. 0 kung hindi pa nasimulan.

finished_at · timestamp

Timestamp kung kailan natapos ang gawain, sa milliseconds. 0 kung hindi pa natapos.

task_error · object

Error object kung nabigo ang gawain. Tingnan ang Errors para sa karagdagang detalye.

consumed_credits · integer

Ang bilang ng credits na nagamit ng gawain na ito (1 credit bawat resize task). Nagbabalik ng 0 para sa mga FAILED na gawain.