はじめに
Meshy N1 は、3D オブジェクト上で直接色を生成するテクスチャモデルです。Retexture に既存のメッシュと参照画像を渡すと、形状と面数を保ったままテクスチャを置き換えた GLB が返ります。実物の写真で見た目を再現したり、スタイル画像で配色を変えたりできます。複数の画像を投影する方式で起こりがちな輪郭の二重化、色のにじみ、模様の途切れを抑えます。
主な機能とハイライト
白いブーツに革や縫い目の色が付きます
正面の商品写真を使うと、テクスチャも UV もなかったブーツに、使い込んだ茶色の革、縫い目、赤い靴ひも、真ちゅう色のハトメが付きました。靴底の溝も濃い茶色になりました。35 秒で返った GLB は 3.5 MB で、2048 ピクセルの PNG テクスチャ 1 枚を内包し、2,804 三角形を維持しました。個別の PBR マップは含まれません。
形はそのままで配色を借りられます
白とオレンジの玩具の宇宙飛行士を参照し、UV の維持を無効にすると、白いアッパー、灰青色のつま先、紺の靴ひも、小さなオレンジの印が付きました。宇宙服のパネルに似た模様も見られました。処理は 28 秒、GLB は 2.6 MB で、面数は 2,804 三角形のままでした。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
mesh_url | はい | 90 MB 以下の GLB、バイナリ FBX、OBJ、STL を渡します。直リンクは該当する拡張子で終える必要があります。 1 文字以上 |
reference_image_urls | いいえ | 同じ物体の写真またはレンダリング画像を 1〜4 枚指定し、先頭を正面にします。 |
reference_image_url | いいえ | 配色、材質の見え方、印を示すスタイル画像を 1 枚指定します。正面として扱われ、 |
keep_original_uv | いいえ | 初期状態では有効で、既存 UV を維持します。無効なら展開し直し、UV のない入力はどちらでも新規作成します。 デフォルト値: |
料金
$0.48 / 納品
正常に納品された処理ごとに固定料金がかかります。モデルの大きさ、参照画像の枚数、keep_original_uv の設定では変わりません。形式の誤りや参照画像の不足を含め、失敗したリクエストには課金されません。
ユースケース
小物の配色を何通りも試します
ゲームや AR で使う小物に、革風や塗装風などの色と模様を付けられます。同じメッシュを使いながら配色を比較し、配置先のシーンで見え方を確認してください。
白いモデルの仕上がりを確認します
白いモデルや 3D プリント用のデジタルモデルを着色し、GLB で完成時の配色を検討できます。ネットショップの商品モデルにも色違いを試し、公開前に裏側や底面まで確認してください。
プロンプトガイドと実践のヒント
元になるモデルを用意します
mesh_url に 90 MB 以下の GLB、バイナリ FBX、OBJ、STL をアップロードするか、.glb、.fbx、.obj、.stl で終わる直リンクを渡します。JSON 形式の .gltf は先に .glb に書き出してください。Meshy が示す上限は 7,999,999 面です。モデルがなければ、Tripo P1、Tripo H3.1、Seed3D 2.0 で画像から作る方法もあります。
参照方法を一つ選びます
同じ物体の写真やレンダリング画像を reference_image_urls に 1〜4 枚指定し、先頭を正面にします。配色や材質の見え方、印を借りるなら reference_image_url にスタイル画像を 1 枚指定します。この画像も正面として扱われます。両方の指定も両方の省略も受理時に拒否され、課金されません。文章での指定はできません。
UV と仕上がりを確認します
keep_original_uv は初期値の true で既存の UV 展開を使い、false で展開し直します。入力に UV がなければ、どちらでも新しく作ります。返された GLB を回して、継ぎ目、底面、色の配置を確認してください。
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/n1/retexture",
"input": {
"mesh_url": "https://example.com/reference.png"
}
}'
# 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 リファレンスを参照してください。







