プリント可能性を修復 API

3Dモデルをプリント可能性のために修復します — 非多様体の辺、縮退面、穴、その他のtopologyの問題を修正し、メッシュをプリント可能な状態にします。オプションで、プリントする予定のサイズで薄すぎる壁を厚くすることもできます。

POST/openapi/v1/print/repair

プリント可能性を修復タスクをストリーム

このエンドポイントは、Server-Sent Events (SSE) を使用して、プリント可能性を修復タスクのリアルタイム更新をストリーミングします。

パラメータ

Name
id
Type
path
Description
ストリーミング対象のプリント可能性を修復タスクの一意の識別子。

戻り値

Server-Sent Eventsとして、Repair Printability Task Objectのストリームを返します。

各フレームには、そのステージにおけるタスクオブジェクト全体が含まれます。これは Get エンドポイントが返すものと同じ形式です。そのため、タスクが PENDING または IN_PROGRESS の間は、出力フィールドはまだ値が設定されておらず（null、[] または {}）、 finished_at は null です。model_urls ブロックは、タスクが SUCCEEDED に達した時点で初めて送信されます。

Request

GET

/openapi/v1/print/repair/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream

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

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// Every frame is the full task object; fields not yet populated are null / empty.
// The PENDING frame below is abbreviated to the fields that change.
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

プリント可能性を修復タスクオブジェクト

Name
id
Type
string
Description
タスクの一意の識別子です。実装の詳細としてタスク ID には k-sortable UUID を使用していますが、id の形式について何らかの前提を置くべきではありません。
Name
type
Type
string
Description
プリント可能性を修復タスクのタイプです。値は print-repair です。
Name
status
Type
string
Description
タスクのステータスです。取り得る値は PENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELED のいずれかです。
Name
progress
Type
integer
Description
タスクの進行状況です。タスクがまだ開始されていない場合、このプロパティは 0 になります。タスクが成功すると 100 になります。
Name
preceding_tasks
Type
integer
Description
先行するタスクの数です。
このフィールドの値は、タスクのステータスが PENDING の場合にのみ意味を持ちます。
Name
created_at
Type
timestamp
Description
タスクが作成された時刻のタイムスタンプ（ミリ秒）です。
Name
started_at
Type
timestamp
Description
タスクが開始された時刻のタイムスタンプ（ミリ秒）です。タスクがまだ開始されていない場合、このプロパティは 0 になります。
Name
finished_at
Type
timestamp
Description
タスクが終了した時刻のタイムスタンプ（ミリ秒）です。タスクがまだ終了していない場合、このプロパティは 0 になります。
Name
expires_at
Type
timestamp
Description
タスクの結果がシステムから失効する時刻のタイムスタンプ（ミリ秒）です。タスクがまだ終了していない場合は 0 です。
Name
task_error
Type
object
Description
タスクが失敗した場合のエラー情報です。タスクが失敗していない場合、このプロパティは null です。詳細はエラーを参照してください。
- Name
  message
  Type
  string
  Description
  何が問題だったかを説明するエラーメッセージです。
Name
model_urls
Type
object
Description
修復された3Dモデルのダウンロード可能な URL です。入力形式に一致するフィールドのみが値を持ち、他の形式のフィールドは空文字列になります。
- Name
  glb
  Type
  string
  Description
  修復された GLB のダウンロード可能な URL です。入力が GLB だった場合、または input_task_id が使用された場合に値が入ります。
- Name
  gltf
  Type
  string
  Description
  修復された GLTF のダウンロード可能な URL です。入力が GLTF のアップロードだった場合に値が入ります。
- Name
  fbx
  Type
  string
  Description
  修復された FBX のダウンロード可能な URL です。入力が FBX のアップロードだった場合に値が入ります。
- Name
  obj
  Type
  string
  Description
  修復された OBJ のダウンロード可能な URL です。入力が OBJ のアップロードだった場合に値が入ります。
- Name
  stl
  Type
  string
  Description
  修復された STL のダウンロード可能な URL です。入力が STL のアップロードだった場合に値が入ります。
- Name
  usdz
  Type
  string
  Description
  USDZ 出力用に予約されています。プリント可能性を修復タスクでは常に空文字列です。
- Name
  3mf
  Type
  string
  Description
  3MF 出力用に予約されています。プリント可能性を修復タスクでは常に空文字列です。
- Name
  mtl
  Type
  string
  Description
  MTL 出力用に予約されています。プリント可能性を修復タスクでは常に空文字列です。
Name
thumbnail_url
Type
string
Description
修復されたモデルからレンダリングされたプレビュー画像の URL です。
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url の透明背景（RGBA）版のダウンロード可能な URL です。タスクが alpha_thumbnail: true で作成され、透明プレビューのレンダリングに成功した場合のみ存在します。それ以外の場合、このフィールドは省略されます。
Name
texture_urls
Type
array
Description
常に空の配列です。修復は入力のジオメトリのみを保持し、テクスチャの再生成は行いません。
Name
consumed_credits
Type
integer
Description
このタスクで消費されたクレジット数です。タスクが SUCCEEDED に達すると 10 になります。FAILED タスクの場合は 0 を返します（失敗時はクレジットが返還されます）。
Name
intended_print
Type
object
Description
修復で使用されたプリンターとサイズで、送信されたものか、解析タスクから再利用されたものです。肉厚修復では最初（PENDING）から存在しますが、まだわからない値は null です。
- Name
  printer_type
  Type
  string
  Description
  fdm、sla、または full_color です。
- Name
  height_mm
  Type
  number
  Description
  プリントの高さでサイズが指定されていた場合の、ミリメートル単位のプリント高さです。それ以外の場合は null です。
- Name
  longest_side_mm
  Type
  number
  Description
  プリントの最長辺の長さ（ミリメートル）です。高さでサイズ指定された場合は、モデルの比率から算出され、モデルの測定が完了するまでは null です。
- Name
  wall_thickness_mm
  Type
  number
  Description
  printer_type に対する最小肉厚（ミリメートル）です。
- Name
  dimensions_mm
  Type
  array
  Description
  プリントの [幅, 奥行き, 高さ]（ミリメートル）です。高さは height_mm と数分の1ミリメートル異なる場合があります。タスクが成功するまでは null で、GLB 以外の入力の場合は常に null です。
Name
print_repair_report
Type
object
Description
肉厚修復が何を行ったかを示します。肉厚修復が成功すると存在します。
- Name
  route
  Type
  string
  Description
  どの修復が実行されたかを示します。次のいずれかです。
  
  thin_wall: 表面の5%以上が薄すぎたため、肉厚の強化も実行されました（applied を参照）。
  
  topology: 壁は十分な厚さがあり、topology 修復のみが実行されました。
  
  topology_unmeasured: 壁の厚さを測定できなかったため、topology 修復のみが実行されました。
- Name
  applied
  Type
  boolean
  Description
  肉厚の強化によってメッシュが変更されたかどうかです。route が thin_wall の場合のみ存在します。
- Name
  faces_before
  Type
  integer
  Description
  入力メッシュの面数です。route が thin_wall の場合のみ存在します。
- Name
  faces_after
  Type
  integer
  Description
  修復後のメッシュの面数です。route が thin_wall の場合のみ存在します。
- Name
  thin_area_ratio_before
  Type
  number
  Description
  入力の表面のうち、intended_print.wall_thickness_mm より薄かった割合（0 から 1）です。入力を測定できなかった場合は省略されます。
- Name
  thin_area_ratio_after
  Type
  number
  Description
  修復後のモデルで測定した同じ割合です。測定できなかった場合は省略されますが、タスク自体は成功します。

The Repair Printability Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

The Repair Printability Task Object (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000090000,
  "expires_at": 1715725490000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10,
  "intended_print": {
    "printer_type": "sla",
    "height_mm": 100,
    "longest_side_mm": 118,
    "wall_thickness_mm": 0.8,
    "dimensions_mm": [118, 72.41, 99.87]
  },
  "print_repair_report": {
    "route": "thin_wall",
    "applied": true,
    "faces_before": 243112,
    "faces_after": 251870,
    "thin_area_ratio_before": 0.083,
    "thin_area_ratio_after": 0.004
  }
}

プリント可能性を修復 API

プリント可能性修復タスクを作成する

パラメータ

戻り値

失敗モード

Request

Response

プリント可能性を修復タスクを取得

パラメーター

戻り値

Request

Response

Response (wall thickness checked)

プリント可能性を修復タスクを削除

パスパラメータ

タスクのステータス

戻り値

Request

Response

プリント可能性を修復タスク一覧の取得

パラメーター

オプション属性

戻り値

Request

Response

プリント可能性を修復タスクをストリーム

パラメータ

戻り値

Request

Response Stream

プリント可能性を修復タスクオブジェクト

The Repair Printability Task Object

The Repair Printability Task Object (wall thickness checked)