はじめに
写真からレリーフを作るエンドポイントです。彫刻の方向、ミリ単位の寸法、背景の除去、曲げ方を設定できます。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 3D モデル |
| 入力写真 |
|
| 納品ファイル | テクスチャなしの GLB、STL、16-bit グレースケール深度 PNG です。 |
| レリーフのプリセット |
|
| 彫刻の方向 |
|
| 深さの上書き |
|
| 実寸の長辺 |
|
| 土台の厚さ |
|
| 背景の除去 |
|
| 曲率の調整 |
|
| メッシュのサンプリング |
|
| 処理時間の実測 | 既定設定の検証では 56–76 秒。プレビューの読み込み時間は別途必要です。 |
| レリーフ単位の料金 | 対応設定によらず固定料金で、失敗したタスクには課金されません。 |
主な機能とハイライト
髪とシルクを彫刻の細部に
新しいサンプルでは、横顔の写真が既定設定でレリーフプレートになりました。髪の束やシルクのひだが深さとして表れ、GLB、STL、16-bit 深度マップがまとめて得られました。表示画像は生成形状のレンダリングであり、実物の印刷品ではありません。
猫の肖像をスライサーへ
猫のサンプルでは mesh_resolution 1024 で 40 MB の GLB、85 MB の STL、深度 PNG が返りました。GLB で形状を調べ、STL を印刷工程に使います。この規模のプレビューは読み込みに時間がかかる場合があります。
オークの細部と残ったプレート
120 mm のオークの検証では、engrave、high、remove_base としきい値 0.05 を組み合わせました。葉とドングリは明瞭でしたが、土台は残りました。しきい値を上げると背景を多く取り除けますが、結果は被写体と周囲の深度差に左右されます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | JPEG・PNG・WebP の写真が必須です。32 x 32 ピクセル以上、20 MB 以下で、既定の画像はありません。 1 文字以上 |
relief_height | いいえ | low(既定、深さ約 3 mm)か high(約 6 mm)を選びます。 |
carving_mode | いいえ | 既定の emboss は被写体をプレートから浮き上がらせます。engrave は手前側の部分を内側へ彫り込みます。 |
carving_depth_mm | いいえ | 0〜60 mm の範囲で深さを任意に上書きできます。省略すると |
size_mm | いいえ | レリーフ上の写真の長辺を、曲げる前の平面で測った寸法です。20〜250 mm、既定は 60 mm です。 |
base_thickness_mm | いいえ | 任意で指定するプレートの厚さです。範囲は 0.1〜10 mm で、数値の既定値はここでは指定されていません。 |
remove_base | いいえ | 既定では無効です。有効にすると、被写体を残して背景とプレートの除去を要求します。 デフォルト値: |
removal_threshold | いいえ | 背景除去のしきい値は 0.01〜1、既定値は 0.01 です。 |
bend_mode | いいえ | off(既定)は平らなプレートを維持し、convex は外向き、concave は内向きに曲げます。曲げモードによる課金の加算はありません。 |
bend_axis | いいえ | xz(既定)は左右の端を、yz は上下の端を曲げます。曲げが有効な場合に使う軸で、請求額には影響しません。 |
bend_angle | いいえ | 曲げ角度を 0〜360 度で指定します。既定は 60 度で、convex または concave と組み合わせます。 |
mesh_resolution | いいえ | 長辺方向のメッシュの点数です。512〜1024 の範囲で、既定は 1024 です。 |
料金
$0.96 / モデル
完成したレリーフごとに定額で課金されます。対応する設定はすべて料金に含まれ、失敗時は無料です。
ユースケース
布の表情を残す肖像の記念品
横顔の写真を記念プレートにできます。当社のシルク衣装のサンプルでは、既定設定で髪の束と布のひだが深さとして表れました。
ペット写真から印刷用プレートへ
ペットの写真からスライス用 STL を作れます。猫の検証では mesh_resolution 1024 で GLB が 40 MB、STL が 85 MB になったため、ファイル処理の時間も見込んでください。
CNC 彫刻に使う深度マップ
付属する 16-bit グレースケール PNG をレリーフ彫刻に取り込めます。明るい部分が高い位置を示すため、メッシュと合わせて高さの参照に使えます。
植物を彫り込んだ装飾パネル
engrave と実寸を指定して装飾を制作できます。120 mm のオークの検証では葉とドングリが明瞭に表れ、除去指定後の目視確認が必要な理由も示されました。
曲面のバッジや展示作品
convex または concave を選び、曲げる縁の組を指定できます。100 mm、convex、90 度の肖像の検証では、髪や衣服の細部を残した明確な曲面を確認できました。
プロンプトガイドと実践のヒント
元にする写真を用意します
被写体が明確で背景がシンプルな JPEG、PNG、WebP を選びます。32 x 32 ピクセル以上、20 MB 以下が条件です。人物の写真は使用権があるものを使い、成人のみを対象とし、なりすましを避けてください。
サイズと彫刻方向を決めます
image_urlを入力して emboss または engrave を選び、size_mmで長辺を 20–250 mm に設定します。relief_heightは low のままにするか high を選び、carving_depth_mmでプリセットの深さを上書きすることもできます。土台と曲面を設定します
土台を残すか
remove_baseで除去を依頼します。除去を有効にした場合はbase_thickness_mmを省略してください。曲面には曲げモード、軸、角度を指定します。背景を除去してもプレートが一部残る場合があります。ファイルを確認して保存します
大きな GLB の読み込みを待ち、複数の角度からレリーフを確認します。スライス用には STL、彫刻用には深度 PNG をダウンロードし、利用先ソフトで寸法を確かめてください。
写真からレリーフへ:元画像を選びます
Meshy Relief は 1 枚の写真から、表面に浮き彫りや彫り込みを施したプレートを作ります。この image-to-3d エンドポイントは肖像の記念品、ペットのプレート、バッジ、装飾彫刻パネルに使えます。曲げる前の裏面は平らで、生成形状にテクスチャはありません。
入力は文章によるシーン指定ではなく image_url です。背景がシンプルで被写体が鮮明な写真を選びます。JPEG、PNG、WebP に対応し、32 x 32 ピクセル以上、20 MB 以下が条件です。人物写真は使用権のある成人のものを用い、なりすましをしないでください。
深さ、実寸、曲率の調整
| パラメータ | 範囲・選択肢 | 既定値と用途 |
|---|---|---|
image_url | JPEG、PNG、WebP を 1 枚、20 MB 以下、32 x 32 ピクセル以上 | 必須の元写真です |
relief_height | low, high | low は約 3 mm、high は約 6 mm の深さです |
carving_mode | emboss, engrave | 既定の emboss は被写体を浮かせ、engrave は手前の部分を内側へ彫ります |
carving_depth_mm | 0–60 mm | 任意指定でプリセットの深さを上書きします |
size_mm | 20–250 mm | 60 mm。曲げる前の平面で測った写真の長辺です |
base_thickness_mm | 0.1–10 mm | 任意のプレート厚です。remove_base 有効時は省略します |
remove_base | true, false | false。背景とプレートの除去を依頼します |
removal_threshold | 0.01–1 | 0.01。除去有効時に値を大きくするほど背景を多く削ります |
bend_mode | off, convex, concave | off。convex は外側、concave は内側へ曲げます |
bend_axis | xz, yz | xz は左右、yz は上下の縁を曲げます |
bend_angle | 0–360 度 | 60。曲げるモードと合わせて使います |
mesh_resolution | 512–1024 | 長辺方向に 1024 個のメッシュ点を配置します |
実寸とメッシュの密度は別々に設定します。size_mm はモデル上の写真の大きさ、mesh_resolution は形状をどれだけ密にサンプリングするかを表します。密度を下げるとファイルが小さくなり、細部も減ります。carving_depth_mm を指定すればプリセットを置き換え、省略すれば low または high に応じたおおよその深さになります。
被写体だけを切り出す指定
プレートを除いて被写体だけにしたい場合は remove_base を有効にし、base_thickness_mm を指定しません。除去は被写体と背景の深度差に依存します。removal_threshold を上げるほど背景を多く除去しますが、有効にしただけでプレートが消えたとは判断できません。出力モデルの輪郭と裏面を確認してください。
工程に合わせた 3 種類のファイル
- GLB:テクスチャなしのレリーフを回転させ、形状や曲率を確認します。
- STL:形状をスライサーに読み込み、印刷工程へ進めます。
- 深度 PNG:16-bit グレースケール画像を CNC やレリーフ彫刻に使います。明るいほど高い位置です。
Meshy は GLB の単位をメートル、STL をミリメートルと説明しています。想定外の縮尺で読み込まれた場合は、利用先の単位設定と指定寸法を照合してください。size_mm は曲げる前の寸法であり、曲がったプレートの端から端までの距離ではありません。
プロンプトと元写真の準備
Photo to Relief に prompt 欄はありません。このページのプロンプト例は、元写真を準備するための説明例であり、エンドポイントに送信する文章ではありません。写真を企画する際に人物や物、服装や素材、雰囲気、照明、場所を決め、完成した画像の URL を送ってください。
たとえば肖像写真なら、シルクのローブを着た 30 代の人物、穏やかな表情、柔らかいスタジオ光、無地の背景を指定できます。周囲の雑多な物より、布のひだや分かれた髪の束が見える構図を選びます。植物のパネルでは、シンプルな背景に葉とドングリが明確に見えるようにします。これらは入力構図の提案であり、すべてのシーンで検証済みの結果ではありません。
サンプルで確認した結果
新しいシルク衣装の横顔サンプルは既定設定を使い、髪の束と布のひだが深さとして彫られたプレートと 3 種類すべてのファイルが得られました。表示画像は形状のレンダリングで、実物の印刷完了を示すものではありません。
mesh_resolution 1024 では、猫のサンプルは GLB が 40 MB、STL が 85 MB でした。120 mm のオークは GLB が 100 MB、STL が 150 MB で、葉とドングリは明瞭でしたが、high、engrave、remove_base、しきい値 0.05 を指定してもプレートが残りました。このため除去結果には目視確認が必要です。
別の肖像テストでは high、engrave、100 mm、convex、90 度を組み合わせました。69 秒で完了し、曲面、髪、衣服のひだが確認できました。既定設定での検証時間は 56–76 秒です。これらは個別の実測であり、大きな GLB プレビューの読み込みには追加の時間がかかります。
料金と他モデルの選択
完成したレリーフごとの固定料金で、サイズ、深さ、サンプリング、除去、曲げ設定によって変わりません。失敗したタスクは課金されません。送信前に Meshy Relief のモデルページ で現在の料金を確認してください。
片面に細部を持つプレートには Relief が適しています。立体物全体には Seed3D 2.0 や Tripo H3.1 を検討できます。製作前に形状と背景除去を確認し、印刷・彫刻ソフトで寸法を確かめてください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "meshy/relief/image-to-3d",
"input": {
"bend_axis": "xz",
"bend_mode": "off",
"carving_mode": "emboss",
"image_url": "https://example.com/reference.png",
"relief_height": "low"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。






