後処理

テクスチャ

POST/v1/assets/{id}/texture

既存の3DアセットのPBRマテリアルを、テキストプロンプトまたは参照画像から再ペイントし、新しいアセットとして作成します。

非同期 idを返します。ポーリングまたはWebhookを使用します目安 ~60–120sコストエンジンにより異なる

パスの{id}はソースモデルです。テクスチャリングは新しいマップを新しいアセットに書き込み、元のアセットはそのまま残します。

パラメーター

パラメーター	説明
prompt任意 string	新しい表面を説明するテキスト（最大1,000文字）。省略するとモデル自体を基準に再テクスチャリングします。
engine任意 string	使用するテクスチャリングエンジン。例: `tripo-texture`, `meshy-texture`, `hunyuan-texture`。省略すると既定値を使用します。正式な一覧: `GET /v1/models?category=texture`。
image任意 file	プロンプトの代わりに、またはプロンプトと併せてテクスチャの基準にするマルチパート参照画像（≤20 MB）。下記の画像ガイドを参照してください。
license任意 string	結果物の使用権。既定は非公開（全権利留保）です。
callbackUrl任意 string	ポーリングの代わりに、完成したアセットをサーバーへプッシュします。Webhookを参照してください。

リクエスト

curl -X POST https://api.picoberry.ai/v1/assets/019…/texture \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"engine":"tripo-texture","prompt":"weathered bronze with green patina"}'

requests.post(f"{BASE}/v1/assets/{id}/texture", headers=headers,
    json={"engine": "tripo-texture", "prompt": "weathered bronze"})

await fetch(`${BASE}/v1/assets/${id}/texture`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ engine: "tripo-texture", prompt: "weathered bronze" }) });

画像ガイド

promptを省略し、multipart/form-dataでimageパート（≤20 MB）を送信すると、テキストの代わりに参照画像でテクスチャリングします。画像ホスティングは不要です。

multipart

curl -X POST https://api.picoberry.ai/v1/assets/019…/texture \
  -H "Authorization: Bearer pb_live_xxx" \
  -F "engine=tripo-texture" -F "image=@./ref.png"

レスポンス

レスポンス · 200

{ "success": true, "data": { "id": "019…", "taskStatus": 0 } }

taskStatusが2になるまでGET /v1/assets/{id}をポーリングしてください。完成したfiles.modelは再テクスチャリングされたメッシュで、files.texturesに新しいマップが格納されます。非同期とポーリングを参照してください。

コストはエンジンにより異なります テクスチャリングエンジンごとに料金が異なります。正確なコストはGET /v1/modelsにあります。