Retexture API

既存の3Dモデルに対して、テキストのpromptや参照画像から新しいテクスチャを生成します。モデルは別のMeshyタスクから取得することも、モデルファイルから取得することもできます。

POST/openapi/v1/retexture

Retexture タスクを作成する

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

Request

POST

/openapi/v1/retexture

# Retexture with text prompt
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "enable_original_uv": true,
    "enable_pbr": true
  }'

# Retexture with image style and PBR
curl https://api.meshy.ai/openapi/v1/retexture \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "model_url": "https://cdn.meshy.ai/model/example_model_2.glb",
    "image_style_url": "<your publicly accessible image url or base64-encoded data URI>",
    "ai_model": "latest",
    "enable_pbr": true,
    "enable_original_uv": true
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

パラメータ

Name
input_task_id
Type
string
必須
Description
model_url を送信しない場合は必須です。テクスチャ付けの対象となる3Dモデルを生成したタスクのID。例えば、Text to 3D、Image to 3D、Remesh、Retextureのいずれかのタスクです。そのタスクはAPIで作成し、ステータスが SUCCEEDED である必要があります。Meshyはそのタスクの GLB にテクスチャを付けます。

Name
model_url
Type
string
必須
Description
input_task_id を送信しない場合は必須です。テクスチャ付けの対象となるモデルを、公開URLまたはデータURIで指定します。両方を送信した場合、Meshyは input_task_id を使用します。
モデルは、http または https のURLからの場合は最大400MB、データURIの場合は最大100MBの GLB、glTF、OBJ、FBX、STL のいずれかのファイルである必要があります。データURIの場合は、MIMEタイプ application/octet-stream を使用してください。例: data:application/octet-stream;base64,<your base64-encoded model data>。
100MBを超えるファイルは、さらに以下のルールに従う必要があります。
- GLB、glTF、FBX、OBJ ファイルは、面数が最大10,000,000面までです。Meshyは面を三角形として数えるため、四角形は2面としてカウントされ、複数回描画されるメッシュはコピーごとに1回としてカウントされます。
- FBXファイルは、バイナリ形式のFBX 7.1以降である必要があります。
- GLBまたはglTFファイルは、Draco圧縮を使用していないこと。

以下の3種類のスタイル入力のいずれか1つを送信してください。

Name
text_style_prompt
Type
string
必須
Description
image_style_url または multiview_image_urls を送信しない場合は必須です。希望するテクスチャを説明するテキストで、最大800文字です。これを超える長さのテキストは 400 を返します。

Name
image_style_url
Type
string
必須
Description
text_style_prompt または multiview_image_urls を送信しない場合は必須です。テクスチャが従うスタイルを示す2D画像で、公開URLまたはデータURI（data:image/jpeg;base64,<your base64-encoded image data>）として指定します。text_style_prompt と image_style_url の両方を送信した場合、Meshyは image_style_url を使用します。
画像は、最大20MBの .jpg、.jpeg、.png、または .webp ファイルである必要があります。
画像内のオブジェクトの形状がモデルと大きく異なる場合、テクスチャがうまく適合しないことがあります。

Name
multiview_image_urls
Type
string[]
必須
Description
text_style_prompt または image_style_url を送信しない場合は必須です。同一オブジェクトを異なる視点から撮影した1枚から4枚までの画像です。最初の画像がメイン（正面）ビューです。それ以外のビュー（左、背面、右）の順序は問いません。空の配列、または5枚以上の画像を送信すると 400 が返されます。
各画像は image_style_url と同じ形式・サイズのルールに従い、1枚あたり最大20MBです。multiview_image_urls は text_style_prompt や image_style_url と組み合わせることはできません。
multiview_image_urls には、明示的な "ai_model": "meshy-7" の指定が必要です。デフォルトの latest を含め、それ以外の ai_model を指定すると 400 が返されます。

Name
ai_model
Type
string
デフォルト latest
Description
テクスチャを生成するAIモデルです。
利用可能な値:
- meshy-6-lite
- meshy-6
- meshy-7
- latest: Meshy 7
Name
enable_original_uv
Type
boolean
デフォルト false
Description
新しいUVを生成する代わりに、モデルのUVレイアウトを維持するかどうかです。
- Meshyが生成したモデル（input_task_id から、またはMeshyの出力を指す model_url から得られたもの）の場合は、true にして最適化されたUVレイアウトを再利用します。
- 他所からアップロードしたモデルの場合は、既に良好なUVを維持したいときに true にします。false のままにしておくと、Meshyが新しいUVを生成します。これは、適切なUVマッピングを持たないモデルに適しています。
Name
enable_pbr
Type
boolean
デフォルト false
Description
ベースカラーに加えて、PBRマップ（メタリック、ラフネス、ノーマル）も生成するかどうかです。meshy-6 を使用する場合、texture_resolution が 8k のときを除き、Meshyはエミッションマップも生成します。meshy-6-lite、meshy-7、latest ではエミッションマップは生成されません。
Name
texture_resolution
Type
string
デフォルト 2k
Description
ベースカラーテクスチャのサイズです。解像度が高いほど、より多くの表面の詳細が捉えられます。
利用可能な値:
- 2k: 2048 × 2048ピクセル
- 4k: 4096 × 4096ピクセル
- 8k: 8192 × 8192ピクセル
4k と 8k には、ai_model として meshy-6、meshy-7、latest のいずれかが必要です。meshy-6-lite の場合は 400 が返されます。8k では、Meshyはエミッションマップを生成しません。
Name
hd_texture
Type
boolean
⚠ 非推奨
デフォルト false
Description
代わりに texture_resolution を使用してください。true は texture_resolution: "4k" と同じ意味です。両方を送信した場合、Meshyは texture_resolution を使用します。
Name
remove_lighting
Type
boolean
デフォルト true
Description
ベースカラーテクスチャからハイライトと影を除去するかどうかです。結果は、ご自身の照明環境下でより良く機能します。
Meshyは meshy-6 を使用し、texture_resolution が 2k または 4k の場合にのみこれを適用します。meshy-7 または latest の場合、あるいは 8k の場合、Meshyはこの値を受け取っても無視します。meshy-6-lite の場合、どの値を送信しても 400 が返されます。
Name
target_formats
Type
string[]
Description
生成するファイル形式です。Meshyはリストに挙げた形式のみを生成するため、タスクを短縮できます。指定しない場合、Meshyは 3mf を除くすべての形式を生成します。
利用可能な値:
- glb
- obj
- fbx
- stl
- usdz
- 3mf
Name
alpha_thumbnail
Type
boolean
デフォルト false
Description
透明背景（RGBA）のプレビューも併せてレンダリングするかどうかです。タスクを取得する際、alpha_thumbnail_url として返されます。thumbnail_url は変化しません。

戻り値

レスポンスの result フィールドには、新しいRetextureタスクのIDが格納されます。

失敗モード

Name
400 - Bad Request
Description
リクエストを実行できません。エラーメッセージには、検出された問題が示されます。例:
- パラメータの欠落: model_url と input_task_id のどちらも送信されていません。
- スタイルの欠落: text_style_prompt、image_style_url、multiview_image_urls のいずれも送信されていません。
- スタイル入力の競合: multiview_image_urls が text_style_prompt または image_style_url と共に送信されました。
- マルチビューでサポートされていないモデル: multiview_image_urls が、明示的な "ai_model": "meshy-7" の指定なしに送信されました。
- 無効な入力タスク: input_task_id が、サポート対象タイプの成功済みタスクではありません。
- 無効なモデル形式: model_url のファイルが、サポートされていない拡張子を持っています。
- 到達不能なURL: Meshyが model_url のファイル、image_style_url の画像、または multiview_image_urls の画像をダウンロードできません。
- モデルファイルが大きすぎる: model_url のファイルが、http または https のURLからの場合400MBを、データURIの場合100MBを超えています。
- 面数が多すぎる: model_url のファイルが100MBを超えており、面数が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を超えており、そのヘッダーに含まれるメッシュ、ノード、レコードの数が多すぎてチェックできません。ファイル内のオブジェクト数を減らしてから、再送信してください。
- 画像が大きすぎる: image_style_url の画像、または multiview_image_urls の画像が20MBを超えています。
リクエストを修正してから、再送信してください。エラーを参照してください。
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を確認してから、リクエストを再送信してください。
Name
429 - Too Many Requests
Description
レート制限を超えました。しばらく待ってから、再試行してください。レート制限を参照してください。

GET/openapi/v1/retexture/:id

Retexture タスクを取得する

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

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "texture_image_url": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

パラメータ

Name
id
Type
path
Description
作成時のレスポンスから取得したタスクID。

返り値

Retexture タスクオブジェクト。

DELETE/openapi/v1/retexture/:id

リテクスチャタスクを削除する

リテクスチャタスクをモデルやデータを含めて完全に削除します。削除を元に戻すことはできません。

Request

DELETE

/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/retexture/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/retexture

リテクスチャタスク一覧の取得

お客様のリテクスチャタスクの一覧を返します。

Request

GET

/openapi/v1/retexture

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

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "retexture",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "expires_at": 1692771679037,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
        "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
        "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
        "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 10
  }
]

パラメータ

Name
page_num
Type
integer
デフォルト 1
Description
返すページ番号。
Name
page_size
Type
integer
デフォルト 10
Description
1ページあたりのタスク数。最大100まで。
Name
sort_by
Type
string
Description
並び順。
利用可能な値:
- +created_at: 古い順
- -created_at: 新しい順

返り値

リテクスチャタスクオブジェクトのページネーションされたリストです。

GET/openapi/v1/retexture/:id/stream

リテクスチャタスクをストリームする

リテクスチャタスクの更新をサーバー送信イベント（SSE）としてストリーミングします。

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/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": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  },
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

パラメータ

Name
id
Type
path
Description
作成レスポンスからのタスクIDです。

返り値

リテクスチャタスクオブジェクトのストリームをサーバー送信イベントとして返します。

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

Retexture タスクオブジェクト

Retexture タスクオブジェクトは、1つの3Dモデルのリテクスチャを記述します。ステータス、progress、そしてタスクが成功した際のモデルファイルとテクスチャファイルを保持します。

プロパティ

Example Retexture Task Model

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***"
  },
  "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style",
  "image_style_url": "https://assets.meshy.ai/***/image/example_image.jpg?Expires=***",
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

Name
id
Type
string
Description
タスクID。不透明な文字列として扱い、その形式に依存しないでください。
Name
type
Type
string
Description
タスクタイプ。常に retexture です。
Name
model_urls
Type
object
Description
テクスチャ適用済みの3DモデルのダウンロードURLで、ファイル形式ごとに用意されています。
- Name
  glb
  Type
  string
  Description
  GLBファイル。
- Name
  fbx
  Type
  string
  Description
  FBXファイル。
- Name
  obj
  Type
  string
  Description
  OBJファイル。
- Name
  usdz
  Type
  string
  Description
  USDZファイル。
- Name
  mtl
  Type
  string
  Description
  MTLファイル。モデルにテクスチャがある場合、MeshyはOBJファイルと一緒にこれを返します。
- Name
  stl
  Type
  string
  Description
  STLファイル。
- Name
  3mf
  Type
  string
  Description
  3MFファイル。target_formats に 3mf が含まれている場合のみ存在します。
Name
text_style_prompt
Type
string
Description
タスクの作成時に指定したテキストプロンプト。
Name
image_style_url
Type
string
Description
タスクの作成時に指定したスタイル画像。
Name
multiview_image_urls
Type
string[]
Description
タスクの作成時に使用したマルチビュー参照画像のダウンロードURL。multiview_image_urls を指定してタスクを作成した場合のみ存在します。
Name
thumbnail_url
Type
string
Description
モデルのサムネイル画像のダウンロードURL。
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url の背景を透過（RGBA）にしたバージョンのダウンロードURL。alpha_thumbnail: true を指定してタスクを作成し、Meshyが透過プレビューをレンダリングした場合のみ存在します。
Name
progress
Type
integer
Description
タスクの進行状況をパーセンテージで示します。タスクが開始するまでは 0、成功すると 100 になります。
Name
started_at
Type
timestamp
Description
タスクが開始した時刻（Unixミリ秒）。タスクが開始するまでは 0 です。
Name
created_at
Type
timestamp
Description
タスクが作成された時刻（Unixミリ秒）。
Name
expires_at
Type
timestamp
Description
タスクの結果が期限切れになる時刻（Unixミリ秒）。
Name
finished_at
Type
timestamp
Description
タスクが終了した時刻（Unixミリ秒）。タスクが終了するまでは 0 です。
Name
status
Type
string
Description
タスクのステータス。PENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELED のいずれかです。
Name
texture_urls
Type
array
Description
生成されたテクスチャのダウンロードURLで、オブジェクトの配列として提供されます。配列には通常1つのオブジェクトが含まれます。各オブジェクトには以下のフィールドがあります。
- Name
  base_color
  Type
  string
  Description
  ベースカラーマップのダウンロードURL。
- Name
  metallic
  Type
  string
  Description
  メタリックマップのダウンロードURL。enable_pbr: false を指定してタスクを作成した場合、Meshyはこのフィールドを省略します。
- Name
  normal
  Type
  string
  Description
  ノーマルマップのダウンロードURL。enable_pbr: false を指定してタスクを作成した場合、Meshyはこのフィールドを省略します。
- Name
  roughness
  Type
  string
  Description
  ラフネスマップのダウンロードURL。enable_pbr: false を指定してタスクを作成した場合、Meshyはこのフィールドを省略します。
- Name
  emission
  Type
  string
  Description
  エミッションマップのダウンロードURL。以下のいずれかを指定してタスクを作成した場合、Meshyはこのフィールドを省略します。
  
  enable_pbr: false
  
  ai_model が meshy-6-lite、meshy-7、または latest
  
  texture_resolution: 8k
Name
preceding_tasks
Type
integer
Description
キュー内でこのタスクより前にあるタスクの数。タスクが PENDING の間のみ存在します。
Name
task_error
Type
object
Description
タスクが失敗した場合のエラー詳細。エラーを参照してください。
Name
consumed_credits
Type
integer
Description
タスクが使用したクレジット数。ステータスが PENDING、IN_PROGRESS、または SUCCEEDED の場合に存在します。タスクが失敗すると、Meshyはクレジットを返金するため、FAILED タスクでは 0 になります。