Creative Lab — ビニールフィギュア API

元となる写真を、大きな頭のビニールコレクティブル3Dフィギュアに変換する処理は、次の2段階で構成されます。prototypeは入力写真からスタイル化されたコンセプト画像を生成し、続くbuildはそのコンセプト画像をテクスチャ付きの3Dモデルに変換します。 この2つの段階はinput_task_idによって関連付けられます。

  • POST /openapi/creative-lab/vinyl-figure/v1/prototype
  • POST /openapi/creative-lab/vinyl-figure/v1/build
POST/openapi/creative-lab/vinyl-figure/v1/prototype

Vinyl Figureプロトタイプタスクを作成する

元の写真から、vinyl figureスタイルのコンセプト画像を1枚生成します。返されたタスクIDは、ビルドエンドポイントに input_task_id として渡すものです。レスポンスの形状については The Vinyl Figure Prototype Task Object を参照してください。

パラメータ

  • Name
    image_url
    Type
    string
    必須
    Description

    Meshyがbig-head vinyl figure風にスタイル変換する元の写真です。現在、.jpg、.jpeg、.png、.webp 形式に対応しています。

    画像を提供する方法は2通りあります。

    • 公開アクセス可能なURL: パブリックインターネットからアクセス可能なURL。
    • Data URI: 画像のbase64エンコードされたdata URI。data URIの例: data:image/jpeg;base64,<your base64-encoded image data>。
  • Name
    name
    Type
    string
    Description

    表示用の任意のタスク名です。最大100文字です。

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

    true に設定すると、プロトタイプ画像は背景が削除された透過RGBA PNGとして返されるため、被写体を任意の背景に合成できます。

戻り値

レスポンスの result プロパティには、新しく作成されたvinyl figureプロトタイプタスクのタスク id が含まれます。タスクが SUCCEEDED に到達するまで Get a Task エンドポイントをポーリングするか、stream を購読し、その後そのIDを build endpoint に input_task_id として渡してください。

失敗モード

  • Name
    400 - Bad Request
    Description

    リクエストが受け付けられませんでした。よくある原因:

    • パラメータの不足: image_url は必須です。
    • 無効な画像形式: 指定された image_url がサポートされている形式（.jpg、.jpeg、.png、.webp）ではありません。
    • 画像サイズが範囲外: 画像が小さすぎるか、最大ファイルサイズを超えているか、最大ピクセル数を超えています。
    • 到達不能なURL: image_url をダウンロードできませんでした（404またはtimeout）。
    • 無効なData URI: base64文字列の形式が不正です。
    • コンテンツがフラグ付けされた: 入力画像がNSFWまたは知的財産moderationによってフラグ付けされました。
  • Name
    401 - Unauthorized
    Description

    認証に失敗しました。APIキーを確認してください。

  • Name
    402 - Payment Required
    Description

    このタスクを実行するためのクレジットが不足しています。

  • Name
    429 - Too Many Requests
    Description

    レート制限を超過しました。

Request

POST
/openapi/creative-lab/vinyl-figure/v1/prototype
# Stage 1: generate a vinyl-figure-style concept image
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<your publicly accessible image url or base64-encoded data URI>"
  }'

Response

{
  "result": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
}
Prototype example
Start with a source photo, then generate the prototype image used by the build stage.
Source photo used as the Creative Lab Vinyl Figure input
Prototype input
Big-head vinyl figure prototype image generated from the source photo
Prototype output
POST/openapi/creative-lab/vinyl-figure/v1/build

ヴィニールフィギュアビルドタスクの作成

成功したプロトタイプタスクから、テクスチャ付きの最終的な3Dヴィニールフィギュアを生成します。ビルドは画像から3Dと同じ画像から3Dへのパイプラインを実行するため、レスポンスオブジェクトの形式と出力URLのリストは完全に一致します。レスポンスの形状については、The Vinyl Figure Build Task Objectを参照してください。

パラメータ

  • Name
    input_task_id
    Type
    string
    必須
    Description

    この同じOpenAPIエンドポイント経由で作成されたプロトタイプタスクのタスクIDです。プロトタイプは同じAPIキーで作成され、SUCCEEDEDに到達しており、候補画像を正確に1枚生成している必要があります。

    webapp経由で作成されたプロトタイプタスクは受け付けられません——ビルドエンドポイントはPOST /openapi/creative-lab/vinyl-figure/v1/prototypeによって生成されたプロトタイプタスクのみを受け付け、それ以外のソースは404で拒否します。

  • Name
    name
    Type
    string
    Description

    表示用のオプションのタスク名です。最大100文字。

戻り値

レスポンスのresultプロパティには、新しく作成されたヴィニールフィギュアビルドタスクのタスクidが含まれます。タスクがSUCCEEDEDに到達するまでGet a Taskエンドポイントをポーリングするか、streamを購読し、その後model_urls.glbからテクスチャ付きのGLBをダウンロードしてください（ダウンストリームのパイプラインでOBJが好まれる場合は、model_urls.objとmodel_urls.mtlからOBJ + MTLのペアをダウンロードできます）。

失敗モード

  • Name
    400 - Bad Request
    Description

    リクエストが受け付けられませんでした。よくある原因：

    • パラメータ不足：input_task_idは必須です。
    • 無効なUUID：input_task_idが有効なUUIDではありません。
    • 親タスクが未成功：参照されたプロトタイプタスクがまだSUCCEEDEDに到達していません。
    • 候補なし：プロトタイプタスクは成功しましたが、候補画像を生成しませんでした。
  • Name
    401 - Unauthorized
    Description

    認証に失敗しました。APIキーを確認してください。

  • Name
    402 - Payment Required
    Description

    このタスクを実行するのに十分なクレジットがありません。

  • Name
    404 - Not Found
    Description

    参照されたプロトタイプタスクが存在しないか、別のユーザーに属しているか、またはwebapp経由で作成されたものです（APIモードのプロトタイプタスクのみがビルドへ連鎖できます）。

  • Name
    429 - Too Many Requests
    Description

    レート制限を超過しました。

Request

POST
/openapi/creative-lab/vinyl-figure/v1/build
# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
  }'

Response

{
  "result": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef"
}
GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

ビニールフィギュアタスクを取得する

有効なタスクidを指定して、プロトタイプまたはビルドタスクを取得します。URLパスは タスクのステージと一致している必要があります。/prototype/:idでビルドタスクを 取得しようとすると404が返され、その逆も同様です。

レスポンスの形式については、ビニールフィギュアプロトタイプタスクオブジェクト およびビニールフィギュアビルドタスクオブジェクトを 参照してください。

パラメータ

  • Name
    id
    Type
    path
    Description

    取得するビニールフィギュアタスクの一意の識別子。

戻り値

レスポンスにはビニールフィギュアタスクオブジェクトが含まれます。形式は リクエストされたステージによって異なります。

Request

GET
/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de
# Prototype
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}
DELETE/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

ビニールフィギュアタスクの削除

ビニールフィギュアタスクをキャンセルします。タスクがまだPENDING状態の場合、作成時に消費されたクレジットは返金されます。すでに IN_PROGRESS状態のタスクは返金なしでキャンセルされます（ワーカーがすでにリソースを消費している可能性があるため）。すでに終了状態 （SUCCEEDED、FAILED、CANCELED）に達しているタスクはキャンセルできません。

URLパスはタスクのステージと一致している必要があります。/prototype/:buildIdに対してDELETEを実行すると 404が返されます。

パスパラメータ

  • Name
    id
    Type
    path
    Description

    キャンセルするビニールフィギュアタスクの一意の識別子。

戻り値

成功時には空のボディとともに204 No Contentを返します。

失敗モード

  • Name
    400 - Bad Request
    Description

    タスクはすでに終了状態にあり、キャンセルできません。

  • Name
    404 - Not Found
    Description

    タスクが存在しない、別のユーザーに属している、またはそのステージがURLパスと一致していません。

Request

DELETE
/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de
curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).
GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id/stream

Stream a Vinyl Figure Task

Server-Sent Events（SSE）を介して、ビニールフィギュアタスクのリアルタイム更新をストリーミングします。URLパスはタスクのステージと一致している必要があります。/prototype/:buildId/stream でストリームを開くと、status_code: 404 を含む単一の event: error ペイロードが送信され、ストリームが閉じられます。

パラメータ

  • Name
    id
    Type
    path
    Description

    ストリーミング対象のビニールフィギュアタスクの一意な識別子です。

戻り値

Vinyl Figure Prototype または Vinyl Figure Build タスクオブジェクトのストリームを Server-Sent Events として返します。各フレームには、そのステージの完全なタスクオブジェクトが含まれます — これはGet エンドポイントが返すものと同じ形式です — そのため、タスクが PENDING または IN_PROGRESS の間は、 出力フィールドはまだ値が設定されておらず（null、[]、または {}）、 finished_at は null になります。

Request

GET
/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream
curl -N https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example (wrong stage or task not found)
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": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}
GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)

Vinyl Figure タスク一覧の取得

単一ステージにおける、あなたのvinyl figureタスクのページネーションされたリストを取得します。 URLパスがステージを選択します — /prototype はプロトタイプタスクを返し、 /build はビルドタスクを返します。もう一方のステージのタスクは、 いずれのレスポンスにも含まれません。

パスパラメータ

  • Name
    stage
    Type
    path
    必須
    Description

    prototype または build のいずれかです。このコレクションは、 URLに一致するステージのタスクのみを返します — /prototype を取得しても ビルドタスクが返されることはなく、逆も同様です。

クエリパラメータ

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

    ページネーション用のページ番号です。

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

    ページサイズの上限です。許可される最大値は 100 件です。

  • Name
    sort_by
    Type
    string
    デフォルト -created_at
    Description

    並び替えに使用するフィールドです。利用可能な値は次のとおりです。

    • +created_at: 作成時刻の昇順で並び替えます。
    • -created_at: 作成時刻の降順で並び替えます。

レスポンス

ステージごとのタスクオブジェクトのページネーションされたリストを返します。 /prototype をリストする場合は Vinyl Figureプロトタイプタスクオブジェクト、 /build をリストする場合は Vinyl Figureビルドタスクオブジェクト のいずれかです。

Request

GET
/openapi/creative-lab/vinyl-figure/v1/prototype
# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response (List Prototype Tasks)

[
  {
    "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
    "type": "creative-lab-vinyl-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1752969600000,
    "started_at": 1752969604000,
    "finished_at": 1752969630000,
    "expires_at": 1753228830000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

ビニールフィギュアプロトタイプタスクオブジェクト

ビニールフィギュアプロトタイプタスクオブジェクトは、元となる写真からビニールフィギュア風のコンセプト画像を生成するために、Meshy が追跡する作業単位です。 このステージの出力は、input_task_id を介して ビルドステージに連結されます。

Properties

  • Name
    id
    Type
    string
    Description

    タスクの一意の識別子です。実装の詳細としてタスク ID には k-sortable な UUID を使用していますが、id のフォーマットについて何らかの前提を置くことは避けてください。

  • Name
    type
    Type
    string
    Description

    タスクのタイプです。値は creative-lab-vinyl-figure-prototype です。

  • Name
    name
    Type
    string
    Description

    タスク作成時に指定されたタスク名です。名前が指定されなかった場合は空文字列になります。

  • Name
    status
    Type
    string
    Description

    タスクのステータスです。可能な値は PENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELED のいずれかです。

  • Name
    progress
    Type
    integer
    Description

    タスクの progress です。タスクがまだ開始されていない場合、このプロパティは 0 になります。タスクが成功すると 100 になります。

  • Name
    created_at
    Type
    timestamp
    Description

    タスクが作成された時刻を示すタイムスタンプ（ミリ秒単位）です。

    タイムスタンプは、RFC 3339 標準に従い、1970年1月1日 UTC からの経過ミリ秒数を表します。 例えば、2023年9月1日金曜日 12:00:00 PM GMT は 1693569600000 と表されます。これは Meshy API におけるすべてのタイムスタンプに当てはまります。

  • Name
    started_at
    Type
    timestamp
    Description

    タスクが開始された時刻を示すタイムスタンプ（ミリ秒単位）です。タスクがまだ開始されていない場合、このプロパティは 0 になります。

  • Name
    finished_at
    Type
    timestamp
    Description

    タスクが完了した時刻を示すタイムスタンプ（ミリ秒単位）です。タスクがまだ完了していない場合、このプロパティは 0 になります。

  • Name
    expires_at
    Type
    timestamp
    Description

    タスク結果が失効する時刻を示すタイムスタンプ（ミリ秒単位）です。

  • Name
    preceding_tasks
    Type
    integer
    Description

    先行するタスクの数です。

    このフィールドの値は、タスクのステータスが PENDING の場合にのみ意味を持ちます。

  • Name
    task_error
    Type
    object
    Description

    失敗したタスクのエラー詳細です。task_error オブジェクトの完全なリファレンスについては、エラーを参照してください。

  • Name
    consumed_credits
    Type
    integer
    Description

    このタスクによって消費されたクレジットの数です。タスクのステータスが PENDING、IN_PROGRESS、または SUCCEEDED の場合に存在します。FAILED タスクの場合は 0 を返します（失敗時にはクレジットが返金されます）。

  • Name
    image_urls
    Type
    array of strings
    Description

    このプロトタイプタスクによって生成されたコンセプト画像候補のダウンロード可能な URL です。現在、API は常にちょうど1つの候補を返しますが、将来的に破壊的変更を伴わずに複数の候補を提供できるよう、このフィールドは配列になっています。

Example Vinyl Figure Prototype Task Object

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

The Vinyl Figure Build Task Object

Vinyl Figure Build Task オブジェクトは、成功したプロトタイプタスクからテクスチャ付きの3D ビニールフィギュアを生成するために Meshy が管理する作業単位です。 このタスクは、画像から3D で使用されているのと同じ image-to-3D パイプラインで実行されるため、出力フィールドはそのエンドポイントのタスクオブジェクトと同じ構造になります。

プロパティ

  • Name
    id
    Type
    string
    Description

    タスクの一意な識別子。

  • Name
    type
    Type
    string
    Description

    タスクの種類。値は creative-lab-vinyl-figure-build です。

  • Name
    name
    Type
    string
    Description

    タスク作成時に指定されたタスク名。名前が指定されなかった場合は空文字列になります。

  • Name
    status
    Type
    string
    Description

    タスクのステータス。PENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELED のいずれかの値を取ります。

  • Name
    progress
    Type
    integer
    Description

    タスクの progress。タスクがまだ開始されていない場合、このプロパティは 0 になります。タスクが成功すると 100 になります。

  • Name
    created_at
    Type
    timestamp
    Description

    タスクが作成された時刻のタイムスタンプ（ミリ秒単位）。

  • Name
    started_at
    Type
    timestamp
    Description

    タスクが開始された時刻のタイムスタンプ（ミリ秒単位）。

  • Name
    finished_at
    Type
    timestamp
    Description

    タスクが終了した時刻のタイムスタンプ（ミリ秒単位）。

  • Name
    expires_at
    Type
    timestamp
    Description

    タスク結果が失効する時刻のタイムスタンプ（ミリ秒単位）。

  • Name
    preceding_tasks
    Type
    integer
    Description

    先行するタスクの数。ステータスが PENDING の場合にのみ意味を持ちます。

  • Name
    task_error
    Type
    object
    Description

    失敗したタスクのエラー詳細。task_error オブジェクトの完全なリファレンスについては、エラー を参照してください。

  • Name
    consumed_credits
    Type
    integer
    Description

    このタスクによって消費されたクレジット数。FAILED タスクの場合は 0 を返します（失敗時はクレジットが返還されます）。

  • Name
    prompt
    Type
    string
    Description

    vinyl figure build では常に空です。画像から3D で使用される共通の V2ImageTo3DTaskResponse 形式とのエンドポイント間互換性のために存在します。

  • Name
    negative_prompt
    Type
    string
    Description

    vinyl figure build では常に空です。エンドポイント間互換性のために存在します。

  • Name
    texture_prompt
    Type
    string
    Description

    vinyl figure build では常に空です。エンドポイント間互換性のために存在します。

  • Name
    texture_image_url
    Type
    string
    Description

    vinyl figure build では常に空です。エンドポイント間互換性のために存在します。

  • Name
    model_urls
    Type
    object
    Description

    生成された3Dモデルのダウンロード可能な URL。vinyl figure build は、テクスチャ付きの GLB に加えて、Wavefront OBJ を好むパイプライン向けに OBJ + MTL のペアを出力します。このフィールドの形状は Image to 3D の model_urls オブジェクトと一致しているため、将来フォーマットが追加されても破壊的変更なしに組み込むことができます。

    • Name
      glb
      Type
      string
      Description

      テクスチャ付き GLB ファイルへのダウンロード可能な URL。

    • Name
      obj
      Type
      string
      Description

      Wavefront OBJ ファイル（ジオメトリ + UV）へのダウンロード可能な URL。

    • Name
      mtl
      Type
      string
      Description

      OBJ に付随する MTL マテリアルファイルへのダウンロード可能な URL。obj と texture_urls[0].base_color のエントリと組み合わせて使用します。

  • Name
    thumbnail_url
    Type
    string
    Description

    モデルファイルのサムネイル画像へのダウンロード可能な URL。

  • Name
    texture_urls
    Type
    array
    Description

    このタスクによって生成されたテクスチャ URL オブジェクトの配列。現在はベースカラーマップを持つ単一のオブジェクトのみが含まれます。

    • Name
      base_color
      Type
      string
      Description

      ベースカラーマップ画像へのダウンロード可能な URL。

Example Vinyl Figure Build Task Object

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}