API Změnit velikost

API Změnit velikost vám umožňuje změnit velikost stávajících 3D modelů na rozměry v reálném světě. Můžete zadat přesnou výšku, omezení nejdelší strany nebo nechat AI automaticky odhadnout vhodnou velikost.

POST/openapi/v1/resize

Vytvoření úlohy Změnit velikost

Tento koncový bod vytvoří novou úlohu změny velikosti.

Parametry

Vyžadován je pouze jeden z parametrů input_task_id nebo model_url. Pokud jsou zadány oba, input_task_id má prioritu.

Name
input_task_id
Type
string
Povinné
Description
ID dokončené úlohy Meshy, jejíž model chcete změnit. Úloha musí mít stav SUCCEEDED. Výstupní formát bude GLB.

Name
model_url
Type
string
Povinné
Description
Veřejně dostupná URL nebo Data URI odkazující na soubor 3D modelu. Podporované formáty: .glb, .gltf, .obj, .fbx, .stl. Pro Data URI použijte MIME type: application/octet-stream. Výstupní formát zachová původní formát vstupního modelu.

Je vyžadován právě jeden mode změny velikosti: resize_height, resize_longest_side nebo auto_size. Tyto tři parametry se vzájemně vylučují.

Name
resize_height
Type
number
Description
Změnit velikost modelu na konkrétní výšku měřenou v metrech.

Name
resize_longest_side
Type
number
Description
Změnit velikost modelu tak, aby jeho nejdelší strana odpovídala této hodnotě měřené v metrech. Poměr stran je zachován.

Name
auto_size
Type
boolean
Description
Při nastavení na true služba použije AI vidění k automatickému odhadu skutečné výšky objektu a podle toho změní velikost modelu. Počátek bude ve výchozím nastavení bottom, pokud není explicitně nastaveno origin_at.

Name
origin_at
Type
string
výchozí bottom
Description
Pozice počátku po změně velikosti.
Dostupné hodnoty: bottom, center.

Vrací

Vlastnost result v odpovědi obsahuje id nově vytvořené úlohy změny velikosti.

Režimy selhání

400 - Chybný požadavek

Požadavek byl nepřijatelný. Časté příčiny:

Chybějící parametr: Musí být zadán buď model_url, nebo input_task_id.
Chybějící mode změny velikosti: Musí být zadán alespoň jeden z parametrů resize_height, resize_longest_side nebo auto_size.
Vzájemně se vylučující parametry: resize_height, resize_longest_side a auto_size nelze kombinovat.
Neplatná vstupní úloha: input_task_id musí odkazovat na úspěšnou úlohu.
Neplatný formát modelu: model_url odkazuje na soubor s nepodporovanou příponou.
Nedostupná URL: model_url se nepodařilo stáhnout.

401 - Neautorizováno

Autentizace selhala. Zkontrolujte prosím svůj API klíč.

402 - Vyžadována platba

Nedostatek kreditů k provedení této úlohy.

429 - Příliš mnoho požadavků

Překročili jste svůj limit rychlosti.

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

Načtení úlohy Změnit velikost

Tento koncový bod načte úlohu změny velikosti podle jejího ID.

Parametry

Name
id
Type
path
Description
ID úlohy změny velikosti, která se má načíst.

Návratová hodnota

Objekt úlohy Změnit velikost.

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

Odstranění úlohy Změnit velikost

Tento koncový bod trvale odstraní úlohu Změnit velikost, včetně všech souvisejících modelů a dat. Tato akce je nevratná.

Parametry cesty

Name
id
Type
path
Description
ID úlohy Změnit velikost, která se má odstranit.

Návratová hodnota

Při úspěchu vrátí 200 OK.

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

Seznam úloh Změnit velikost

Tento koncový bod vám umožňuje načíst seznam úloh změny velikosti.

Parametry

Name
page_num
Type
integer
výchozí 1
Description
Číslo stránky pro stránkování.

Name
page_size
Type
integer
výchozí 10
Description
Limit velikosti stránky. Maximální povolený počet je 50 položek.

Name
sort_by
Type
string
Description
Pole, podle kterého se má řadit. Dostupné hodnoty:
- +created_at: Řadit podle času vytvoření vzestupně.
- -created_at: Řadit podle času vytvoření sestupně.

Vrací

Vrací stránkovaný seznam objektů úlohy Změnit velikost.

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

Streamování úlohy Změnit velikost

Tento koncový bod streamuje aktualizace úlohy změny velikosti v reálném čase pomocí Server-Sent Events (SSE).

Parametry

Name
id
Type
path
Description
Jedinečný identifikátor úlohy změny velikosti, která se má streamovat.

Vrací

Vrací stream objektů úlohy Změnit velikost jako Server-Sent Events.

U úloh PENDING nebo IN_PROGRESS bude stream odpovědi obsahovat pouze nezbytná pole progress a 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
}

Objekt úlohy Změnit velikost

Objekt úlohy Změnit velikost představuje úlohu změny velikosti.

Vlastnosti

id · string

Jedinečný identifikátor úlohy.

type · string

Typ úlohy. Hodnota je resize.

model_urls · object

Stažitelná adresa URL pro soubor modelu se změněnou velikostí. Při použití input_task_id je výstup vždy GLB. Při použití model_url si výstup zachová původní formát.

progress · integer

Progress úlohy (0–100).

status · string

Stav úlohy. Možné hodnoty: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

preceding_tasks · integer

Počet předcházejících úloh. Má význam pouze tehdy, když je stav PENDING.

created_at · timestamp

Časové razítko vytvoření úlohy, v milisekundách.

started_at · timestamp

Časové razítko spuštění úlohy, v milisekundách. 0, pokud nebyla spuštěna.

finished_at · timestamp

Časové razítko dokončení úlohy, v milisekundách. 0, pokud nebyla dokončena.

task_error · object

Objekt chyby, pokud úloha selhala. Další podrobnosti najdete v části Chyby.

consumed_credits · integer

Počet kreditů spotřebovaných touto úlohou (1 kredit na úlohu změny velikosti). Vrací 0 pro úlohy FAILED.