Meshy 7.1 API - 画像を詳細な3Dアセットに変換

Meshy 7.1は、細かな表面ジオメトリを備えた3Dアセットを生成するMeshyのAIモデルです。画像リファレンスを、キャラクター、プロップ、クリエイティブ制作向けの詳細な形状に変換します。PoYoは、非同期APIを通じて、タスクステータスとダウンロード可能な結果ファイルを備えた単一画像、マルチ画像、および別個のテキストから3D生成ワークフローを提供します。

はい。PoYo は meshy-7.1-text-to-3d を、prompt が 1〜600 文字の形式で提供します。ジオメトリには mode=preview を、テクスチャ付き出力には mode=full を選択してください。これは別個の text 駆動型サービスワークフローです。画像ベースのエンドポイントでは prompt の代わりに image_urls が必要です。

単一画像エンドポイントでは、image_urlsエントリが正確に1つ必要です。マルチ画像エンドポイントでは1〜4枚の画像を受け付けます。同じオブジェクトの明確なビューを使用し、外観とライティングを一貫させてください。画像入力には、公開アクセス可能なHTTP(S) URLまたは対応する画像データURIを使用できます。

いいえ。geometry_resolutionはジオメトリの詳細度を制御するものであり、テクスチャ画像の寸法ではありません。テキストおよび単一画像エンドポイントの標準モデルタイプはstandard、2k、4kを受け付けます。マルチ画像エンドポイントはstandardと2kを受け付けます。Smart Topologyは別個のオプションであり、geometry_resolutionを受け付けません。

テキストおよび単一画像エンドポイントは、target_polycountを100〜15,000の範囲で指定できるmodel_type=smart-topologyをサポートし、デフォルトは4,000です。Standardモードは100〜300,000をサポートし、デフォルトは30,000です。マルチ画像ではstandardの範囲を使用し、model_typeは受け付けません。targetはメッシュ生成の設定であり、正確な出力を保証するものではありません。

オプションのenable_riggingおよびenable_animation設定を利用できます。アニメーションを使用するにはリギングを有効にする必要があります。rigging_height_metersのデフォルト値は1.7です。animation_action_idのデフォルト値は92で、0〜696の整数を受け付けます。本番環境で結果を使用する前に、キャラクターの適性と返却されたファイルを確認してください。

完了したタスクでは、data.files[].file_urlにfile_typeとともにダウンロード可能なファイルが公開されます。ワークフローと有効化されたオプションに応じて、結果にはモデルファイル、サムネイル、テクスチャ、またはリギング済み・アニメーション済みアセットが含まれる場合があります。すべてのタスクですべてのエクスポート形式が含まれると想定せず、実際のレスポンスを確認してください。

送信時に返されるtask_idを保持してください。タスクのステータスがfinishedまたはfailedになるまでポーリングするか、callback_urlを指定してください。処理時間は入力内容と有効化された設定によって異なります。一時的なステータス照会エラーが発生しても、別の生成リクエストを送信する必要はありません。既存のタスクの確認を続けてください。