lowpoly は 2026/10/30 に廃止されます。 リクエストエラーを避けるため、これらの日付までにモデルを切り替えてください。 非推奨の一覧を見る

プリント可能性を修復 API

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


POST/openapi/v1/print/repair

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

プリント可能性を修復タスクを作成します。このタスクは3Dモデルのtopologyを修復し、プリント可能な水密(watertight)バージョンを返します。タスクはバックグラウンドで実行されます。タスクに通常どれくらいの時間がかかるかについては、処理時間を参照してください。

修復されたモデルは入力と同じフォーマットになります。例えば、model_url に .stl ファイルを送信した場合、model_urls.stl に修復済みメッシュが格納され、model_urls にはそれ以外のフォーマットのキーは含まれません。input_task_id を使用する場合、Meshyは常に元のタスクのGLBファイルを修復するため、出力は .glb ファイルになります。

ジオメトリが変更されるため、Meshyは修復時にモデルのテクスチャを削除します。テクスチャを再度追加するには、修復済みモデルをリテクスチャAPIに送信してください。

Request

POST
/openapi/v1/print/repair
# Repair an existing task
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Or repair a model URL directly
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.stl"
  }'

# Also thicken walls that are too thin for a 100 mm tall SLA print
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "printer_type": "sla",
    "intended_print_height_mm": 100
  }'

Response

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

パラメータ

  • Name
    input_task_id
    Type
    string
    必須
    Description

    model_url を送信しない場合は必須です。修復したいモデルを持つタスクのID。例えば画像から3D、マルチ画像から3D、テキストから3D、リメッシュ、リテクスチャ、プリント可能性を分析タスクなどです。このタスクはAPIで作成したもので、ステータスが SUCCEEDED であり、GLBモデルを持っている必要があります。

    肉厚をチェックした「プリント可能性を分析」タスクは、そのプリンターとサイズも引き継ぎます。その場合、修復は肉厚をチェックし、どちらも送信しなかった場合でも薄い壁を厚くします。送信した printer_type やプリントサイズは、分析から引き継がれた値を置き換えます。model_url から渡された .stl、.fbx、.gltf ファイルの「プリント可能性を分析」タスクは機能しません。代わりにそのファイルを model_url として送信してください。

  • Name
    model_url
    Type
    string
    必須
    Description

    input_task_id を送信しない場合は必須です。修復対象のモデルを、公開URLまたはData URIとして指定します。両方を送信した場合、Meshyは input_task_id を使用します。

    http または https のURLの場合、モデルは最大400MBの .glb、.gltf、.obj、.fbx、.stl ファイルである必要があります。Data URIは、最大100MBのbase64エンコードされたGLB(data:model/gltf-binary;base64,...)またはglTF(data:model/gltf+json;base64,...)ファイルのみを保持できます。.obj、.fbx、.stl ファイルは http または https のURLとして送信してください。

    100MBを超えるファイルは、以下のルールにも従う必要があります:

    • GLB、glTF、FBX、OBJファイルの面数は最大10,000,000面までです。Meshyは面を三角形として数えるため、四角形は2面とカウントされ、複数回描画されるメッシュはコピーごとに1回カウントされます。
    • FBXファイルはバイナリFBX 7.1以降である必要があります。
    • GLBまたはglTFファイルはDraco圧縮を使用していてはいけません。

    Meshyのダウンロード URL(assets.meshy.ai/…?Expires=…&Signature=…)は署名付きであり、そのタスクの expires_at を過ぎると機能しなくなります。タスクを再度取得しても更新されません。Meshyで作成したモデルについては、代わりに input_task_id を送信してください。これはMeshyが元のタスクを保持している間は機能します(アセット保持期間を参照)。それ以降もモデルを使用するには、expires_at より前にダウンロードし、ご自身のコピーを送信してください。

  • Name
    alpha_thumbnail
    Type
    boolean
    デフォルト false
    Description

    透過背景(RGBA)のプレビューも生成するかどうかを指定します。タスクを取得した際、alpha_thumbnail_url として返されます。thumbnail_url は変化しません。

プリント予定のサイズで薄すぎる壁も厚くしたい場合は、printer_type、プリントサイズ、またはその両方を送信してください。Meshyは、表面の5%以上がそのプリンターにとって薄すぎる場合にのみ壁を厚くします。修復されたモデルは元のスケールを維持します。スケールを変更するには、リサイズAPIを使用してください。このAPIはサイズをメートル単位で受け取るため、100mmは 0.1 になります。

  • Name
    printer_type
    Type
    string
    Description

    使用予定のプリンターです。これにより、修復が目指す最小肉厚が設定されます。printer_type を指定せずにプリントサイズを送信した場合、input_task_id の「プリント可能性を分析」タスクがプリンターを提供していない限り、Meshyは fdm を使用します。

    利用可能な値:

    • fdm: フィラメント、最小肉厚1.0mm
    • sla: レジン、最小肉厚0.8mm
    • full_color: フルカラー、最小肉厚2.0mm

    これら以外の値を指定した場合は 400 が返されます。

  • Name
    intended_print_height_mm
    Type
    number
    Description

    プリントの高さをミリメートル単位で指定します。範囲は 1 から 1000 です。範囲外の値を指定すると 400 が返されます。これと intended_print_longest_side_mm のどちらか一方のみを送信してください。

    これはGLB入力でのみ機能します。.glb ファイルでない model_url の場合は、代わりに intended_print_longest_side_mm を送信してください。

  • Name
    intended_print_longest_side_mm
    Type
    number
    Description

    プリントの最長辺の長さをミリメートル単位で指定します。範囲は 1 から 1000 です。範囲外の値を指定すると 400 が返されます。これはすべての入力フォーマットで機能します。

サイズを指定せずに printer_type を送信し、Meshyが「プリント可能性を分析」タスクからサイズを引き継がない場合、Meshyは次のプリントサイズを使用します:

  • .glb ファイルまたはいずれかの input_task_id:高さ150mm
  • .stl ファイル:ファイル自体の最長辺をミリメートルとして読み取った値
  • .obj、.fbx、.gltf ファイル:最長辺150mm

他の単位のSTLファイルの場合は、intended_print_longest_side_mm を送信してください。

Meshyは両方のプリントサイズを最も近いミリメートルに丸めます。

戻り値

レスポンスの result フィールドには、新しく作成されたプリント可能性を修復タスクのIDが格納されます。

失敗モード

  • Name
    400 - Bad Request
    Description

    リクエストを実行できません。エラーメッセージには、検出された問題の内容が示されます。例:

    • パラメータ不足:input_task_id と model_url のどちらも送信されていません。
    • 無効なUUID:input_task_id が有効なUUIDではありません。
    • 無効なモデルURL:model_url の形式が不正、サポートされていないスキームを使用している、またはサポートされていないファイル拡張子です。
    • モデルファイルが大きすぎる:http または https のURLからの model_url ファイルが400MBを超えている、またはData URIとして100MBを超えています。
    • 面数が多すぎる:model_url ファイルが100MBを超えるGLB、glTF、FBX、またはOBJファイルで、面数が10,000,000を超えています。面数を減らしてから、再度ファイルを送信してください。
    • 100MBを超えるASCII FBX:model_url ファイルが100MBを超えるASCII FBXです。バイナリFBXまたはGLBとして送信してください。
    • 読み取れないモデルファイル:model_url ファイルが100MBを超えており、Meshyがそのヘッダーを読み取れません。例えば、Draco圧縮されたGLBやglTF、または7.1より古いバイナリFBXなどです。
    • モデルヘッダーが複雑すぎる:model_url ファイルが100MBを超えており、そのヘッダーに含まれるメッシュ、ノード、レコードが多すぎてチェックできません。ファイル内のオブジェクト数を減らしてから、再度送信してください。
    • モデルファイルをダウンロードできない:model_url がエラーを返しました。多くの場合、署名付きのMeshyダウンロードURLの有効期限が切れたことが原因です。タスクを再度取得しても、同じ有効期限の同じURLが返されます。ファイルのご自身のコピーを送信するか、Meshyが元のタスクを保持している間は input_task_id を送信してください。
    • タスクが成功していない:input_task_id のタスクがまだ保留中、処理中、または失敗しています。
    • GLBがない:input_task_id のタスクに修復対象のGLBモデルがありません。
    • 無効なプリントサイズ:intended_print_height_mm または intended_print_longest_side_mm が 1 から 1000 の範囲外である、またはリクエストに両方が含まれています。
    • 不明なプリンタータイプ:printer_type が fdm、sla、full_color のいずれでもありません。
    • 非GLBモデルに対する高さ指定:リクエストに intended_print_height_mm が含まれており、model_url が .glb ファイルではありません。代わりに intended_print_longest_side_mm を送信してください。
    • このモデルを高さでサイズ調整できない:指定した高さ、またはデフォルトの150mmでは、モデルの最長辺が1~1,000mmの範囲外になります。モデルが平面的な場合や、Meshyがサイズを特定できない場合にも発生します。代わりに intended_print_longest_side_mm を送信してください。.glb の model_url や一部の input_task_id タスクでは、Meshyはタスク開始後にしかこれを検出できず、その場合タスクは代わりに FAILED として終了します。
    • STLサイズが使用不可:リクエストにサイズを指定せずに printer_type が含まれており、Meshyが .stl ファイル自体の最長辺を読み取れない、またはその値が1~1,000mmの範囲外です。intended_print_longest_side_mm を送信してください。

    リクエストを修正してから、再度送信してください。エラーを参照してください。

  • Name
    401 - Unauthorized
    Description

    APIキーが指定されていないか、無効です。Authorization ヘッダーを確認してください。

  • Name
    402 - Payment Required
    Description

    例:

    • クレジット不足:このタスクを実行するための十分なクレジットがない、またはアカウントがクレジット上限に達しています。クレジット残高を確認してから、再試行してください。
    • フリープラン:タスクを作成するには有料プランが必要です。サブスクリプション設定でプランをアップグレードしてから、再試行してください。
  • Name
    403 - Forbidden
    Description

    input_task_id がバスレリーフモデルであり、このエンドポイントでは修復できません。メッセージは This model type does not support this operation です。別のモデルを送信してください。

  • Name
    404 - Not Found
    Description

    input_task_id のタスクが存在しないか、別のユーザーに属しています。IDを確認し、そのタスクを作成したアカウントのAPIキーを使用してください。

  • Name
    429 - Too Many Requests
    Description

    レート制限を超えたか、保留中のタスクが多すぎます。しばらく待ってから再試行してください。レート制限を参照してください。


GET/openapi/v1/print/repair/:id

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

IDを指定してプリント可能性を修復タスクを返します。

Request

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

Response

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

Response (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "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=***"
  },
  "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
  }
}

パラメータ

  • Name
    id
    Type
    path
    Description

    作成レスポンスから取得したタスクID。

返り値

プリント可能性を修復タスクオブジェクト。model_urlsフィールドは、タスクがSUCCEEDEDになるまで空です。その後は、入力フォーマットに一致するキーのみが含まれます。肉厚の修復では、開始時からintended_printが含まれ、タスクが成功した後にprint_repair_reportが含まれます。


DELETE/openapi/v1/print/repair/:id

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

プリント可能性を修復タスクを、修復済みモデルを含めて完全に削除します。削除を元に戻すことはできません。

Request

DELETE
/openapi/v1/print/repair/a43b5c6d-7e8f-901a-234b-567c890d1e2f
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/repair/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 keeps 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."
}

パスパラメータ

  • Name
    id
    Type
    path
    Description

    削除するタスクのID。

タスクステータス

PENDING のタスクを削除すると、作成時に使用したクレジットが返金されます。

IN_PROGRESS のタスクは削除できません。リクエストは 409 Conflict を返し、 タスクは実行され続けます。Meshyは、すでに開始されたタスクについては クレジットを返金しないため、削除するとクレジットと結果の両方を失うことに なります。SUCCEEDED、FAILED、または CANCELED のいずれかの状態に なるまで待ってから削除してください。

最終ステータス(SUCCEEDED、FAILED、または CANCELED)のタスクを 削除しても、クレジットは返金されません。

戻り値

タスクが削除された場合は 200 OK、タスクが IN_PROGRESS の場合は 409 Conflict を返します。


GET/openapi/v1/print/repair

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

あなたのプリント可能性を修復タスクの一覧を返します。

Request

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

Response

[
  {
    "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=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
    "texture_urls": [],
    "consumed_credits": 10
  }
]

パラメータ

  • Name
    page_num
    Type
    integer
    デフォルト 1
    Description

    返すページ番号。1 から始まります。

  • Name
    page_size
    Type
    integer
    デフォルト 10
    Description

    1ページあたりのタスク数。最大 100。

  • Name
    sort_by
    Type
    string
    Description

    並び順。

    利用可能な値:

    • +created_at:古い順
    • -created_at:新しい順

戻り値

ページ分割されたプリント可能性を修復タスクオブジェクトの一覧。


GET/openapi/v1/print/repair/:id/stream

プリント可能性を修復タスクをストリーム取得する

プリント可能性を修復タスクの更新を、Server-Sent Events(SSE)としてストリーム配信します。

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 following PENDING frame 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=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

パラメータ

  • Name
    id
    Type
    path
    Description

    作成レスポンスから取得したタスクIDです。

戻り値

プリント可能性を修復タスクオブジェクトのストリームを、Server-Sent Eventsとして返します。

各イベントには、Get エンドポイントが返すものと同じ形式の、タスクオブジェクト全体が含まれます。タスクがPENDINGまたはIN_PROGRESSの間、出力フィールドは空(null、[]、または{})で、finished_atは0です。 model_urlsは、タスクがSUCCEEDEDになるまで空のオブジェクトです。


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

プリント可能性を修復タスクオブジェクトは、3Dモデルの1件の修復を表します。タスクのステータス、progress、そしてタスクが成功した場合は修復済みのモデルを保持します。

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=***"
  },
  "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=***"
  },
  "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
  }
}
  • Name
    id
    Type
    string
    Description

    タスク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

    タスクが作成された時刻で、Unixミリ秒単位です。

  • Name
    started_at
    Type
    timestamp
    Description

    タスクが開始した時刻で、Unixミリ秒単位です。タスクが開始するまでは 0 です。

  • Name
    finished_at
    Type
    timestamp
    Description

    タスクが終了した時刻で、Unixミリ秒単位です。タスクが終了するまでは 0 です。

  • Name
    expires_at
    Type
    timestamp
    Description

    タスクの結果が期限切れになる時刻で、Unixミリ秒単位です。タスクが終了するまでは 0 です。

  • Name
    task_error
    Type
    object
    Description

    タスクが失敗した場合のエラーの詳細です。タスクが失敗していない場合は null です。エラーを参照してください。

    • Name
      message
      Type
      string
      Description

      何が問題だったかを説明する文言です。

  • Name
    model_urls
    Type
    object
    Description

    修復済みモデルのダウンロードURLです。入力フォーマットに一致するキーのみを持ちます。 タスクが生成しなかったフォーマットには、空文字列ではなくキー自体が存在しません。

    • Name
      glb
      Type
      string
      Description

      修復済みのGLBファイルです。入力がGLBファイルだった場合、または input_task_id を送信した場合に設定されます。

    • Name
      gltf
      Type
      string
      Description

      修復済みのglTFファイルです。入力がglTFファイルだった場合に設定されます。

    • Name
      fbx
      Type
      string
      Description

      修復済みのFBXファイルです。入力がFBXファイルだった場合に設定されます。

    • Name
      obj
      Type
      string
      Description

      修復済みのOBJファイルです。入力がOBJファイルだった場合に設定されます。

    • Name
      stl
      Type
      string
      Description

      修復済みのSTLファイルです。入力がSTLファイルだった場合に設定されます。

  • Name
    thumbnail_url
    Type
    string
    Description

    修復済みモデルのプレビュー画像のダウンロードURLです。

  • Name
    alpha_thumbnail_url
    Type
    string
    Description

    thumbnail_url の透明背景版(RGBA)のダウンロードURLです。タスクを alpha_thumbnail: true で作成し、Meshyが透明プレビューをレンダリングした場合にのみ存在します。

  • Name
    texture_urls
    Type
    array
    Description

    常に空の配列です。修復は入力のジオメトリのみを保持し、テクスチャの再ベイクは行いません。

  • Name
    consumed_credits
    Type
    integer
    Description

    タスクが使用したクレジット数です。タスクが SUCCEEDED の場合は 10、FAILED のタスクの場合は 0 です。これは、タスクが失敗した場合にMeshyがクレジットを払い戻すためです。

  • Name
    intended_print
    Type
    object
    Description

    修復で使用されたプリンターとサイズです。あなたがこれらを送信した場合でも、Meshyがプリント可能性を分析タスクから再利用した場合でも同様です。肉厚の修復では、タスクが PENDING の間を含め、最初から存在します。Meshyがまだ把握していない値は 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

      プリントの最も長い辺の長さ(ミリメートル単位)です。プリントが高さでサイズ指定されている場合、Meshyはモデルの比率から計算します。Meshyがモデルを計測するまでは 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: Meshyが壁を計測できなかったため、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 までの値です。Meshyが入力を計測できなかった場合は省略されます。

    • Name
      thin_area_ratio_after
      Type
      number
      Description

      修復済みモデルで計測した同じ割合です。計測できなかった場合は省略されます。この場合もタスクは成功します。