コンテンツへスキップ

Meshy 6 · Text to 3D

統合

モデルID meshy/v6/text-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v6/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

このリクエスト: $0.80 800 APIクレジット · ≈ ₽86.06 このページで実行

APIキーを取得
Meshy テキストから3D #text-to-3d

プレビューまたはテクスチャ付きモード、任意のPBR、リギング、アニメーションに対応したテキストから3Dメッシュ生成

Meshy · 3D

最初の結果がここに表示されます

以下でリクエストを作成し、APIキーで実行してください。出力はストレージにコピーされ、永久保存または無料で7日保存されます。

リクエストを作成

コントロールはモデルスキーマから生成されます。値を変更するとコードと価格が更新されます。

•必須 88 / 600

3Dモデルとして表現するオブジェクトの説明。600文字以内です。

詳細設定 texture_prompt · texture_image_url · mode · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_rigging · enable_animation · enable_safety_checker
0 / 600

'full' モードで追加のテキストプロンプトを使ってテクスチャリングを指示します。他のモードでは使用されません。

ファイルをドロップ、または

テクスチャ生成用の2D参照画像。'full' モードでのみ適用されます。

mode デフォルト full

生成モード。'preview' はテクスチャなしのジオメトリを出力し、'full' はpreviewとrefineを組み合わせてテクスチャ付きモデルを出力します。

model_type デフォルト standard

3Dメッシュモード。よりクリーンなポリゴンに最適化された低ポリゴン結果には 'lowpoly' を選択します。このモードではMeshyはtopology、target_polycount、should_remeshを無視します。通常の高精細な結果には 'standard'、ジオメトリ(preview)段階でMeshy-T2を使用して最初から個別に生成されたクリーンなパーツを得るには 'smart-topology' を選択します。

topology デフォルト triangle

幾何学的なディテールを重視するTriangleと、表面の滑らかさを重視するQuadから選択するモデルのトポロジー。

symmetry_mode デフォルト auto

モデル生成時に適用する対称性設定。

pose_mode デフォルト

空文字列にすると生成モデルのポーズを指定しません。'a-pose' でAポーズ、't-pose' でTポーズを指定できます。

デフォルト 30000

ポリゴン数の目標。model_type が 'smart-topology' の場合は15,000が上限です。このモードで目標を省略すると、Meshyの低いデフォルト値4,000が選択されます。

デフォルト 1.7

enable_rigging が true の場合に、メートル単位の推定キャラクター身長を指定します。それ以外では効果がありません。

デフォルト 92

MeshyライブラリのアニメーションプリセットID。利用可能なアクションは https://docs.meshy.ai/en/api/animation-library に一覧されています。検証と使用は enable_animation が true の場合にのみ行われます。[0, 696] の範囲外の値は422で拒否され、"Idle" は `0` に対応します。

変更していないプロンプトとともにこのシードを再利用すると、通常は以前の結果を再現できます。

POST /run/meshy/v6/text-to-3d?wait=20 見積もり → $0.80
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v6/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

このリクエストを実行

キーはこのブラウザ内に保持されます。Doitong APIにのみ送信され、「記憶する」にチェックを入れた場合のみlocalStorageに保存されます。 APIキーを取得

Meshy 6 · Text to 3Dについて

最大600文字のテキスト `prompt` から3Dモデルを作成します。`mode` でテクスチャなしのジオメトリ(`preview`)またはテクスチャ付き結果(`full`)を選択します。`model_type` はstandard、lowpoly、smart-topology、`target_polycount` は100〜300000(smart topologyは15000まで)です。PBRマップ、ポーズ、ヒューマノイドのリギング、アニメーションプリセットも追加できます。

パラメータ

名前型 デフォルト許可される値 説明
prompt必須
型string
≤ 600文字
3Dモデルとして表現するオブジェクトの説明。600文字以内です。
mode任意
型enum
デフォルトfull
previewfull
生成モード。'preview' はテクスチャなしのジオメトリを出力し、'full' はpreviewとrefineを組み合わせてテクスチャ付きモデルを出力します。
seed任意
型integer | null
変更していないプロンプトとともにこのシードを再利用すると、通常は以前の結果を再現できます。
model_type任意
型enum
デフォルトstandard
standardlowpolysmart-topology
3Dメッシュモード。よりクリーンなポリゴンに最適化された低ポリゴン結果には 'lowpoly' を選択します。このモードではMeshyはtopology、target_polycount、should_remeshを無視します。通常の高精細な結果には 'standard'、ジオメトリ(preview)段階でMeshy-T2を使用して最初から個別に生成されたクリーンなパーツを得るには 'smart-topology' を選択します。
topology任意
型enum
デフォルトtriangle
quadtriangle
幾何学的なディテールを重視するTriangleと、表面の滑らかさを重視するQuadから選択するモデルのトポロジー。
target_polycount任意
型integer
デフォルト30000
100 – 300,000
ポリゴン数の目標。model_type が 'smart-topology' の場合は15,000が上限です。このモードで目標を省略すると、Meshyの低いデフォルト値4,000が選択されます。
should_remesh任意
型boolean
デフォルトtrue
falseにするとリメッシュをスキップして生の三角形メッシュを受け取り、それ以外ではリメッシュ段階を有効にします。
symmetry_mode任意
型enum
デフォルトauto
offautoon
モデル生成時に適用する対称性設定。
enable_pbr任意
型boolean
デフォルトfalse
ベースカラーと併せてメタリック、ラフネス、法線のPBRマップを生成するかどうかを制御します。
is_a_t_pose任意
型boolean
デフォルトfalse
trueで有効になるTポーズ生成切り替え。pose_modeに置き換えられ、非推奨です。
pose_mode任意
型enum
デフォルト
a-poset-pose
空文字列にすると生成モデルのポーズを指定しません。'a-pose' でAポーズ、't-pose' でTポーズを指定できます。
enable_prompt_expansion任意
型boolean
デフォルトfalse
大規模言語モデルにプロンプトを詳細化させます。この拡張を有効にしても、プロンプトの意味は変わりません。
texture_prompt任意
型string | null
≤ 600文字
'full' モードで追加のテキストプロンプトを使ってテクスチャリングを指示します。他のモードでは使用されません。
texture_image_url任意
型url · image
テクスチャ生成用の2D参照画像。'full' モードでのみ適用されます。
enable_rigging任意
型boolean
デフォルトfalse
自動人型リギング。四肢を明確に識別できる人型モデルで最も効果的です。有効にすると生成モデルをリギングし、歩行および走行用の基本アニメーションを提供します。
rigging_height_meters任意
型number
デフォルト1.7
> 0
enable_rigging が true の場合に、メートル単位の推定キャラクター身長を指定します。それ以外では効果がありません。
enable_animation任意
型boolean
デフォルトfalse
リギング済みモデルにプリセットアニメーションを適用するかどうか。enable_rigging が true である必要があります。
animation_action_id任意
型integer
デフォルト92
MeshyライブラリのアニメーションプリセットID。利用可能なアクションは https://docs.meshy.ai/en/api/animation-library に一覧されています。検証と使用は enable_animation が true の場合にのみ行われます。[0, 696] の範囲外の値は422で拒否され、"Idle" は `0` に対応します。
enable_safety_checker任意
型boolean
デフォルトtrue
前処理の安全性チェック切り替え。trueにすると、処理前の入力安全性チェックが必須になります。
必須

ファイルパラメータには、公開されたhttps:// URL、10 MBまでのdata: URI、またはアップロードしたファイルのfile_urlを指定します。 ファイル

出力

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v6/text-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 800,
    "usd": "0.80",
    "charged": 800,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "animation_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "animation_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "thumbnail": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "obj": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "usdz": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "blend": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "stl": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "texture_urls": [
      {
        "base_color": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "metallic": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "normal": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "roughness": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        }
      }
    ],
    "seed": 42,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "rigged_character_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "rigged_character_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "basic_animations": {
      "walking_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "rig_task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ファイルの保存期間を選択すべてのoutputs[].urlはストレージ上のコピーです。アカウント設定または?storage=により、永久保存(GB・月単位で有料)または無料で7日保存できます。
すべてのモデルで同じ形式画像、動画、音声のいずれでも、type、url、content_type、width、height、durationが含まれます。outputはモデル独自の結果オブジェクトです。
出力フィールド
animation_glb
object {url, content_type, file_name, file_size} | null3DモデルをGLBとして含むアニメーション結果。enable_animation が true でない限り、この結果はレスポンスに含まれません。
animation_fbx
object {url, content_type, file_name, file_size} | null3DモデルをFBXとして含むアニメーション結果。enable_animation が true でない限り、この結果はレスポンスに含まれません。
model_glb
object {url, content_type, file_name, file_size}生成された3Dオブジェクトを含むGLBファイル。
thumbnail
object {url, content_type, file_name, file_size} | null生成モデルのプレビューを示すサムネイル。
model_urls
object {glb, fbx, obj, usdz, blend, stl}各種形式の3Dモデルへのリンク。
texture_urls
array of object {base_color, metallic, normal, roughness}オブジェクトの配列として表すテクスチャファイル。
seed
integer | null生成時に使用するシード値。
prompt
string生成に指定したテキストプロンプト。
actual_prompt
string | nullプロンプト拡張が有効な場合に、生成へ実際に適用されたプロンプト。
rigged_character_glb
object {url, content_type, file_name, file_size} | nullGLBキャラクターファイルとして返されるリギング結果。enable_rigging が true でない限りレスポンスに含まれません。
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullFBXキャラクターファイルとして返されるリギング結果。enable_rigging が true でない限りレスポンスに含まれません。
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | null基本的な歩行および走行アニメーション。enable_rigging が true の場合にのみ含まれます。
rig_task_id
string | nullリギングタスクの識別子。enable_rigging が true の場合にのみ含まれます。

その他のモデル: テキストから3D

AIエージェント向け:このページのMarkdown版はこちらです: https://doitong.com/ja/developers/models/meshy/v6/text-to-3d.md. すべてのモデルとガイド: https://doitong.com/developers/llms.txt