後処理

リメッシュ

POST/v1/assets/{id}/remesh

AIで生成済みのアセットを、まったく新しいアセットへリトポロジーします。シルエットは保ちつつ、ポリゴン数を減らします。

非同期 idを返します。ポーリングまたはウェブフックで受け取ります一般的 約30〜90秒コスト 10クレジット〜

パスの{id}は元アセットです。テキスト → 3D、画像 → 3D、または以前の後処理ステップで生成したモデルであれば何でも指定できます。リメッシュは結果を新しいアセットに書き出し、元のアセットはそのまま残します。

パラメーター

パラメーター説明
engine任意
string		使用するリトポロジーエンジン。例: pb-remesh、tripo-remesh、tripo-remesh-quad(クアッド出力)、meshy-remesh、hunyuan-remesh。省略するとデフォルトを使用します。正式な一覧: GET /v1/models?category=remesh。
polycount任意
integer		目標ポリゴン数、100〜2,000,000。セルフホスト型のpb-remeshエンジンは500〜500,000に対応します。省略するとエンジンが自動で選択します。
license任意
string		結果物の使用権限。デフォルトは非公開(全権利留保)です。
callbackUrl任意
string		ポーリングの代わりに、完成したアセットをサーバーへプッシュします。ウェブフックを参照してください。
元アセットはAIで生成したものが必要です リメッシュはPicoBerryが生成したモデルのみを受け付けます。アップロードしたメッシュはリメッシュできず、error.code 13005とともに400が返されます。

リクエスト

リクエスト
curl -X POST https://api.picoberry.ai/v1/assets/019…/remesh \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"engine":"tripo-remesh-quad","polycount":8000}'
requests.post(f"{BASE}/v1/assets/{id}/remesh", headers=headers,
    json={"engine": "tripo-remesh-quad", "polycount": 8000})
await fetch(`${BASE}/v1/assets/${id}/remesh`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ engine: "tripo-remesh-quad", polycount: 8000 }) });

レスポンス

レスポンス · 200
{ "success": true, "data": { "id": "019…", "taskStatus": 0 } }

これは生成レスポンスです。新しいアセットが現在処理中です。taskStatusが2になるまでGET /v1/assets/{id}をポーリングすると、files.modelにリトポロジー済みのメッシュが格納されます。ループについては非同期とポーリングを参照してください。

コストはエンジンによって異なります PB Remeshは10クレジットから始まり、Tripo・Meshy・Hunyuanエンジンはより高い価格です。エンジンごとの正確なコストはGET /v1/modelsにあります。