lowpoly は 2026/10/30 に廃止されます。 3D 生成モデルとしての meshy-7 は 2026/12/31 に廃止されます。テクスチャモデルとしては引き続き利用できます。 リクエストエラーを避けるため、これらの日付までにモデルを切り替えてください。 非推奨の一覧を見る

Rigging API

ヒューマノイドまたは四足の3Dモデルにスケルトン(アーマチュア)を追加し、メッシュをそれにバインドすることで、キャラクターをアニメーション可能な状態にします。リギングされたキャラクターにアニメーションを適用する方法については、Animation API を参照してください。

リギングは、手足と身体の構造が明確に定義された標準的なヒューマノイド(二足歩行)キャラクターや、四足動物に適しています。動物をリギングするには、四足動物をリギングする を参照してください。


POST/openapi/v1/rigging

Riggingタスクを作成する

3Dモデル用のRiggingタスクを作成します。タスクが成功すると、標準的な形式でリギングされたキャラクターが返され、オプションで基本的な歩行・走行アニメーションも返されます。

タスクはバックグラウンドで実行されます。タスクに通常どれくらいの時間がかかるかについては、処理時間を参照してください。

リギングは次のようなモデルには適していません。

  • テクスチャのないメッシュ
  • 人型でも四足動物でもないアセット
  • 四肢や体の構造が不明瞭な人型アセット

Request

POST
/openapi/v1/rigging
# Rig a model from a URL
curl https://api.meshy.ai/openapi/v1/rigging \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "YOUR_MODEL_URL_OR_DATA_URI",
    "height_meters": 1.8
  }'

Response

{
  "result": "018b314a-a1b5-716d-c222-2f1776f7f579"
}

パラメータ

  • Name
    input_task_id
    Type
    string
    必須
    Description

    model_urlを送信しない場合は必須です。リギングしたいモデルを持つタスクのIDです。Meshyはテクスチャ付きの人型モデルと四足動物をサポートしています。

    モデルの三角形数は最大380,000(クアッドは2としてカウント)で、これを超えると400が返されます。この上限を下回るには、まずRemesh APIをtarget_polycountを300000以下、またはtopology: quadの場合は150000以下にして実行してください。

  • Name
    model_url
    Type
    string
    必須
    Description

    input_task_idを送信しない場合は必須です。リギングするモデルを、公開URLまたはData URIとして指定します。両方を送信した場合、Meshyはinput_task_idを使用します。

    モデルは、httpまたはhttpsのURLからの場合は最大400MB、Data URIの場合は最大100MBのGLB(.glb)ファイルである必要があります。リギングはテクスチャ付きの人型モデルと四足動物をサポートしています。

    モデルの三角形数は最大380,000(クアッドは2としてカウント)で、これを超えると400が返されます。この上限を下回るには、まずRemesh APIをtarget_polycountを300000以下、またはtopology: quadの場合は150000以下にして実行してください。

    キャラクターの正面は、glTFの標準の前方向である+Z軸を向いている必要があります。モデルが別の軸を向いている場合、姿勢推定は失敗します。

    100MBを超えるファイルは、さらに次のルールにも従う必要があります。

    • 面の数は最大10,000,000までです。これを超えるファイルは400を返します。Meshyは面を三角形として数え、複数回描画されるメッシュはコピーごとに1回としてカウントします。
    • Draco圧縮を使用してはいけません。
  • Name
    animation_type
    Type
    string
    デフォルト biped
    Description

    リギングするキャラクターの種類です。それ以外の値を指定すると400が返されます。

    使用可能な値:

  • Name
    height_meters
    Type
    number
    デフォルト 1.7 (biped)
    Description

    モデルの身長(メートル単位)です。Meshyはリギングされたモデルをこの身長にスケーリングします。負の値を指定すると400が返されます。

    • Bipedリグ:デフォルトは1.7です。
    • Quadrupedリグ:指定しない場合、または0を指定した場合、動物は元のサイズを維持します。
  • Name
    texture_image_url
    Type
    string
    ⚠ 非推奨
    Description

    モデルが独自のテクスチャを持っている場合は指定しないでください。指定しない場合、Meshyはmodel_urlファイルに埋め込まれたテクスチャ、または入力タスクのテクスチャを使用します。これを送信すると、この画像がリギングされたモデルの唯一のテクスチャとなり、モデルはPBRマップを失います。

    モデルのUV展開済みベースカラーテクスチャを、公開URLまたはData URIとして指定します。画像は最大20MBのPNGファイルである必要があります。別の画像形式を指定すると400が返されます。

  • Name
    skeleton_template
    Type
    string
    デフォルト meshyrig
    Description

    リギングされたキャラクターのスケルトンで、ボーン名と階層構造を設定します。使用しているエンジンやツールが期待するものを選んでください。

    使用可能な値:

    • meshyrig:Meshy独自のスケルトン
    • mixamo:Mixamo
    • ue5_mannequin:Unreal Engine 5 Mannequin
    • max_biped:3ds Max Biped
    • unity_humanoid:Unity Humanoid
    • maya_human_ik:Maya HumanIK
    • blender_rigify_basic_human:Blender Rigify basic human
    • cc5_hd_neutral_base:Character Creator 5 HD neutral base
    • daz_genesis9:DAZ Genesis 9

    それ以外の値を指定すると400が返されます。Bipedリグでのみ機能します。

    meshyrig以外の値を指定した場合、またはinclude_fingersをtrueに設定した場合、ファイルはメートル単位となり、そのスケルトンのボーンを使用します。デフォルトの24ボーンのmeshyrigファイル(センチメートル単位)とは異なります。そのスケルトンでMeshyがリギングできないモデルは、タスクが失敗します。meshyrigとinclude_fingersをfalseにして再試行するか、別の値を指定してください。

    これらのファイル内のライブラリアニメーションクリップは、デフォルトのmeshyrigファイルと同じ名前(Armature|walking_man|baselayerなど)を持ちます。Text to Motionクリップは、どのリグでもretarget_clipという名前になります。FBXファイルにはエンドボーンが含まれます。headfrontなど一部のエンドボーンは、元の名前のまま保持されます。

    このリグから作成されたAnimationタスクは、同じスケルトンを使用します。

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

    キャラクターの手に指のボーンを追加するかどうかです。Bipedリグでのみ機能します。meshyrigの場合、指のボーンはLeftHandThumb1のようなMixamoの名前を使用します。

    trueを指定すると、次のリクエストはエラーを返し、Meshyはこれらに対して課金しません。

    • Quadrupedリグ、texture_image_url、またはクアッドtopologyのモデルを持つinput_task_idを指定すると400が返されます。
    • Meshyが指のボーンなしでしかリギングできないモデルの場合、422が返されます。
    • Meshyがキャラクターの手を指付きでリギングできない場合、タスクは失敗します。再試行するか、include_fingersをfalseに設定してください。

    Meshyは自動的に指を検出し、指がはっきりと分かれている手で最も効果を発揮します。ミトンや手袋、様式化された手のように1つの形状としてモデリングされた手では、リグに含まれる指のボーンが少なくなり、手全体を1つの部品としてアニメーションさせることがあります。それ以外の部分のスケルトンはどちらの場合も同じです。スケルトンには、例えば髪や衣服用の追加ボーンが含まれる場合もあります。指のボーンによってクレジットのコストが変わることはありません。

返り値

レスポンスのresultフィールドには、新しく作成されたRiggingタスクのIDが格納されます。

失敗モード

  • Name
    400 - Bad Request
    Description

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

    • パラメータが不足:model_urlとinput_task_idのどちらも送信されませんでした。
    • 無効なモデル形式:model_urlファイルがサポートされていない拡張子です。サポートされているのは.glbのみです。
    • 到達できないURL:Meshyがmodel_urlファイルをダウンロードできません。
    • モデルファイルが大きすぎる:model_urlファイルが、httpまたはhttpsのURLの場合は400MBを超えているか、Data URIの場合は100MBを超えています。
    • 面の数が多すぎる:model_urlファイルが100MBを超えており、面の数が10,000,000を超えています。面の数を減らしてから、再度ファイルを送信してください。
    • 読み取れないモデルファイル:model_urlファイルが100MBを超えており、Meshyがそのヘッダーを読み取れません。例えば、Draco圧縮されたGLBである場合です。
    • モデルヘッダーが複雑すぎる:model_urlファイルが100MBを超えており、そのヘッダーに含まれるメッシュ、ノード、またはレコードが多すぎてチェックできません。ファイル内のオブジェクト数を減らしてから、再度送信してください。
    • 画像が大きすぎる:texture_image_urlの画像が20MBを超えています。
    • 無効なテクスチャ形式:texture_image_urlの画像がPNGファイルではありません。
    • 無効な身長:height_metersが負の値です。
    • 無効なスケルトンテンプレート:skeleton_templateが使用可能な値のいずれでもないか、Quadrupedリグと一緒に送信されました。
    • 指のボーンがサポートされていない:include_fingersがtrueで、Quadrupedリグ、texture_image_url、またはクアッドtopologyのモデルを持つinput_task_idと一緒に送信されました。
    • 無効な入力タスク:input_task_idが有効なAPIタスクを参照していません。
    • 入力タスクが準備できていない:input_task_idのタスクがまだSUCCEEDEDに到達していません。タスクが成功するまで待ってから再試行してください。
    • 面の数が上限を超えている:入力モデルの三角形数が380,000を超えています(クアッドは2としてカウント)。モデルをリギングする前に、Remesh APIをtarget_polycountを300000以下、またはtopology: quadの場合は150000以下にして実行してください。

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

  • 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

    Meshyがinput_task_idタスクのファイルを見つけられません。次のいずれかに該当します。

    • expires_atの経過後、Meshyがタスクのファイルを削除しました。タスクを再作成してから、そのタスクのIDを送信してください。
    • タスクに、リギングに必要なファイル(プレビュー画像など)がありません。例えばConvertタスクの場合です。元になったタスクをリギングするか、モデルをmodel_urlとして送信してください。
  • Name
    422 - Unprocessable Entity
    Description

    例えば:

    • 姿勢推定に失敗:モデルが有効な人型キャラクターではない可能性があります。人型キャラクターのモデルを送信してください。model_urlの場合は、キャラクターが+Z軸を向いているかも確認してください。
    • スケルトンテンプレートが利用不可:Meshyはこのモデルをmeshyrigスケルトンでしかリギングできません。skeleton_templateを指定しないか、meshyrigに設定してください。Meshyはこのリクエストに課金しません。
    • 指のボーンが利用不可:Meshyはこのモデルを、指のボーンなしのmeshyrigでしかリギングできません。include_fingersとskeleton_templateを指定しないでください。Meshyはこのリクエストに課金しません。
  • Name
    429 - Too Many Requests
    Description

    レート制限を超えました。しばらく待ってから再試行してください。レート制限を参照してください。

  • Name
    503 - Service Unavailable
    Description

    Meshyはモデルの姿勢の解析を完了できませんでした。リクエストを再試行してください。


四足動物をリギングする

四足動物をリギングするには、animation_type に quadruped を設定して送信します。

四足動物のrigは、二足動物のrigと次の点で異なります:

  • basic_animations には、その動物の歩行アニメーションと走行アニメーションが含まれます。Meshyがそのいずれかを作成できない場合、該当するURLは空文字列になりますが、タスク自体は成功します。walking_armature_glb_url と running_armature_glb_url は、アニメーションを含まないrigのスケルトンです。
  • height_meters のデフォルトは 1.7 ではありません。リギングタスクの作成を参照してください。
  • skeleton_template を送信する、または include_fingers に true を設定すると、400 が返されます。
  • Meshyがモデルを四足動物としてリギングできない場合、タスクは失敗します。

四足動物のrigの料金は、二足動物のrigと同じです。料金を参照してください。

リギングした動物にアニメーションを適用するには、rig_type が quadruped であるライブラリアニメーションを、action_id または action_ids として適用します。アニメーションを参照してください。

Request

POST
/openapi/v1/rigging
# Rig a four-legged animal
curl https://api.meshy.ai/openapi/v1/rigging \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "YOUR_MODEL_URL_OR_DATA_URI",
    "animation_type": "quadruped"
  }'

GET/openapi/v1/rigging/:id

Rigging タスクを取得する

IDを指定してRiggingタスクを返します。

Request

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
curl https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
    "rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
      "walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
      "walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
      "running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
      "running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
      "running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
    }
  }
}

パラメータ

  • Name
    id
    Type
    path
    Description

    作成時のレスポンスで返されたタスクID。

戻り値

Riggingタスクオブジェクト。


DELETE/openapi/v1/rigging/:id

リギングタスクを削除する

リギングタスクを、そのモデルやデータも含めて完全に削除します。削除を取り消すことはできません。

Request

DELETE
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
  -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/rigging

リギングタスクの一覧取得

あなたのリギングタスクの一覧を、新しい順にページネーション形式で返します。一覧をページ送りするには、page_num と page_size を使用してください。

APIで作成したタスクはAPI内にとどまり、ウェブアプリのMy Assetsには表示されません。IDが分からなくなったタスクを見つけるには、このエンドポイントを使用してください。

Request

GET
/openapi/v1/rigging
curl "https://api.meshy.ai/openapi/v1/rigging?page_num=1&page_size=20" \
-H "Authorization: Bearer ${YOUR_API_KEY}"

GET/openapi/v1/rigging/:id/stream

リギングタスクをストリームする

リギングタスクの更新をServer-Sent Events(SSE)としてストリーミングします。

Request

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/stream
curl -N https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/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.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: { // Example of a SUCCEEDED task event, with the same fields as the Rigging task object
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/.../Character_output.fbx?...",
    "rigged_character_glb_url": "https://assets.meshy.ai/.../Character_output.glb?...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.glb?...",
      "walking_fbx_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.fbx?...",
      "walking_armature_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin_armature.glb?...",
      "running_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.glb?...",
      "running_fbx_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.fbx?...",
      "running_armature_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin_armature.glb?..."
    }
  }
}

パラメータ

  • Name
    id
    Type
    path
    Description

    作成レスポンスに含まれるタスクID。

戻り値

リギングタスクオブジェクトのストリームをServer-Sent Eventsとして返します。

各イベントには、Get endpointが返すものと同じ形式の、タスクオブジェクト全体が含まれます。タスクがPENDINGまたはIN_PROGRESSの間は、その結果フィールドにはまだ値がありません。


Rigging タスクオブジェクト

Rigging タスクオブジェクトは、1体のキャラクターのリギングを表します。タスクが成功した際には、ステータス、progress、および出力ファイルを保持します。

プロパティ

Example Rigging Task Object

{
  "id": "018b314a-a1b5-716d-c222-2f1776f7f579",
  "type": "rig",
  "status": "SUCCEEDED",
  "created_at": 1747032400453,
  "progress": 100,
  "started_at": 1747032401314,
  "finished_at": 1747032418417,
  "expires_at": 1747291618417,
  "task_error": null,
  "consumed_credits": 5,
  "result": {
    "rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
    "rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
    "basic_animations": {
      "walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
      "walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
      "walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
      "running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
      "running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
      "running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
    }
  }
}
  • Name
    id
    Type
    string
    Description

    タスクID。不透明な文字列として扱い、そのフォーマットに依存しないでください。

  • Name
    type
    Type
    string
    Description

    タスクタイプ。常に rig です。

  • Name
    status
    Type
    string
    Description

    タスクのステータス。PENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELED のいずれかです。

  • Name
    progress
    Type
    integer
    Description

    タスクの完了度をパーセンテージで示します。タスクが開始するまでは 0、成功すると 100 になります。

  • 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ミリ秒)。この時刻を過ぎると、Meshy はファイルを削除することがあります。

  • Name
    task_error
    Type
    object
    Description

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

  • Name
    consumed_credits
    Type
    integer
    Description

    タスクが使用したクレジット数。ステータスが PENDING、IN_PROGRESS、SUCCEEDED の場合に存在します。FAILED タスクでは 0 です。これは、タスクが失敗した場合に Meshy がクレジットを返金するためです。

  • Name
    result
    Type
    object
    Description

    出力ファイルのURL。タスクが成功するまでは、各URLは空文字列であり、basic_animations は null です。

    • Name
      rigged_character_fbx_url
      Type
      string
      Description

      FBXファイルとしてのリギング済みキャラクターのダウンロードURL。

    • Name
      rigged_character_glb_url
      Type
      string
      Description

      GLBファイルとしてのリギング済みキャラクターのダウンロードURL。

    • Name
      basic_animations
      Type
      object (optional)
      Description

      デフォルトの歩行および走行アニメーションのダウンロードURL。

      • Name
        walking_glb_url
        Type
        string
        Description
        スキン付きの歩行アニメーション(GLBファイル)。
      • Name
        walking_fbx_url
        Type
        string
        Description
        スキン付きの歩行アニメーション(FBXファイル)。
      • Name
        walking_armature_glb_url
        Type
        string
        Description
        歩行アニメーションのアーマチュア(GLBファイル)。
      • Name
        running_glb_url
        Type
        string
        Description
        スキン付きの走行アニメーション(GLBファイル)。
      • Name
        running_fbx_url
        Type
        string
        Description
        スキン付きの走行アニメーション(FBXファイル)。
      • Name
        running_armature_glb_url
        Type
        string
        Description
        走行アニメーションのアーマチュア(GLBファイル)。
  • Name
    preceding_tasks
    Type
    integer
    Description

    キュー内でこのタスクより前にあるタスクの数。この値はタスクが PENDING の間のみ意味を持ちます。値が 0 の場合、このフィールドは省略されます。